| 1 |
%% |
| 2 |
%% This is the documentation of scsnowman package. |
| 3 |
%% (Last Update: 2023/02/23) |
| 4 |
%% Maintained on GitHub: |
| 5 |
%% https://github.com/aminophen/scsnowman |
| 6 |
%% |
| 7 |
%% Copyright (c) 2015-2023 Hironobu Yamashita |
| 8 |
%% Email : h.y.acetaminophen[a t]gmail.com |
| 9 |
%% GitHub : https://github.com/aminophen |
| 10 |
%% Blog : http://acetaminophen.hatenablog.com/ |
| 11 |
%% Twitter : @aminophen |
| 12 |
%% |
| 13 |
\documentclass[a4paper]{article} |
| 14 |
\usepackage{doc} |
| 15 |
\usepackage[svgnames]{xcolor} |
| 16 |
\usepackage{scsnowman} |
| 17 |
\pagenumbering{enumsnowman} |
| 18 |
\GetFileInfo{scsnowman.sty} |
| 19 |
\usepackage{array} |
| 20 |
\usepackage{amsthm} |
| 21 |
\usepackage{luatexja} |
| 22 |
\usepackage{luatexja-fontspec} |
| 23 |
\def\BigSnowman#1{\fontsize{60pt}{60pt}\selectfont\symbol{"#1}} |
| 24 |
\newjfontfamily\fipam{IPAexMincho} |
| 25 |
\newjfontfamily\fhrgnm{HiraMinProN-W3} |
| 26 |
\newjfontfamily\fkozm{KozMinPr6N-Regular} |
| 27 |
\newjfontfamily\fmsmin{MS-Mincho} |
| 28 |
\newjfontfamily\fvlgo{VLGothic} |
| 29 |
\usepackage{hyperref} |
| 30 |
% documentation |
| 31 |
\newtheorem{theorem}{Theorem} |
| 32 |
% misc |
| 33 |
\def\Lpack#1{\textsf{#1}} |
| 34 |
\def\Lopt#1{\texttt{#1}} |
| 35 |
% scsnowman in title |
| 36 |
\scsnowmandefault{adjustbaseline,scale=2,hat=Green,buttons=RoyalBlue} |
| 37 |
\def\scsnowmanleft{\scsnowman[arms=Brown,muffler=Red]} |
| 38 |
\def\scsnowmanright{\scsnowman[snow=SkyBlue]} |
| 39 |
\title{\scsnowmanleft\ The \Lpack{scsnowman} package \fileversion\ \scsnowmanright} |
| 40 |
\author{Hironobu Yamashita} |
| 41 |
\date{\filedate} |
| 42 |
\begin{document} |
| 43 |
|
| 44 |
\maketitle |
| 45 |
\scsnowmandefault{} |
| 46 |
|
| 47 |
The \LaTeX\ package \Lpack{scsnowman} provides a command \verb+\scsnowman+, which can display |
| 48 |
many variants of snowmen. This package utilizes Ti\emph{k}Z for drawing snowmen. |
| 49 |
\begin{figure}[htb]\centering |
| 50 |
\scsnowmandefault{adjustbaseline} |
| 51 |
\scsnowman[scale=5,hat,snow,arms]\scsnowman[scale=5,hat=RoyalBlue,muffler=Green] |
| 52 |
\scsnowman[scale=2]\scsnowman[scale=5]\scsnowman[scale=7]\par |
| 53 |
\scsnowmandefault{scale=6,hat,muffler=Red} |
| 54 |
\scsnowman[mouthshape=smile] |
| 55 |
\scsnowman[mouthshape=frown] |
| 56 |
\scsnowman[mouthshape=tight] |
| 57 |
\scsnowman[mouthshape=tight,arms,buttons,sweat]\\[2ex] |
| 58 |
\scsnowmandefault{scale=5} |
| 59 |
\begin{tabular}{ccc} |
| 60 |
\texttt{U+2603} & \texttt{U+26C4} & \texttt{U+26C7} \\ |
| 61 |
\texttt{SNOWMAN} & \texttt{SNOWMAN WITHOUT SNOW} & \texttt{BLACK SNOWMAN} \\ |
| 62 |
\scsnowman[body=false,snow=true] & \scsnowman[body=false,snow=false] & \scsnowman[body=true,snow=true] |
| 63 |
\end{tabular} |
| 64 |
\end{figure} |
| 65 |
|
| 66 |
The package is maintained on GitHub: |
| 67 |
\begin{itemize} |
| 68 |
\item \url{https://github.com/aminophen/scsnowman} |
| 69 |
\end{itemize} |
| 70 |
|
| 71 |
\begin{figure}[htb]\centering |
| 72 |
\scsnowmandefault{adjustbaseline,scale=8,buttons=RoyalBlue} |
| 73 |
\scsnowman[hat=Green,muffler=Red,arms=Brown,buttons=Green,broom=DarkGoldenrod] |
| 74 |
\scsnowman[hat=Green,body,muffler=Red,arms=Brown,nose=Orange,snow=SkyBlue] |
| 75 |
\scsnowman[snow=SkyBlue,note=Red] |
| 76 |
\scsnowman[hat=Green,muffler=RoyalBlue,arms=Brown,buttons=Green,broom=DarkGoldenrod] |
| 77 |
\end{figure} |
| 78 |
|
| 79 |
\clearpage |
| 80 |
\tableofcontents\clearpage |
| 81 |
|
| 82 |
\section{The History of Snowman in Unicode} |
| 83 |
|
| 84 |
In October 1991, the first volume of the Unicode standard was published. Since then, |
| 85 |
there was a code point assigned to a character ``snowman''; \verb:U+2603:. |
| 86 |
\begin{quote} |
| 87 |
\verb:U+2603 SNOWMAN:\\ |
| 88 |
= snowy weather |
| 89 |
\end{quote} |
| 90 |
It seems that the shape of its reference glyph in Unicode 1.0.0 was taken from ``Ryumin'', |
| 91 |
which was developed by Morisawa (a famous font vendor in Japan). |
| 92 |
\begin{figure} |
| 93 |
%\includegraphics[width=0.3\textwidth]{} |
| 94 |
\end{figure} |
| 95 |
A few years later, the reference glyph has sometimes been changed to another; however, |
| 96 |
there had been only one ``snowman'' in Unicode until 2009. |
| 97 |
\begin{figure} |
| 98 |
%\includegraphics[width=0.3\textwidth]{} |
| 99 |
\end{figure} |
| 100 |
|
| 101 |
In October 2009, Unicode 5.2 was published. In this volume, two ``snowman'' code points |
| 102 |
were added; \verb:U+26C4: and \verb:U+26C7:. |
| 103 |
\begin{quote} |
| 104 |
\verb:U+26C4 SNOWMAN WITHOUT SNOW:\\ |
| 105 |
= light snow\\ |
| 106 |
\verb:U+26C7 BLACK SNOWMAN:\\ |
| 107 |
= heavy snow |
| 108 |
\end{quote} |
| 109 |
According to the code chart, the origin of these two characters is ARIB STD-B24 |
| 110 |
(Data Coding and Transmission Specification for Digital Broadcasting;\footnote{% |
| 111 |
\url{http://www.arib.or.jp/tyosakenkyu/kikaku_hoso/hoso_std-b024.html}; Abstract in PDF format |
| 112 |
(both \href{http://www.arib.or.jp/tyosakenkyu/kikaku_sample/sample-std-b24-1-6.3.pdf}{Japanese} |
| 113 |
and \href{http://www.arib.or.jp/english/html/overview/doc/6-STD-B24v5_2-1p3-E1.pdf}{English}) are |
| 114 |
available.}), which was established by Association of Radio Industries and Business in |
| 115 |
Japan. Since then, it can be said that the old code point \verb:U+2603: has been given |
| 116 |
an implicit meaning of ``\verb:SNOWMAN WITH SNOW:''. The reference glyphs were also changed |
| 117 |
at that time. |
| 118 |
\begin{figure} |
| 119 |
%\includegraphics[width=0.3\textwidth]{} |
| 120 |
\end{figure} |
| 121 |
|
| 122 |
\section{Variation of Snowman among Actual Fonts} |
| 123 |
|
| 124 |
Since the shapes of the reference glyphs used in the Unicode code charts are not |
| 125 |
prescriptive, the actual fonts have a wide variety of glyph designs. However, when it |
| 126 |
comes to snowmen, the variation between fonts is enormous. This variation is very |
| 127 |
interesting, however, on the other hand, problematic. |
| 128 |
|
| 129 |
Table \ref{table:actualfonts} shows the variety of ``snowman'' in actual fonts. |
| 130 |
\begin{table}[tbp] |
| 131 |
\caption{The variety of ``snowman'' in actual fonts}\label{table:actualfonts} |
| 132 |
\setlength{\extrarowheight}{50pt}% |
| 133 |
\centering |
| 134 |
\begin{tabular}{cccc} |
| 135 |
\hline |
| 136 |
& \raisebox{2ex}{\Large\texttt{U+2603}} & \raisebox{2ex}{\Large\texttt{U+26C4}} & \raisebox{2ex}{\Large\texttt{U+26C7}} \\ \hline |
| 137 |
\raisebox{4ex}{\fipam IPAex明朝} & {\fipam \BigSnowman{2603}} & & \\ |
| 138 |
\raisebox{4ex}{\fmsmin MS 明朝} & {\fmsmin \BigSnowman{2603}} & & \\ |
| 139 |
\raisebox{4ex}{\fkozm 小塚明朝 Pr6N Regular} & {\fkozm \BigSnowman{2603}} & & \\ |
| 140 |
\raisebox{4ex}{\fhrgnm ヒラギノ明朝 ProN W3} & {\fhrgnm \BigSnowman{2603}} & & \\ |
| 141 |
\raisebox{4ex}{\fvlgo VLゴシック} & {\fvlgo \BigSnowman{2603}} & {\fvlgo \BigSnowman{26C4}} & {\fvlgo \BigSnowman{26C7}} \\ |
| 142 |
\hline |
| 143 |
\end{tabular} |
| 144 |
\end{table} |
| 145 |
The snowman in ``IPA Mincho (IPA明朝)'' from Information-technology Promotion Agency is very similar |
| 146 |
to the one in ``Ryumin (リュウミン)'' from Morisawa. However, in ``MS Mincho (MS 明朝)'' from Microsoft, |
| 147 |
the snowman wears a black hat instead of white one. In ``Kozuka Mincho (小塚明朝)'' from Adobe Systems Inc., |
| 148 |
he/she wears a muffler instead of a hat. Moreover, it doesn't snow in ``Hiragino Mincho (ヒラギノ明朝)'' from |
| 149 |
SCREEN Graphic and Precision Solutions Co., Ltd. It is natural that some fonts developed before 2009 have |
| 150 |
a ``snowman without snow'' glyph in the code point \verb:U+2603:, however, it can be a problem when we |
| 151 |
have to transfer the exact information to others. |
| 152 |
|
| 153 |
\section{Introduction to \Lpack{scsnowman} Package} |
| 154 |
|
| 155 |
The \LaTeX\ package \Lpack{scsnowman} provides a command \verb+\scsnowman+, which can |
| 156 |
display many variants of snowmen. This package depends on Ti\emph{k}Z package for drawing |
| 157 |
snowman images. |
| 158 |
|
| 159 |
To use this package, load it in preamble: |
| 160 |
\begin{quote}\begin{verbatim} |
| 161 |
\usepackage{scsnowman} |
| 162 |
\end{verbatim}\end{quote} |
| 163 |
In the main document, use \verb+\scsnowman+ command to print a snowman: \scsnowman. |
| 164 |
By default, the snowman is ``plain'' style, without any decoration such as snow, a hat or |
| 165 |
a muffler. |
| 166 |
|
| 167 |
\section{Command Options} |
| 168 |
|
| 169 |
You can customize the style of a snowman using the optional argument. The syntax is |
| 170 |
\begin{quote} |
| 171 |
\verb+\scsnowman[+\emph{$\langle$key-value list$\rangle$}\verb+]+ |
| 172 |
\end{quote} |
| 173 |
|
| 174 |
\subsection{Scaling and Adjustment Options} |
| 175 |
|
| 176 |
The following \emph{key}s are available: |
| 177 |
\begin{quote} |
| 178 |
\Lopt{scale}, \Lopt{adjustbaseline} |
| 179 |
\end{quote} |
| 180 |
The key \Lopt{scale} takes a scale factor. The origin of scaling is set at the lower |
| 181 |
left corner of the bounding box. For example, \verb+\scsnowman+, |
| 182 |
\verb+\scsnowman[scale=3]+ and \verb+\scsnowman[scale=5]+ give: |
| 183 |
\begin{quote}\begin{minipage}{.9\textwidth} |
| 184 |
\scsnowman\scsnowman[scale=3]\scsnowman[scale=5]\quad |
| 185 |
with visualized bounding boxes: |
| 186 |
\fboxsep0pt\fbox{\scsnowman}\fbox{\scsnowman[scale=3]}\fbox{\scsnowman[scale=5]} |
| 187 |
\end{minipage}\end{quote} |
| 188 |
When the key \Lopt{adjustbaseline} is specified (or, \Lopt{adjustbaseline=true}), |
| 189 |
the base line of the in-line snowman will be adjusted to that of the surrounding texts. |
| 190 |
This will be helpful when a snowman appears to be ``floating in the air.''\\[1ex] |
| 191 |
\begin{minipage}{.55\textwidth}\begin{verbatim} |
| 192 |
Text, |
| 193 |
\scsnowman[scale=1]% |
| 194 |
\scsnowman[scale=4]% |
| 195 |
\scsnowman[scale=7], |
| 196 |
T.\par |
| 197 |
Text, |
| 198 |
\scsnowman[adjustbaseline,scale=1]% |
| 199 |
\scsnowman[adjustbaseline,scale=4]% |
| 200 |
\scsnowman[adjustbaseline,scale=7], |
| 201 |
T. |
| 202 |
\end{verbatim}\end{minipage} |
| 203 |
\begin{minipage}{.4\textwidth} |
| 204 |
Text, |
| 205 |
\scsnowman[scale=1]% |
| 206 |
\scsnowman[scale=4]% |
| 207 |
\scsnowman[scale=7], |
| 208 |
T.\par |
| 209 |
Text, |
| 210 |
\scsnowman[adjustbaseline,scale=1]% |
| 211 |
\scsnowman[adjustbaseline,scale=4]% |
| 212 |
\scsnowman[adjustbaseline,scale=7], |
| 213 |
T. |
| 214 |
\end{minipage} |
| 215 |
|
| 216 |
\subsection{Design Options} |
| 217 |
|
| 218 |
Following \emph{key}s take a \emph{value} which specifies color. When the \emph{value} is omitted, |
| 219 |
it reacts to the surrounding text color: |
| 220 |
\begin{quote} |
| 221 |
\Lopt{body}, \Lopt{eyes}, \Lopt{mouth}, \Lopt{nose}, \Lopt{sweat}, \Lopt{arms}, |
| 222 |
\Lopt{hat}, \Lopt{muffler}, \Lopt{buttons}, \Lopt{snow}, \Lopt{note}, \Lopt{broom} |
| 223 |
\end{quote} |
| 224 |
The following \emph{key}s require one specific \emph{value}: |
| 225 |
\begin{quote} |
| 226 |
\Lopt{shape}, \Lopt{mouthshape} |
| 227 |
\end{quote} |
| 228 |
|
| 229 |
The key \Lopt{shape} specifies the outline shape of the snowman body. |
| 230 |
Currently, only \Lopt{shape=normal} is officially available, but you can define and use other shapes |
| 231 |
using \verb+\usescsnowmanlibrary+ command (described later, section \ref{usescsnowmanlibrary}). |
| 232 |
|
| 233 |
The key \Lopt{mouthshape} takes one of the followings: \Lopt{smile}, \Lopt{tight} or \Lopt{frown}. |
| 234 |
|
| 235 |
Here are some examples:\\[1ex] |
| 236 |
\begin{minipage}{.7\textwidth}\begin{verbatim} |
| 237 |
\scsnowman[scale=2,body,hat=red,muffler=blue] |
| 238 |
\scsnowman[scale=3,hat,snow,arms,buttons,note] |
| 239 |
\scsnowman[scale=2,muffler=red,arms,broom=brown] |
| 240 |
\scsnowman[scale=2,mouthshape=frown,hat=green] |
| 241 |
\end{verbatim}\end{minipage} |
| 242 |
\begin{minipage}{.25\textwidth} |
| 243 |
\scsnowman[scale=2,body,hat=red,muffler=blue] |
| 244 |
\scsnowman[scale=3,hat,snow,arms,buttons,note] |
| 245 |
\scsnowman[scale=2,muffler=red,arms,broom=brown] |
| 246 |
\scsnowman[scale=2,mouthshape=frown,hat=green] |
| 247 |
\end{minipage}\\[1ex] |
| 248 |
\begin{minipage}{.7\textwidth}\begin{verbatim} |
| 249 |
{\color{blue} |
| 250 |
\scsnowman[scale=2,body,hat=red,muffler=blue] |
| 251 |
\scsnowman[scale=2,hat,snow,arms,buttons,note] |
| 252 |
\scsnowman[scale=3,muffler=red,arms,broom=brown] |
| 253 |
\scsnowman[scale=2,mouthshape=frown,hat=green]} |
| 254 |
\end{verbatim}\end{minipage} |
| 255 |
\begin{minipage}{.25\textwidth} |
| 256 |
{\color{blue} |
| 257 |
\scsnowman[scale=2,body,hat=red,muffler=blue] |
| 258 |
\scsnowman[scale=2,hat,snow,arms,buttons,note] |
| 259 |
\scsnowman[scale=3,muffler=red,arms,broom=brown] |
| 260 |
\scsnowman[scale=2,mouthshape=frown,hat=green]} |
| 261 |
\end{minipage} |
| 262 |
|
| 263 |
\section{Changing the Default} |
| 264 |
|
| 265 |
The package default is the ``plain'' style snowman. This default can be changed by using |
| 266 |
\verb+\scsnowmandefault+ command. The syntax is |
| 267 |
\begin{quote} |
| 268 |
\verb+\scsnowmandefault{+\emph{$\langle$key-value list$\rangle$}\verb+}+ |
| 269 |
\end{quote} |
| 270 |
The available \emph{key}s are the same as those in \verb+\scsnowman+. |
| 271 |
|
| 272 |
Here are some examples:\\[1ex] |
| 273 |
\begin{minipage}{.6\textwidth}\begin{verbatim} |
| 274 |
\scsnowmandefault{scale=5,hat=red} |
| 275 |
\scsnowman |
| 276 |
\scsnowman[body,muffler=blue,arms] |
| 277 |
\scsnowman[hat=green,snow,nose=orange] |
| 278 |
\end{verbatim}\end{minipage} |
| 279 |
\begin{minipage}{.35\textwidth} |
| 280 |
\scsnowmandefault{scale=5,hat=red} |
| 281 |
\scsnowman |
| 282 |
\scsnowman[body,muffler=blue,arms] |
| 283 |
\scsnowman[hat=green,snow,nose=orange] |
| 284 |
\end{minipage} |
| 285 |
|
| 286 |
\section{Adding User-defined Snowman Shapes}\label{usescsnowmanlibrary} |
| 287 |
|
| 288 |
Any users can define and use custom snowman shape definitions. |
| 289 |
Here is a description of adding a shape named \Lopt{myfavorite}. |
| 290 |
\begin{enumerate} |
| 291 |
\item Prepare a snowman definition file \texttt{scsnowman-myfavorite.def} |
| 292 |
and put it into \verb+$TEXMF+ tree (e.g. \verb+texmf-local/tex/latex/scsnowman/+). |
| 293 |
For the format of snowman definition files, please refer to \texttt{scsnowman-normal.def}. |
| 294 |
\item Use \verb+\usescsnowmanlibrary+ command (don't forget \emph{sc}!) to load it. |
| 295 |
\begin{verbatim} |
| 296 |
\usepackage{scsnowman} |
| 297 |
\usescsnowmanlibrary{myfavorite} |
| 298 |
\end{verbatim} |
| 299 |
\item You can use the shape by \verb+\scsnowman[shape=myfavorite]+ command. |
| 300 |
\end{enumerate} |
| 301 |
If you have created a fancy snowman, please contact me, so that I can incorporate it |
| 302 |
into the official release! |
| 303 |
|
| 304 |
\section{Funny Usages} |
| 305 |
|
| 306 |
\subsection{Changing Item Labels and QED Symbols} |
| 307 |
|
| 308 |
For those who want more snowmen in the documents, currently \Lpack{scsnowman} provides |
| 309 |
the following additional commands: |
| 310 |
\begin{quote} |
| 311 |
\verb+\makeitemsnowman+:\\ |
| 312 |
\makeitemsnowman |
| 313 |
Change item labels in \Lopt{itemize} environment to snowmen |
| 314 |
{\labelitemi\labelitemii\labelitemiii\labelitemiv}. |
| 315 |
\makeitemother |
| 316 |
The command \verb+\makeitemother+ restores the default, |
| 317 |
usually {\labelitemi\labelitemii\labelitemiii\labelitemiv}.\par |
| 318 |
\verb+\makeqedsnowman+:\\ |
| 319 |
\makeqedsnowman |
| 320 |
Change the QED symbol in \Lopt{proof} environment to a snowman {\qedsymbol}. |
| 321 |
The package \Lpack{amsthm} is required. |
| 322 |
\makeqedother |
| 323 |
The command \verb+\makeqedother+ restores the default, usually {\qedsymbol}. |
| 324 |
\end{quote} |
| 325 |
These commands can be used wherever you want, and are effective within the current group. |
| 326 |
|
| 327 |
Here are some examples:\\[1ex] |
| 328 |
\begin{minipage}{.5\textwidth}\begin{verbatim} |
| 329 |
\begin{itemize} |
| 330 |
\makeitemsnowman |
| 331 |
\item Foo X. |
| 332 |
\begin{itemize} |
| 333 |
\item Bar A. |
| 334 |
\begin{itemize} |
| 335 |
\item Baz P. \item Baz Q. |
| 336 |
\end{itemize} |
| 337 |
\item Bar B. \item Bar C. |
| 338 |
\end{itemize} |
| 339 |
\end{itemize} |
| 340 |
\end{verbatim}\end{minipage} |
| 341 |
\begin{minipage}{.45\textwidth} |
| 342 |
\begin{itemize} |
| 343 |
\makeitemsnowman |
| 344 |
\item Foo X. |
| 345 |
\begin{itemize} |
| 346 |
\item Bar A. |
| 347 |
\begin{itemize} |
| 348 |
\item Baz P. \item Baz Q. |
| 349 |
\end{itemize} |
| 350 |
\item Bar B. \item Bar C. |
| 351 |
\end{itemize} |
| 352 |
\end{itemize} |
| 353 |
\end{minipage}\\[1ex] |
| 354 |
\begin{minipage}{.55\textwidth}\begin{verbatim} |
| 355 |
\makeqedsnowman |
| 356 |
\begin{theorem} |
| 357 |
Given two line segments whose |
| 358 |
lengths are $a$ and $b$ respectively, |
| 359 |
there is a real number $r$ such that |
| 360 |
$b=ra$. |
| 361 |
\end{theorem} |
| 362 |
\begin{proof} |
| 363 |
To prove it by contradiction try and |
| 364 |
asuume that the statement is false, |
| 365 |
proceed from there and at some point |
| 366 |
you will arrive to a contradiction. |
| 367 |
\end{proof} |
| 368 |
\end{verbatim}\end{minipage} |
| 369 |
\begin{minipage}{.45\textwidth} |
| 370 |
\makeqedsnowman |
| 371 |
\begin{theorem} |
| 372 |
Given two line segments whose |
| 373 |
lengths are $a$ and $b$ respectively, |
| 374 |
there is a real number $r$ such that |
| 375 |
$b=ra$. |
| 376 |
\end{theorem} |
| 377 |
\begin{proof} |
| 378 |
To prove it by contradiction try and |
| 379 |
asuume that the statement is false, |
| 380 |
proceed from there and at some point |
| 381 |
you will arrive to a contradiction. |
| 382 |
\end{proof} |
| 383 |
\end{minipage}\medskip |
| 384 |
|
| 385 |
The names of these commands are, of course, named after the \LaTeX\ \verb+\makeatletter+ |
| 386 |
and \verb+\makeatother+;-) |
| 387 |
|
| 388 |
\subsection{Drawing ``\emph{Kagami-mochi}''} |
| 389 |
|
| 390 |
Using \Lpack{scsnowman} package, you can also draw ``\emph{kagami-mochi}'' |
| 391 |
(mirror rice cake). It is a traditional Japanese New Year decoration, |
| 392 |
which usually consists of two round ``\emph{mochi}'' (rice cakes), the smaller |
| 393 |
placed atop the larger, and a ``\emph{daidai}'' (a Japanese bitter orange) |
| 394 |
with an attached leaf on top. |
| 395 |
|
| 396 |
Following \emph{key}s are implemented for this usage:\footnote{Strictly speaking, |
| 397 |
the orange on top of rice cakes should be ``\emph{daidai}''; however, |
| 398 |
a ``\emph{mikan}'' is often substituted for the original ``\emph{daidai}''.} |
| 399 |
\begin{quote} |
| 400 |
\Lopt{mikan}, \Lopt{leaf} |
| 401 |
\end{quote} |
| 402 |
The \emph{key} \Lopt{leaf} is effective only when \Lopt{mikan} is specified. |
| 403 |
Here is an example:\\[1ex] |
| 404 |
\begin{minipage}{.85\textwidth}\begin{verbatim} |
| 405 |
\scsnowmandefault{scale=5.5} |
| 406 |
\scsnowman[eyes=false,mouth=false,mikan=orange,leaf=green] |
| 407 |
\end{verbatim}\end{minipage} |
| 408 |
\begin{minipage}{.1\textwidth} |
| 409 |
\scsnowmandefault{scale=5.5} |
| 410 |
\scsnowman[eyes=false,mouth=false,mikan=orange,leaf=green] |
| 411 |
\end{minipage} |
| 412 |
|
| 413 |
\subsection{Replacing All ``8'' with Snowmen} |
| 414 |
|
| 415 |
You can replace all ``8'' inside an arabic number expression with snowmen |
| 416 |
\scsnowman\ by using \verb+\scsnowmannumeral+. |
| 417 |
Here is an example:\\[1ex] |
| 418 |
\begin{minipage}{.85\textwidth}\begin{verbatim} |
| 419 |
\scsnowmandefault{adjustbaseline}\scsnowmannumeral{18882} |
| 420 |
\scsnowmannumeral[muffler=blue,scale=1.5]{4283859} |
| 421 |
\end{verbatim}\end{minipage} |
| 422 |
\begin{minipage}{.1\textwidth} |
| 423 |
\scsnowmandefault{adjustbaseline}\scsnowmannumeral{18882} |
| 424 |
\scsnowmannumeral[muffler=blue,scale=1.5]{4283859} |
| 425 |
\end{minipage}\medskip |
| 426 |
|
| 427 |
You can also replace all ``8'' inside the page numbering with snowmen |
| 428 |
\scsnowman\ by adding \verb+\pagenumbering{enumsnowman}+. |
| 429 |
This documentation itself is an example! |
| 430 |
|
| 431 |
\clearpage |
| 432 |
|
| 433 |
\section*{Version History} |
| 434 |
|
| 435 |
This is the summary of changes. For more detail, see GitHub repository. |
| 436 |
\begin{table}[h] |
| 437 |
\centering |
| 438 |
\begin{tabular}{lll} |
| 439 |
Version 0.1 & 2015-12-13 & First public version on GitHub \\ |
| 440 |
Version 0.8 & 2016-08-08 & Second public version on GitHub: \\ |
| 441 |
& & new variants \Lopt{buttons}, \Lopt{mouthshape}, \Lopt{sweat} are added \\ |
| 442 |
Version 1.0 & 2016-12-22 & First CTAN release \\ |
| 443 |
Version 1.1 & 2017-01-22 & Add a new key \Lopt{adjustbaseline} \\ |
| 444 |
& & Update documentation \\ |
| 445 |
Version 1.2 & 2017-08-08 & Default color reacts to surrounding text color \\ |
| 446 |
& & Support vertical writing on (u)p\TeX\ and Lua\TeX-ja \\ |
| 447 |
& & Add a new key \Lopt{shape} \\ |
| 448 |
& & Add a new command \verb+\usescsnowmanlibrary+ \\ |
| 449 |
Version 1.2a & 2017-11-25 & Fix a bug in scaling with \Lopt{adjustbaseline} \\ |
| 450 |
Version 1.2b & 2018-01-05 & Add new keys \Lopt{mikan}, \Lopt{leaf} for drawing `kagami-mochi' \\ |
| 451 |
& & Stopped loading \Lpack{amsthm} by default \\ |
| 452 |
Version 1.2c & 2018-01-15 & Add a new key \Lopt{broom} \\ |
| 453 |
Version 1.2d & 2018-06-07 & Add new keys \Lopt{nose}, \Lopt{note} \\ |
| 454 |
& & Add a new command \verb+\scsnowmannumeral+ \\ |
| 455 |
Version 1.2e & 2019-08-12 & Fix a bug of possible infinite loop \\ |
| 456 |
Version 1.3a & 2020-10-10 & Update for new \LaTeX \\ |
| 457 |
Version 1.3b & 2023-02-14 & Fix a bug of up\TeX\ engine detection \\ |
| 458 |
Version 1.3c & 2023-02-23 & Another bug fix of engine detection \\ |
| 459 |
\end{tabular} |
| 460 |
\end{table} |
| 461 |
|
| 462 |
\begin{thebibliography}{9} |
| 463 |
\bibitem{NAOI1} |
| 464 |
\href{http://d.hatena.ne.jp/NAOI/20080623/1214211959}{雪だるまの親子関係} |
| 465 |
\ --- Mac OS Xの文字コード問題に関するメモ |
| 466 |
\bibitem{NAOI2} |
| 467 |
\href{http://d.hatena.ne.jp/NAOI/20110707/1310031226}{ヒラギノの雪だるまは、なぜ寂しそうなのか} |
| 468 |
\ --- Mac OS Xの文字コード問題に関するメモ |
| 469 |
\bibitem{DORA1} |
| 470 |
\href{http://doratex.hatenablog.jp/entry/20140327/1395878814}{いろいろなゆきだるま} |
| 471 |
\ --- TeX Alchemist Online |
| 472 |
\bibitem{ACE1} |
| 473 |
\href{http://acetaminophen.hatenablog.com/entry/2014/09/05/090313}{「\TeX{}でゆきだるま」をもっとたくさん} |
| 474 |
\ --- Acetaminophen's diary |
| 475 |
\bibitem{ZR1} |
| 476 |
\href{http://d.hatena.ne.jp/zrbabbler/20140911/1410439004}{Unicodeの例の雪だるまは多分アレ} |
| 477 |
\ --- マクロツイーター |
| 478 |
\bibitem{ACE2} |
| 479 |
\href{http://acetaminophen.hatenablog.com/entry/2015/12/13/080226}{\TeX{}でゆきだるまを“もっともっと”たくさん} |
| 480 |
\ --- Acetaminophen's diary |
| 481 |
\bibitem{ACE3} |
| 482 |
\href{http://acetaminophen.hatenablog.com/entry/2016/08/08/080800}{夏といえば、やっぱり「ゆきだるま」!} |
| 483 |
\ --- Acetaminophen's diary |
| 484 |
\bibitem{SX229957} |
| 485 |
\href{http://tex.stackexchange.com/questions/229957/}{How do I redefine the QED symbol to be a Unicode character?} |
| 486 |
\ --- \TeX\ -- \LaTeX\ Stack Exchange |
| 487 |
\end{thebibliography} |
| 488 |
|
| 489 |
\end{document} |