From 7283687018f8730d7066ec0e99438b72ed64eaac Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 1 Nov 2023 20:09:24 +0000 Subject: coloredbelts (1nov23) git-svn-id: svn://tug.org/texlive/trunk@68717 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/coloredbelts/README.md | 8 + .../doc/latex/coloredbelts/coloredbelts-doc-en.pdf | Bin 0 -> 523936 bytes .../doc/latex/coloredbelts/coloredbelts-doc-en.tex | 224 +++++++++++++++++++++ .../doc/latex/coloredbelts/coloredbelts-doc-fr.pdf | Bin 0 -> 519983 bytes .../doc/latex/coloredbelts/coloredbelts-doc-fr.tex | 223 ++++++++++++++++++++ 5 files changed, 455 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/coloredbelts/README.md create mode 100644 Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdf create mode 100644 Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.tex create mode 100644 Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdf create mode 100644 Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.tex (limited to 'Master/texmf-dist/doc') 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-en.pdf 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-.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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/coloredbelts/coloredbelts-doc-fr.pdf 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-.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 -- cgit v1.2.3