[bclogo.git] / dev / doc / bclogo-doc.tex

\documentclass[a4paper,10pt]{article}
\usepackage[latin1]{inputenc}
\usepackage[charter]{mathdesign}
\usepackage[blur]{bclogo}
\usepackage{tikz}
\usepackage{verbatim}
\usepackage[margin=2.5cm]{geometry}
\usepackage{amsmath}
\usepackage[frenchb]{babel}
\usepackage{xcolor}
\usepackage{multicol}
\usepackage{listings}
\usepackage{pifont}
\usepackage{lipsum}
\usepackage{mflogo}
\usepackage{longtable}
\usepackage{url}
\definecolor{cPG}{RGB}{235, 227, 150}
\definecolor{link}{RGB}{150, 81, 0}
\usepackage[colorlinks, linkcolor=link]{hyperref}
\usetikzlibrary{decorations.pathmorphing}
\usetikzlibrary{shapes}
\definecolor{fbase}{gray}{0.95}
\usepackage{framed}
\newenvironment{gbar}[1]{%
  \def\FrameCommand{{\color{#1}\vrule width 3pt}\colorbox{fbase}}%
  \MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}

\definecolor{vert}{RGB}{0,105,29}
\definecolor{bleu}{RGB}{78,88,169}
\lstset{% general command to set parameter(s)
    basicstyle=\small,          % print whole listing small
    keywordstyle=\color{bleu}\ttfamily,
                                % underlined bold black keywords
%   identifierstyle=,
    basicstyle=\ttfamily\footnotesize,          % nothing happens
    commentstyle=\itshape\color{vert}, % white comments
    stringstyle=\ttfamily,      % typewriter type for strings
    showstringspaces=false,
    language=[LaTeX]TeX,
    defaultdialect=[LaTeX]TeX,
    morekeywords={RequirePackage}
}
\lstdefinestyle{numbers}
    {numbers=left, stepnumber=1, numberstyle=\tiny, numbersep=10pt}


\newenvironment{enum}{%
\begin{dingautolist}{202}}
{\end{dingautolist}}

\newenvironment{Code}{%
\begin{bclogo}[logo = \bccrayon, noborder = true]{Code}%
}
{%
\end{bclogo}
}
\definecolor{cPG}{RGB}{235, 227, 150}

\title{\texttt{bclogo} version 2.26}
\author{ Maxime \textsc{Chupin} et Patrick \textsc{Fradin}
\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{29 Juillet 2011}

\begin{document}
\enlargethispage{9.4pt}
\maketitle

\begin{abstract}
Ce paquet 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\footnote{Il y a bien
entendu d'autres options}.
\end{abstract}

\begin{bclogo}[couleur = cPG, cadreTitre = true, arrondi = 0.1]{Le paquet \texttt{bclogo}}
\begin{multicols}{3}
\begin{itemize}
\item La fleur: \bcfleur
\item Le chantier: \bcpanchant
\item La note: \bcnote
\item L'étoile: \bcetoile
\item L'ourson: \bcours
\item Take care: \bctakecare
\item La lampe: \bclampe
\item Le point d'interrogation: \bcquestion
\item Le crayon: \bccrayon
\item Attention: \bcattention
\item Le c\oe ur: \bccoeur
\item Danger: \bcdanger
\item Smiley heureux: \bcsmbh
\item Smiley malheureux: \bcsmmh
\item Le trèfle: \bctrefle
\item Le livre: \bcbook
\item Ornement: \bcorne
\item Info: \bcinfo
\item La plume: \bcplume
\item Le pique de \LaTeX{}: \bcspadesuit
\item La bombe: \bcbombe
\item Le cube: \bccube
\item Le dodécaèdre: \bcdodecaedre
\item L'icosaèdre: \bcicosaedre
\item L'octaèdre: \bcoctaedre
\item Le tétraèdre: \bctetraedre
\item L'Allemagne: \bcdallemagne
\item L'Autriche: \bcdautriche
\item La Belgique: \bcdbelgique
\item La Bulgarie: \bcdbulgarie
\item La France: \bcdfrance
\item L'Italie: \bcditalie
\item Le Luxembourg: \bcdluxembourg
\item Les Pays Bas: \bcdpaysbas
\item Le soleil: \bcsoleil
\item L'éclaircie: \bceclaircie
\item La pluie: \bcpluie
\item La neige: \bcneige
\item Le sens interdit: \bcinterdit
\item Le stop: \bcstop
\item Le poisson: \bcpoisson
\item L'horloge: \bchorloge
\item Le calendrier: \bccalendrier
\item La rose des vents: \bcrosevents
\item Le yin et le yang: \bcyin
\item Danger glissant: \bcdz
\item Le vélo: \bcvelo
\item Le \emph{peace and love}: \bcpeaceandlove
\item L'\oe il: \bcoeil
\item Le nucléaire: \bcnucleaire
\item La femme: \bcfemme
\item L'homme: \bchomme
\item La loupe: \bcloupe
\item Le recyclage: \bcrecyclage
\item Le valet de c\oe ur: \bcvaletcoeur
\item La clé: \bccle
\item La clé de fa: \bcclefa
\item La clé de sol: \bcclesol
\item Le feu vert: \bcfeuvert
\item Le feu jaune: \bcfeujaune
\item Le feu rouge: \bcfeurouge
\item Le feu tricolore: \bcfeutricolore
\item L'outil: \bcoutil
\item Le trombone: \bctrombone
\end{itemize}
\end{multicols}
\end{bclogo}

\newpage

\tableofcontents
\newpage

\section{Introduction}

Ce paquet a été créé pour faciliter la fabrication de boîtes colorées plus ou
moins complexes disposant d'un titre, d'un logo et d'une couleur de fond.
Depuis la version 2.0, \texttt{bclogo} s'appuie principalement sur
\texttt{Pstricks} \textbf{ou} sur \texttt{tikz}\footnote{Ceci grâce à Patrick
\textsc{Fradin}}. Ce paquet utilise \texttt{xkeyval} pour la gestion des
paramètres. Ces boîtes permettent de colorer un peu les pages d'un document
\LaTeX{} tout en mettant en relief le contenu de la boîte.

Pour son bon fonctionnement, il est nécessaire d'avoir les extensions suivants
installées sur votre machine.

\begin{bclogo}[couleur = cPG, logo = \bcattention, cadreTitre = true, arrondi = 0.1]{Les extensions \textit{indispensables}}
\begin{multicols}{2}
\begin{enum}
\item \verb+Pstricks+
\item \verb+graphicx+
\item \verb+pst-grad+
\item  \verb+xkeyval+
\item \verb+pst-coil+
\item \verb+ifthen+
\item \verb+ifpdf+
\item \verb+pst-blur+ si l'on souhaite utiliser la fonction (voir section \ref{blur})
\end{enum}
\end{multicols}
ou \texttt{tikz} et ses librairies \texttt{shadows} et
\texttt{decorations.pathmorphing}.

\verb+xkeyval+, \verb+ifthen+ et \verb+ifpdf+ sont nécessaires dans les deux utilisations.
\end{bclogo}

\section{Le chargement du paquet}

Depuis la version 2.0 de \texttt{bclogo}, le chargement s'effectue avec deux
options, soit on utilise \texttt{pstricks} (par défaut)\footnote{sur un conseil
d'Herbert \textsc{Voss} qui vérifie à chaque nouvelle version le code, merci à
lui.} soit \texttt{tikz}. Ceci s'effectue dans le préambule du document
\LaTeX{}:

\begin{Code}
\begin{lstlisting}
\usepackage[tikz]{bclogo}
\end{lstlisting}
ou
\begin{lstlisting}
\usepackage[pstricks]{bclogo}
\end{lstlisting}
\end{Code}

\noindent\textbf{Remarque: } Les syntaxes
\begin{lstlisting}
\usepackage[pstricks]{bclogo}
\end{lstlisting}
et
\begin{lstlisting}
\usepackage{bclogo}
\end{lstlisting}
sont équivalentes.
\section{Syntaxe générale}

Quelle que soit l'option de chargement choisie, la syntaxe pour la création de
boîte est la même.
\bigskip

Voici le schéma de base pour réaliser une boîte:

\begin{Code}
\begin{lstlisting}
\begin{bclogo}[<options>]{Titre}
Corps de la boite...
\end{bclogo}
\end{lstlisting}
\end{Code}

\section{Les options}

\subsection{La couleur de fond}

On définit la couleur de fond grâce à \texttt{couleur = <macouleur>}, par
exemple:
\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur = blue!30]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
\bigskip

Ce qui donne:
\medskip
\begin{bclogo}[couleur = blue!30]{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\dots
\end{bclogo}
\medskip

Par défaut la couleur est blanche.

\subsection{La couleur du trait de bord}

Cette nouvelle option a été créée sur la demande de Philippe \bsc{Fortemps}. On
commande la couleur du trait de bord par \texttt{couleurBord=<couleur>}. Voici
un exemple:
\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur = blue!30,couleurBord=red!30]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
\bigskip

Ce qui donne:
\medskip
\begin{bclogo}[couleur = blue!30,couleurBord=red!30]{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\dots
\end{bclogo}

\subsection{L'arrondi des coins}

On commande la taille de l'arrondi dans les options de la manière suivante
\texttt{arrondi=<valeur>}, elle\footnote{Avant la version 2.22, les arrondis
pstricks étaient relatifs, ils sont maintenant absolus.} se règle en cm:

\begin{Code}
\begin{lstlisting}
\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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
\bigskip

Ce qui donne:
\medskip
\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\dots
\end{bclogo}
\medskip

Par défaut, l'arrondi est à 0.

\subsection{Le style de titre}


Il y a deux styles de titre. Celui par défaut (ou avec la commande
\texttt{cadreTitre = false}) est celui utilisé pour les boîtes précédentes. On
peut cependant le modifier grâce à la commande:
\begin{lstlisting}
\renewcommand\bcStyleTitre[1]{\hfill\large\textsl{#1}\hfill}
\end{lstlisting}
Ce qui produit:
\renewcommand\bcStyleTitre[1]{\hfill\large\textsl{#1}\hfill}

\medskip
\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\dots
\end{bclogo}

Par défaut, \verb+\bcStyleTitre+ est définie comme cela:
\begin{lstlisting}
\renewcommand\bcStyleTitre[1]{\large\textbf{#1}}
\end{lstlisting}
\renewcommand\bcStyleTitre[1]{\large\textbf{#1}}
On peut alors s'amuser à toutes sortes de choses; en voici un exemple.
\begin{Code}
\begin{lstlisting}
\renewcommand\bcStyleTitre[1]{\hfill\tikz %
    \node[fill=blue!20,starburst,draw=black] {#1};\hfill}
\begin{bclogo}[noborder=true]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

\renewcommand\bcStyleTitre[1]{\hfill\tikz \node[fill=blue!20,starburst,draw=black] {#1};\hfill}
\begin{bclogo}[noborder=true]{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\dots
\end{bclogo}

\renewcommand\bcStyleTitre[1]{\large\textbf{#1}}

\bigskip

Le second style, plus élaboré mais non modifiable, est un cadre avec un
gradient de couleur \textit{gold}. Ceci  s'obtient avec la commande
\texttt{cadreTitre = true}.

\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur=blue!30, arrondi=0.1, cadreTitre=true]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
 \bigskip

Ce qui donne:
\smallskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, cadreTitre = true]{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\dots
\end{bclogo}

\subsubsection{Sous-titre}

Si on utilise le style de titre sans cadre (\textit{i.e.} le style par défaut)
alors on peut définir un sous-titre grâce à la commande \texttt{sousTitre=<Mon
sous-titre>}\footnote{Cette option a été mise en place sur la demande de Gaétan
\textsc{Marris}}. Par exemple:

\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur=blue!30,arrondi=0.1,sousTitre=Sous-titre]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
 \bigskip

Ce qui donne:
\medskip
\begin{bclogo}[couleur=blue!30,arrondi=0.1,sousTitre=Sous-titre]{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\dots
\end{bclogo}
\medskip
\paragraph{Le style du sous-titre} On peut redéfinir le style de sous-titre comme ceci:
\begin{lstlisting}
\renewcommand\styleSousTitre[1]{\hfill\textsl{#1}}
\end{lstlisting}

\renewcommand\styleSousTitre[1]{\hfill\textsl{#1}}

On obtient alors

\medskip
\begin{bclogo}[couleur=blue!30,arrondi=0.1,sousTitre=Sous-titre]{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\dots
\end{bclogo}
\medskip


Dans \texttt{bclogo}, \verb+\styleSousTitre+ est définie comme ceci:

\begin{lstlisting}
\newcommand\styleSousTitre[1]{\normalsize\textit{#1}}
\end{lstlisting}

\renewcommand\styleSousTitre[1]{\normalsize\textit{#1}}

Il faut juste se dire que l'on se trouve dans une case d'un tableau,
ainsi des constructions plus complexes sont envisageables.

\subsection{Les logos}

C'est là que réside l'originalité de \texttt{bclogo}\dots{}  Pour la plupart
des logos, je les ai dessinés avec \textit{Inkscape}.
Pour d'autres, Patrick \bsc{Fradin} et Alphonse \bsc{Capriani} ont utilisé le
super \TeX{}graph.

Depuis la version 2.6\footnote{Dans les versions précédentes, deux formats étaient utilisés, soit \texttt{eps}, soit
  \texttt{pdf}. La conversion en masse a été réalisée grâce à
  l'utilitaire \texttt{pstoedit}.}, on passe\footnote{Sur une initiative de
  François \bsc{Pétiard}.} par \MP{} pour générer des fichiers
\texttt{.mps} qui sont interprétés en eps ou en pdf selon le mode dans
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
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}.

Je remercie tout ceux qui participent à la création de logo et en particulier
Alphonse \bsc{Capriani} et François \bsc{Pétiard} qui ont bien
augmenté la collection.

Voici la liste des logos :\footnote{Le choix des drapeaux n'est pas
  délibéré, ce sont des contributions, vous pouvez bien sûr augmenter
  la collection !}


\begin{longtable}{cccc}
  Nom & Commande & Image & Auteur \\\hline\endhead
  \hline                         &&&\hfill suite\dots\\\endfoot
  \hline&&&\endlastfoot
  la fleur& \verb+\bcfleur+ & \bcfleur & Maxime \bsc{Chupin}\\
  \og{}en chantier\fg{}&\verb+\bcpanchant+&\bcpanchant&Jean-Michel
  \textsc{Sarlat}\\
  la note&\verb+\bcnote+&\bcnote&Thomas \textsc{Labarussias}\\
  l'étoile& \verb+\bcetoile+&\bcetoile& Maxime \bsc{Chupin}\\
  l'ourson& \verb+\bcours+&\bcours&"\\
  \og{}attention\fg{}&\verb+\bcattention+&\bcattention& "\\
  le c\oe{}ur&\verb+\bccoeur+&\bccoeur&"\\
  ornement&\verb+\bcorne+&\bcorne&"\\
  danger&\verb+\bcdanger+&\bcdanger&François \textsc{Boerkmann}\\
  smiley heureux&\verb+\bcsmbh+&\bcsmbh&"\\
  smiley malheureux&\verb+\bcsmmh+&\bcsmmh&"\\
  take care&\verb+\bctakecare+&\bctakecare&Patrick \textsc{Fradin}\\
  la lampe& \verb+\bclampe+&\bclampe&"\\
  le livre&\verb+\bcbook+&\bcbook&"\\
  le trèfle&\verb+\bctrefle+&\bctrefle&Maxime \bsc{Chupin}\\
  le point d'interrogation&\verb+\bcquestion+&\bcquestion&"\\
  le crayon& \verb+\bccrayon+&\bccrayon&Anne-Sophie
  \textsc{Philippe}\\
  le pique de \LaTeX{}&\verb+\bcspadesuit+&\bcspadesuit&\LaTeX\\
  logo info&\verb+\bcinfo+&\bcinfo&Thomas \textsc{Labarussias}\\
  la plume& \verb+\bcplume+&\bcplume& Maxime \bsc{Chupin}\\
  la bombe& \verb+\bcbombe+&\bcbombe&Alphonse \bsc{Capriani}\\
  le cube&\verb+\bccube+&\bccube&"\\
  le dodécaèdre&\verb+\bcdodecaedre+&\bcdodecaedre&"\\
  l'icosaèdre&\verb+\bcicosaedre+&\bcicosaedre&"\\
  l'octaèdre&\verb+\bcoctaedre+&\bcoctaedre&"\\
  le tétraèdre&\verb+\bctetraedre+&\bctetraedre&"\\
  l'Allemagne&\verb+\bcdallemagne+&\bcdallemagne&"\\
  l'Autriche&\verb+\bcdautriche+&\bcdautriche&François \bsc{Pétiard}\\
  la Belgique&\verb+\bcdbelgique+&\bcdbelgique&Alphonse
  \bsc{Capriani}\\
  la Bulgarie&\verb+\bcdbulgarie+&\bcdbulgarie&François
  \bsc{Pétiard}\\
  la France&\verb+\bcdfrance+&\bcdfrance&Alphonse
  \bsc{Capriani}\\
  l'Italie&\verb+\bcditalie+&\bcditalie&"\\
  le Luxembourg&\verb+\bcdluxembourg+&\bcdluxembourg&François
  \bsc{Pétiard}\\
  les Pays-Bas&\verb+\bcdpaysbas+&\bcdpaysbas&Alphonse
  \bsc{Capriani}\\
  le soleil&\verb+\bcsoleil+&\bcsoleil&"\\
  l'éclaircie&\verb+\bceclaircie+&\bceclaircie&"\\
  la pluie&\verb+\bcpluie+&\bcpluie&"\\
  la neige&\verb+\bcneige+&\bcneige&"\\
  le sens interdit&\verb+\bcinterdit+&\bcinterdit&"\\
  le poisson&\verb+\bcpoisson+&\bcpoisson&"\\
  l'horloge&\verb+\bchorloge+&\bchorloge&"\\
  le calendrier&\verb+\bccalendrier+&\bccalendrier&"\\
  la rose des vents&\verb+\bcrosevents+&\bcrosevents&"\\
  le yin et le yang&\verb+\bcyin+&\bcyin&"\\
  danger glissant&\verb+\bcdz+&\bcdz&Vincent \bsc{Pantaloni}\\
  le vélo&\verb+\bcvelo+&\bcvelo&François \bsc{Pétiard}\\
  le \emph{peace and love}&\verb+\bcpeaceandlove+&\bcpeaceandlove&"\\
  l'\oe il&\verb+\bcoeil+&\bcoeil&"\\
  le nucléaire& \verb+\bcnucleaire+&\bcnucleaire&"\\
  la femme&\verb+\bcfemme+&\bcfemme&"\\
  l'homme&\verb+\bchomme+&\bchomme&"\\
  la loupe&\verb+\bcloupe+&\bcloupe&"\\
  le recyclage&\verb+\bcrecyclage+&\bcrecyclage&"\\
  le valet de c\oe ur&\verb+\bcvaletcoeur+&\bcvaletcoeur&"\\
  la clé&\verb+\bccle+&\bccle&"\\
  la clé de fa&\verb+\bcclefa+& \bcclefa&"\\
  la clé de sol&\verb+\bcclesol+&\bcclesol&"\\
  le feu vert&\verb+\bcfeuvert+&\bcfeuvert&"\\
  le feu jaune&\verb+\bcfeujaune+&\bcfeujaune&"\\
  le feu rouge&\verb+\bcfeurouge+&\bcfeurouge&"\\
  le feu tricolore&\verb+\bcfeutricolore+&\bcfeutricolore&"\\
  l'outil&\verb+\bcoutil+&\bcoutil&"\\
  le trombone&\verb+\bctrombone+&\bctrombone&"
\end{longtable}


Par exemple,

\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bctrefle]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

produit:
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bctrefle]{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\dots
\end{bclogo}

\paragraph{Remarque:}
On peut se définir soi-même de nouvelles commandes de logo sans pour autant que
ces logos soient disponibles dans \verb+bclogo+. Par exemple, pour obtenir le
\emph{c\oe{}ur} de \LaTeX{} $\heartsuit$, il suffit de définir dans le
préambule de document la commande:

\begin{lstlisting}
\newcommand\bcheartsuit{\centering \huge $\heartsuit$}
\end{lstlisting}

Ceci donnera le même résultat que pour le pique \LaTeX{} (attention
\verb+\bcheartsuit+ n'est pas définie dans \verb+bclogo+).

On peut aussi faire ceci pour un code \verb+pstricks+, \verb+pgf+, une
image\dots{} Voici trois exemples illustrant respectivement les trois cas
mentionnés:

\begin{Code}
\begin{lstlisting}
% mon logo code pstricks
\newcommand\monlogopst{\begingroup \input{monlogo.pst}\endgroup}
% mon logo code pgf
\newcommand\monlogopgf{\begingroup \input{monlogo.pgf}\endgroup}
% mon image
\newcommand\monimage{\includegraphics[width=17pt]{monimage}}
\end{lstlisting}
\end{Code}

\subsubsection{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:
\begin{lstlisting}
\renewcommand\logowidth{<valeur>pt}
\end{lstlisting}

Par exemple, une redéfinition à 10pt donnera:
\medskip
\renewcommand\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\dots
\end{bclogo}
\renewcommand\logowidth{17pt}
\subsection{L'ombre}

La gestion de l'ombre se règle comme les autres options. Par défaut, il n'y en
a pas (la valeur \texttt{ombre} vaut \texttt{false}). On active l'ombre avec la
commande \texttt{ombre = true}. Par exemple:

\begin{Code}
\begin{lstlisting}
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

Ce qui produit:
\medskip

\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true]{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\dots
\end{bclogo}

\subsubsection{Paramètres de l'ombre}

\paragraph{Épaisseur}
On règle l'épaisseur de l'ombre avec la commande \texttt{epOmbre =
<\textrm{valeur en cm}>}. La valeur par défaut est de 0.125 cm.

\paragraph{Couleur}
On règle la couleur avec la commande \texttt{couleurOmbre =
<\textrm{couleur}>}. La valeur par défaut est \textit{black}.

Voici un exemple illustrant les deux options:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true, epOmbre = 0.25, couleurOmbre = black!30]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

produit:
\medskip

\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true, epOmbre = 0.25, couleurOmbre = black!30]{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\dots
\end{bclogo}

\subsubsection{\label{blur}Le paramètre \texttt{blur}}

Depuis la version 2.24, on a rajouté l'option proposée par le paquet
\texttt{pst-blur}. L'utilisation de celle-ci est légèrement plus compliquée que
celle des autres.

Si on utilise \texttt{pstricks}, alors, lors du chargement de \texttt{bclogo},
il faut mettre l'option \texttt{blur} qui permet de «charger»
\texttt{pst-blur}.
\begin{lstlisting}
\usepackage[blur]{bclogo}
\end{lstlisting}

Si on utilise \texttt{tikz}, alors il n'y a pas besoin de rajouter l'option
\texttt{blur} au chargement de \texttt{bclogo}.

L'utilisation de cette option ne diffère pas selon \texttt{tikz} ou
\texttt{pstricks}. On procède de la façon suivante:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true, couleurOmbre = black!60,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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

produit:
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, ombre = true, couleurOmbre = black!60,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\dots
\end{bclogo}

\subsection{Styles de barre}

La syntaxe générale de commande du style de barre est \texttt{barre=<style>}.

\subsubsection{La barre droite}

Par défaut, on a une barre verticale droite comme dans tous les exemples
précédents (la commande est \texttt{barre=line}).

\paragraph{Épaisseur}
On peut régler l'épaisseur de la barre grâce à la commande \texttt{epBarre = <valeur en pt>}. Par exemple:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, epBarre = 3.5]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}
donne:
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, epBarre = 4.5]{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\dots
\end{bclogo}

Par défaut cette valeur est \texttt{epBarre = 1.5pt}.

\subsubsection{La barre «zigzag»}

Ce style de barre s'obtient avec la commande \texttt{barre=zigzag}. Par
exemple:
\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = zigzag]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = zigzag]{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\dots
\end{bclogo}

\subsubsection{La barre «snake»}
Ce style de barre s'obtient avec la commande \texttt{barre=snake}. Par exemple:
\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = snake]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = snake]{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\dots
\end{bclogo}

\subsubsection{Réglage  pour «snake» et «zigzag»}

Pour ces deux styles de barre, on règle la taille (ou amplitude) de
l'ondulation avec la commande\par\noindent\texttt{tailleOndu = <valeur en pt>}. C'est la
taille d'\textbf{une} ondulation. Par défaut la valeur est de 2.5. Par exemple:
\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = snake,tailleOndu = 1.5]{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\dots
\end{bclogo}
\end{lstlisting}
\end{Code}

donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = snake,tailleOndu = 1.5]{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\dots
\end{bclogo}

\subsubsection{Répétition d'un «motif»}

Cette fonction permet de répéter verticalement un motif quelconque à la place
de la barre verticale. Ceci s'obtient avec la commande \texttt{barre = motif}
et ce \textbf{couple} avec la commande \texttt{motifBarre = <motif>}. Par
exemple:
\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = motif,motifBarre = $\star$]{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\dots   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}
\end{lstlisting}
\end{Code}
donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = motif,motifBarre = $\star$]{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\dots   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}
\medskip

Si je dispose d'une image personnelle, par exemple
\texttt{spir.mps}\footnote{Ici, j'utilise un \texttt{.mps} mais un utilisateur
de \texttt{latex} peut très bien utiliser un \texttt{eps} et un utilisateur de \texttt{pdflatex} peut très  bien utiliser un \texttt{jpg},
\texttt{pdf}\dots} \includegraphics{spir}, il suffit de mettre:

\verb+motifBarre = \includegraphics{spir}+.
 Ceci donne:
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = motif,motifBarre = \includegraphics{spir}]{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\dots   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}
\medskip

Un autre exemple pour donner des idées\dots
\medskip

\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = motif,motifBarre = {\includegraphics[width=8pt]{bc-inter}}]{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\dots   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}

\subsubsection{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.}

\includegraphics{brace}

grâce à la commande \texttt{barre = imageExt} couplée avec \texttt{imageBarre =
brace}, je l'obtiens «étirée» à la place de la barre verticale. Par exemple:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = imageExt,imageBarre = brace]{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\dots   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}
\end{lstlisting}
\end{Code}
donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = imageExt,imageBarre = brace]{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\dots   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}

\subsubsection{Image personnelle «clippée»}

Si on dispose d'une image personnelle (assez longue de préférence), on peut
grâce à la commande \texttt{barre=imageClip} couplée encore une fois avec la
commande \texttt{imageBarre = <monimage>}. On obtient à la place de la barre
verticale, l'image «tronquée». Par exemple, si je dispose de l'image
\texttt{losanges.mps} (image tournée de 90 degrés):

\noindent\includegraphics[angle = 90,bb=0 0 17 \linewidth,clip]{losanges}

Cet exemple


\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = imageClip,imageBarre = losanges]{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\dots   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}
\end{lstlisting}
\end{Code}

donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = imageClip,imageBarre = losanges]{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\dots   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}

\subsubsection{Pour les utilisateurs de mathdesign}

Si on utilise une police \textit{mathdesign}, alors on a accès à une barre
ondulée, faite avec un glyphe répété verticalement, grâce à la commande
\texttt{barre = wave}. Voici un exemple:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = wave]{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\dots   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}
\end{lstlisting}
\end{Code}

Ce qui donne:
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = wave]{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\dots   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}


\subsubsection{Couleur de la barre}

Pour les barres \texttt{line}, \texttt{zigzag}, \texttt{snake}, \texttt{motif}
et \texttt{wave} (pour motif, seulement si on utilise un motif provenant de
\LaTeX{}, caractères, traits\dots), on peut changer la couleur. Pour ce faire,
on utilise la commande \texttt{couleurBarre = <ma couleur>}. Par exemple:
\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, couleurBarre = green!80!blue!60]{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\dots   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}
\end{lstlisting}
\end{Code}
donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, couleurBarre = red!60!black!100]{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\dots   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}

avec \texttt{barre = snake}
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion,barre = snake, couleurBarre = red!60!black!100]{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\dots   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}

\subsubsection{Pas de barre}

Si on ne veut pas de barre verticale sur le côté, il suffit d'utiliser la
commande \texttt{barre = none}. Par exemple:

\begin{Code}
\begin{lstlisting}[ breaklines=true,breakindent=30pt]
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion,barre = none]{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\dots   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}
\end{lstlisting}
\end{Code}

donne
\medskip
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion,barre = none]{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\dots   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}

\subsection{Le bord--Épaisseur}

On peut (depuis la version 2.24) régler l'épaisseur du trait de bord grâce à la
commande\par\noindent\texttt{epBord=<valeur>} (attention, ne pas mettre d'unité). Par
exemple:
\begin{Code}
\begin{lstlisting}
\begin{bclogo}[logo = \bccrayon, epBord=0.2]{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\dots 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}
\end{lstlisting}
\end{Code}
Ce qui donne:
\medskip
\begin{bclogo}[logo = \bccrayon, epBord=0.2]{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\dots 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}
\medskip
Par défaut, l'épaisseur est à 0.8pt.

\subsubsection{Option \texttt{noborder}}

Par défaut, il y a un trait pour délimiter le bord de la boîte, on peut
cependant choisir de ne pas en mettre avec l'option \texttt{noborder = true}
(par défaut elle est à \texttt{false}).

Par exemple:
\begin{Code}
\begin{lstlisting}
\begin{bclogo}[logo = \bccrayon, noborder = true]{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\dots 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}
\end{lstlisting}
\end{Code}
donne
\medskip
  \begin{bclogo}[logo = \bccrayon, noborder = true]{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\dots 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}
\medskip
\noindent Cela ne vous dit rien?

\noindent Voici un autre exemple, avec de la couleur\dots
\medskip
  \begin{bclogo}[logo = \bcbook, noborder = true, couleur = red!30!blue!40]{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\dots 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}

\subsection{Les marges}

On peut aussi régler les marges entre l'intérieur de la boîte et le bord. Ceci
se fait  par la commande \texttt{marge= <entier>}. Elle est définie en nombre
de points, par défaut \texttt{marge = 3} (ne pas préciser l'unité).

Cette nouvelle commande (due à Patrick \textsc{Fradin} sur une demande de
Gaétan \textsc{Marris}) permet, entre autre, de prolonger le texte jusqu'à la
marge de la page lorsque \texttt{noborder=true}. Par exemple,
\medskip
\begin{Code}
\begin{lstlisting}
\noindent\hrule
\begin{bclogo}[logo = \bccrayon, noborder = true,marge=0]{Mon titre}
\lipsum[2]
\end{bclogo}
\noindent\hrule
\begin{bclogo}[logo = \bccrayon, noborder = true,marge=8]{Mon titre}
\lipsum[2]
\end{bclogo}
\noindent\hrule
\end{lstlisting}
\end{Code}

produit ceci.
\bigskip

\noindent\hrule
\begin{bclogo}[logo = \bccrayon, noborder = true,marge=0]{Mon titre}
\lipsum[2]
\end{bclogo}
\noindent\hrule
\begin{bclogo}[logo = \bccrayon, noborder = true,marge=8]{Mon titre}
\lipsum[2]
\end{bclogo}
\noindent\hrule
\section{Liste des boîtes}

On peut, comme avec \verb+\tableofcontents+, lister les boîtes utilisées dans
le document et ce grâce à la commande:

\begin{lstlisting}
\listofbclogo
\end{lstlisting}

Les noms affichés dans la liste sont les différents titres des boîtes et,
si on utilise le package \verb+hyperref+, cette liste est «cliquable» et permet
le transport dans le document\footnote{Ce transport est maintenant mieux géré
(version 2.21) grâce à François \textsc{Pétiard}}. Par exemple dans ce document
la liste donne (ici j'utilise un \texttt{multicols} pour l'affichage sur deux
colonnes):
\begin{multicols}{2}
\listofbclogo
\end{multicols}
\bigskip

Le titre de la liste peut alors être modifié par la commande:

\begin{lstlisting}
\renewcommand{\titrebclogo}{Liste des fiches}
\end{lstlisting}

\section{Avec \texttt{framed.sty}}

Je présente ici une utilisation de \texttt{bclogo} \emph{couplée} avec un
environnement écrit par Jean-Michel \textsc{Sarlat} utilisant
\texttt{framed.sty}. Voici cet environnement:

\begin{Code}
\begin{lstlisting}
\newenvironment{gbar}[1]{%
  \def\FrameCommand{{\color{#1}\vrule width 3pt}\colorbox{fbase}}%
  \MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}
\end{lstlisting}
\end{Code}

En disposant cet environnement, on s'amuser à mélanger les deux:
\begin{Code}
\begin{lstlisting}
\begin{bclogo}[logo=\bcinfo,barre = none,noborder=true]{Test avec
      \texttt{framed.sty}}%
\begin{gbar}{yellow}
  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 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{gbar}
\end{bclogo}
\end{lstlisting}
\end{Code}

Ce qui donne
\medskip

\begin{bclogo}[logo=\bcinfo,barre = none,noborder=true]{Test avec \texttt{framed.sty}}%
\begin{gbar}{yellow}
  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 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{gbar}
\end{bclogo}

\section{Réglage global des paramètres}

On peut régler les paramètres pour toutes les boîtes \texttt{bclogo}. Pour cela
on utilise la commande
\begin{lstlisting}
\presetkeys{bclogo}{<liste des parametres>}{}
\end{lstlisting}
Par exemple:
\begin{lstlisting}
\presetkeys{bclogo}{ombre=true, epBord=1pt}{}
\end{lstlisting}

\section{Historique}
\begin{itemize}
\item bclogo v2.26 (29 Juillet 2011) : Passage au format mps pour les
  logos, ajouts de nouveaux logos (François \textsc{Pétiard}),
  corrections du code pour éviter les overfull et underfull box
\item bclogo v2.25 (06 Juillet 2011) : correction du drapeau allemand
\item bclogo v2.24 (09 septembre 2009) : plein de nouveauté, logos, réglage de couleur de bord, d'épaisseur de bord, de marge à l'intérieur, option blur pour l'ombre, nouvelle barre pour les utilisateurs de mathdesign

\item bclogo v2.22 (18 janvier 2009) : toujours la même version, j'avais oublié de documenter l'option noborder

\item bclogo v2.22 (15 janvier 2009) : Réglages arrondis absolu en pstricks, les logos (fichiers) sont renommés bc-<logo>.<ext>

\item bclogo v2.21 (12 janvier 2009) : Nouveaux logos crayon et pique, plus amélioration de la gestion des références, amélioration de la documentation

\item bclogo v2.2 (11 janvier 2009) : Options sur la barre verticale, nouveau logo question

\item bclogo v2.1 (04 janvier 2009) : Inversion de l'option par défaut, maintenant c'est pstricks, nouveau logo livre

\item bclogo v2.0 (27 décembre 2008) : Options tikz ou pstricks suivant le choix de compilation, ombre, 3 logos take care, lampe et trêfle

\item bclogo v1.3 (20 août 2008) : Gestion des paramètres avec « xkeyval » et ajout de 3 logos de François Boerkmann

\item bclogo v1.27 (14 juillet 2008) : Correction de l'oubli de chargement du paquet « ifthen »

\item bclogo v1.26 (30 juin 2008) : création du logo ornement -- deux styles de titre -- fonction listofbclogo

\item bclogo v1.25 (5 avril 2008) : modification du logo attention et création du coeur

\item bclogo v1.2 (2 avril 2008) : création des logo etoile, ours et attention

\item bclogo v1.15 (19 mars 2008) : ajout de la fonction « arrondi » en quatrième argument

\item bclogo v1.1 (19 mars 2008)
\end{itemize}

\section{Le code}

%\begin{lstlisting}[style=numbers, breaklines=true,breakindent=30pt]
\lstset{style=numbers, breaklines=true,breakindent=30pt}
\lstinputlisting{../latex/bclogo.sty}
%\end{lstlisting}



\end{document}