summaryrefslogtreecommitdiff
path: root/graphics/pgf/contrib/tikzlings/tikzlings-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/pgf/contrib/tikzlings/tikzlings-doc.tex')
-rw-r--r--graphics/pgf/contrib/tikzlings/tikzlings-doc.tex635
1 files changed, 468 insertions, 167 deletions
diff --git a/graphics/pgf/contrib/tikzlings/tikzlings-doc.tex b/graphics/pgf/contrib/tikzlings/tikzlings-doc.tex
index 11b06c3f7d..f2c9191a6e 100644
--- a/graphics/pgf/contrib/tikzlings/tikzlings-doc.tex
+++ b/graphics/pgf/contrib/tikzlings/tikzlings-doc.tex
@@ -1,7 +1,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Documentation for the tikzlings package
-% A collection of packages to draw animals in tikz
+% A package to bring cute little animals and other beings into tikz
% Maintained by samcarter
%
% Project repository and bug tracker:
@@ -10,30 +10,29 @@
% Released under the LaTeX Project Public License v1.3c or later
% See http://www.latex-project.org/lppl.txt
%
-% Version 0.2
-% April 7, 2019
-%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[parskip=half]{scrartcl}
% packages %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\usepackage[T1]{fontenc}
-\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
\usepackage[english]{babel}
\usepackage[svgnames]{xcolor}
\usepackage[bitstream-charter]{mathdesign}
\usepackage{tikzlings}
\usepackage[most]{tcolorbox}
+\usepackage{bearwear}
\usepackage[paper=a4paper,margin=3cm]{geometry}
\usepackage{url}
\usepackage{xspace}
\usepackage{scrlayer-scrpage}
\usepackage[hang,flushmargin,bottom]{footmisc}
\usepackage[%
- colorlinks=true,
- breaklinks=true,
- allcolors=SteelBlue!50!black
+ colorlinks=true,
+ breaklinks=true,
+ allcolors=SteelBlue!50!black
]{hyperref}
+\usetikzlibrary{3d}
% macros %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newcommand{\CTAN}{\textsc{CTAN}\xspace}
@@ -66,7 +65,7 @@
\makeatletter
\renewcommand{\sectionlinesformat}[4]{%
-\ifstr{#1}{section}{%
+\Ifstr{#1}{section}{%
\parbox[t]{\linewidth}{%
\raggedsection\@hangfrom{\hskip #2#3}{#4}\par%
\kern-.75\ht\strutbox\rule{\linewidth}{.8pt}%
@@ -84,46 +83,46 @@
\colorlet{blue}{SteelBlue}
\lstdefinestyle{duckstyle}{%
- language={[latex]TeX},
- tabsize=2,
- breaklines,
- basicstyle=\ttfamily,
- commentstyle={\color{green!50!black}\slshape},
- columns=fullflexible,
- alsodigit={-},
- alsoletter={3},
- emphstyle=\color{red!60!black},
- emph=[1]{
- tikzlings,
- tikzlings-marmots, tikzlings-bears, tikzlings-coatis, tikzlings-koalas, tikzlings-marmots, tikzlings-owls, tikzlings-penguins, tikzlings-snowmans, tikzlings-mice, tikzlings-moles, tikzlings-sloths, tikzlings-pigs, tikzlings-cats, tikzlings-hippos, tikzlings-rhinos, tikzlings-pandas,
- body, 3D, rotatehead, sideward, blush, sleeping, whiskers, teeth, shadow, askphil, leftstep, rightstep, eye, nose, pupil, bill, feet, belly, ask, phil, mouth, buttons, rotatearms, eyes, paws,
- scale, yshift, xshift, rotate, hands, muzzle, schroedinger, toes,
- hat, tophat, beret, strawhat, ribbon, harlequin, niuqelrah, witch, magichat, magicstars, crown, queencrown, kingcrown, santa, chef, graduate, tassel, alien, book, bookcolour, signpost, signcolour, signback, speech, think, bubblecolour, pizza, cheese, baguette, cake, icecream, flavoura, flavourb, flavourc, milkshake, wine, cricket, hockey, football, crystalball, magicwand, rollingpin, lightsaber, torch, basket, easter, egga, eggb, eggc, crozier, shovel, pickaxe, umbrella, umbrellaclosed, handbag, cocktail, pupilwidth,
- },
- texcsstyle=*\color{SteelBlue!50!black}\bfseries,
- keywordstyle=\color{red!60!black}\bfseries,
- morekeywords={tikzpicture},
- moretexcs={
- usepackage, usetikzlibrary, marmot, coati, bear, koala, owl, penguin, thing, tikzling, snowman, mouse, moles, sloth, pig, cat, hippo, rhino, panda,
- },
- delim ={[s][\ttfamily\color{green!50!black}]{$}{$}},
- moredelim=[is][\footnotesize\ttfamily\color{orange!70!black}]{|}{|},
- index=[1][emph]
+ language={[latex]TeX},
+ tabsize=2,
+ breaklines,
+ basicstyle=\ttfamily,
+ commentstyle={\color{green!50!black}\slshape},
+ columns=fullflexible,
+ alsodigit={-},
+ alsoletter={3},
+ emphstyle=\color{red!60!black},
+ emph=[1]{
+ tikzlings,
+ tikzlings-marmots, tikzlings-bears, tikzlings-coatis, tikzlings-koalas, tikzlings-marmots, tikzlings-owls, tikzlings-penguins, tikzlings-snowmans, tikzlings-mice, tikzlings-moles, tikzlings-sloths, tikzlings-pigs, tikzlings-cats, tikzlings-hippos, tikzlings-rhinos, tikzlings-pandas, tikzlings-bees, tikzlings-anteaters, tikzlings-squirrels,
+ body, 3D, rotatehead, sideward, blush, sleeping, whiskers, teeth, shadow, askphil, leftstep, rightstep, eye, nose, pupil, bill, feet, belly, ask, phil, mouth, buttons, rotatearms, eyes, paws, back, pupilwidth, globalwarming, wings, antennas, stripes,
+ scale, yshift, xshift, rotate, hands, muzzle, schroedinger, toes,
+ hat, tophat, beret, strawhat, ribbon, harlequin, niuqelrah, witch, magichat, magicstars, crown, queencrown, kingcrown, santa, chef, graduate, tassel, alien, book, bookcolour, signpost, signcolour, signback, speech, think, bubblecolour, pizza, cheese, baguette, cake, icecream, flavoura, flavourb, flavourc, milkshake, wine, cricket, hockey, football, crystalball, magicwand, rollingpin, lightsaber, torch, basket, easter, egga, eggb, eggc, crozier, shovel, pickaxe, umbrella, umbrellaclosed, handbag, cocktail,
+ },
+ texcsstyle=*\color{SteelBlue!50!black}\bfseries,
+ keywordstyle=\color{red!60!black}\bfseries,
+ morekeywords={tikzpicture},
+ moretexcs={
+ usepackage, usetikzlibrary, marmot, coati, bear, koala, owl, penguin, thing, tikzling, snowman, mouse, moles, sloth, pig, cat, hippo, rhino, panda, bee, anteater, squirrel, bearwear, tikzlinghookbackground, tikzlinghookbelly, tikzlinghookbody, tikzlinghookforeground, mousehookbelly
+ },
+ delim ={[s][\ttfamily\color{green!50!black}]{$}{$}},
+ moredelim=[is][\footnotesize\ttfamily\color{orange!70!black}]{|}{|},
+ index=[1][emph]
}
\tcbset{%
- colframe=SteelBlue!50!black,
- arc=0mm,
- fonttitle=\bfseries,
- sidebyside,
- listing options={style=duckstyle},
- center lower,
- righthand width=6.5cm,
- bottom=0pt,
- top=0pt,
- tikz lower,
- height plus=3cm,
- colback=SteelBlue!30!white
+ colframe=SteelBlue!50!black,
+ arc=0mm,
+ fonttitle=\bfseries,
+ sidebyside,
+ listing options={style=duckstyle},
+ center lower,
+ righthand width=6.5cm,
+ bottom=0pt,
+ top=0pt,
+ tikz lower,
+ height plus=3cm,
+ colback=SteelBlue!30!white
}
\lstset{style=duckstyle}
@@ -134,61 +133,25 @@
\cfoot{\thepage}
\pagestyle{scrheadings}
-\makeatletter
-\renewcommand*{\coati}[1][]{%
- \begin{scope}%
- \path (-1.63,0.1) rectangle (1.63,2.26);
- \tikzset{/coati/.cd,#1}%
- \coati@draw%
- \end{scope}%
- \thing[#1]%
-}
-
-\renewcommand*{\mouse}[1][]{%
- \begin{scope}%
- \path (-1.6,0.1) rectangle (0.905, 2.17);
- \tikzset{/mouse/.cd,#1}%
- \mouse@draw%
- \end{scope}%
- \thing[#1]%
-}
-
-\renewcommand*{\cat}[1][]{%
- \begin{scope}%
- \tikzset{/cat/.cd,#1}%
- \ifcat@schroedinger
- \pgfmathparse{int(random(0,1))}
- \let\cat@random=\pgfmathresult
- \ifnum\cat@random=1
- \cat@tombstone%
- \else%
- \path (-1.6,0.1) rectangle (0.905, 2.17);
- \cat@draw%
- \fi%
- \else%
- \path (-1.6,0.1) rectangle (0.905, 2.17);
- \cat@draw%
- \fi
- \end{scope}%
- \thing[#1]%
-}
-\makeatother
+\newcommand{\coatihookbackground}{\path (-1.63,0.1) rectangle (1.63,2.26);}
+\newcommand{\mousehookbackground}{\path (-1.6,0.1) rectangle (0.905, 2.17);}
+\newcommand{\cathookbackground}{\path (-1.6,0.1) rectangle (0.905, 2.17);}
\cfoot{%
- \begin{tikzpicture}[scale=0.5]
- \tikzling[signpost={\thepage}]
- \end{tikzpicture}
+ \begin{tikzpicture}[scale=0.5]
+ \tikzling[signpost={\thepage}]
+ \end{tikzpicture}
}
% meta %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\title{The \texorpdfstring{\tikzlings}{tikzlings} package}
\subtitle{drawing animals and beings in \TikZ}
\author{%
- \texorpdfstring{\texttt{samcarter}\\[0.8em]
- \url{https://github.com/samcarter/tikzlings}\\
- \url{https://www.ctan.org/pkg/tikzlings}
- }{samcarter}}
-\date{Version 0.2 -- \today}
+ \texorpdfstring{\texttt{samcarter}\\[0.8em]
+ \url{https://github.com/samcarter/tikzlings}\\
+ \url{https://www.ctan.org/pkg/tikzlings}
+ }{samcarter}}
+\date{Version v0.3 \textendash{} 2020/04/22}
\begin{document}
\maketitle
@@ -201,11 +164,12 @@ The \tikzlings are a collection of little animals (and beings) drawn in \TikZ. I
This package is work in progress, therefore I would be happy to hear your feedback and ideas how to improve the package.
The head version of the source code can be found on \url{github.com/samcarter/tikzlings}, including a bug tracker -- please make constructive use of it!
+If you seek any other assistance (not bug reports/feature requests), I suggest asking a question at \url{topanswers.xyz/tex}.
A more stable package version can be found on \CTAN (\url{https://www.ctan.org/pkg/tikzlings}) and is included in both \miktex and \texlive as \tikzlings.
\subsection*{Acknowledgements}
-I'd like to thank the friendly and helpful community of \href{https://tex.stackexchange.com/}{TeX.Stackexchange} for their suggestions, feedback and help to create this package and find a suitable name for it. As a thank you all the \tikzlings have a name which is in some way or another connected to the users of TeX.SE.
+I'd like to thank the friendly and helpful community of \TeX{} users for their suggestions, feedback and help to create this package and find a suitable name for it. As a thank you all the \tikzlings have a name which is in some way or another connected to the users of \TeX{}.
\subsection*{License}
@@ -231,15 +195,133 @@ will produce a marmot. All usual \TikZ and \lstinline|pgf| keys can be passed as
In addition to the standard options provided by \TikZ each \tikzlings also comes with some additional options which are listed in the following sections. If these additional options consist of multiple words they are available both with and without spaces, for example \lstinline|askphil| and \lstinline|ask phil| will be treated as the same.
+To make customisation of the \tikzlings easier, some hooks are provided, which can be redefined by the user in order to add commands at specific layers:
+\begin{itemize}
+ \color{SteelBlue!50!black}
+ \item \lstinline|\<name_of_the_tikzling>hookbackground|
+ \item \lstinline|\<name_of_the_tikzling>hookbelly|
+ \item \lstinline|\<name_of_the_tikzling>hookbody|
+ \item \lstinline|\<name_of_the_tikzling>hookforeground|
+\end{itemize}
+
+With regard to the individual components of the \tikzlings, they are located in the following z order:
+\begin{center}
+\begin{tikzpicture}
+ \newcommand{\planes}{\fill[SteelBlue!30!white,opacity=0.9] (-1.9,-0.1) rectangle (1.9,2.4);}
+ \newcommand{\hooks}{\draw[SteelBlue!50!black, rounded corners=3pt, line width=1pt] (-1.9,-0.1) rectangle (1.9,2.4);}
+ \newcounter{layer}
+ \setcounter{layer}{0}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \hooks
+ \node[font=\footnotesize\ttfamily,rotate=45] at (0,0.1) {background};
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \planes
+ \newcommand{\rhinohookbelly}{
+ \pgfsetfillopacity{0}
+ \pgfsetstrokeopacity{0}
+ }
+ \rhino
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \hooks
+ \node[font=\footnotesize\ttfamily,rotate=45] at (0,0.1) {belly};
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \planes
+ \newcommand{\rhinohookbackground}{
+ \pgfsetfillopacity{0}
+ \pgfsetstrokeopacity{0}
+ }
+ \newcommand{\rhinohookbelly}{
+ \pgfsetfillopacity{1}
+ \pgfsetstrokeopacity{1}
+ }
+ \rhino
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \hooks
+ \node[font=\footnotesize\ttfamily,rotate=45] at (0,0.1) {body};
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \planes
+ \thing[magichat,magicwand]
+ \end{scope}
+ \addtocounter{layer}{1}
+ \begin{scope}[canvas is zy plane at x=\thelayer*1.8]
+ \hooks
+ \node[font=\footnotesize\ttfamily,rotate=45] at (0,0.1) {foreground};
+ \end{scope}
+ \end{tikzpicture}
+\end{center}
+
+In addition the hooks \lstinline|\tikzlinghookbackground|, \lstinline|\tikzlinghookbelly|, \lstinline|\tikzlinghookbody| and \lstinline|\tikzlinghookforeground| are available and will effect all \tikzlings.
+
+A short example how the hooks can be used:
+
+\begin{tcblisting}{}
+\newcommand{\mousehookbelly}{%
+ \fill[red!80!black]
+(0.55, 1.35) -- (0.65, 0.3) --
+(-0.65, 0.3) -- (-0.55, 1.35)
+-- (0.0, 0.9) -- cycle;
+}
+\mouse
+\end{tcblisting}
+
\subsection*{List of all \tikzlings:}
\begingroup
- \hypersetup{hidelinks}
- \tableofcontents
+ \hypersetup{hidelinks}
+ \tableofcontents
\endgroup
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+% Anteater
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section[Anteater]{Peter, the anteater}
+
+\subsection{Package name}
+
+\begin{tcolorbox}[lower separated=false, lefthand width=.8\linewidth]
+\vspace*{0.5cm}
+\lstinline|\usepackage{tikzlings-anteaters}|
+\vspace*{0.5cm}
+\end{tcolorbox}
+
+\subsection{Basic Usage}
+
+\begin{tcblisting}{}
+\anteater
+\end{tcblisting}
+
+\subsection{Options}
+
+The basic anteater can be modified by changing its colour:
+\begin{tcblisting}{}
+\anteater[body=blue]
+\end{tcblisting}
+
+To view the anteater from behind:
+\begin{tcblisting}{}
+\anteater[back]
+\end{tcblisting}
+
+The key \lstinline|3D| will make the anteater 3-dimensional:
+\begin{tcblisting}{}
+\anteater[3D]
+\end{tcblisting}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
% Bear
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -269,11 +351,96 @@ The basic teddy bear can be modified by changing its colour:
\bear[body=blue]
\end{tcblisting}
+To view the teddy bear from behind:
+\begin{tcblisting}{}
+\bear[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the teddy bear 3-dimensional:
\begin{tcblisting}{}
\bear[3D]
\end{tcblisting}
+\subsection{Extension}
+
+The B\"ar and Ulrike Fischer wrote the fantastic \lstinline|bearwear| package, that provides many different clothing options for the \lstinline|TikZbears|. All the other \tikzlings admire them for the nice clothing!
+
+A short example:
+
+\begin{tcblisting}{}
+%\usepackage{bearwear}
+\bear
+\bearwear[
+ long sleeves,
+ shirt=red!80!black
+]
+\end{tcblisting}
+
+Many more options and examples can be found in the package documentation \url{https://ctan.org/pkg/bearwear}.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% Bee
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section[Bee]{Beeing, the bee}
+
+\emph{The bee was kindly contributed by @marmot}
+
+\subsection{Package name}
+
+\begin{tcolorbox}[lower separated=false, lefthand width=.8\linewidth]
+\vspace*{0.5cm}
+\lstinline|\usepackage{tikzlings-bees}|
+\vspace*{0.5cm}
+\end{tcolorbox}
+
+\subsection{Basic Usage}
+
+\begin{tcblisting}{}
+\bee
+\end{tcblisting}
+
+\subsection{Options}
+
+The basic bee can be modified by changing its colour:
+\begin{tcblisting}{}
+\bee[body=blue]
+\end{tcblisting}
+
+In addition to the colour of the body, the colour of various body parts can be adjusted:
+\begin{tcblisting}{}
+\bee[antennas=red]
+\end{tcblisting}
+\begin{tcblisting}{}
+\bee[eye=red]
+\end{tcblisting}
+\begin{tcblisting}{}
+\bee[mouth=red]
+\end{tcblisting}
+\begin{tcblisting}{}
+\bee[wings=red]
+\end{tcblisting}
+\begin{tcblisting}{}
+\bee[hands=red]
+\end{tcblisting}
+\begin{tcblisting}{}
+\bee[stripes=red]
+\end{tcblisting}
+
+To view the bee from behind:
+\begin{tcblisting}{}
+\bee[back]
+\end{tcblisting}
+
+The key \lstinline|3D| will make the bee 3-dimensional:
+\begin{tcblisting}{}
+\bee[3D]
+\end{tcblisting}
+
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Cat
@@ -348,12 +515,25 @@ Additionally several predefined widths exist:
\end{tikzpicture}
\end{tcolorbox}
-
-There is also the special option \lstinline|schroedinger|. This cat is both alive and death as long as you did not compile your document.
+There is also the special option \lstinline|schroedinger|. This cat is both alive and dead as long as you did not compile your document.
Be prepared for a possibly disturbing scene when you open the pdf, this option is not suited for sensitive \tikzlings.
+\begingroup
+\makeatletter
+\renewcommand*{\cat}[1][]{%
+ \tikzset{/cat/.cd,#1}%
+ \cat@tombstone%
+}
+\renewcommand{\cathookbackground}{}
+\makeatother
\begin{tcblisting}{}
\cat[schroedinger]
\end{tcblisting}
+\endgroup
+
+To view the cat from behind:
+\begin{tcblisting}{}
+\cat[back]
+\end{tcblisting}
Finally the key \lstinline|3D| will make the cat 3-dimensional:
\begin{tcblisting}{}
@@ -401,6 +581,11 @@ For the head an alternative sidewards facing head is available. It can be combin
\coati[sideward]
\end{tcblisting}
+To view the coati from behind:
+\begin{tcblisting}{}
+\coati[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the coati 3-dimensional:
\begin{tcblisting}{}
\coati[3D]
@@ -442,6 +627,11 @@ The hippo can also do its nails:
\hippo[toes=red]
\end{tcblisting}
+To view the hippo from behind:
+\begin{tcblisting}{}
+\hippo[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the hippo 3-dimensional:
\begin{tcblisting}{}
\hippo[3D]
@@ -455,7 +645,7 @@ The key \lstinline|3D| will make the hippo 3-dimensional:
\clearpage
\section[Koala]{Will, the koala}
-\emph{The koala was generously contributed by the TeX.Stackexchange user marmot and is named in honour of a \LaTeX{} developer from Down Under}
+\emph{The koala was generously contributed by @marmot and is named in honour of a \LaTeX{} developer from Down Under}
\subsection{Package name}
@@ -488,6 +678,11 @@ and if tired, it is going to take a nap:
\koala[sleeping]
\end{tcblisting}
+To view the koala from behind:
+\begin{tcblisting}{}
+\koala[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the koala 3-dimensional:
\begin{tcblisting}{}
\koala[3D]
@@ -555,6 +750,11 @@ If a good weather prognosis is derived, the happy marmot can dance by lifting up
\marmot[rightstep,xshift=2cm]
\end{tcblisting}
+To view the marmot from behind:
+\begin{tcblisting}{}
+\marmot[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the marmot 3-dimensional:
\begin{tcblisting}{}
\marmot[3D]
@@ -587,7 +787,7 @@ Finally the key \lstinline|3D| will make the marmot 3-dimensional:
\subsection{Options}
-The basic mouse can be modified by changing its colour:
+The basic mole can be modified by changing its colour:
\begin{tcblisting}{}
\moles[body=blue]
\end{tcblisting}
@@ -605,6 +805,11 @@ In addition to the colour of the body, the colour of various body parts can be a
\moles[feet=red]
\end{tcblisting}
+To view the mole from behind:
+\begin{tcblisting}{}
+\moles[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the mole 3-dimensional:
\begin{tcblisting}{}
\moles[3D]
@@ -618,7 +823,7 @@ The key \lstinline|3D| will make the mole 3-dimensional:
\clearpage
\section[Mouse]{Tokz, the mouse}
-\emph{The idea for the mouse came from an Italian TeX.Stackexchange user -- Tokz is a combination of the Italian word for mouse and \TikZ}
+\emph{The idea for the mouse came from an Italian \LaTeX{} user -- Tokz is a combination of the Italian word for mouse and \TikZ}
\subsection{Package name}
@@ -646,6 +851,17 @@ The rotation angle of its arms can be adjusted:
\mouse[rotatearms=40]
\end{tcblisting}
+And the mouse can lift its legs:
+\begin{tcblisting}{}
+\mouse[leftstep]
+\mouse[rightstep,xshift=2cm]
+\end{tcblisting}
+
+To view the mouse from behind:
+\begin{tcblisting}{}
+\mouse[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the mouse 3-dimensional:
\begin{tcblisting}{}
\mouse[3D]
@@ -659,7 +875,7 @@ The key \lstinline|3D| will make the mouse 3-dimensional:
\clearpage
\section[Owl]{Jake, the owl}
-\emph{The owl Jake was inspired by the avatar of one of the top users of TeX.Stackexchange}
+\emph{The owl Jake was inspired by the avatar of one of the world's top TikZperts}
\subsection{Package name}
@@ -696,6 +912,11 @@ In addition to the colour of the body, the colour of various body parts can be a
\owl[feet=red]
\end{tcblisting}
+To view the owl from behind:
+\begin{tcblisting}{}
+\owl[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the owl 3-dimensional:
\begin{tcblisting}{}
\owl[3D]
@@ -732,6 +953,11 @@ The basic panda can be modified by changing its colour:
\panda[body=blue]
\end{tcblisting}
+To view the panda from behind:
+\begin{tcblisting}{}
+\panda[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the panda 3-dimensional:
\begin{tcblisting}{}
\panda[3D]
@@ -786,6 +1012,11 @@ In addition to the colour of the body, the colour of various body parts can be a
\penguin[feet=red]
\end{tcblisting}
+To view the penguin from behind:
+\begin{tcblisting}{}
+\penguin[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the penguin 3-dimensional:
\begin{tcblisting}{}
\penguin[3D]
@@ -822,6 +1053,11 @@ The basic pig can be modified by changing its colour:
\pig[body=blue]
\end{tcblisting}
+To view the pig from behind:
+\begin{tcblisting}{}
+\pig[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the pig 3-dimensional:
\begin{tcblisting}{}
\pig[3D]
@@ -863,12 +1099,16 @@ The hippo can also do its nails:
\rhino[toes=red]
\end{tcblisting}
+To view the rhino from behind:
+\begin{tcblisting}{}
+\rhino[back]
+\end{tcblisting}
+
The key \lstinline|3D| will make the rhino 3-dimensional:
\begin{tcblisting}{}
\rhino[3D]
\end{tcblisting}
-
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Sloth
@@ -877,7 +1117,7 @@ The key \lstinline|3D| will make the rhino 3-dimensional:
\clearpage
\section[Sloth]{Riley, the sloth}
-\emph{One of the regulars in the TeX.Stackexchange chat once met a sloth called Riley}
+\emph{One of good souls behind the TugBoat once met a sloth called Riley}
\subsection{Package name}
@@ -905,6 +1145,11 @@ If tired, the sloth can take a nap:
\sloth[sleeping]
\end{tcblisting}
+To view the sloth from behind:
+\begin{tcblisting}{}
+\sloth[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the sloth 3-dimensional:
\begin{tcblisting}{}
@@ -913,6 +1158,47 @@ Finally the key \lstinline|3D| will make the sloth 3-dimensional:
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+% Squirrel
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section[Squirrel]{Ratatosk, the squirrel}
+
+\emph{named after the squirrel from Norse mythology who climbs around Yggdrasil}
+
+\subsection{Package name}
+
+\begin{tcolorbox}[lower separated=false, lefthand width=.8\linewidth]
+\vspace*{0.5cm}
+\lstinline|\usepackage{tikzlings-squirrels}|
+\vspace*{0.5cm}
+\end{tcolorbox}
+
+\subsection{Basic Usage}
+
+\begin{tcblisting}{}
+\squirrel
+\end{tcblisting}
+
+\subsection{Options}
+
+The basic squirrel can be modified by changing its colour:
+\begin{tcblisting}{}
+\squirrel[body=blue]
+\end{tcblisting}
+
+To view the squirrel from behind:
+\begin{tcblisting}{}
+\squirrel[back]
+\end{tcblisting}
+
+Finally the key \lstinline|3D| will make the squirrel 3-dimensional:
+\begin{tcblisting}{}
+\squirrel[3D]
+\end{tcblisting}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
% Snowman
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -956,6 +1242,16 @@ In addition to the colour of the body, the colour of various body parts can be a
\snowman[buttons=red]
\end{tcblisting}
+The biggest enemy of the snowman are raising temperatures:
+\begin{tcblisting}{}
+\snowman[globalwarming,tophat]
+\end{tcblisting}
+
+To view the snowman from behind:
+\begin{tcblisting}{}
+\snowman[back]
+\end{tcblisting}
+
Finally the key \lstinline|3D| will make the snowman 3-dimensional:
\begin{tcblisting}{}
@@ -968,7 +1264,7 @@ Finally the key \lstinline|3D| will make the snowman 3-dimensional:
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\clearpage
-\section[Ti\emph{k}Zlings]{... , the Ti\emph{k}Zling}
+\section[Ti\emph{k}Zling]{... , the Ti\emph{k}Zling}
\emph{The inventor of the word \tikzlings has yet to come up with a name for the Ti\emph{k}Zling}
@@ -993,12 +1289,17 @@ Only options common for all \tikzlings are supported for the \lstinline|\tikzlin
\tikzling[body=blue]
\end{tcblisting}
+to view the \tikzlings from behind
+\begin{tcblisting}{}
+\tikzling[back]
+\end{tcblisting}
+
and the \lstinline|3D| key, which will make the Ti\emph{k}Zlings 3-dimensional:
\begin{tcblisting}{}
\tikzling[3D]
\end{tcblisting}
-If an option of a specific tikzlings is used (for example \lstinline|sleeping| which only the koala can do) this only works if your are lucky and the koala is drawn, in all other cases it will result in an error.
+If an option of a specific tikzlings is used (for example \lstinline|sleeping| which only the koala can do) this only works if you are lucky and the koala is drawn, in all other cases it will result in an error.
In addition all usual \TikZ and \lstinline|pgf| keys can be used in the optional argument as well as the accessories presented in the following section.
@@ -1035,89 +1336,89 @@ A list of all available accessories is given below. For completeness the default
\begin{tcblisting}{}
\penguin[
- hat=blue!40!black
+ hat=blue!40!black
]
\end{tcblisting}
\begin{tcblisting}{}
\snowman[
- tophat=black!90!white
+ tophat=black!90!white
]
\end{tcblisting}
\begin{tcblisting}{}
\mouse[
- beret=black
+ beret=black
]
\end{tcblisting}
\begin{tcblisting}{}
-\owl[
- strawhat=gray!30!white,
- ribbon=black
+\anteater[
+ strawhat=blue,
+ ribbon=black
]
\end{tcblisting}
\begin{tcblisting}{}
\coati[
- harlequin=blue,
- niuqelrah=red
+ harlequin=blue,
+ niuqelrah=red
]
\end{tcblisting}
\begin{tcblisting}{}
\cat[
- witch=gray
+ witch=gray
]
\end{tcblisting}
\begin{tcblisting}{}
\bear[
- magichat=violet,
- magicstars=yellow!80!brown
+ magichat=violet,
+ magicstars=yellow!80!brown
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- crown=yellow!90!orange
+ crown=yellow!90!orange
]
\end{tcblisting}
\begin{tcblisting}{}
\koala[
- queencrown=yellow
+ queencrown=yellow
]
\end{tcblisting}
\begin{tcblisting}{}
\marmot[
- kingcrown=gray
+ kingcrown=gray
]
\end{tcblisting}
\begin{tcblisting}{}
\mouse[
- santa=red!80!black
+ santa=red!80!black
]
\end{tcblisting}
\begin{tcblisting}{}
\bear[
- chef=gray!20!white
+ chef=gray!20!white
]
\end{tcblisting}
\begin{tcblisting}{}
\snowman[
- graduate=black,
- tassel=red
+ graduate=black,
+ tassel=red
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- alien=green
+ alien=green
]
\end{tcblisting}
@@ -1125,30 +1426,30 @@ A list of all available accessories is given below. For completeness the default
\begin{tcblisting}{}
\coati[
- book={\tiny\TeX},
- bookcolour=brown
+ book={\tiny\TeX},
+ bookcolour=brown
]
\end{tcblisting}
\begin{tcblisting}{}
\pig[
- signpost={\TeX},
- signcolour= brown!50!black,
- signback=green!40!black
+ signpost={\TeX},
+ signcolour= brown!50!black,
+ signback=green!40!black
]
\end{tcblisting}
\begin{tcblisting}{}
\bear[
- speech={\TeX},
- bubblecolour=gray!30!white
+ speech={\TeX},
+ bubblecolour=gray!30!white
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- think={\TeX},
- bubblecolour=gray!30!white
+ think={\TeX},
+ bubblecolour=gray!30!white
]
\end{tcblisting}
@@ -1156,46 +1457,46 @@ A list of all available accessories is given below. For completeness the default
\begin{tcblisting}{}
\koala[
- pizza
+ pizza
]
\end{tcblisting}
\begin{tcblisting}{}
\mouse[
- cheese=yellow!30!orange!60!white
+ cheese=yellow!30!orange!60!white
]
\end{tcblisting}
\begin{tcblisting}{}
\coati[
- baguette=brown
+ baguette=brown
]
\end{tcblisting}
\begin{tcblisting}{}
\moles[
- cake=violet
+ cake=violet
]
\end{tcblisting}
\begin{tcblisting}{}
\marmot[
- icecream=brown!60!gray,
- flavoura=brown!50!black,
- flavourb=white!70!brown,
- flavourc=red!50!white
+ icecream=brown!60!gray,
+ flavoura=brown!50!black,
+ flavourb=white!70!brown,
+ flavourc=red!50!white
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- milkshake=red!20!white
+ milkshake=red!20!white
]
\end{tcblisting}
\begin{tcblisting}{}
\owl[
- wine=red!70!black
+ wine=red!70!black
]
\end{tcblisting}
@@ -1203,19 +1504,19 @@ A list of all available accessories is given below. For completeness the default
\begin{tcblisting}{}
\coati[
- cricket=brown
+ cricket=brown
]
\end{tcblisting}
\begin{tcblisting}{}
-\hippo[
- hockey=brown
+\bee[
+ hockey=brown
]
\end{tcblisting}
\begin{tcblisting}{}
-\koala[
- football=white
+\squirrel[
+ football=white
]
\end{tcblisting}
@@ -1223,88 +1524,88 @@ A list of all available accessories is given below. For completeness the default
\begin{tcblisting}{}
\marmot[
- crystalball=cyan
+ crystalball=cyan
]
\end{tcblisting}
\begin{tcblisting}{}
\bear[
- magicwand
+ magicwand
]
\end{tcblisting}
\begin{tcblisting}{}
\coati[
- rollingpin=brown
+ rollingpin=brown
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- lightsaber=green
+ lightsaber=green
]
\end{tcblisting}
\begin{tcblisting}{}
\snowman[
- torch=gray
+ torch=gray
]
\end{tcblisting}
\begin{tcblisting}{}
\mouse[
- basket=brown!70!gray
+ basket=brown!70!gray
]
\end{tcblisting}
\begin{tcblisting}{}
\sloth[
- easter=brown!70!gray,
- egga=blue,
- eggb=green,
- eggc=red
+ easter=brown!70!gray,
+ egga=blue,
+ eggb=green,
+ eggc=red
]
\end{tcblisting}
\begin{tcblisting}{}
\koala[
- crozier=brown
+ crozier=brown
]
\end{tcblisting}
\begin{tcblisting}{}
\snowman[
- shovel=gray
+ shovel=gray
]
\end{tcblisting}
\begin{tcblisting}{}
\penguin[
- pickaxe=gray
+ pickaxe=gray
]
\end{tcblisting}
\begin{tcblisting}{}
\rhino[
- umbrella=cyan
+ umbrella=cyan
]
\end{tcblisting}
\begin{tcblisting}{}
\marmot[
- umbrellaclosed=cyan
+ umbrellaclosed=cyan
]
\end{tcblisting}
\begin{tcblisting}{}
\mouse[
- handbag=red!70!black
+ handbag=red!70!black
]
\end{tcblisting}
\begin{tcblisting}{}
\bear[
- cocktail
+ cocktail
]
\end{tcblisting}