summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-04-04 20:37:13 +0000
committerKarl Berry <karl@freefriends.org>2024-04-04 20:37:13 +0000
commit065b8058335efb32efce6a0c3f5f9f4cd56b15db (patch)
tree50bb580357653f5eeecdae640d9fb9bd6475cdf4 /Master/texmf-dist/doc
parentb4450378e723ad21a576e362c33cd3cca807aa69 (diff)
customenvs (4apr24)
git-svn-id: svn://tug.org/texlive/trunk@70859 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.pdfbin116272 -> 182916 bytes
-rw-r--r--Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.tex83
-rw-r--r--Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.pdfbin519283 -> 1399073 bytes
-rw-r--r--Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.tex92
-rw-r--r--Master/texmf-dist/doc/latex/customenvs/envtexo_exemples.tex2
5 files changed, 168 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.pdf b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.pdf
index c4a06de15b3..f1bf30aacca 100644
--- a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.pdf
+++ b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.tex b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.tex
index 4bc63e0c5f9..b8352c628d3 100644
--- a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.tex
+++ b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-en.tex
@@ -34,8 +34,8 @@
\usepackage[margin=1.5cm]{geometry}
\setlength{\parindent}{0pt}
-\def\TPversion{0.1.3}
-\def\TPdate{30/03/2024}
+\def\TPversion{0.1.4}
+\def\TPdate{04/04/2024}
\usepackage{tcolorbox}
\sethlcolor{lightgray!25}
\NewDocumentCommand\MontreCode{ m }{%
@@ -111,6 +111,8 @@
\section{History}
+\verb|v0.1.4|~:~~~~Create a SMS conversation
+
\verb|v0.1.3|~:~~~~Environment for exercise(s) (in french doc)
\verb|v0.1.2|~:~~~~Pencil of skills
@@ -357,7 +359,7 @@ The idea is to :
\begin{itemize}
\item present of list of categories and skills ;
- \item prensented like a pencil.
+ \item presented like a pencil.
\end{itemize}
The code (within CC-BY-SA 4.0 license) is adapted from :
@@ -420,4 +422,79 @@ The last argument, mandatory and between \MontreCode{(...)} give the list of cat
Search/Skill 1\\Skill 2,Model/{Skill 1\\Skill 2}}
\end{demohigh}
+\pagebreak
+
+\section{SMS conversation}
+
+\subsection{Global use}
+
+The idea is to present a conversation of SMS.
+
+\begin{codehigh}[language=latex/latex3,style/main=teal!25,style/code=teal!25]
+\begin{ChatSMS}[keys]{name}
+ \InSMS(*){time}{msg}
+ \OutSMS*(*){time}{msg}
+\end{ChatSMS}
+\end{codehigh}
+
+The style is globally fixed, but there's some customization available.
+
+\subsection{The environment}
+
+Available \MontreCode{keys} are :
+
+\begin{itemize}
+ \item \MontreCode{height} : height of the window (auto or specific) ; \MontreCode{auto} by default
+ \item \MontreCode{width} : width of the window ; \MontreCode{7cm} by default
+ \item \MontreCode{margin} : margin (L or R) for the bubble \MontreCode{1.5cm} by default
+ \item \MontreCode{color} : \textit{main} color (banner) ; \MontreCode{teal!75!cyan!75!white} by default ;
+ \item \MontreCode{colback} : color for background ; \MontreCode{lightgray!5} by default
+ \item \MontreCode{colorin} : color for incoming SMS ; \MontreCode{lime!25} by default
+ \item \MontreCode{colorout} : color for outcoming SMS ; \MontreCode{teal!25} by default
+ \item \MontreCode{writetxt} : text of sending zone ; \MontreCode{Write} by default
+ \item \MontreCode{fonttxt} : bubble's font ; \MontreCode{\textbackslash normalfont} by default
+ \item \MontreCode{avatar} : avatar of contact ; \MontreCode{\textbackslash faAddressCard} by default
+ \item \MontreCode{dispavatar} : boolean for displaying avatar near the bubbles ; \MontreCode{false} by default
+ \item \MontreCode{blackwhite} : boolean pour black\&white. \MontreCode{false} by default
+\end{itemize}
+
+The argument, mandatory and between \MontreCode{(...)} give the name of the contact.
+
+\subsection{Macros for the bubbles}
+
+Regarding the bubble creation commands, \MontreCode{\textbackslash InSMS} and \MontreCode{\textbackslash OutSMS}:
+
+\begin{itemize}
+ \item the \textit{starred} version does not display the \textit{checkmarks} of \textit{good reception};
+ \item the first mandatory argument is the time to display ;
+ \item the second mandatory argument is the message to display (including multi-lines).
+\end{itemize}
+
+\subsection{Examples}
+
+\begin{demohigh}[language=latex/latex3,style/main=teal!25,style/code=teal!25]
+%with a personal image
+\begin{ChatSMS}%
+ [width=6cm,fonttxt=\sffamily,height=10cm,avatar=img/android,dispavatar]{CP}
+ \InSMS{19:23}{Hi !}
+ \OutSMS{19:23}{Hi !\\ How are you ?}
+ \InSMS{19:25}{Just a problem with a math question\ldots}
+ \OutSMS{19:26}{Wanna help ??}
+ \InSMS{19:28}{Yes, I need to compute $\mathsf{\int_{0}^{1} x^2e^{-x}\,dx}$\ldots}
+ \OutSMS*{19:30}{Take care !!}
+\end{ChatSMS}
+\end{demohigh}
+
+\begin{demohigh}[language=latex/latex3,style/main=teal!25,style/code=teal!25]
+\begin{ChatSMS}%
+ [width=8cm,fonttxt=\sffamily,avatar=\faCanadianMapleLeaf,blackwhite]{CP}
+ \InSMS{19:23}{Hi !}
+ \OutSMS{19:23}{Hi !\\ How are you ?}
+ \InSMS{19:25}{Just a problem with a math question\ldots}
+ \OutSMS{19:26}{Wanna help ??}
+ \InSMS{19:28}{Yes, I need to compute $\mathsf{\int_{0}^{1} x^2e^{-x}\,dx}$\ldots}
+ \OutSMS*{19:30}{Take care !!}
+\end{ChatSMS}
+\end{demohigh}
+
\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.pdf b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.pdf
index c81bd43b7f7..87d7507f613 100644
--- a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.pdf
+++ b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.tex b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.tex
index 650bb37932e..9cdaeadf73d 100644
--- a/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.tex
+++ b/Master/texmf-dist/doc/latex/customenvs/customenvs-doc-fr.tex
@@ -39,9 +39,9 @@
\usepackage[margin=1.5cm]{geometry}
\setlength{\parindent}{0pt}
-\def\TPversion{0.1.3}
-\def\TPdate{30 mars 2024}
-\usepackage[most]{tcolorbox}
+\def\TPversion{0.1.4}
+\def\TPdate{4 avril 2024}
+\usepackage{tcolorbox}
\tcbuselibrary{listingsutf8}
\newtcblisting{DemoCode}[1]{%
enhanced,width=0.95\linewidth,center,%
@@ -66,10 +66,10 @@
keywordstyle={\color{violet}},%
classoffset=2,%
alsoletter={-},%
- morekeywords={\ReponsesQCM,MultiCols,\CreerListeItems,\ListeChoixItems,\TableauCompetences,\CrayonDeCompetences,\StyleEnvtExo,\StyleEnvtExoDefaut,\TitreExo,\ipsum},%
+ morekeywords={\ReponsesQCM,MultiCols,\CreerListeItems,\ListeChoixItems,\TableauCompetences,\CrayonDeCompetences,\StyleEnvtExo,\StyleEnvtExoDefaut,\TitreExo,\ipsum,EnvSMS,\SMSrec,\SMSenv},%
keywordstyle={\color{green!50!black}},%
classoffset=3,%
- morekeywords={Largeur,Filets,EspacesCL,NbCols,Labels,PoliceLabels,EspaceLabels,Swap,Type,CoeffEspVert,EpTrait,Alea,LargeurNivs,Niveaux,NoticeNiveaux,Titre,PolTitre,PolNotice,PolComp,LigneSep,CouleurNotice,CouleurNiveaux,CouleurFond,Note,Notice,PoliceCateg,PoliceBloc,Couleurs,LargeurBloc,Echelle,NoirBlanc,Libelle,EpTrait,Police,Type,ComplementTitre,Titre,CodeDebut,Couleur,EchelleImage,Decoration,Trait},%
+ morekeywords={Largeur,Filets,EspacesCL,NbCols,Labels,PoliceLabels,EspaceLabels,Swap,Type,CoeffEspVert,EpTrait,Alea,LargeurNivs,Niveaux,NoticeNiveaux,Titre,PolTitre,PolNotice,PolComp,LigneSep,CouleurNotice,CouleurNiveaux,CouleurFond,Note,Notice,PoliceCateg,PoliceBloc,Couleurs,LargeurBloc,Echelle,NoirBlanc,Libelle,EpTrait,Police,Type,ComplementTitre,Titre,CodeDebut,Couleur,EchelleImage,Decoration,Trait,Avatar,AffAvatar,NoirBlanc,CouleurE,CouleurR,CouleurFond,Hauteur,Largeur,PoliceTxt,CouleurTitre},%
keywordstyle={\color{orange}}
},%
#1
@@ -788,6 +788,88 @@ L'argument, obligatoire et entre \MontreCode{\{...\}} est la liste des catégori
\pagebreak
+\section{Fenêtre type conversation instantanée}
+
+\subsection{Principe et fonctionnement}
+
+L'idée est de proposer un environnement pour créer une fenêtre type \textit{conversation instantanée}, basée sur \MontreCode{tcolorbox}.
+
+\begin{DemoCode}{listing only}
+\begin{EnvSMS}[Clés]{nom}
+ \SMSrec(*){heure}{msg}
+ \SMSenv(*){heure}{msg}
+\end{EnvSMS}
+\end{DemoCode}
+
+\begin{DemoCode}{}
+\begin{EnvSMS}{\LaTeX}
+ \SMSrec{19:23}{Salut !}
+ \SMSenv{19:23}{Salut!\\ Comment ça va~?}
+\end{EnvSMS}
+\end{DemoCode}
+
+La forme générale est fixée, et seuls quelques éléments de personnalisation(s) sont modifiables.
+
+\subsection{L'environnement}
+
+Les \MontreCode{clés} disponibles pour l'environnement, à donner entre \MontreCode{[...]}, sont :
+
+\begin{itemize}
+ \item \MontreCode{Hauteur} : hauteur de la fenêtre (automatique ou spécifique) ; \MontreCode{auto} par défaut
+ \item \MontreCode{Largeur} : largeur de la fenêtre (un minimum de 5 cm est conseillé) ; \MontreCode{7cm} par défaut
+ \item \MontreCode{Marge} : marge (G ou D) pour les bulles \MontreCode{1.5cm} par défaut
+ \item \MontreCode{Couleur} : couleur \textit{principale} (bandeau) ; \MontreCode{teal!75!cyan!75!white} par défaut ;
+ \item \MontreCode{CouleurFond} : couleur du fond ; \MontreCode{lightgray!5} par défaut
+ \item \MontreCode{CouleurR} : couleur des bulles de réception ; \MontreCode{lime!25} par défaut
+ \item \MontreCode{CouleurE} : couleur des bulles d'envoi ; \MontreCode{teal!5} par défaut
+ \item \MontreCode{TxtEcrire} : texte dans la zone d'envoi ; \MontreCode{Écrire} par défaut
+ \item \MontreCode{PoliceTxt} : police des textes ; \MontreCode{\textbackslash normalfont} par défaut
+ \item \MontreCode{Avatar} : avatar du contact ; \MontreCode{\textbackslash faAddressCard} par défaut
+ \item \MontreCode{AffAvatar} : booléen pour ajouter l'avatar aux bulles de réception ; \MontreCode{false} par défaut
+ \item \MontreCode{NoirBlanc} : booléen pour forcer un affichage N\&B. \MontreCode{false} par défaut
+\end{itemize}
+
+L'argument, obligatoire et entre \MontreCode{\{...\}}, est le nom du contact à afficher.
+
+\subsection{Les commandes de création des bulles}
+
+En ce qui concerne les commandes de création des bulles, \MontreCode{\textbackslash SMSrec} et \MontreCode{\textbackslash SMSenv} :
+
+\begin{itemize}
+ \item la version \textit{étoilée} n'affiche pas les \textit{coches} de \textit{bonne réception} ;
+ \item le premier argument obligatoire est l'heure à afficher ;
+ \item le deuxième argument obligatoire est le message à afficher (y compris multi-lignes).
+\end{itemize}
+
+\subsection{Exemples}
+
+\begin{DemoCode}{}
+%avec une image personnelle
+\begin{EnvSMS}%
+ [Largeur=5cm,Hauteur=13cm,AffAvatar,Avatar=Image/avatar]{CP}
+ \SMSrec{19:23}{Salut !}
+ \SMSenv{19:23}{Salut!\\ Comment ça va~?}
+ \SMSrec{19:25}{Je n'arrive pas à un truc en maths\ldots}
+ \SMSenv{19:26}{Tu veux un coup de main ??}
+ \SMSrec{19:28}{Oui, faut qu'je calcule $\int_{0}^{1} x^2e^{-x}\,dx$\ldots}
+ \SMSenv*{19:30}{Je m'en occupe !!}
+\end{EnvSMS}
+\end{DemoCode}
+
+\begin{DemoCode}{}
+\begin{EnvSMS}%
+ [Largeur=8cm,PoliceTxt=\sffamily,NoirBlanc]{CP}
+ \SMSrec{19:23}{Salut !}
+ \SMSenv{19:23}{Salut!\\ Comment ça va~?}
+ \SMSrec{19:25}{Je n'arrive pas à un truc en maths\ldots}
+ \SMSenv{19:26}{Tu veux un coup de main ??}
+ \SMSrec{19:28}{Oui, faut que je calcule $\mathsf{\int_{0}^{1} x^2e^{-x}\,dx}$\ldots}
+ \SMSenv*{19:30}{Je m'en occupe !!}
+\end{EnvSMS}
+\end{DemoCode}
+
+\pagebreak
+
\section{Titre d'exercices}
\subsection{Principe et définition du style global}
diff --git a/Master/texmf-dist/doc/latex/customenvs/envtexo_exemples.tex b/Master/texmf-dist/doc/latex/customenvs/envtexo_exemples.tex
index bc9bf990f75..2daa1951791 100644
--- a/Master/texmf-dist/doc/latex/customenvs/envtexo_exemples.tex
+++ b/Master/texmf-dist/doc/latex/customenvs/envtexo_exemples.tex
@@ -77,4 +77,4 @@
\ipsum<Lang=FR,Type=sent>
-\end{document}
+\end{document} \ No newline at end of file