diff options
author | Karl Berry <karl@freefriends.org> | 2020-07-05 20:54:40 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-07-05 20:54:40 +0000 |
commit | 52b71425066d8e4015ed93679940bedbf7d69e3a (patch) | |
tree | 33bc2a4139c66120ae365c9ab7e6755609c0c862 /Master/texmf-dist/doc/latex | |
parent | 89f4d0db57dc9feccb7bfc85ebf5a6827a907cc5 (diff) |
cascade (5jul20)
git-svn-id: svn://tug.org/texlive/trunk@55759 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/cascade/README.md | 29 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/cascade/cascade-french.pdf | bin | 0 -> 65039 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/cascade/cascade-french.tex | 310 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/cascade/cascade.pdf | bin | 74417 -> 108503 bytes |
4 files changed, 335 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/cascade/README.md b/Master/texmf-dist/doc/latex/cascade/README.md index a92779e26c5..a124aabb105 100644 --- a/Master/texmf-dist/doc/latex/cascade/README.md +++ b/Master/texmf-dist/doc/latex/cascade/README.md @@ -1,8 +1,29 @@ -The LaTeX extension nicematrix is distributed under the LPPL 1.3 license. +# Readme for the package cascade -This extension has been written by F. Pantigny (fpantigny@wanadoo.fr). +Author: F. Pantigny (`fpantigny@wanadoo.fr`). -This extension is entirely contained in a single file : cascade.sty +CTAN page: `https://ctan.org/pkg/nicematrix` -The LaTeX package cascade provides a command \Cascade to do contructions to present mathematical +## License +The LaTeX extension `cascade` is distributed under the LPPL 1.3 license. + +## Presentation + + +The LaTeX package `cascade` provides a command `\Cascade` to do contructions to present mathematical demonstrations with successive braces for the deductions. + + +## Installation + +The package `cascade` is present in the distributions MiKTeX, TeXLive and MacTeX. + +For a manual installation: + +* put the files `cascade.ins` and `cascade.dtx` in the same directory; +* run `latex cascade.ins`. + +The file `cascade.sty` will be generated. + +The file `cascade.sty` is the only file necessary to use the extension `cascade`. +You have to put it in the same directory as your document or (best) in a `texmf` tree. diff --git a/Master/texmf-dist/doc/latex/cascade/cascade-french.pdf b/Master/texmf-dist/doc/latex/cascade/cascade-french.pdf Binary files differnew file mode 100644 index 00000000000..223217e4a6f --- /dev/null +++ b/Master/texmf-dist/doc/latex/cascade/cascade-french.pdf diff --git a/Master/texmf-dist/doc/latex/cascade/cascade-french.tex b/Master/texmf-dist/doc/latex/cascade/cascade-french.tex new file mode 100644 index 00000000000..bc0115099c8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/cascade/cascade-french.tex @@ -0,0 +1,310 @@ +% -*- coding: utf-8 ; -*- +\documentclass[dvipsnames]{article}% dvipsnames is for xcolor (loaded by Tikz, loaded by nicematrix) +\usepackage{xltxtra} +\usepackage[french]{babel} +\frenchsetup{og = « , fg = »} + +\usepackage{xcolor} +\usepackage{tikz} +\usetikzlibrary{calc} +\usepackage{geometry} +\geometry{left=2.8cm,right=2.8cm,top=2.5cm,bottom=2.5cm,papersize={21cm,29.7cm}} + +\usepackage{cascade} + + +\usepackage{enumitem} +\usepackage{verbatim} +\usepackage{amsmath} + +% We use \MakeShortVerb of shortvrb and not \DefineShortVerb of fancyvrb +% because we don't want the contents of short verbatim colored in gray +\usepackage{shortvrb} +\MakeShortVerb{\|} + +\setlength{\fboxsep}{0pt} + +\usepackage{fancyvrb} +\fvset{commandchars=\~\#\@,formatcom=\color{gray}} + +\usepackage{titlesec} +\titlespacing*{\section}{0pt}{6.5ex plus 1ex minus .2ex}{4.3ex plus .2ex} +\titlespacing*{\subsection}{0pt}{4.5ex plus 1ex minus .2ex}{2ex plus .2ex} + + +\def\interitem{\vspace{7mm plus 2 mm minus 3mm}} +\def\emphase{\bgroup\color{RoyalPurple}\let\next=} + +\usepackage{footnote} + +\usepackage{varwidth} + +\usepackage[hyperfootnotes = false]{hyperref} + +\hypersetup + { + pdfinfo = + { + Title = L’extension cascade , + Subject = Une extension LaTeX , + Author = F. Pantigny + } + } + + +\NewDocumentEnvironment {scope} {} {} {} + +\NewDocumentCommand {\pkg} {m} {\textsf{#1}} +\NewDocumentCommand {\cls} {m} {\textsf{#1}} + +\setlength{\parindent}{0pt} + + +\begin{document} + +\VerbatimFootnotes + + +\title{L'extension LaTeX \pkg{cascade}\thanks{Ce document correspond à la +version~\myfileversion\space of \pkg{cascade}, à la date du~\myfiledate.}} +\author{F. Pantigny \\ \texttt{fpantigny@wanadoo.fr}} + +\maketitle + +\begin{abstract} +L'extension LaTeX \pkg{cascade} fournit une commande |\Cascade| pour faire des +constructions qui présentent des démonstrations mathématiques avec des accolades +enchaînées pour les déductions. +\end{abstract} + + + +\vspace{1cm} +\section{Présentation} + +L'extension \pkg{cascade} fournit une commande |\Cascade| qui permet des +constructions comme la suivante, où la taille de l'accolade de droite est +calculée sur seulement une partie des éléments LaTeX composés à gauche. +\begin{center} +\Cascade{$\det(A) = \begin{vmatrix}3&4\\ -1&7\end{vmatrix}\neq 0$}% + {et, par conséquent, $A$ est inversible}% + {}% + {or $AX=Y$} +donc, $X = A^{-1}Y$ +\end{center} + +\medskip +\begin{Verbatim} +~emphase#\Cascade@{$\det(A) = \begin{vmatrix}3&4\\ -1&7\end{vmatrix}\neq 0$}% + {et, par conséquent, $A$ est inversible}% + {}% + {or $AX=Y$} +donc, $X = A^{-1}Y$ +\end{Verbatim} + + +\interitem +La commande |\Cascade| prend ses quatre arguments comme suit : +\begin{center} +\Cascade{\fbox{\hbox to 2cm{\vrule height 18 pt depth 5 pt width 0pt\hfil \texttt{\#1}\hfil}}}% +{\fbox{\hbox to 3cm{\vrule height 10 pt depth 12 pt width 0pt\hfil \texttt{\#2}\hfil}}}% +{\fbox{\hbox to 2.5cm{\vrule height 15 pt depth 14 pt width 0pt\hfil \texttt{\#3}\hfil}}}% +{\fbox{\hbox to 1.7cm{\vrule height 12 pt depth 5 pt width 0pt\hfil \texttt{\#4}\hfil}}} +\end{center} + +\interitem +Les commandes |\Cascade| peuvent être imbriquées comme dans l'exemple suivant : +\begin{center} +\Cascade{\ShortCascade{$(BH) \perp (AC)$}{$(OC) \perp (AC)$}} + {or\enskip $(BH) \parallel (OC)$} + {\ShortCascade{$(CH) \perp (AB)$}{$(OB) \perp (AB)$}} + {or\enskip $(CH) \parallel (OB)$} +donc $(OBHC)$ est un parallélogramme +\end{center} + +\interitem +Pour la lisibilité de ces constructions, une version simplifiée de |\Cascade| +est disponible, nommée |\ShortCascade|. + + +Le code |\ShortCascade{X}{Y}| est simplement un raccourci pour le code +|\Cascade{}{X}{}{Y}|. + +\medskip +L'exemple précédent peut être codé avec deux commandes |\ShortCascade| +et une commande |\Cascade| englobante. +\begin{Verbatim} +~emphase#\Cascade@{~emphase#\ShortCascade@{$(BH) \perp (AC)$} + {$(OC) \perp (AC)$}} + {or\enskip $(BH) \parallel (OC)$} + {~emphase#\ShortCascade@{$(CH) \perp (AB)$} + {$(OB) \perp (AB)$}} + {or\enskip $(CH) \parallel (OB)$} +donc $(OBHC)$ est un parallélogramme +\end{Verbatim} + + +\bigskip +\section{L'option t} + +Si on utilise l'option |t| sur la commande |\Cascade| englobante, une structure +complète de commandes |\Cascade| est alignée sur la ligne du haut. + +Quand cette clé |t| est utilisée, si on souhaite ajouter du texte après la +structure, on doit le placer entre chevrons pour que ce texte soit aligné avec +la dernière accolade. + + +\begin{Verbatim} +\begin{enumerate} +\item \Cascade~emphase#[t]@{\ShortCascade{$(BH) \perp (AC)$}{$(OC) \perp (AC)$}} + {or\enskip $(BH) \parallel (OC)$} + {\Cascade{}{$(CH) \perp (AB)$}{}{$(OB) \perp (AB)$}} + {or\enskip $(CH) \parallel (OB)$} + ~emphase#<donc $(OBHC)$ est un parallélogramme>@ +\end{enumerate} +\end{Verbatim} + + +\begin{enumerate} +\item \Cascade[t]{\ShortCascade{$(BH) \perp (AC)$}{$(OC) \perp (AC)$}} + {or\enskip $(BH) \parallel (OC)$} + {\Cascade{}{$(CH) \perp (AB)$}{}{$(OB) \perp (AB)$}} + {or\enskip $(CH) \parallel (OB)$} + <donc $(OBHC)$ est un parallélogramme> +\end{enumerate} + + + +\bigskip +\section{Autres options} + +\begin{itemize} +\item L'option |space-between| est une dimension LaTeX décrite sur la figure +suivante. Sa valeur initiale est de $0.5$~em. Elle s'applique à la commande +courante mais aussi à toutes les éventuelles commandes imbriquées dedans. + + +\item L'option |interline| peut être utilisée pour \emph{augmenter} +l'«interligne» +comme illustré sur la figure suivante. La valeur initiale de |interline| est de +$0$~pt et s'applique seulement à la commande |\Cascade| courante. + +\item L'option |interline-all| change la valeur initiale de |interline| utilisée +par la commande |\Cascade| courante mais aussi toutes les éventuelles commandes +|\Cascade| imbriquées. +\end{itemize} + +\vspace{1cm} + +\begin{center} +\Cascade{\fbox{\hbox to 2cm{\vrule height 18 pt depth 5 pt width 0pt\hfil \texttt{\#1}\hfil + \tikz[remember picture] \coordinate (one) at (0,0) ;}}}% +{\fbox{\vtop{\hbox to 3cm{\tikz[remember picture] \coordinate (two) at (0,0) ; + \vrule height 10 pt depth 12 pt width 0pt\hfil \texttt{\#2}\hfil} + \hbox{\tikz[remember picture] \coordinate (three) at (0,0) ;}}}}% +{\fbox{\vbox{\hbox{\tikz[remember picture] \coordinate (four) at (0,0) ;}% + \hbox to 2.5cm{\vrule height 15 pt depth 14 pt width 0pt\hfil \texttt{\#3}\hfil}}}}% +{\fbox{\hbox to 1.7cm{\vrule height 12 pt depth 5 pt width 0pt\hfil \texttt{\#4}\hfil}}} +\begin{tikzpicture}[remember picture,overlay,blue] +\draw (one) to ++(0,1cm) coordinate (A) to ++(0,2mm) ; +\draw (two) to ++(0,1cm) coordinate (B) to ++(0,2mm) ; +\draw (A) -- (B) ; +\draw[<-] (A) -- ++(-1mm,0) ; +\draw[<-] (B) -- ++(1mm,0) ; +\path (B) node [right=2mm] {\texttt{space-between}} ; +\draw (three) to ++(-3cm,0) coordinate (C) to ++(-2mm,0) ; +\draw (four) -| coordinate (D) (C) ; +\draw (D) to ++(-2mm,0) ; +\draw[<-] (C) -- ++(0,1mm) ; +\draw[<-] (D) -- ++(0,-1mm) ; +\path ($(C)!0.5!(D)$) node [left=2mm] {l'«interligne»} ; +\end{tikzpicture} +\end{center} + +\begin{Verbatim} +\Cascade[~emphase#interline=4mm@]{\ShortCascade{A}{B}}{E}{\ShortCascade{C}{D}}{F} G +\end{Verbatim} + +\begin{center} +\Cascade[interline=4mm]{\ShortCascade{A}{B}}{E}{\ShortCascade{C}{D}}{F} G +\end{center} + +\bigskip +\begin{Verbatim} +\Cascade[~emphase#interline-all=4mm@]{\ShortCascade{A}{B}}{E}{\ShortCascade{C}{D}}{F} G +\end{Verbatim} + +\begin{center} +\Cascade[interline-all=4mm]{\ShortCascade{A}{B}}{E}{\ShortCascade{C}{D}}{F} G +\end{center} + +\interitem +Ces options peuvent être fixées au niveau du document avec la commande +|\CascadeOptions|. Dans ce cas, la portée de ces déclarations est le groupe TeX +courant (ces déclarations sont, comme on dit parfois «semi-globales»). + + + +\bigskip +\section{Remarque technique} + +L'extension |\Cascade| est conçue pour fournir par défaut des résultats similaires +à ceux fournis par les environnements de l'\pkg{amsmath} (et de +\pkg{mathtools}), en particulier |{aligned}|. + + +\bigskip +\begin{BVerbatim}[baseline=c,boxwidth=10cm] +\[\left.\begin{aligned} +& A = \sqrt{a^2+b^2} \\ +& B = \frac{ax+b}{cx+d} +\end{aligned}\right\}\] +\end{BVerbatim} +$\left.\begin{aligned} +& A = \sqrt{a^2+b^2} \\ +& B = \frac{ax+b}{cx+d} +\end{aligned}\right\}$ + +\bigskip +\begin{BVerbatim}[baseline=c,boxwidth=10cm] +\ShortCascade{$\displaystyle A = \sqrt{a^2+b^2}$} + {$B = \dfrac{ax+b}{cx+d}$} +\end{BVerbatim} +\ShortCascade{$\displaystyle A = \sqrt{a^2+b^2}$}{$B = \dfrac{ax+b}{cx+d}$} + +\interitem +L'extension \pkg{cascade} construit les accolades avec la paire habituelle +|\left|-|\right| de TeX. Néanmoins, les délimiteurs extensibles, en TeX, ne +peuvent pas prendre toutes les tailles. On donne, dans l'exemple suivant, les +accolades obtenues en entourant des filets verticaux de $6$~mm à $17$~mm (le code +est en |expl3|). + +\begin{Verbatim} +\int_step_inline:nnnn 6 1 {17} { $\left.\hbox{\vrule height ~#1 mm}\right\}$\quad } +\end{Verbatim} + +\medskip +\begin{center} +\ExplSyntaxOn +\int_step_inline:nnnn 6 1 {17} { $\left.\hbox{\vrule height #1 mm}\right\}$\quad} +\ExplSyntaxOff +\end{center} + + +\section*{Autre documentation} + +Le document |cascade.pdf| (fourni avec l'extension \pkg{cascade}) contient une traduction anglaise de la +documentation ici présente, ainsi que le code source commenté et un historique des versions. + + + + + + +\end{document} + + + + + diff --git a/Master/texmf-dist/doc/latex/cascade/cascade.pdf b/Master/texmf-dist/doc/latex/cascade/cascade.pdf Binary files differindex 4ce09e99de2..b500b161715 100644 --- a/Master/texmf-dist/doc/latex/cascade/cascade.pdf +++ b/Master/texmf-dist/doc/latex/cascade/cascade.pdf |