\documentclass[ a4paper, 11pt]{article} \usepackage[utf8]{inputenc} \usepackage[garamond]{mathdesign} \usepackage{bclogo} \usepackage{verbatim} \usepackage[margin=2.5cm]{geometry} \usepackage{amsmath} \usepackage[frenchb]{babel} \usepackage{xcolor} \usepackage{multicol} \usepackage{listings} \usepackage{pifont} \usepackage{url} \definecolor{cPG}{RGB}{235, 227, 150} \definecolor{link}{RGB}{150, 81, 0} \usepackage[colorlinks, linkcolor=link]{hyperref} \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 } \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.22} \author{ Maxime \textsc{Chupin} et Patrick \textsc{Fradin} \footnote{Merci à Jean-Côme \textsc{Charpentier}, Ulrike \textsc{Fischer} et Manuel \textsc{Pégourié-Gonnard}}\\\url{notezik@gmail.com}} \date{12 Janvier 2009} \begin{document} \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} \vspace*{2cm} \begin{bclogo}[couleur = cPG, cadreTitre = true, arrondi = 0.1]{Le paquet \texttt{bclogo}} Voici les logos : \begin{multicols}{2} \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 Ornement : \bcdanger \item Smiley heureux : \bcsmbh \item Smiley malheureux : \bcsmmh \item Le trèfle : \bctrefle \item Le livre : \bcbook \item Ornement : \bcorne{} \item Le pique de \LaTeX{} : \bcspadesuit \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 paquets suivants installés sur votre machine. \begin{bclogo}[couleur = cPG, logo = \bcattention, cadreTitre = true, arrondi = 0.1]{Les paquets \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+ \end{enum} \end{multicols} et/ou \texttt{tikz} et ses librairies \texttt{shadows} et \texttt{decorations.pathmorphing}. \verb+xkeyval+ et \verb+ifthen+ sont nécessaires dans les deux utilisations. \end{bclogo} \section{La 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{Ceci est issue d'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} Quelque 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}[]{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 = }, par exemple : \begin{Code} \begin{lstlisting} \begin{bclogo}[couleur = blue!30]{Mon Titre} Du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} \bigskip Ce qui donne : \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} \bigskip Par défaut la couleur est blanche. \subsection{L'arrondi des coins} On commande la taille de l'arrondi dans les options de la manière suivante \texttt{arrondi=}, 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\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} \bigskip Ce qui donne : \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} \bigskip Par défaut, l'arrondi est à 0. \subsection{Le style de titre} Il y a deux styles de titre. Un, par défaut ou avec la commande \texttt{cadreTitre = false}. Les boîtes précédentes utilisent ce style de titre. \bigskip Le second style, plus élaboré, 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\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} \bigskip Ce qui donne : \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} \subsection{Les logos} C'est là que réside l'originalité de \texttt{bclogo}\dots{} Pour la plupart, je les ai dessinés avec \textit{Inkscape} et exportés en PSTricks. Il y a depuis la version 2.0, plusieurs façons de créer des logos, soit au format \texttt{pstricks}, soit au format \texttt{pgf}, soit au format \texttt{eps}, soit au format \texttt{pdf}. Des commandes sont définies appelant les fichiers aux différents formats. 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). Lors de la création des logos il faut veiller à permettre la double utilisation \texttt{tikz} et \texttt{pstricks}. Voici la liste des logos : \begin{bclogo}[arrondi=0.1, logo=\bcpanchant, couleur= cPG, cadreTitre = true]{Les logos} \begin{enumerate} \item la fleur : commande \verb+\bcfleur+ \raisebox{-3mm}{\bcfleur} \item \og{}en chantier\fg{} : commande \verb+\bcpanchant+ \raisebox{-3mm}{\bcpanchant} (Jean-Michel \textsc{Sarlat}) \item la note : commande \verb+\bcnote+ \raisebox{-3mm}{\bcnote} (Thomas \textsc{Labarrusias}) \item l'étoile : commande \verb+\bcetoile+ \raisebox{-3mm}{\bcetoile} \item l'ourson : commande \verb+\bcours+ \raisebox{-3mm}{\bcours} \item \og{}attention\fg{} : commande \verb+\bcattention+ \raisebox{-3mm}{\bcattention} \item le c\oe{}ur : commande \verb+\bccoeur+ \raisebox{-3mm}{\bccoeur} \item ornement : commande \verb+\bcorne+ \raisebox{-3mm}{\bcorne} \item danger : commande \verb+\bcdanger+ \raisebox{-3mm}{\bcdanger} (François \textsc{Boerkmann}) \item smiley heureux : commande \verb+\bcsmbh+ \raisebox{-3mm}{\bcsmbh} (François \textsc{Boerkmann}) \item smiley malheureux : commande \verb+\bcsmmh+ \raisebox{-3mm}{\bcsmmh} (François \textsc{Boerkmann}) \item Take care : commande \verb+\bctakecare+ \raisebox{-3mm}{\bctakecare} (Patrick \textsc{Fradin}) \item La lampe : commande \verb+\bclampe+ \raisebox{-3mm}{\bclampe} (Patrick \textsc{Fradin}) \item Le livre : commande \verb+\bcbook+ \raisebox{-3mm}{\bcbook} (Patrick \textsc{Fradin}) \item Le trèfle : commande \verb+\bctrefle+ \raisebox{-3mm}{\bctrefle} \item Le point d'interrogation : commande \verb+\bcquestion+ \raisebox{-3mm}{\bcquestion} \item Le crayon : commande \verb+\bccrayon+ \raisebox{-1mm}{\bccrayon} (Anne-Sophie \textsc{Philippe}) \item Le pique de \LaTeX{} : commande \verb+\bcspadesuit+ {\bcspadesuit} \end{enumerate} \end{bclogo} Par exemple, \begin{Code} \begin{lstlisting} \begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bctrefle]{Mon Titre} Du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} produit : \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 nouvelle commande de logo sans pour autant que ces logos soient disponible dans \verb+bclogo+. Par exemple, pour obtenir le \emph{coeur} 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} donnera le même resultat 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} \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\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} Ce qui produit : \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\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple, du texte qui se r\'ep\`ete encore et encore pour l'exemple\dots \end{bclogo} \end{lstlisting} \end{Code} produit : \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} \subsection{Styles de barre} La syntaxe générale de commande du style de barre est \texttt{barre=