tikzducks (9nov18)

git-svn-id: svn://tug.org/texlive/trunk@49112 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 60 insertions, 40 deletions

diff --git a/Master/texmf-dist/doc/latex/tikzducks/README.md b/Master/texmf-dist/doc/latex/tikzducks/README.md
index f6ca89d5efc..13add9a0943 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/README.md
+++ b/Master/texmf-dist/doc/latex/tikzducks/README.md
@@ -4,23 +4,25 @@ This is a little LaTeX package for ducks to be used in TikZ pictures. The projec
 
 This project is licensed under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
 
-The project repository, including a bug tracker, can be found at https://github.com/samcarter8/tikzducks/issues
+The project repository, including a bug tracker, can be found at https://github.com/samcarter/tikzducks/issues
 
 ![This repository has an official duck seal of approval](https://i.stack.imgur.com/mSAtL.png)
 
-### A few examples:
+## A few examples:
 
 ![tikz ducks](https://user-images.githubusercontent.com/8226363/33049537-e71e9dd0-ce60-11e7-8b4c-7e1de0177f14.png)
 
-### Video showcase
+## Video showcases
 
-[![Watch a video showcase of this package](https://i.stack.imgur.com/iwZPt.png)](https://vimeo.com/246256860)
+There are several videos featuring the TikZducks, kindly contributed by Ulrike and Gert Fischer, Carla Maggi, Paulo Cereda and Prof. van Duck - many thanks to you all!
 
-(Kindly contributed by Ulrike and Gert Fischer, Carla Maggi, Paulo Cereda and Prof. van Duck - many thanks to you all!)
+[![The great TikZducks Christmas Extravaganza](https://user-images.githubusercontent.com/8226363/43651585-1281b074-9743-11e8-97f5-bf70617738a5.png)](https://vimeo.com/246256860)
+[![International Pizza Day](https://user-images.githubusercontent.com/8226363/43651587-12c92daa-9743-11e8-83b5-7fd3a3ac19a3.png)](https://vimeo.com/254643482)
+[![Happy Groundhog Day](https://user-images.githubusercontent.com/8226363/43651589-12e84334-9743-11e8-9621-d5e6e53a0ca8.png)](https://vimeo.com/252719006)
+[![Aquarela with TikZducks](https://user-images.githubusercontent.com/8226363/43651586-12a6c008-9743-11e8-99d2-5a66e7f5f1ee.png)](https://vimeo.com/270727100)
+[![Saint Crispin's Day](https://user-images.githubusercontent.com/43832342/47496794-37d18600-d858-11e8-9e6e-777ffee1acdc.png)](https://vimeo.com/295353434)
+[![James Bond](https://user-images.githubusercontent.com/43832342/47496795-37d18600-d858-11e8-8c0c-20ea2d0a23cd.png)](https://vimeo.com/284348495)
 
-The source code for the video showcase is available in [this repository](https://github.com/cereda/duck-extravaganza).
 
-More video showcases:
 
-- [Happy Groundhog day, 2018](https://vimeo.com/252719006)
-- [International pizza day, 2018](https://vimeo.com/254643482)
+The source code for the "The great TikZducks Christmas Extravaganza" is available in [this repository](https://github.com/cereda/duck-extravaganza).
diff --git a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
index fe722152751..8266ad7fe39 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
+++ b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
index c33d671ea9f..6407df30665 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
+++ b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
@@ -5,13 +5,13 @@
 % Maintained by samcarter
 %
 % Project repository and bug tracker:
-% https://github.com/samcarter8/tikzducks
+% https://github.com/samcarter/tikzducks
 %
 % Released under the LaTeX Project Public License v1.3c or later
 % See http://www.latex-project.org/lppl.txt
 %
-% Version 0.7
-% July 10, 2018 
+% Version 1.0
+% Nov 8, 2018 
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \documentclass[parskip=half]{scrartcl}
@@ -26,13 +26,13 @@
 \usepackage[most]{tcolorbox}
 \usepackage[paper=a4paper,margin=3cm]{geometry}
 \usepackage{url}
-\usepackage[colorlinks=true,breaklinks=true,urlcolor=duckblue,linkcolor=duckblue,citecolor=duckblue,filecolor=duckblue]{hyperref}
 \usepackage{xspace}
 \usepackage{scrlayer-scrpage} 
 \usepackage{marvosym}
 \usepackage{fontawesome}
 \usepackage[hang,flushmargin,bottom]{footmisc}
 \usepackage{imakeidx}
+\usepackage[colorlinks=true,breaklinks=true,urlcolor=duckblue,linkcolor=duckblue,citecolor=duckblue,filecolor=duckblue]{hyperref}
 
 % macros %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \newcommand{\CTAN}{\textsc{CTAN}\xspace}
@@ -56,7 +56,7 @@
 	commentstyle={\color{green!50!black}\slshape}, 
 	columns=fullflexible,
 	emphstyle=\color{orange!70!black},
-	emph=[1]{water,body,head,eye,pupil,bill,grumpy,tshirt,jacket,tie,cape,shorthair,longhair,crazyhair,recedinghair,eyebrow,beard,glasses,sunglasses,alien,hat,cap,santa,chef,graduate,tassel,beret,crown,unicorn,icecream,flavoura,flavourb,flavourc,book,bookcolour,signpost,signcolour,signback,magichat,magicstars,magicwand,witch,cricket,rollingpin,lightsaber,torch,cake,pizza,hockey,baguette,wing,football,mask,bunny,inear,necklace,milkshake,wine,peakedcap,prison,tophat,speech,bubblecolour,think,buttons,sheep,squareglasses,tail,basket,easter,egga,eggb,eggc,mohican,mullet,horsetail,darthvader,crozier,queencrown,kingcrown,wing,laughing,parrot,stethoscope,niuqelrah,harlequin,neckerchief,woggle,snowduck,invisible,strawhat,ribbon,vampire,parting},
+	emph=[1]{water,body,head,eye,pupil,bill,grumpy,tshirt,jacket,tie,cape,shorthair,longhair,crazyhair,recedinghair,eyebrow,beard,glasses,sunglasses,alien,hat,cap,santa,chef,cheese,graduate,tassel,beret,crown,unicorn,icecream,flavoura,flavourb,flavourc,book,bookcolour,signpost,signcolour,signback,magichat,magicstars,magicwand,witch,cricket,rollingpin,lightsaber,torch,cake,pizza,hockey,baguette,wing,football,mask,bunny,inear,necklace,milkshake,wine,peakedcap,prison,tophat,speech,bubblecolour,think,buttons,sheep,squareglasses,tail,basket,easter,egga,eggb,eggc,mohican,mullet,horsetail,darthvader,crozier,queencrown,kingcrown,wing,laughing,parrot,stethoscope,niuqelrah,harlequin,neckerchief,woggle,snowduck,invisible,strawhat,ribbon,vampire,parting,crystalball,helmet,shovel,pickaxe},
 	texcsstyle=*\color{duckblue}\bfseries,
 	keywordstyle=\color{red!60!black}\bfseries,
 	morekeywords={tikzpicture,scope,patterns,calc,pgfinterruptboundingbox},
@@ -85,7 +85,7 @@
 \lstset{style=duckstyle}
 \pgfkeys{/duck/|stripes|/.style={stripes={#1}}}
 
-\pgfmathsetseed{1}
+\pgfmathsetseed{2}
 \setlength{\footheight}{45pt}
 \newlength{\duckoffset}
 
@@ -98,7 +98,7 @@
 } 
 \pagestyle{scrheadings}
 \indexsetup{firstpagestyle=scrheadings}
-\makeindex
+\makeindex[columns=3]
 
 \usetikzlibrary{external}
 \ifnum\pdfshellescape=1
@@ -116,10 +116,10 @@
 					longhair=red!50!brown, 
 					jacket=blue!50!black]
 		\end{tikzpicture})\\[0.8em]
-		\url{https://github.com/samcarter8/tikzducks}\\
+		\url{https://github.com/samcarter/tikzducks}\\
 		\url{https://www.ctan.org/pkg/tikzducks}
 	}{samcarter}}
-\date{Version 0.7 -- \today}
+\date{Version 1.0 -- \today}
 
 \begin{document}
 \maketitle
@@ -132,7 +132,7 @@ Rubber ducks can be made of latex, but can they also be made with \LaTeX? Yes! T
 This project is a continuation of an answer at TeX.Stackexchange: \href{tex.stackexchange.com/a/347458/36296}{How can we draw a duck?}.
 
 This package is work in progress (and will probably never be really finished as there is an infinite amount of things which could be added), 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/samcarter8/tikzducks}, including a bug tracker -- please make constructive use of it! A more stable package version can be found on \CTAN (\url{www.ctan.org/pkg/tikzducks}) and is included in both \miktex and \texlive as \tikzducks. If you seek any other assistance (not bug reports/feature requests), I suggest using the \href{https://tex.stackexchange.com/questions/tagged/tikzducks}{\texttt{\{tikzducks\}}-tag} on TeX.Stackexchange.
+The head version of the source code can be found on \url{github.com/samcarter/tikzducks}, including a bug tracker -- please make constructive use of it! A more stable package version can be found on \CTAN (\url{www.ctan.org/pkg/tikzducks}) and is included in both \miktex and \texlive as \tikzducks. If you seek any other assistance (not bug reports/feature requests), I suggest using the \href{https://tex.stackexchange.com/questions/tagged/tikzducks}{\texttt{\{tikzducks\}}-tag} on TeX.Stackexchange.
 
 \subsection{Acknowledgements}
 
@@ -167,7 +167,7 @@ The ducks mostly consist of basic geometric shapes drawn in \TikZ. Some of the m
 
 The \tikzducks package loads \TikZ, which in turn loads the \lstinline|xcolor| package (amongst others). If you require one of these packages to be loaded with some option, please consider loading it yourself before the \tikzducks package or use, e.g.
 
-\begin{lstlisting}[aboveskip=1.2em,morekeywords={xcolor,svgnames}]
+\begin{lstlisting}[aboveskip=0em,morekeywords={xcolor,svgnames}]
 	\PassOptionsToPackage{svgnames}{xcolor}
 \end{lstlisting}
 It also uses the \lstinline|\usetikzlibrary{patterns}| and \lstinline|\usetikzlibrary{calc}|. Furthermore the packages \lstinline|ifpdf| and \lstinline|ifluatex| are necassary starting with version 0.5 of this package.
@@ -198,20 +198,15 @@ To customise this basic duck, the package uses \lstinline|pgf| keys. For almost
 If the keyword consists of multiples words, it works both with and without spaces. In the following usually the version without spaces is given. 
 
 \clearpage
-If the size of the ducks should be changed or shifted:
+In addition to the keys defined in this package, all usual \TikZ and \lstinline|pgf| keys can also be used. For example if the size of the ducks should be changed or shifted:
 
 \begin{tcblisting}{title={Scaled duck and \emph{The Ugly Duckling}},	righthand width=3cm}
 \begin{tikzpicture}[scale=0.6]
 	\duck
-	\begin{scope}[xshift=90pt, scale=.3, yshift=150pt]
-		\duck
-	\end{scope}
-	\begin{scope}[xshift=60pt, scale=.3, yshift=100pt]
-		\duck
-	\end{scope}
-	\begin{scope}[xshift=80pt, scale=.3, yshift=50pt]
-		\duck[body=gray!50!white,head=gray!50!white]
-	\end{scope}		
+	\duck[xshift=90pt, scale=.3, yshift=150pt]
+	\duck[xshift=60pt, scale=.3, yshift=100pt]
+	\duck[body=gray!50!white,head=gray!50!white,
+		xshift=80pt, scale=.3, yshift=50pt]
 \end{tikzpicture}
 \end{tcblisting}
 
@@ -490,6 +485,12 @@ There is a multitude of things a duck might need. The following examples all als
 \end{tikzpicture}
 \end{tcblisting}
 
+\begin{tcblisting}{title={Knight duck}}
+\begin{tikzpicture}
+	\duck[helmet=gray]
+\end{tikzpicture}
+\end{tcblisting}
+
 \begin{tcblisting}{title={Unicorn duck}}
 \begin{tikzpicture}
 	\duck[body=pink,
@@ -704,6 +705,12 @@ There is a multitude of things a duck might need. The following examples all als
 \end{tikzpicture}	
 \end{tcblisting}
 
+\begin{tcblisting}{title={Cheese duck}}
+\begin{tikzpicture}
+  \duck[cheese=orange]
+\end{tikzpicture}	
+\end{tcblisting}
+
 \begin{tcblisting}{title={Milkshake duck}}
 \begin{tikzpicture}
 	\duck[milkshake=red!20!white]
@@ -772,6 +779,23 @@ There is a multitude of things a duck might need. The following examples all als
 \end{tikzpicture}  
 \end{tcblisting}
 
+\addtocounter{footnote}{1}
+\begin{tcblisting}{title={Fortune Quacker$^{\thefootnote}$}}
+\begin{tikzpicture}
+	\duck[crystalball=cyan]
+\end{tikzpicture}   
+\end{tcblisting}
+\footnotetext[\thefootnote]{The crystal ball is kindly contributed by \href{https://tex.stackexchange.com/users/121799/marmot}{@marmot}}
+
+\begin{tcblisting}{title={Shovelling Duck}}
+\begin{tikzpicture}
+	\duck[shovel=gray]
+\end{tikzpicture}  
+\begin{tikzpicture}
+	\duck[pickaxe=gray]
+\end{tikzpicture}  
+\end{tcblisting}
+
 \clearpage
 \section{Random ducks}
 With all these available accessories it might be hard to decide which one to choose, but don't worry the \tikzducks provide a solution for this dilemma, the random duck, or short \lstinline|\randuck|, which automatically creates a duck with a randomly chosen accessories and something on top of the head (hair, a hat, ears, alien antenna ...)
@@ -853,10 +877,8 @@ To distinguish coordinates from multiple ducks in the same \lstinline|tikzpictur
 \begin{tcblisting}{title={Named coordinates},listing options={style={duckstyle}, emph={name,wing}}}
 \begin{tikzpicture}
 	\duck[name=foo]
-	\begin{scope}[xshift=90pt,
-			scale=.3, yshift=150pt]
-	 	\duck[name=bar]
-	\end{scope}
+ 	\duck[name=bar,xshift=90pt,
+ 				scale=.3,yshift=150pt]
 	\draw (foo-wing) -- (bar-wing);
 \end{tikzpicture}	
 \end{tcblisting}
@@ -1311,12 +1333,8 @@ In the following a few examples of possible duck customisations, some of which w
 \begin{tikzpicture}
 \duck[body=qskin,bill=qbill,jacket=qdress,tshirt=teal!30!qdress,shorthair=gray!60!white,necklace=gray!10!white]  
 \fill[gray!60!white,rotate=-30] (0.27,1.23) rectangle (0.37,0.65);
-\begin{scope}[scale=0.23,rotate=-20,yshift=82,xshift=38]
-	\fill[qcrown] \duckpathqueencrown;
-\end{scope}
-\begin{scope}[yshift=3]
-	\fill[qcrown] \duckpathkingcrown;
-\end{scope}
+\fill[qcrown,scale=0.23,rotate=-20,yshift=82,xshift=38] \duckpathqueencrown;
+\fill[qcrown,yshift=3] \duckpathkingcrown;
 \end{tikzpicture}
 \end{tcblisting}