Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:texte:paragraphes:encadrer_du_texte [2016/10/18 22:26] – jejust
+++ 3_composition:texte:paragraphes:encadrer_du_texte [2022/06/30 19:22] (Version actuelle) – [L'extension awesomebox] dbitouze
@@ Ligne 1: / Ligne 1: @@
-====== Comment encadrer du texte~?} ======
+====== Comment encadrer du texte? ======
+===== Avec la commande de base \fbox =====
-$Reponse$  Une solution consiste à définir un tableau d'une seule
+La commande ''\fbox'' met son argument dans une boîte (comme ''\parbox'') puis dessine un cadre autour :
-cellule.
+<WRAP column 40ex>
+<code latex>
+Je souhaite \fbox{encadrer} un mot
+dans un paragraphe.
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=9cm,height=1cm]{geometry}
+\pagestyle{empty}
+\begin{document}
+Je souhaite \fbox{encadrer} un mot dans un paragraphe.
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
-$Reponse$  On peut aussi utiliser~:
+Mais attention : tout le texte passé à la commande va se retrouver sur une seule ligne, sans coupure de mot possible !
+Pour encadrer tout un paragraphe, une solution est de le placer dans un environnement ''minipage'' :
+<WRAP column 40ex>
 <code latex>
+\fbox{%
+\begin{minipage}{0.75\textwidth}
+   Je souhaite encadrer tout un
+   paragraphe, sur plusieurs lignes.
+\end{minipage}
+}
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=9cm,height=7cm]{geometry}
+\usepackage{microtype}
+\pagestyle{empty}
+\begin{document}
-\fbox{
+\fbox{%
-\begin{minipage}{0.7\textwidth}
+\begin{minipage}{0.75\textwidth}
-   Texte...
+   Je souhaite encadrer tout un
+   paragraphe, sur plusieurs lignes.
 \end{minipage}
+}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear/>
+La commande \fbox est soumise à quelques paramètres : par exemple, l'épaisseur du trait et l'espace entre le texte et le trait est défini respectivement par les longueurs ''\fboxrule'' et ''\fnboxsep'' :
+<WRAP column 40ex>
+<code latex>
+Je souhaite \fbox{encadrer} un mot
+dans un paragraphe.
+{% Cette paire d'accolades permet
+ % que la modification n'ait
+ % qu'un effet local.
+ \setlength{\fboxrule}{2pt}
+ Je souhaite \fbox{encadrer} un mot
+ dans un paragraphe.
+}
+{%
+ \setlength{\fboxsep}{1.5ex}
+ Je souhaite \fbox{encadrer} un mot
+ dans un paragraphe.
 }
 </code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=9cm,height=7cm]{geometry}
+\pagestyle{empty}
+\begin{document}
+Je souhaite \fbox{encadrer} un mot
+dans un paragraphe.
+{% Cette paire d'accolades permet
+ % que la modification n'ait
+ % qu'un effet local.
+ \setlength{\fboxrule}{2pt}
+ Je souhaite \fbox{encadrer} un mot
+ dans un paragraphe.
+}
-$Reponse$  On peut également se définir son propre environnement. Voir
+{%
-le source~\vref{fmpage}.
+ \setlength{\fboxsep}{1.5ex}
+ Je souhaite \fbox{encadrer} un mot
+ dans un paragraphe.
+}
-\begin{file}{fmpage.sty}{fmpage}
+\end{document}
-\newsavebox{\fmbox}
+</latexdoc>
-\newenvironment{fmpage}[1]
+</WRAP>
-    {\begin{lrbox}{\fmbox}\begin{minipage}{#1}}
+<WRAP clear/>
-    {\end{minipage}\end{lrbox}\fbox{\usebox{\fmbox}}}
-\end{file}
+===== Avec l'environnement tabular =====
-Utilisation de l'environnement définit par ''fmpage.sty''
+Avoir du texte encadré revient à avoir un tableaau avec une unique cellule :
-<code latex>
-\input{faq.fmpage.sty}
+<WRAP column 40ex>
-\begin{fmpage}{3cm}
+<code latex>
-   Texte à encadrer dans une bo\^ite ne
+\begin{tabular}{|p{5cm}|}
-   dépassant pas 3 centimètres de large.
+\hline
-\end{fmpage}
+On ne dirait pas, mais il s'agit
+ici d'un tableau. \\
+\hline
+\end{tabular}
 </code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=9cm,height=7cm]{geometry}
+\pagestyle{empty}
+\begin{document}
+\begin{tabular}{|p{5cm}|}
+\hline
+On ne dirait pas, mais il s'agit ici d'un tableau. \\
+\hline
+\end{tabular}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear/>
-$Reponse$  Il existe également le package [[ctanpkg>fancybox|fancybox]], disponible sur
+===== Exemples avancés avec d'autres extensions =====
-https://www.ctan.org/{macros/latex/contrib/seminar/inputs/}, qui définit
-des fonctions telles que ''shadowbox'', ''doublebox'', ''ovalbox'',
-etc.
+Les méthodes ci-dessous fournissent des cadres d'apparence très classique.
+D'autres extensions dessinent des cadres adaptés à des documents
+au look plus moderne, avec couleurs et icônes.
+Certaines extensions permettent également d'encadrer des pages entières,
+ou des blocs de texte s'étendant sur plusieurs pages.
+==== L'extension fancybox ====
+L'extension [[ctanpkg>fancybox]] définit des commandes telles que ''\shadowbox'', ''\doublebox'' et ''\ovalbox'', qui fonctionnent de la même manière que ''\fbox'' ci-dessus :
+<WRAP column 40ex>
 <code latex>
+\usepackage{fancybox}
 \shadowbox{Texte ombré.}
@@ Ligne 55: / Ligne 162: @@
   aux coins arrondis.}
 </code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=9cm,height=7cm]{geometry}
+\usepackage{fancybox}
+\pagestyle{empty}
+\begin{document}
+\shadowbox{Texte ombré.}
+\smallskip
+\doublebox{Texte doublement encadré.}
+\smallskip
-$Reponse$  Le package [[ctanpkg>boxedminipage|boxedminipage]] est un vieux style <latex>\LaTeX</latex>2.09
+\ovalbox{Texte dans un cadre
-disponible sur https://www.ctan.org/{macros/latex209/contrib/misc/}.
+  aux coins arrondis.}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+==== L'extension awesomebox ====
-$Reponse$  Voir également le package [[ctanpkg>hhflxbox|hhflxbox]] disponible sur
+L'extension [[ctanpkg>awesomebox]] ne dessine pas de cadres à proprement parler,
-https://www.ctan.org/{usergrps/uktug/baskervi/5_5/}.
+mais peut mettre en valeur un bloc de texte avec une icône et un filet coloré:
-%\url{ftp://ftp.fdn.fr/pub/not-on-CTAN/macros/latex/contrib/hh/}.
+<WRAP column 45ex>
+<code latex>
+\documentclass{article}
+  \usepackage{awesomebox}
-$Reponse$  Le package [[ctanpkg>niceframe|niceframe]] disponible sur
+\begin{document}
-https://www.ctan.org/{macros/latex/contrib/niceframe/} permet de
-définir des cadres pleine page.
+\notebox{Notez bien ceci !}
+\smallskip
-$Reponse$  Pour encadrer un texte pouvant s'étendre sur plusieurs pages, on
+\importantbox{Lisez bien ce paragraphe
-peut utiliser l'environnement ''breakbox'' du package [[ctanpkg>boites|boites]]
+avant de passer à la suite de ce document
-disponible sur https://www.ctan.org/{macros/latex/contrib/boites/}.
+sinon, vous risquez de perdre votre temps
+en considérations inutiles !}
+\end{document}
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+  \usepackage[width=9cm,height=7cm]{geometry}
+  \usepackage{awesomebox}
+  \pagestyle{empty}
-Le package [[ctanpkg>boitesexemples|boitesexemples]] disponible au même endroit, définit les
+\begin{document}
-environnements ''boiteepaisseavecuntitre'',
-''boitenumeroteeavecunedoublebarre''
-''boiteavecunelignequiondulesurlecote'' et ''boitecoloriee'' qui
-proposent différentes méthodes d'encadrement.
-\begin{descrcmd}
+\notebox{Notez bien ceci !}
-  \item[bkcounttrue] les lignes sont numérotées ;
+\smallskip
-  \item[bkcountfalse] elles ne le sont pas (défaut).
-\end{descrcmd}
-On peut emboîter ces environnements.
+\importantbox{Lisez bien ce paragraphe
+avant de passer à la suite de ce document
+sinon, vous risquez de perdre votre temps
+en considérations inutiles !}
+\smallskip
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear/>
+[[ctanpkg>awesomebox|Awesomebox]] a cinq dessins de base,
+utilisables sous forme d'une commande ou d'un environnement:
+^ Pour...   ^ Commande  ^ Environnement  ^ Exemple  ^
+| Une note  | ''\notebox'' | ''\begin{noteblock}''...''\end{noteblock}''  | <latexdoc>\documentclass[6pt]{extarticle}\usepackage{awesomebox}\pagestyle{empty}\begin{document}\notebox{Marcel se couche de bonne heure.}\end{document}</latexdoc>  |
+| Une suggestion  | ''\tipbox'' | ''\begin{tipblock}''...''\end{tipblock}''  | <latexdoc>\documentclass[6pt]{extarticle}\usepackage{awesomebox}\pagestyle{empty}\begin{document}\tipbox{Marcel se couche de bonne heure.}\end{document}</latexdoc>  |
+| Un avertissement  | ''\warningbox'' | ''\begin{warningblock}''...''\end{warningblock}''  | <latexdoc>\documentclass[6pt]{extarticle}\usepackage{awesomebox}\pagestyle{empty}\begin{document}\warningbox{Marcel se couche de bonne heure.}\end{document}</latexdoc>  |
+| Une mise en garde  | ''\cautionbox'' | ''\begin{cautionblock}''...''\end{cautionblock}''  | <latexdoc>\documentclass[6pt]{extarticle}\usepackage{awesomebox}\pagestyle{empty}\begin{document}\cautionbox{Marcel se couche de bonne heure.}\end{document}</latexdoc>  |
+| Une remarque importante  | ''\importantbox'' | ''\begin{importantblock}''...''\end{importantblock}''  | <latexdoc>\documentclass[6pt]{extarticle}\usepackage{awesomebox}\pagestyle{empty}\begin{document}\importantbox{Marcel se couche de bonne heure.}\end{document}</latexdoc>  |
+<note tip>
+Il est également très facile de définir vos propres boîtes avec la commande
+''\awesomebox''. Les icônes peuvent être choisies parmi celles de l'extension
+[[ctanpkg>fontawesome5]], et vous pouvez mettre des filets horizontaux avant
+et/ou après votre bloc de texte:
+<WRAP clear />
+<code latex>
+\documentclass{article}
+  \usepackage{awesomebox}
+\begin{document}
+\awesomebox[white][\abShortLine]{0pt}{\faGrinBeam[regular]}{pink}{Ceci va vous rendre heureux\dots}
+\end{document}
+</code>
+</note>
+==== L'extension tcolorbox ====
+L'extension [[ctanpkg>tcolorbox]] utilise [[ctanpkg>tikz|TikZ/PGF]]
+pour dessiner ses cadres.
+Si vous avez l'habitude de Ti//k//Z, vous apprécierez la syntaxe clefs-valeurs
+qui permet de paramétrer finement l'apparence des cadres (couleurs, formes,
+structures...).
+À cause de ses possibilités de configuration immenses, [[texdoc>tcolorbox|sa documentation]]
+fait plus de 500 pages (en anglais).
+Mais les deux exemples ci-dessous montrent qu'il n'est vraiment pas compliqué
+de dessiner des cadres déjà adaptés à pas mal de circonstances,
+et les nombreuses illustrations de la documentation devraient vous aider à aller plus loin:
+<WRAP column 50ex>
+<code latex>
+\documentclass{article}
+  \usepackage{tcolorbox}
+\begin{document}
+\begin{tcolorbox}
+Le cadre par défaut
+\end{tcolorbox}
+\smallskip
+\begin{tcolorbox}[colback=red!5!white,
+                  colframe=red!75!black,
+                  title=Cadre sexy
+                 ]
+Un autre cadre \textbf{plus coloré}, séparé
+en deux parties, et portant un titre.
+\tcblower
+Demain, \textit{j'enlève le bas}.
+\end{tcolorbox}
+\end{document}
+</code>
+</WRAP>
+<WRAP column 40ex>
+<latexdoc>
+\documentclass{article}
+  \usepackage[width=6cm,height=6cm]{geometry}
+  \usepackage{microtype}
+  \usepackage[french]{babel}
+  \usepackage{tcolorbox}
+  \pagestyle{empty}
+\begin{document}
+\begin{tcolorbox}
+Le cadre par défaut
+\end{tcolorbox}
+\smallskip
+\begin{tcolorbox}[colback=red!5!white,
+                  colframe=red!75!black,
+                  title=Cadre sexy
+                 ]
+Un autre cadre \textbf{plus coloré}, séparé
+en deux parties, et portant un titre.
+\tcblower
+Demain, \textit{j'enlève le bas}.
+\end{tcolorbox}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+==== L'extension boites ====
+Pour encadrer un texte pouvant s'étendre sur plusieurs pages, on peut utiliser l'environnement ''breakbox''
+de l'extension [[ctanpkg>boites]]. Cette extension définit également, par le biais du fichier
+''boites_exemples.sty'' (à charger car [[ctanpkg>boites]] ne le précharge pas),
+des environnements qui proposent différentes méthodes d'encadrement :
+  * ''boiteepaisseavecuntitre'' ;
+  * ''boitenumeroteeavecunedoublebarre'' ;
+  * ''boiteavecunelignequiondulesurlecote'' ;
+  * et ''boitecoloriee''.
+Ces environnements peuvent tous être modifiés par deux commandes   :
+  * ''bkcounttrue'' qui numérote les lignes de ces boîtes ;
+  * ''bkcountfalse'' qui ne les numérote plus (option par défaut).
+Il est également possible d'emboîter ces environnements.
+==== L'extension niceframe ====
+L'extension [[ctanpkg>niceframe]] permet de définir des cadres pleine page.
+FIXME Détailler [[ctanpkg>nieframe]].
+==== L'extension boxedminipage ====
+L'extension [[ctanpkg>boxedminipage]] correspond à un vieux style <latex>\LaTeX</latex> 2.09 qui a été actualisé.
+FIXME Détailler [[ctanpkg>boxedminipage]].
+==== L'extension bclogo ====
+FIXME Détailler [[ctanpkg>bclogo]].
+===== Avec des environnements « faits maison » =====
+Les extensions présentées ci-dessus sont évidemment bien plus plus puissantes
+mais, à titre pédagogique, voici un exemple d'environnement « fait main »
+pour encadrer des paragraphes de texte :
+<file latex fmpage.sty>
+\newsavebox{\fmbox}
+\newenvironment{fmpage}[1]
+    {\begin{lrbox}{\fmbox}\begin{minipage}{#1}}
+    {\end{minipage}\end{lrbox}\fbox{\usebox{\fmbox}}}
+</file>
+Et voici un exemple d'utilisation de ce fichier :
+<WRAP column 40ex>
+<code latex>
+\input{fmpage.sty}
+\begin{fmpage}{3cm}
+   Texte à encadrer dans une boîte
+   ne dépassant pas 3 centimètres
+   de large.
+\end{fmpage}
+</code>
+</WRAP>
+<WRAP column 30x>
+<latexdoc>
+\documentclass{article}
+\usepackage[width=6cm,height=7cm]{geometry}
+\pagestyle{empty}
+\newsavebox{\fmbox}
+\newenvironment{fmpage}[1]
+    {\begin{lrbox}{\fmbox}\begin{minipage}{#1}}
+    {\end{minipage}\end{lrbox}\fbox{\usebox{\fmbox}}}
+\begin{document}
+\begin{fmpage}{3cm}
+   Texte à encadrer dans une boîte
+   ne dépassant pas 3 centimètres
+   de large.
+\end{fmpage}
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear/>
+{{htmlmetatags>metatag-keywords=(LaTeX,entourer du texte,mettre un cadre,dessiner un cadre,dessiner des filets)
+metatag-og:title=(Comment encadrer du texte)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}