From 10a84c41425b6c784c34739f39cef25d8f4e58a8 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 19 Jan 2009 23:42:03 +0000 Subject: bclogo 2.22 (18jan09) git-svn-id: svn://tug.org/texlive/trunk@11920 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex | 663 ++++++++++++++++++---- 1 file changed, 549 insertions(+), 114 deletions(-) (limited to 'Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex') diff --git a/Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex b/Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex index f7a24d1a399..9628f1d8e20 100644 --- a/Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex +++ b/Master/texmf-dist/doc/latex/bclogo/bclogo-doc.tex @@ -10,14 +10,20 @@ \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{blue}\ttfamily, + keywordstyle=\color{bleu}\ttfamily, % underlined bold black keywords % identifierstyle=, basicstyle=\ttfamily\footnotesize, % nothing happens - commentstyle=\itshape\color{green}, % white comments + commentstyle=\itshape\color{vert}, % white comments stringstyle=\ttfamily, % typewriter type for strings showstringspaces=false, language=[LaTeX]TeX, @@ -32,7 +38,7 @@ {\end{dingautolist}} \newenvironment{Code}{% -\begin{bclogo}[logo = \bcorne]{Code}% +\begin{bclogo}[logo = \bccrayon, noborder = true]{Code}% } {% \end{bclogo} @@ -43,9 +49,9 @@ \definecolor{cPG}{RGB}{235, 227, 150} -\title{\texttt{bclogo} version 2.1} -\author{ Maxime \textsc{Chupin} et Patrick \textsc{Fradin} \footnote{Merci à Jean-Côme \textsc{Charpentier}, Ulrike \textsc{Fischer} et Manuel \textsc{Pégourié-Gonnard}}\\\texttt{notezik@gmail.com}} -\date{4 Janvier 2009} +\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} @@ -56,7 +62,7 @@ Ce paquet permet la création, via \texttt{Pstricks} ou \texttt{Tikz}, de boîte \end{abstract} \vspace*{2cm} -\begin{bclogo}[couleur = cPG, cadretitre = true, arrondi = 0.1]{Le paquet \texttt{bclogo}} +\begin{bclogo}[couleur = cPG, cadreTitre = true, arrondi = 0.1]{Le paquet \texttt{bclogo}} Voici les logos : \begin{multicols}{2} @@ -68,15 +74,17 @@ Voici les logos : \item L'ourson : \bcours \item Take care : \bctakecare \item La lampe : \bclampe -\end{itemize} -\begin{itemize} +\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 Le trèfle : \bctrefle +\item Le livre : \bcbook +\item Ornement : \bcorne{} +\item Le pique de \LaTeX{} : \bcspadesuit \end{itemize} \end{multicols} @@ -91,20 +99,22 @@ Voici les logos : 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 necessaire d'avoir les paquets suivants installés sur votre machine. +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{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 sa librairie \texttt{shadows}. +et/ou \texttt{tikz} et ses librairies \texttt{shadows} et \texttt{decorations.pathmorphing}. -\verb+xkeyval+ est nécessaire dans les deux utilisations. +\verb+xkeyval+ et \verb+ifthen+ sont nécessaires dans les deux utilisations. \end{bclogo} \section{La chargement du paquet} @@ -117,7 +127,7 @@ Depuis la version 2.0 de \texttt{bclogo}, le chargement s'effectue avec deux opt \end{lstlisting} ou \begin{lstlisting} -\usepackage[pstrick]{bclogo} +\usepackage[pstricks]{bclogo} \end{lstlisting} \end{Code} @@ -174,7 +184,7 @@ 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 se règle en cm : +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} @@ -200,14 +210,14 @@ 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. +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}. +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} +\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 @@ -218,7 +228,7 @@ Le second style, plus élaboré, est un cadre avec un gradient de couleur \texti Ce qui donne : -\begin{bclogo}[couleur = blue!30, arrondi = 0.1, cadretitre = true]{Mon Titre} +\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 @@ -230,12 +240,12 @@ C'est là que réside l'originalité de \texttt{bclogo}\dots{} Pour la plupart, 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 raisonable). Lors de la création des logos il faut veiller à permettre la double utilisation \texttt{tikz} et \texttt{pstricks}. +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.05, logo=\bctrefle, couleur= cPG, cadretitre = true]{Les 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}) @@ -251,7 +261,10 @@ Voici la liste des logos : \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 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} @@ -275,6 +288,26 @@ produit : 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 : @@ -300,7 +333,7 @@ Ce qui produit : \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}. +\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 : @@ -322,6 +355,300 @@ produit : 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=