summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-11-01 20:09:24 +0000
committerKarl Berry <karl@freefriends.org>2023-11-01 20:09:24 +0000
commit7283687018f8730d7066ec0e99438b72ed64eaac (patch)
treee8d34d4df1b6dc90338d14fb42de2b2ffa49c275 /Master/texmf-dist/doc
parent6bc8756745f718a12a63db91399cec8770da62f2 (diff)
coloredbelts (1nov23)
git-svn-id: svn://tug.org/texlive/trunk@68717 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/coloredbelts/README.md8
-rw-r--r--Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdfbin0 -> 523936 bytes
-rw-r--r--Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.tex224
-rw-r--r--Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdfbin0 -> 519983 bytes
-rw-r--r--Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.tex223
5 files changed, 455 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/coloredbelts/README.md b/Master/texmf-dist/doc/latex/coloredbelts/README.md
new file mode 100644
index 00000000000..58f1eaa7272
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coloredbelts/README.md
@@ -0,0 +1,8 @@
+coloredbelts is a package with colored judo's belts.
+-----------------------------------------------------------------
+coloredbelts est un package avec des ceintures de judo, colorées.
+-----------------------------------------------------------------
+Author.......: Cédric Pierquet
+email........: cpierquet@outlook.fr
+Licence......: Released under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
+Licence svg : CC BY-SA 3.0 https://fr.wikipedia.org/wiki/Fichier:Judo_yellow_belt.svg \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdf b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdf
new file mode 100644
index 00000000000..c87afa6ee2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.tex b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.tex
new file mode 100644
index 00000000000..8a86ee02145
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.tex
@@ -0,0 +1,224 @@
+% !TeX TXS-program:compile = txs:///arara
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
+
+\documentclass[english,11pt,a4paper]{article}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+%\usepackage{DejaVuSerif}
+%\usepackage[scale=1.125]{inconsolata}
+\usepackage{pgffor}
+\usepackage{coloredbelts}
+\usepackage{enumitem}
+\usepackage{soul}
+\usepackage{codehigh}
+\usepackage{multicol}
+\usepackage{tabularray}
+\usepackage{fontawesome5}
+\usepackage{fancyvrb}
+\usepackage{fancyhdr}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+%\rhead{\sffamily\small\affloetalab[Legende]}
+\lfoot{\sffamily\small [coloredbelts]}
+\cfoot{\sffamily\small - \thepage{} -}
+\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
+\usepackage{hologo}
+\usepackage{xspace}
+\providecommand\tikzlogo{Ti\textit{k}Z}
+\providecommand\TeXLive{\TeX{}Live\xspace}
+\providecommand\PSTricks{\textsf{PSTricks}\xspace}
+\let\pstricks\PSTricks
+\let\TikZ\tikzlogo
+
+\usepackage{hyperref}
+\urlstyle{same}
+\hypersetup{pdfborder=0 0 0}
+\usepackage[margin=2cm]{geometry}
+\setlength{\parindent}{0pt}
+
+\def\TPversion{0.1.0}
+\def\TPdate{30/10/2023}
+\def\HtRet{0.45}\def\LgRect{1.5}
+\usepackage{tcolorbox}
+
+\def\ListeTailleTexte{tiny,scriptsize,footnotesize,small,normalsize,large,large,LARGE,huge,Huge}
+
+\sethlcolor{lightgray!25}
+\NewDocumentCommand\MontreCode{ m }{%
+ \hl{\vphantom{\texttt{pf}}\texttt{#1}}%
+}
+
+\usepackage{babel}
+
+\begin{document}
+
+\pagestyle{fancy}
+
+\thispagestyle{empty}
+
+\begin{center}
+ \begin{minipage}{0.88\linewidth}
+ \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
+ \begin{center}
+ \begin{tabular}{c}
+ {\Huge \texttt{coloredbelts}}\\
+ \\
+ {\LARGE Colored belt, in vectorial format,} \\
+ \\
+ {\LARGE to present skills, for example.} \\
+ \\
+ {\small \texttt{Version \TPversion{} -- \TPdate}}
+ \end{tabular}
+ \end{center}
+ \end{tcolorbox}
+\end{minipage}
+\end{center}
+
+\begin{center}
+ \begin{tabular}{c}
+ \texttt{Cédric Pierquet}\\
+ {\ttfamily c pierquet -- at -- outlook . fr}\\
+ \texttt{\url{https://github.com/cpierquet/coloredbelts}}
+\end{tabular}
+\end{center}
+
+\hrule
+
+\phantomsection
+
+\hypertarget{matoc}{}
+
+\tableofcontents
+
+\vspace*{5mm}
+
+\hrule
+
+\vspace*{5mm}
+
+\vfill
+
+\begin{tcolorbox}[colframe=lightgray,colback=lightgray!10]
+\hfill
+{\Huge\ColorBelt[Hauteur=2cm]{red}}
+\hfill~
+
+\bigskip
+
+\hfill\foreach \couleur in {white,yellow,orange,red,pink,green,blue,brown,purple,gray,black}{{\LARGE\sffamily\ColorBelt{\couleur}\,}}\hfill~
+
+\bigskip
+
+\hfill{\Huge\rotatebox[origin=c]{45}{\ColorBelt{green}}\:\rotatebox[origin=c]{-45}{\ColorBelt{blue}}}\hfill~
+\end{tcolorbox}
+
+\vfill~
+
+\pagebreak
+
+\section{The package coloredbelts}
+
+\subsection{Ideas}
+
+The idea is to display a pictogram like "colored judo's belt" to present skills, for example.
+
+\medskip
+
+The pictograms are \textit{vectorial} \MontreCode{pdf}, made with a \MontreCode{svg}, diffused in CC BY-SA 3.0 (\url{https://fr.wikipedia.org/wiki/Fichier:Judo_yellow_belt.svg}).
+
+\subsection{Loading}
+
+The package loads within the preamble, with \MontreCode{\textbackslash usepackage\{coloredbelts\}}.
+
+The only loaded packages are \MontreCode{graphicx}, \MontreCode{calc}, \MontreCode{simplekv} and \MontreCode{xstring}.
+
+\begin{codehigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\usepackage{coloredbelts}
+\end{codehigh}
+
+\section{The command}
+
+\subsection{Naming of the files}
+
+Each pictogram is named like \MontreCode{judobelt-<color>.pdf}, so that they can be embedded with a "simple" \MontreCode{\textbackslash includegraphics} \textit{classic}.
+
+\begin{demohigh}[language=latex/latex3,style/main=cyan!10,style/code=cyan!10,style/demo=cyan!10]
+\includegraphics[height=5cm]{judobelt-yellow.pdf}\par
+\includegraphics[width=4cm]{judobelt-pink.pdf}
+\end{demohigh}
+
+\subsection{Usage}
+
+The command is \MontreCode{\textbackslash ColorBelt}.
+
+\begin{codehigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\ColorBelt(*)[options]{color}
+\end{codehigh}
+
+The starred version is an "alias" for a \MontreCode{\textbackslash includegraphics}, with optionals parameters in \MontreCode{[...]}.
+
+\medskip
+
+The options for the non starred version are
+
+\begin{itemize}[leftmargin=*]
+ \item the key \MontreCode{Height} :
+ \begin{itemize}
+ \item can use an automatic height, with \MontreCode{auto} (95\,\% og the global height of current fonte + small vertical offset) ;
+ \item can specify a global height ;
+ \end{itemize}
+ \item the key \MontreCode{OffsetV} (without \MontreCode{auto} for \MontreCode{Height}) can offset vertically the pictogram.
+\end{itemize}
+
+Available colors are :
+
+\begin{itemize}
+ \item \ColorBelt{white} : \texttt{white} ;
+ \item \ColorBelt{yellow} : \texttt{yellow} ;
+ \item \ColorBelt{orange} : \texttt{orange} ;
+ \item \ColorBelt{red} : \texttt{red} ;
+ \item \ColorBelt{pink} : \texttt{pink} ;
+ \item \ColorBelt{green} : \texttt{green} ;
+ \item \ColorBelt{blue} : \texttt{blue} ;
+ \item \ColorBelt{brown} : \texttt{brown} ;
+ \item \ColorBelt{purple} : \texttt{purple} ;
+ \item \ColorBelt{gray} : \texttt{gray} ;
+ \item \ColorBelt{black} : \texttt{black}.
+\end{itemize}
+
+\medskip
+
+\begin{tblr}{hlines,width=\linewidth,colspec={Q[l,m]X[l,m]},row{1}={magenta!10},row{2-Z}={cyan!10}}
+ \SetCell[r=1,c=2]{c,m} \fakeverb{\ColorBelt} & \\
+ {\tiny\fakeverb{\tiny}} & {\tiny Inline \ColorBelt{red} pictogram} \\
+ {\scriptsize\fakeverb{\scriptsize}} & {\scriptsize Inline \ColorBelt{red} pictogram} \\
+ {\footnotesize\fakeverb{\footnotesize}} & {\footnotesize Inline \ColorBelt{red} pictogram} \\
+ {\small\fakeverb{\small}} & {\small Inline \ColorBelt{red} pictogram} \\
+ {\normalsize\fakeverb{\normalsize}} & {\normalsize Inline \ColorBelt{red} pictogram} \\
+ {\large\fakeverb{\large}} & {\large Inline \ColorBelt{red} pictogram} \\
+ {\Large\fakeverb{\Large}} & {\Large Inline \ColorBelt{red} pictogram} \\
+ {\LARGE\fakeverb{\LARGE}} & {\LARGE Inline \ColorBelt{red} pictogram} \\
+ {\huge\fakeverb{\huge}} & {\huge Inline \ColorBelt{red} pictogram} \\
+ {\Huge\fakeverb{\Huge}} & {\Huge Inline \ColorBelt{red} pictogram} \\
+\end{tblr}
+
+\begin{demohigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+{\Huge\rotatebox[origin=c]{30}{\ColorBelt{brown}}\:
+\rotatebox[origin=c]{-45}{\ColorBelt{blue}}}
+\end{demohigh}
+
+\begin{demohigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\ColorBelt*[scale=0.25]{orange}\par
+\ColorBelt*[scale=0.15]{yellow}
+\end{demohigh}
+
+\vfill
+
+\section{History}
+
+\verb|v0.1.0|~:~~~~Initial version
+
+\vspace*{15mm}
+
+\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdf b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdf
new file mode 100644
index 00000000000..2085bc5f88e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.tex b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.tex
new file mode 100644
index 00000000000..1d57ceaa050
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.tex
@@ -0,0 +1,223 @@
+% !TeX TXS-program:compile = txs:///arara
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode}
+% arara: pdflatex: {shell: no, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
+
+\documentclass[french,11pt,a4paper]{article}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+%\usepackage{DejaVuSerif}
+%\usepackage[scale=1.125]{inconsolata}
+\usepackage{pgffor}
+\usepackage{coloredbelts}
+\usepackage{enumitem}
+\usepackage{soul}
+\usepackage{codehigh}
+\usepackage{multicol}
+\usepackage{tabularray}
+\usepackage{fontawesome5}
+\usepackage{fancyvrb}
+\usepackage{fancyhdr}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+%\rhead{\sffamily\small\affloetalab[Legende]}
+\lfoot{\sffamily\small [coloredbelts]}
+\cfoot{\sffamily\small - \thepage{} -}
+\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
+\usepackage{hologo}
+\providecommand\tikzlogo{Ti\textit{k}Z}
+\providecommand\TeXLive{\TeX{}Live\xspace}
+\providecommand\PSTricks{\textsf{PSTricks}\xspace}
+\let\pstricks\PSTricks
+\let\TikZ\tikzlogo
+
+\usepackage{hyperref}
+\urlstyle{same}
+\hypersetup{pdfborder=0 0 0}
+\usepackage[margin=2cm]{geometry}
+\setlength{\parindent}{0pt}
+
+\def\TPversion{0.1.0}
+\def\TPdate{30 octobre 2023}
+\def\HtRet{0.45}\def\LgRect{1.5}
+\usepackage{tcolorbox}
+
+\def\ListeTailleTexte{tiny,scriptsize,footnotesize,small,normalsize,large,large,LARGE,huge,Huge}
+
+\sethlcolor{lightgray!25}
+\NewDocumentCommand\MontreCode{ m }{%
+ \hl{\vphantom{\texttt{pf}}\texttt{#1}}%
+}
+
+\usepackage{babel}
+
+\begin{document}
+
+\pagestyle{fancy}
+
+\thispagestyle{empty}
+
+\begin{center}
+ \begin{minipage}{0.88\linewidth}
+ \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
+ \begin{center}
+ \begin{tabular}{c}
+ {\Huge \texttt{coloredbelts}}\\
+ \\
+ {\LARGE Des ceintures colorées, au format vectoriel,} \\
+ \\
+ {\LARGE pour présenter des compétences, par exemple.} \\
+ \\
+ {\small \texttt{Version \TPversion{} -- \TPdate}}
+ \end{tabular}
+ \end{center}
+ \end{tcolorbox}
+\end{minipage}
+\end{center}
+
+\begin{center}
+ \begin{tabular}{c}
+ \texttt{Cédric Pierquet}\\
+ {\ttfamily c pierquet -- at -- outlook . fr}\\
+ \texttt{\url{https://github.com/cpierquet/coloredbelts}}
+\end{tabular}
+\end{center}
+
+\hrule
+
+\phantomsection
+
+\hypertarget{matoc}{}
+
+\tableofcontents
+
+\vspace*{5mm}
+
+\hrule
+
+\vspace*{5mm}
+
+\vfill
+
+\begin{tcolorbox}[colframe=lightgray,colback=lightgray!10]
+\hfill
+{\Huge\CeintureCouleur[Hauteur=2cm]{red}}
+\hfill~
+
+\bigskip
+
+\hfill\foreach \couleur in {blanc,jaune,orange,rouge,rose,vert,bleu,marron,violet,gris,noir}{{\LARGE\sffamily\CeintureCouleur{\couleur}\,}}\hfill~
+
+\bigskip
+
+\hfill{\Huge\rotatebox[origin=c]{45}{\CeintureCouleur{vert}}\:\rotatebox[origin=c]{-45}{\CeintureCouleur{bleu}}}\hfill~
+\end{tcolorbox}
+
+\vfill~
+
+\pagebreak
+
+\section{Le package coloredbelts}
+
+\subsection{Idées}
+
+L'idée est de pouvoir intégrer, dans un document \LaTeX, un pictogramme type \textit{ceinture colorée} pour présenter par exemple des niveaux de compétences.
+
+\medskip
+
+Les logos sont au format (vectoriel) \MontreCode{pdf}, et ont été obtenus à partir d'un fichier \MontreCode{svg}, diffusé sous licence CC BY-SA 3.0 (\url{https://fr.wikipedia.org/wiki/Fichier:Judo_yellow_belt.svg}). Le fichier a servi de base pour les différents coloris.
+
+\subsection{Chargement}
+
+Le package se charge dans le préambule, via \MontreCode{\textbackslash usepackage\{coloredbelts\}}.
+
+Les seuls packages chargés sont \MontreCode{graphicx}, \MontreCode{calc} et \MontreCode{simplekv} et \MontreCode{xstring}.
+
+\begin{codehigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\usepackage{coloredbelts}
+\end{codehigh}
+
+\section{La commande}
+
+\subsection{Masque de nommage des fichiers}
+
+Chaque logo est nommé sous la forme \MontreCode{judobelt-<couleur>.pdf}, de sorte que les pictogrammes peuvent être insérés directement via la commande \MontreCode{\textbackslash includegraphics} \textit{classique}.
+
+\begin{demohigh}[language=latex/latex3,style/main=cyan!10,style/code=cyan!10,style/demo=cyan!10]
+\includegraphics[height=5cm]{judobelt-yellow.pdf}\par
+\includegraphics[width=4cm]{judobelt-pink.pdf}
+\end{demohigh}
+
+\subsection{Fonctionnement}
+
+La commande dédiée à un affichage \textit{en ligne} est \MontreCode{\textbackslash CeintureCouleur}.
+
+\begin{codehigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\CeintureCouleur(*)[options]{couleur}
+\end{codehigh}
+
+La version étoilée correspond en fait à un \textit{alias} d'un \MontreCode{\textbackslash includegraphics}, avec les paramètres optionnels entre \MontreCode{[...]}.
+
+\medskip
+
+Concernant les options de la version non étoilée :
+
+\begin{itemize}[leftmargin=*]
+ \item la cle \MontreCode{Hauteur} permet de :
+ \begin{itemize}
+ \item spécifier une hauteur automatique, via \MontreCode{auto}, au quel cas le code se charge de positionner la ceinture en fonction de la fonte et de la taille du texte courant (95\,\% de la hauteur globale des lettres + léger décalage vertical) ;
+ \item ou bien de spécifier une hauteur globale ;
+ \end{itemize}
+ \item la clé \MontreCode{DecalV} (sans hauteur automatique) permet de décaler verticalement le pictogramme.
+\end{itemize}
+
+Les couleurs diponibles sont :
+
+\begin{itemize}
+ \item \CeintureCouleur{blanc} : \texttt{blanc} ;
+ \item \CeintureCouleur{jaune} : \texttt{jaune} ;
+ \item \CeintureCouleur{orange} : \texttt{orange} ;
+ \item \CeintureCouleur{rouge} : \texttt{rouge} ;
+ \item \CeintureCouleur{rose} : \texttt{rose} ;
+ \item \CeintureCouleur{vert} : \texttt{vert} ;
+ \item \CeintureCouleur{bleu} : \texttt{bleu} ;
+ \item \CeintureCouleur{marron} : \texttt{marron} ;
+ \item \CeintureCouleur{violet} : \texttt{violet} ;
+ \item \CeintureCouleur{gris} : \texttt{gris} ;
+ \item \CeintureCouleur{noir} : \texttt{noir}.
+\end{itemize}
+
+\medskip
+
+\begin{tblr}{hlines,width=\linewidth,colspec={Q[l,m]X[l,m]},row{1}={magenta!10},row{2-Z}={cyan!10}}
+ \SetCell[r=1,c=2]{c,m} \fakeverb{\CeintureCouleur} & \\
+ {\tiny\fakeverb{\tiny}} & {\tiny Essai de logo \CeintureCouleur{red} en ligne} \\
+ {\scriptsize\fakeverb{\scriptsize}} & {\scriptsize Essai de \CeintureCouleur{red} en ligne} \\
+ {\footnotesize\fakeverb{\footnotesize}} & {\footnotesize Essai de \CeintureCouleur{red} en ligne} \\
+ {\small\fakeverb{\small}} & {\small Essai de \CeintureCouleur{red} en ligne} \\
+ {\normalsize\fakeverb{\normalsize}} & {\normalsize Essai de \CeintureCouleur{red} en ligne} \\
+ {\large\fakeverb{\large}} & {\large Essai de \CeintureCouleur{red} en ligne} \\
+ {\Large\fakeverb{\Large}} & {\Large Essai de \CeintureCouleur{red} en ligne} \\
+ {\LARGE\fakeverb{\LARGE}} & {\LARGE Essai de \CeintureCouleur{red} en ligne} \\
+ {\huge\fakeverb{\huge}} & {\huge Essai de \CeintureCouleur{red} en ligne} \\
+ {\Huge\fakeverb{\Huge}} & {\Huge Essai de \CeintureCouleur{red} en ligne} \\
+\end{tblr}
+
+\begin{demohigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+{\Huge\rotatebox[origin=c]{30}{\CeintureCouleur{marron}}\:
+\rotatebox[origin=c]{-45}{\CeintureCouleur{bleu}}}
+\end{demohigh}
+
+\begin{demohigh}[language=latex/latex2,style/main=cyan!10,style/code=cyan!10]
+\CeintureCouleur*[scale=0.25]{orange}\par
+\CeintureCouleur*[scale=0.15]{yellow}
+\end{demohigh}
+
+\vfill
+
+\section{Historique}
+
+\verb|v0.1.0|~:~~~~Version initiale
+
+\vspace*{15mm}
+
+\end{document} \ No newline at end of file