From 41d30b64b0ba0859b19a0ab4563368c17bdf906f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 22 Dec 2016 22:56:28 +0000 Subject: scsnowman (22dec16) git-svn-id: svn://tug.org/texlive/trunk@42774 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/scsnowman/LICENSE | 25 +++ Master/texmf-dist/doc/latex/scsnowman/README.md | 31 +++ .../doc/latex/scsnowman/scsnowman-sample.pdf | Bin 0 -> 52624 bytes .../doc/latex/scsnowman/scsnowman-sample.tex | 131 +++++++++++ .../texmf-dist/doc/latex/scsnowman/scsnowman.pdf | Bin 0 -> 340931 bytes .../texmf-dist/doc/latex/scsnowman/scsnowman.tex | 246 +++++++++++++++++++++ 6 files changed, 433 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/scsnowman/LICENSE create mode 100644 Master/texmf-dist/doc/latex/scsnowman/README.md create mode 100644 Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.pdf create mode 100644 Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.tex create mode 100644 Master/texmf-dist/doc/latex/scsnowman/scsnowman.pdf create mode 100644 Master/texmf-dist/doc/latex/scsnowman/scsnowman.tex (limited to 'Master/texmf-dist/doc/latex/scsnowman') diff --git a/Master/texmf-dist/doc/latex/scsnowman/LICENSE b/Master/texmf-dist/doc/latex/scsnowman/LICENSE new file mode 100644 index 00000000000..613c036e2f8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/scsnowman/LICENSE @@ -0,0 +1,25 @@ +(The BSD 2-Clause License) + +Copyright (c) 2015-2016 Hironobu Yamashita +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/Master/texmf-dist/doc/latex/scsnowman/README.md b/Master/texmf-dist/doc/latex/scsnowman/README.md new file mode 100644 index 00000000000..86bb99b11c5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/scsnowman/README.md @@ -0,0 +1,31 @@ +# scsnowman + +This LaTeX package provides a command `\scsnowman`, which can display many +variants of snowman ("yukidaruma" in Japanese). +This package utilizes TikZ for drawing snowman. + +The package is maintained on GitHub: +https://github.com/aminophen/scsnowman + +## Requirements + +This package requires "tikz" package. + +## Installation + +Deploy the files in an appropriate place under the TEXMF tree. + + * scsnowman.sty, sctkzsym-base.sty, scsnowman-normal.def + => $TEXMF/tex/latex/scsnowman + * scsnowman.{tex,pdf}, scsnowman-sample.{tex,pdf} + => $TEXMF/doc/latex/scsnowman + +Then, execute mktexlsr. + +## License + +This package is distributed under the BSD 2-Clause License. +See [LICENSE](./LICENSE). + +Copyright (c) 2015-2016 Hironobu Yamashita +http://acetaminophen.hatenablog.com/ diff --git a/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.pdf b/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.pdf new file mode 100644 index 00000000000..e9fa7cca004 Binary files /dev/null and b/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.pdf differ diff --git a/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.tex b/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.tex new file mode 100644 index 00000000000..50a9d07c7c8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/scsnowman/scsnowman-sample.tex @@ -0,0 +1,131 @@ +%% +%% This is file `scsnowman-sample.tex', part of scsnowman package. +%% Maintained on GitHub: +%% https://github.com/aminophen/scsnowman +%% +%% Copyright (c) 2015-2016 Hironobu Yamashita +%% Email : h.y.acetaminophen[a t]gmail.com +%% GitHub : https://github.com/aminophen +%% Blog : http://acetaminophen.hatenablog.com/ +%% Twitter : @aminophen +%% +% platex + dvipdfmx +\documentclass[dvipdfmx,twocolumn]{jsarticle} +\usepackage[margin=21truemm]{geometry} +\usepackage[svgnames]{xcolor} +\usepackage{scsnowman} +\title{\textsf{scsnowman}パッケージの実用例} +\author{アセトアミノフェン} +\begin{document} +\maketitle + +% ふつうのゆきだるま +これはゆきだるま\scsnowman です。 + +% 雪ありゆきだるま +今日の天気は\scsnowman[snow]です。 + +% 帽子をかぶったゆきだるま +ゆきだるま\scsnowman[hat]が帽子をかぶりました。 + +% 帽子をかぶったゆきだるま(帽子の色は青) +私は青い帽子をかぶった\scsnowman[hat=blue]が大好きです。 + +% 帽子とマフラー付(マフラーの色は赤) +マフラー\scsnowman[hat=true,muffler=red]を付けてあげましょう。 + +% 腕あり +腕も作って\scsnowman[hat=true,muffler=red,arms=true]あげましょう。 + +% サイズ変更 +小\scsnowman、 +中\scsnowman[scale=3]、 +大\scsnowman[scale=5]。 + +% ゆきだるま三兄弟 +\begin{table}[htb] + \begin{tabular}{ccc} + \texttt{U+2603} & \texttt{U+26C4} & \texttt{U+26C7} \\ + \texttt{SNOWMAN} & \texttt{SNOWMAN WITHOUT SNOW} & \texttt{BLACK SNOWMAN} \\ + \scsnowman[scale=5,body=false,snow=true] & \scsnowman[scale=5,body=false,snow=false] & \scsnowman[scale=5,body=true,snow=true] + \end{tabular} +\end{table} + +\begin{table}[htb] + \begin{tabular}{ccc} + \texttt{U+2603} & \texttt{U+26C4} & \texttt{U+26C7} \\ + \texttt{SNOWMAN} & \texttt{SNOWMAN WITHOUT SNOW} & \texttt{BLACK SNOWMAN} \\ + \scsnowman[scale=5,body=false,snow=true,muffler=true] & \scsnowman[scale=5,body=false,snow=false,muffler=true] & \scsnowman[scale=5,body=true,snow=true,muffler=true] + \end{tabular} +\end{table} + +\begin{table}[htb] + \begin{tabular}{ccc} + \texttt{U+2603} & \texttt{U+26C4} & \texttt{U+26C7} \\ + \texttt{SNOWMAN} & \texttt{SNOWMAN WITHOUT SNOW} & \texttt{BLACK SNOWMAN} \\ + \scsnowman[scale=5,body=false,snow=true,hat=true,arms=true] & \scsnowman[scale=5,body=false,snow=false,hat=true,arms=true] & \scsnowman[scale=5,body=true,snow=true,hat=true,arms=true] + \end{tabular} +\end{table} + +\begin{table}[htb] + \begin{tabular}{ccc} + \texttt{U+????} & \texttt{U+????} & \texttt{U+????} \\ + \texttt{RED SNOWMAN} & \texttt{BLUE SNOWMAN} & \texttt{GREEN SNOWMAN} \\ + \scsnowman[scale=5,body=red,snow=red,hat=red] & \scsnowman[scale=5,body=blue,hat=blue,arms=blue,muffler=blue] & \scsnowman[scale=5,body=green,snow=green,arms=green] + \end{tabular} +\end{table} + +\newpage + +\scsnowmandefault{body,hat,snow,muffler}% +私、黒\scsnowman 大輔は、1950年に黒\scsnowman 太郎の長男として +誕生しました。その後、黒\scsnowman 家には… + +\scsnowmandefault{hat,snow,arms}% +お隣には白\scsnowman さんが住んでいました。白\scsnowman さんは、 +宛名の文字を「\scsnowman」でなく「\scsnowman[arms=false,muffler]」 +と書いてしまうとお手紙を読まずに食べてしまうような変わった方でした。 +ただし、\scsnowman[hat=red]のように帽子に色が付いた宛名を見ると、 +白\scsnowman さんは喜んでいました。 + +% buttons で「ボタン」(マフラーの有無で微妙に位置が変わる) +\scsnowmandefault{scale=5,hat=Green,arms=Brown,snow=SkyBlue} +\scsnowman[buttons=RoyalBlue,muffler=Red] +\scsnowman[buttons=RoyalBlue] + +% mouthshape で「口の形」 +\scsnowmandefault{scale=5,hat,muffler=Red} +\scsnowman[mouthshape=smile]% にっこり +\scsnowman[mouthshape=frown]% しかめっ面 +\scsnowman[mouthshape=tight]% 真一文字 + +% sweat で「汗」 +\scsnowmandefault{scale=5,hat} +\scsnowman[mouthshape=tight,arms,buttons,sweat] + +ゆきだるまで箇条書き: +\makeitemsnowman +\begin{itemize} + \item 動物 + \begin{itemize} + \item 哺乳類 + \item 鳥類 + \item … + \end{itemize} + \item 植物 + \begin{itemize} + \item 裸子植物 + \item 被子植物 + \begin{itemize} + \item 単子葉類 + \item 双子葉類 + \begin{itemize} + \item 合弁花類 + \item 離弁花類 + \end{itemize} + \end{itemize} + \end{itemize} +\end{itemize} +\makeitemother + +\end{document} diff --git a/Master/texmf-dist/doc/latex/scsnowman/scsnowman.pdf b/Master/texmf-dist/doc/latex/scsnowman/scsnowman.pdf new file mode 100644 index 00000000000..cc1a7bef9c7 Binary files /dev/null and b/Master/texmf-dist/doc/latex/scsnowman/scsnowman.pdf differ diff --git a/Master/texmf-dist/doc/latex/scsnowman/scsnowman.tex b/Master/texmf-dist/doc/latex/scsnowman/scsnowman.tex new file mode 100644 index 00000000000..78aa99bca33 --- /dev/null +++ b/Master/texmf-dist/doc/latex/scsnowman/scsnowman.tex @@ -0,0 +1,246 @@ +%% +%% This is the documentation of scsnowman package. +%% (Last Update: 2016/12/22) +%% Maintained on GitHub: +%% https://github.com/aminophen/scsnowman +%% +%% Copyright (c) 2015-2016 Hironobu Yamashita +%% Email : h.y.acetaminophen[a t]gmail.com +%% GitHub : https://github.com/aminophen +%% Blog : http://acetaminophen.hatenablog.com/ +%% Twitter : @aminophen +%% +\documentclass[a4paper]{article} +\usepackage{doc} +\usepackage[svgnames]{xcolor} +\usepackage{scsnowman} +\GetFileInfo{scsnowman.sty} +\usepackage{array} +\usepackage{luatexja} +\usepackage{luatexja-fontspec} +\def\BigSnowman#1{\fontsize{60pt}{60pt}\selectfont\symbol{"#1}} +\newjfontfamily\fipam{IPAexMincho} +\newjfontfamily\fhrgnm{HiraMinProN-W3} +\newjfontfamily\fkozm{KozMinPr6N-Regular} +\newjfontfamily\fmsmin{MS-Mincho} +\newjfontfamily\fvlgo{VLGothic} +\usepackage{hyperref} +% misc +\def\Lpack#1{\textsf{#1}} +\def\Lopt#1{\texttt{#1}} +% scsnowman in title +\def\scsnowmanleft{% + \raisebox{-1ex}{\scsnowman[scale=2,hat=Green,arms=Brown,snow=SkyBlue,buttons=RoyalBlue,muffler=Red]}} +\def\scsnowmanright{% + \raisebox{-1ex}{\scsnowman[scale=2,hat=Green,arms=Brown,snow=SkyBlue,buttons=RoyalBlue]}} +\title{\scsnowmanleft\ The \Lpack{scsnowman} package \fileversion\ \scsnowmanright} +\author{Hironobu Yamashita} +\date{\filedate} +\begin{document} + +\maketitle + +The \LaTeX\ package \Lpack{scsnowman} provides a command \verb+\scsnowman+, which can display +many variants of snowman. This package utilizes Ti\emph{k}Z for drawing snowman. +\begin{figure}[htb]\centering +\scsnowman[scale=3,hat,snow,arms]\scsnowman[scale=3,hat=RoyalBlue,muffler=Green] +\scsnowman\scsnowman[scale=3]\scsnowman[scale=5]\par +\scsnowmandefault{scale=5,hat,muffler=Red} +\scsnowman[mouthshape=smile] +\scsnowman[mouthshape=frown] +\scsnowman[mouthshape=tight] +\scsnowman[mouthshape=tight,arms,buttons,sweat]\\[2ex] +\scsnowmandefault{scale=5} +\begin{tabular}{ccc} + \texttt{U+2603} & \texttt{U+26C4} & \texttt{U+26C7} \\ + \texttt{SNOWMAN} & \texttt{SNOWMAN WITHOUT SNOW} & \texttt{BLACK SNOWMAN} \\ + \scsnowman[body=false,snow=true] & \scsnowman[body=false,snow=false] & \scsnowman[body=true,snow=true] +\end{tabular} +\end{figure} + +The package is maintained on GitHub: +\begin{itemize} +\item \url{https://github.com/aminophen/scsnowman} +\end{itemize} + +\tableofcontents\clearpage + +\section{The History of Snowman in Unicode} + +In October 1991, the first volume of the Unicode standard was published. Since then, +there was a code point assigned to a character ``snowman''; \verb:U+2603:. +\begin{quote} + \verb:U+2603 SNOWMAN:\\ + = snowy weather +\end{quote} +It seems that the shape of its reference glyph in Unicode 1.0.0 was taken from ``Ryumin'', +which was developed by Morisawa (a famous font vendor in Japan). +\begin{figure} +%\includegraphics[width=0.3\textwidth]{} +\end{figure} +A few years later, the reference glyph has sometimes been changed to another; however, +there had been only one ``snowman'' in Unicode until 2009. +\begin{figure} +%\includegraphics[width=0.3\textwidth]{} +\end{figure} + +In October 2009, Unicode 5.2 was published. In this volume, two ``snowman'' code points +were added; \verb:U+26C4: and \verb:U+26C7:. +\begin{quote} + \verb:U+26C4 SNOWMAN WITHOUT SNOW:\\ + = light snow\\ + \verb:U+26C7 BLACK SNOWMAN:\\ + = heavy snow +\end{quote} +According to the code chart, the origin of these two characters is ARIB STD-B24 +(Data Coding and Transmission Specification for Digital Broadcasting;\footnote{% +\url{http://www.arib.or.jp/tyosakenkyu/kikaku_hoso/hoso_std-b024.html}; Abstract in PDF format +(both \href{http://www.arib.or.jp/tyosakenkyu/kikaku_sample/sample-std-b24-1-6.3.pdf}{Japanese} +and \href{http://www.arib.or.jp/english/html/overview/doc/6-STD-B24v5_2-1p3-E1.pdf}{English}) are +available.}), which was established by Association of Radio Industries and Business in +Japan. Since then, it can be said that the old code point \verb:U+2603: has been given +an implicit meaning of ``\verb:SNOWMAN WITH SNOW:''. The reference glyphs were also changed +at that time. +\begin{figure} +%\includegraphics[width=0.3\textwidth]{} +\end{figure} + +\section{Variation of Snowman among Actual Fonts} + +Since the shapes of the reference glyphs used in the Unicode code charts are not +prescriptive, the actual fonts have a wide variety of glyph designs. However, when it +comes to snowman, the variation between fonts is enormous. This variation is very +interesting, however, on the other hand, problematic. + +Table \ref{table:actualfonts} shows the variety of ``snowman'' in actual fonts. +\begin{table}[tbp] +\caption{The variety of ``snowman'' in actual fonts}\label{table:actualfonts} +\setlength{\extrarowheight}{50pt}% +\centering +\begin{tabular}{cccc} +\hline + & \raisebox{2ex}{\Large\texttt{U+2603}} & \raisebox{2ex}{\Large\texttt{U+26C4}} & \raisebox{2ex}{\Large\texttt{U+26C7}} \\ \hline +\raisebox{4ex}{\fipam IPAex明朝} & {\fipam \BigSnowman{2603}} & & \\ +\raisebox{4ex}{\fmsmin MS 明朝} & {\fmsmin \BigSnowman{2603}} & & \\ +\raisebox{4ex}{\fkozm 小塚明朝 Pr6N Regular} & {\fkozm \BigSnowman{2603}} & & \\ +\raisebox{4ex}{\fhrgnm ヒラギノ明朝 ProN W3} & {\fhrgnm \BigSnowman{2603}} & & \\ +\raisebox{4ex}{\fvlgo VLゴシック} & {\fvlgo \BigSnowman{2603}} & {\fvlgo \BigSnowman{26C4}} & {\fvlgo \BigSnowman{26C7}} \\ +\hline +\end{tabular} +\end{table} +The snowman in ``IPA Mincho (IPA明朝)'' from Information-technology Promotion Agency is very similar +to the one in ``Ryumin (リュウミン)'' from Morisawa. However, in ``MS Mincho (MS 明朝)'' from Microsoft, +the snowman wears a black hat instead of white one. In ``Kozuka Mincho (小塚明朝)'' from Adobe Systems Inc., +he/she wears a muffler instead of a hat. Moreover, it doesn't snow in ``Hiragino Mincho (ヒラギノ明朝)'' from +SCREEN Graphic and Precision Solutions Co., Ltd. It is natural that some fonts developed before 2009 have +a ``snowman without snow'' glyph in the code point \verb:U+2603:, however, it can be a problem when we +have to transfer the exact information to others. + +\section{Introduction to \Lpack{scsnowman} Package} + +The \LaTeX\ package \Lpack{scsnowman} provides a command \verb+\scsnowman+, which can +display many variants of snowman. This package depends on Ti\emph{k}Z package for drawing +snowman images. + +To use this package, load it in preamble: +\begin{quote}\begin{verbatim} +\usepackage{scsnowman} +\end{verbatim}\end{quote} +In the main document, use \verb+\scsnowman+ command to print snowman: \scsnowman. +By default, the snowman is ``plain'' style, without any decoration such as snow, a hat or +a muffler. + +\section{Command Options} + +You can customize the style of snowman using the optional argument. The syntax is +\begin{quote} +\verb+\scsnowman[+\emph{$\langle$key-value list$\rangle$}\verb+]+ +\end{quote} +Following \emph{key}s take a \emph{value} which specifies color. When the \emph{value} is omitted, +the default color, black or white, will be used: +\begin{quote} + \Lopt{body}, \Lopt{eyes}, \Lopt{mouth}, \Lopt{sweat}, + \Lopt{hat}, \Lopt{arms}, \Lopt{muffler}, \Lopt{buttons}, \Lopt{snow} +\end{quote} +Other \emph{key}s require one specific \emph{value}: +\begin{quote} + \Lopt{mouthshape}, \Lopt{scale} +\end{quote} +The key \Lopt{mouthshape} takes one of the followings: \Lopt{smile}, \Lopt{tight} or \Lopt{frown}. +The key \Lopt{scale} takes a scale factor. + +Here is some examples:\\[1ex] +\begin{minipage}{.7\textwidth}\begin{verbatim} + \scsnowman[scale=2,body,hat=red,muffler=blue] + \scsnowman[scale=3,hat,snow,arms,buttons] + \scsnowman[scale=3,mouthshape=tight,muffler=red] + \scsnowman[scale=3,mouthshape=frown,hat=green] +\end{verbatim}\end{minipage} +\begin{minipage}{.25\textwidth} + \scsnowman[scale=2,body,hat=red,muffler=blue] + \scsnowman[scale=3,hat,snow,arms,buttons] + \scsnowman[scale=2,mouthshape=tight,muffler=red] + \scsnowman[scale=2,mouthshape=frown,hat=green] +\end{minipage} + +\section{Changing the Default} + +The package default is the ``plain'' style snowman. This default can be changed by using +\verb+\scsnowmandefault+ command. The syntax is +\begin{quote} +\verb+\scsnowmandefault{+\emph{$\langle$key-value list$\rangle$}\verb+}+ +\end{quote} +The available \emph{key}s are the same as those in \verb+\scsnowman+. + +Here is some examples:\\[1ex] +\begin{minipage}{.65\textwidth}\begin{verbatim} + \scsnowmandefault{scale=3,hat=red} + \scsnowman + \scsnowman[body,hat=red,muffler=blue] + \scsnowman[hat=green,snow] +\end{verbatim}\end{minipage} +\begin{minipage}{.3\textwidth} + \scsnowmandefault{scale=5,hat=red} + \scsnowman + \scsnowman[body,hat=red,muffler=blue] + \scsnowman[hat=green,snow] +\end{minipage} + +\section*{Version History} + +This is the summary of changes. For more detail, see GitHub repository. +\begin{table}[h] +\centering +\begin{tabular}{lll} +Version 0.1 & 2015-12-13 & First public version on GitHub \\ +Version 0.8 & 2016-08-08 & Second public version on GitHub: \\ + & & new variants \Lopt{buttons}, \Lopt{mouthshape}, \Lopt{sweat} are added \\ +Version 1.0 & 2016-12-22 & First CTAN release +\end{tabular} +\end{table} + +\begin{thebibliography}{9} +\bibitem{NAOI1} +\href{http://d.hatena.ne.jp/NAOI/20080623/1214211959}{雪だるまの親子関係} + -- Mac OS Xの文字コード問題に関するメモ +\bibitem{NAOI2} +\href{http://d.hatena.ne.jp/NAOI/20110707/1310031226}{ヒラギノの雪だるまは、なぜ寂しそうなのか} + -- Mac OS Xの文字コード問題に関するメモ +\bibitem{DORA1} +\href{http://doratex.hatenablog.jp/entry/20140327/1395878814}{いろいろなゆきだるま} + -- TeX Alchemist Online +\bibitem{ACE1} +\href{http://acetaminophen.hatenablog.com/entry/2014/09/05/090313}{「\TeX{}でゆきだるま」をもっとたくさん} + -- Acetaminophen's diary +\bibitem{ZR1} +\href{http://d.hatena.ne.jp/zrbabbler/20140911/1410439004}{Unicode の例の雪だるまは多分アレ} + -- マクロツイーター +\bibitem{ACE2} +\href{http://acetaminophen.hatenablog.com/entry/2015/12/13/080226}{\TeX{}でゆきだるまを“もっともっと”たくさん} + -- Acetaminophen's diary +\bibitem{ACE3} +\href{http://acetaminophen.hatenablog.com/entry/2016/08/08/080800}{夏といえば、やっぱり「ゆきだるま」!} + -- Acetaminophen's diary +\end{thebibliography} + +\end{document} -- cgit v1.2.3