Utilisation de madframed sans modifier ce package
[bclogo.git] / dev / doc / bclogo-doc.tex
index 686059f..664d547 100644 (file)
 \definecolor{vert}{RGB}{0,105,29}%
 \definecolor{bleu}{RGB}{78,88,169}%
 \usepackage[colorlinks, linkcolor=link,urlcolor=url]{hyperref}
-\usepackage{babel}
+\usepackage{numprint,babel}
 %
 \pagestyle{fancyplain}
 \renewcommand{\sectionmark}[1]{\markright{#1}}
 %\lhead[\fancyplain{}{\slshape\thepage}]{\fancyplain{}{\slshape\rightmark}}
 %\rhead[\fancyplain{}{\slshape\leftmark}]{\fancyplain{}{\slshape\thepage}}
 %\lhead{\chaptername}
-\lhead{\rightmark}
-\rhead{\textsl{bclogo v3.0}}
+\lhead{\rightmark}%
+\rhead{\textsl{bclogo v3.0}}%
 \lfoot{\footnotesize Maxime \textsc{Chupin} \& Patrick \textsc{Fradin}}%
 \cfoot{\footnotesize -- \url{http://melusine.eu.org/syracuse/G/bclogo/} -- }%
 \rfoot{\thepage/\pageref{LastPage}}%
@@ -82,8 +82,6 @@
 \VerbatimInput{toto.txt}%
 \end{footnotesize}%
 \end{bclogo}%
-\color{black}%
-\par%\goodbreak%
 \noindent\textbf{Résultat}:\par\smallskip
 \input{toto.txt}%
 }%
@@ -97,7 +95,7 @@
 \footnote{Merci à tous ceux qui ont participé, entre autres, Jean-Côme \textsc{Charpentier},
 Ulrike \textsc{Fischer} et Manuel \textsc{Pégourié-Gonnard}\dots et
 plus particulièrement à François \textsc{Pétiard}}\\\url{notezik@gmail.com}}
-\date{15 octobre 2011}
+\date{21 juillet 2012}
 
 \begin{document}
 %% === Page de garde ===================================================
@@ -134,8 +132,8 @@ plus particuli
 \begin{abstract}
 Cette extension pour le format \LaTeX\ permet la création, via \texttt{Pstricks} ou \texttt{Tikz}, de boîtes
 colorées avec un logo, un titre et une couleur de fond. Depuis la
-version 3.0, \texttt{bclogo} se base sur l'extension \texttt{mdframed}
-de Marco \bsc{Daniel} et Elke \bsc{Schubert} pour permettre aux boîtes
+version 3.0, \texttt{bclogo} se base sur l'extension \texttt{mdframed} (version 1.5 ou ultérieure) de 
+Marco \bsc{Daniel} et Elke \bsc{Schubert} pour permettre aux boîtes
 de se couper lors de changement de page.
 \end{abstract}
 \vspace*{4cm}
@@ -169,7 +167,7 @@ install
 \begin{multicols}{2}
 \begin{enum}
 \item \verb+Pstricks+
-\item \verb+mdframed+ (coupure des boîtes)
+\item \verb+mdframed+ (coupure des boîtes, version 1.5 ou plus)
 \item \verb+graphicx+
 \item \verb+pst-grad+
 \item \verb+xkeyval+
@@ -211,20 +209,20 @@ Quelle que soit l'option de chargement choisie, la syntaxe pour la cr
 
 \subsection{Coupure ou pas coupure?}
 
-Depuis la version 3.0, bclogo utilise le paquet \emph{mdframed} qui autorise les coupures de boîtes en fin de page (ce qui n'était pas le cas auparavant). Les macros de ce paquet liées à l'affichage des boîtes, ont été redéfinies pour ajouter le titre, le logo, la barre et l'ombre éventuelle. Ces modifications sont dans les fichiers \emph{bclogoMdframedTikz.tex} et \emph{bclogoMdframedPst.tex}, ceux-ci sont chargés juste après \emph{mdframed}.
+Depuis la version 3.0, bclogo utilise le paquet \emph{mdframed} (version 1.5 ou ultérieure) qui autorise les coupures de boîtes en fin de page (ce qui n'était pas le cas auparavant). Le paquet  \emph{mdframed} propose des macros permettant d'ajouter du code personnel pour l'affichage des boîtes, c'est ainsi que sont ajoutés le titre avec son logo, et la barre.
 
 \begin{demo}
-\begin{bclogo}[logo=\bcplume,couleur=AliceBlue,blur,epBord=0.8,couleurOmbre=gray,barre=wave,%
+\begin{bclogo}[logo=\bcplume,couleur=AliceBlue,ombre,epBord=0.8,barre=wave,%
                 couleurBarre=red]{Exemple de coupure}%
 \lipsum[1-13]
 \end{bclogo}
 \end{demo}
 
-La version 0.9 de \emph{mdframed} propose une option empêchant la coupure de la boîte, cette option est valable avec l'environnement \emph{bclogo}, c'est l'option 
+Depuis la version 0.9, \emph{mdframed} propose une option empêchant la coupure de la boîte, cette option est valable avec l'environnement \emph{bclogo}, c'est l'option 
 {\cmd\verb|nobreak=true/false|}. Par défaut sa valeur est \texttt{false}, ce qui autorise les coupures, pour les empêcher, il suffit de taper 
 {\cmd\verb|nobreak|} ou bien {\cmd\verb|nobreak=true|}.
 
-Si votre version de \emph{mdframed} est antérieure à la 0.9, nous vous recommandons vivement de la mettre à jour en téléchargeant la dernière version (archive Zip) sur le CTAN\footnote{\url{http://www.ctan.org/tex-archive/macros/latex/contrib/mdframed}}.
+Si votre version de \emph{mdframed} est antérieure à la 1.5, il vous faudra la mettre à jour en téléchargeant la dernière version (archive Zip) sur le CTAN\footnote{\url{http://www.ctan.org/tex-archive/macros/latex/contrib/mdframed}}.
 
 \section{Réglages des couleurs}
 
@@ -251,9 +249,8 @@ La couleur de la barre (noir par d
 
 \subsection{\'Epaisseur du bord}
 
-On peut (depuis la version 2.24) régler l'épaisseur du trait de bord (0.4pt par défaut) grâce à l'option
-{\cmd\verb|epBord=<valeur>|} (attention, ne pas mettre d'unité). Par
-exemple:
+On peut (depuis la version 2.24) régler l'épaisseur du trait de bord (\numprint[pt]{0.4} par défaut) grâce à l'option
+{\cmd\verb|epBord=<valeur>|} (attention, ne pas mettre d'unité). Par exemple:
 
 \begin{demo}
 \begin{bclogo}[logo=\bccrayon,epBord=0.2]{Mon titre}
@@ -318,7 +315,7 @@ marge droite de la page lorsque {\cmd\verb|noborder=true|} et que la marge ext
 Il est possible de laisser une marge à gauche de la boîte et une marge à droite de la boîte. Ces marges sont nulles par défaut et peuvent être mofiées par les options {\cmd\verb|margeG=<valeur>|} et {\cmd\verb|margeD=<valeur>|}, l'unité est le centimètre et ne doit pas être précisée. Ces valeurs peuvent être négatives. Exemple:
 
 \begin{demo}
-\begin{bclogo}[margeG=-1,margeD=1,couleur=blue!30,blur]{Modification marges}%
+\begin{bclogo}[margeG=-1,margeD=1,couleur=blue!30,ombre]{Modification marges}%
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
   et encore pour l'exemple, du texte qui se répète encore et encore pour l'exemple.
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
@@ -334,10 +331,10 @@ Il y a deux styles de titre. Celui par d
 {\cmd\verb|cadreTitre=false|}) est celui utilisé pour les boîtes précédentes. On
 peut cependant le modifier grâce à la commande:
 
-\hfil{\cmd\verb|\renewcommand\bcStyleTitre[1]{\hfill\large\textsl{#1}\hfill}|}\hfil
+\hfil{\cmd\verb|\renewcommand\bcStyleTitre[1]{\centering\large\textsl{#1}}|}\hfil
 
 Ce qui produit:
-\renewcommand\bcStyleTitre[1]{\hfill\large\textsl{#1}\hfill}
+\renewcommand\bcStyleTitre[1]{\centering\large\textsl{#1}}
 
 \begin{bclogo}[couleur=blue!30, arrondi=0.1]{Mon Titre}
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
@@ -354,7 +351,7 @@ Par d
 On peut alors s'amuser à toutes sortes de choses. En voici un exemple:
 
 \begin{demo}
-\renewcommand\bcStyleTitre[1]{\hfill\tikz\node[fill=blue!20,starburst,draw=black]{#1};\hfill}%
+\renewcommand\bcStyleTitre[1]{\centering\tikz\node[fill=blue!20,starburst,draw=black]{#1};}%
 \begin{bclogo}[noborder]{Mon Titre}%
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
   et encore pour l'exemple, du texte qui se répète encore et encore pour l'exemple.
@@ -431,7 +428,7 @@ Depuis la version 2.6\footnote{Dans les versions pr
 lequel on se trouve (d'où la nécessité de l'extension \verb+ifpdf+).
 
 La création de logo est un travail amusant, ceux qui veulent y participer n'ont
-qu'à me contacter par mail (les logos sont définis avec une largeur de 17pt, la
+qu'à me contacter par mail (les logos sont définis avec une largeur de \numprint[pt]{17}, la
 hauteur est plus ou moins libre dans la mesure du raisonnable).
 Si vous souhaitez participer à l'élaboration de logos,  fournissez moi soit un fichier \MP{}, soit un fichier
 \texttt{eps}.
@@ -560,18 +557,18 @@ mentionn
 \subsection{Taille des logos}
 
 On peut redéfinir la taille des logos en largeur. Par défaut celle-ci est de
-17pt. Cette redéfinition s'effectue de la manière suivante: {\cmd\verb|\renewcommand\logowidth{<valeur>pt}|}.
+\numprint[pt]{17}. Cette redéfinition s'effectue de la manière suivante: {\cmd\verb|\setlength{\logowidth}{<valeur>pt}|}.
 
-Par exemple, une redéfinition à 10pt donnera:
+Par exemple, une redéfinition à \numprint[pt]{10} donnera:
 
-\renewcommand\logowidth{10pt}
+\setlength{\logowidth}{10pt}
 \begin{bclogo}[couleur=blue!30,arrondi=0.1]{Mon Titre}
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
   et encore pour l'exemple, du texte qui se répète encore et encore pour l'exemple.
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
   et encore pour l'exemple, du texte qui se répète encore et encore pour l'exemple\dots
 \end{bclogo}
-\renewcommand\logowidth{17pt}
+\setlength{\logowidth}{17pt}
 
 \section{L'ombre}
 
@@ -590,9 +587,9 @@ commande {\cmd\verb|ombre=true|}. Par exemple:
 
 \subsection{Paramètres de l'ombre}
 
-\noindent\textbf{Épaisseur}: on règle l'épaisseur de l'ombre avec la commande {\cmd\verb|epOmbre=<valeur en cm>|}. La valeur par défaut est de 0.125 cm.
+\noindent\textbf{Épaisseur}: on règle l'épaisseur de l'ombre avec la commande {\cmd\verb|epOmbre=<valeur en cm>|}. La valeur par défaut est de \numprint[cm]{0.2}.
 
-\noindent\textbf{Couleur}: on règle la couleur avec la commande {\cmd\verb|couleurOmbre=<couleur>|}. La valeur par défaut est \textit{black}.
+\noindent\textbf{Couleur}: on règle la couleur avec la commande {\cmd\verb|couleurOmbre=<couleur>|}. La valeur par défaut est \texttt{black!30}.
 
 Voici un exemple illustrant les deux options:
 
@@ -624,7 +621,7 @@ L'utilisation de cette option ne diff
 
 \begin{demo}
 \begin{bclogo}[couleur=blue!30,arrondi=0.1,ombre=true,
-                couleurOmbre=black!60,blur]{Mon Titre}
+                couleurOmbre=black!30,blur]{Mon Titre}
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
   et encore pour l'exemple, du texte qui se répète encore et encore pour l'exemple.
   Du texte qui se répète encore et encore pour l'exemple, du texte qui se répète encore
@@ -652,7 +649,7 @@ pr
 \end{bclogo}
 \end{demo}
 
-Par défaut cette valeur est de 1.5pt.
+Par défaut cette valeur est de \numprint[pt]{1.5}.
 
 \subsection{La barre «zigzag»}
 
@@ -677,7 +674,7 @@ Ce style de barre s'obtient avec la commande {\cmd\verb|barre=<snake>|}. Par exe
 
 Pour ces deux styles de barre, on règle la taille (ou amplitude) de
 l'ondulation avec la commande {\cmd\verb|tailleOndu=<valeur en pt>|}. C'est la
-taille d'\textbf{une} ondulation. Par défaut la valeur est de 2.5. Par exemple:
+taille d'\textbf{une} ondulation. Par défaut la valeur est de $2.5$. Par exemple:
 
 \begin{demo}
 \begin{bclogo}[couleur=blue!30,arrondi=0.1,logo=\bcquestion,barre=snake,
@@ -735,7 +732,7 @@ Un autre exemple pour donner des id
 \subsection{Image personnelle «étendue»}
 
 Si je dispose d'une image, par exemple \texttt{brace.mps}\footnote{Comme
-précédemment, les utilisateurs de \LaTeX peuvent utiliser une image eps et ceux de pdf\LaTeX{} peuvent utiliser une image pdf.} (image normalement verticale): \includegraphics[angle=90]{brace}
+précédemment, les utilisateurs de \LaTeX{} peuvent utiliser une image eps et ceux de pdf\LaTeX{} peuvent utiliser une image pdf.} (image normalement verticale): \includegraphics[angle=90]{brace}
 grâce à la commande {\cmd\verb|barre=imageExt|} couplée avec {\cmd\verb|imageBarre=brace|}, je l'obtiens «étirée» à la place de la barre verticale. Par exemple:
 
 \begin{demo}

Licence Creative Commons Les fichiers de Syracuse sont mis à disposition (sauf mention contraire) selon les termes de la
Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International.