%!TEX program = SpiX
%$ xelatex -synctex=1 $texname
%$ komkindex -k -s kosimple $basename
%$ xelatex -synctex=1 $texname
\documentclass[a4paper]{srcandtext}

\ifLuaOrXeTeX
\setmainfont{TeX Gyre Pagella}
\setkomainfont(Noto Serif CJK KR)
\fi

%\usepackage[1in]{fapapersize}
%\def\keyfontname{HANBatang.ttf}
\usepackage{kshcrkey}

\begin{document}

\title{kshcrkey.sty}
\author{Nova de Hi}
\date{2024/10/06\quad v0.4}

\maketitle

\section{이번 버전에서 바뀐 점}

\paragraph{0.4}
\hologo{pdfTeX}의 \stp{kotex}을 지원하게 되었다. 폰트를 직접 이용할 수 없으므로 함초롬 바탕 LVT 서체의
글리프를 그림으로 변환하여 불러오게 한다.

\section{개요}

함초롬 바탕 LVT 서체(\texttt{HANBatang-LVT.ttf})의 
``보충 사용자 정의 영역-A''(Supplementary Private Use Area-A)에는
여러 가지 기호가 들어 있고 그 가운데 키보드 글자도 포함되어 있다.

키보드 글자를 식자하기 위해서 \stp{menykeys} 패키지나 \stp{libertine}의
keycap macro를 이용하는 방법이 \LaTeX 에서 일반적으로 쓰인다.
이것으로도 충분하다 하겠지만 모처럼 함초롬 서체를 설치했으니 이것도 사용할
방법을 찾아보았다.

%이 패키지는 %\stm{hcrkey} 명령 하나만을 제공한다. 
%일단 \XeLaTeX 만 지원한다.
%\XeLaTeX 과 \LuaLaTeX 을 지원한다.

\section{사용법}

|\hcrkey{<keyname>}| 명령으로 사용한다. 일부 특수문자, 예컨대 |#| 기호는
|hash|라고 입력해야 하며, 대소문자는 구별하지 않는다.

|\hcrkeys[<separator>]{<keyname>,...}| 둘 이상의 키 이름을 쉼표로 연결하여 줄 수 있다.
이 때 옵션 인자는 각 키 사이를 연결하는 문자를 둔다. 기본값은 스페이스이다.

\subsection{기능키}

\begin{examplebelow}
\hcrkey{f1}, \hcrkey{f2}, \hcrkey{f3}, \ldots, \hcrkey{f12}
\end{examplebelow}

\subsection{알파벳키}

\begin{examplebelow}
\hcrkey{q}, \hcrkey{w}, \hcrkey{e}, \hcrkey{r}, \hcrkey{t}, \ldots
\end{examplebelow}

\subsection{특수한 키}

\begin{examplebelow}
\hcrkey{ESC}, \hcrkey{Alt}, \hcrkey{Ctrl},
\hcrkey{TAB}, \hcrkey{capslock}, \hcrkey{Shift},
\hcrkey{space}, \hcrkey{backspace}, \hcrkey{del},
\hcrkey{ins}, \hcrkey{enter}
\end{examplebelow}

\subsection{커서 키}

\begin{examplebelow}
\hcrkey{left}, \hcrkey{right}, \hcrkey{up}, \hcrkey{down},
\hcrkey{pgup}, \hcrkey{pgdn}, \hcrkey{home}, \hcrkey{end}
\end{examplebelow}

\subsection{부호 키}

\begin{examplebelow}
\hcrkey{backquote} = \hcrkey{tilde},
\hcrkey{1}, \hcrkey{2}, \hcrkey{3}, \ldots, \hcrkey{0}\\
\hcrkey{!}, \hcrkey{@}, \hcrkey{hash}, \hcrkey{dollar},
\hcrkey{percent}, \hcrkey{caret}, \hcrkey{ampersand},
\hcrkey{*}, \hcrkey{(}, \hcrkey{)} \\
\hcrkey{-}=\hcrkey{_}, \hcrkey{+}=\hcrkey{=},
\hcrkey{\{}=\hcrkey{[}, \hcrkey{\}}=\hcrkey{]},
\hcrkey{backslash}=\hcrkey{|}, \hcrkey{:}=\hcrkey{;},
\hcrkey{"}=\hcrkey{'}, \hcrkey{<}=\hcrkey{,},
\hcrkey{>}=\hcrkey{.}, \hcrkey{?}=\hcrkey{/}
\end{examplebelow}

\subsection{numpad 키}

\begin{examplebelow}
\hcrkey{PrtSc}, \hcrkey{ScrollLock}, \hcrkey{Pause},
\hcrkey{NumLock} \\
\hcrkey{num/} \hcrkey{num*} \hcrkey{num-} \hcrkey{num+} \hcrkey{numEnter} \\
\hcrkey{num1}, \hcrkey{num2}, \hcrkey{num3}, \ldots, \hcrkey{num9} \\
\hcrkey{numins}, \hcrkey{numdel}, \hcrkey{numpgup}, \hcrkey{numpgdn},
\hcrkey{numleft}, \hcrkey{numright}, \hcrkey{numup}, \hcrkey{numdown}
\end{examplebelow}

\subsection{\cs{hcrkeys} 명령}

\begin{examplebelow}
\hcrkeys{ctrl,alt,del} \quad
\hcrkeys[+]{ctrl,alt,del}
\end{examplebelow}

\subsection{기타}

\begin{examplebelow}
\hcrkey{windows}, \hcrkey{blank}, \hcrkey{fn}
\end{examplebelow}

만약 |HANBatang-LVT.ttf| 대신 한글과컴퓨터의 |HANBatang.ttf|를 쓰고자 한다면
|\usepackage{hcrkey}|하기 전에
\begin{verbatim}
\def\hcrkeyfontname{HANBatang.ttf}
\end{verbatim}
를 선언하라.


%\printindex

\end{document}

