Le wiki de Syracuse

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Environnement bclogo ======

Avec l'aide de Ulrike Fischer  et de Jean-Côme Charpentier, //j'ai// réalisé un environnement de boîte colorée dans l'idée des boites colorées de Christophe. L'idée est d'avoir ici un environnement où on définit la couleur de fond, le logo (en haut à gauche) et le titre de la boîte.

Depuis la version 2.0, bclogo est aussi utilisable par les utilisateurs de pdflatex et ceci grâce à Patrick Fradin. Maintenant lors du chargement du package, deux options s'offrent à nous : 
  * celle par défaut Pstricks (depuis la version 2.1, pour la 2.0 c'était tikz, un conseil de Herbert Voss)  :
<code latex>
\usepackage{bclogo}
</code>
ou (ce qui est équivalent) :
<code latex>
\usepackage[pstricks]{bclogo}
</code>
  * et l'option tikz qui permet la compilation pdflatex:

<code latex>
\usepackage[tikz]{bclogo}
</code>


**Remarque ** cette page du wiki peut servir de documentation, mais elle est (pour moi) moi bien faite que la vrai documentation à télécharger dans l'archive en fin de page. Cette page a surtout pour but de permettre la participation, et de montrer la progression.

===== Syntax =====


La syntax générale est : 

<code latex>
\begin{bclogo}[<options>]{<Le titre>}
<le corps>
\end{bclogo}
</code>

Si l'on ne met pas les options ''[<options>]'' alors les paramètres (options) prennent des valeurs par défaut (voir plus bas).

===== Les options =====
==== Les coins arrondis ====
On commande la taille de l'arrondi dans les options de la manière suivante ''arrondi = <valeur>'' :
<code latex>
\begin{bclogo}[arrondi = 0.1]{Titre}
Texte
\end{bclogo}
</code>

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

==== La couleur de fond de la boîte ====
On définit la couleur de fond grâce à ''couleur = <macouleur>'', par exemple :

<code latex>
\begin{bclogo}[arrondi = 0.1, couleur = blue!30]{Titre}
Texte
\end{bclogo}
</code>

Par défaut la couleur est blanche.

==== Style de titre ====
Il y a deux styles de titre. Un, par défaut ou avec la commande ''cadretitre = false'', qui donne :

{{ mc:style0.png }}

L'autre, qui se choisit avec la commande ''cadretitre = true'' (toujours dans les options), qui donne :

{{ mc:style1.png }}

==== Ombre ====

Là aussi, il s'agit d'une option issue de la participation de Patrick Fradin. On peut grâce à la commande ''ombre = true'', mettre une ombre derrière la boîte. Par défaut, il n'y en a pas. 

=== Couleur de l'ombre ===

La couleur de l'ombre (par défaut noir) se règle grâce à la commande ''couleurOmbre = <ma couleur>''.

=== Épaisseur de l'ombre ===

On règle la distance de la boîte à l'ombre grâce à la commande ''epOmbre = <valeur en cm>''. Par défaut, elle est réglée à 0.125cm.

== Exemple ==

<code latex>
\begin{bclogo}[ombre = true, logo = \bcbook]{Démonstration de l'ombre}
Cette option est une idée de Patrick \textsc{Fradin}, on remarque que la taille de la boîte s'ajuste pour ne pas sortir des marges imposées.
\end{bclogo}

\begin{bclogo}[ombre = true, epOmbre = 0.25, couleurOmbre = black!30, logo = \bcbook, arrondi = 0.1]{Démonstration de l'ombre}
Cette option est une idée de Patrick \textsc{Fradin}, on remarque que la taille de la boîte s'ajuste pour ne pas sortir des marges imposées.
\end{bclogo}
</code>

donne :
{{ :mc:ombre.png }}

==== Les logos ====

Les logos se choisissent parmis une liste (voir plus bas) ''logo = \bcetoile'', par defaut on a la fleur.

==== Exemple ====

<code latex>
\begin{bclogo}[logo = \bcattention, arrondi = 0.1, 
couleur = green!20!blue!20, cadretitre=true]%
{\texttt{bclogo} est un super paquet!}
Avec cette nouvelle gestion des paramètres de la boîte,
 \verb+bclogo+ devient plus léger à  utiliser!
 Merci encore à  Ulrike et à  Manuel!
\end{bclogo}
</code>

{{ mc:complet.png }}



===== List of bclogo =====

Les boîtes sont maintenant "listables" en utilisant la commande :

<code latex>
\listofbclogo
</code>

Qui donne par défaut : 

{{ mc:list.png }}

Les références sont les titres des boîtes. Le titre de la liste peut être mofifié par 

<code latex>
\renewcommand{\titrebclogo}{Liste des fiches}
</code>

===== Les logos =====
Pour la plupart, je les ai dessinés avec Inskape et exportée en PSTricks. Seul point négatif (selon JCC) c'est la ligne :
<code latex>
\psset{xunit=.5pt,yunit=.5pt,runit=.5pt}
</code>

Les logos sont définis avec une largeur de 17pt.

Je définis une commande \bcfleur contenant le code pstricks. Il reste donc à en créer d'autre ;) (l'appel est fait).

Sur les logos autres que le panneau chantier, il y a des fichiers tex externes qui sont appelés dans le fichier "maitre" bclogo.sty.

Depuis, la version 2.0, les logos doivent être exploitable par pstricks et tikz. Il faut donc veiller à fournir les logos dans plusieurs formats. Par exemple pst,  pdf et eps, ou pst et pgf...

==== Le logo « en chantier » ===

{{ mc:enchantier.png }}

**Archive** : {{mc:bclogo-20080318.zip}}
 --- //Jean-Michel Sarlat, 2008/03/18 23:27//





==== Liste des logos ====

**Attention ** depuis la version 2.0, les commandes de logo ont légèrement changées, elles sont précédées de bc pour éviter des redéfinitions de commandes (par exemple avec Fourier).

  - la fleur : commande \bcfleur
  - « en chantier » : commande \bcpanchant  (Jean-Michel SARLAT)     
  - la note : commande \bcnote (Thomas LABARRUSIAS)
  - l’étoile : commande \bcetoile
  - l’ourson : commande \bcours
  - « attention » : commande \bcattention
  - le cœur : commande \bccoeur
  - ornement : commande \bcorne
  - danger : commande \bcdanger  (François BOERKMANN)
  - smiley heureux : commande \bcsmbh (François BOERKMANN)                                        
  - smiley malheureux : commande \bcsmmh (François BOERKMANN)
  - Take care : commande \bctakecare  (Patrick FRADIN)
  - Lampe : commande \bclampe (Patrick FRADIN)
  - Le livre : commande \bcbook (Patrick FRADIN)
  - Le trêfle : commande \bctrefle






{{ :mc:logov2-1.png }}

===== Le fichier bclogo.sty =====

L'archive est à décompresser dans son arborescence (la)tex.

**Téléchargement** : 
  * {{:mc:bclogo-v2-1.zip|bclogo v2.1 (04 janvier 2009) : Inversion de l'option par défaut, maintenant c'est pstricks, nouveau logo livre}}
  * {{:mc:bclogo-v2-0.zip|bclogo v2.0 (27 décembre 2008) : Options tikz ou pstricks suivant le choix de compilation, ombre, 3 logos take care, lampe et trefle}}
  * {{mc:bclogo-v1-3.zip|bclogo v1.3 (20 août 2008) : Gestion des paramètres avec ''xkeyval'' et ajout de 3 logos de François Boerkmann}}
  * {{mc:bclogo-v1-27.zip|bclogo v1.27 (14 juillet 2008) : Correction de l'oubli de chargement du paquet ''ifthen''}}
  * {{mc:bclogo-v1-26.zip|bclogo v1.26 (30 juin 2008) : création du logo ornement -- deux styles de titre -- fonction listofbclogo}}

  * {{mc:bclogo-v1-25.tar.gz|bclogo v1.25 (5 avril 2008) : modification du logo attention et création du coeur}}
 
  * {{mc:bclogo-v1-2.tar.gz|bclogo v1.2 (2 avril 2008) : création des logo etoile, ours et attention}}

  * {{mc:bclogo-v1-15.tar.gz|bclogo v1.15 (19 mars 2008) : ajout de la fonction "arrondi" en quatrième argument}}

  * {{mc:bclogo-v1-1.tar.gz|bclogo v1.1 (19 mars 2008)}}


<code latex>
\NeedsTeXFormat{LaTeX2e}
\def\PackageName{bclogo}
\def\fileversion{v2.1}
\def\filedate{2009/04/01}
\ProvidesPackage{bclogo}
   [\filedate\space\fileversion]
\RequirePackage{xkeyval}

%% Les options globales du package sont au nombre de 2: tikz ou pstricks

\newif\iftikz\tikzfalse%
\define@key{bclogo.sty}{pstricks}[]{\tikzfalse}%
\define@key{bclogo.sty}{tikz}[]{\tikztrue}%
\ProcessOptionsX%



\iftikz%
\RequirePackage{tikz}%
\usetikzlibrary{shadows}%
\else%
\RequirePackage{pstricks}%
\RequirePackage{pst-grad}%
\RequirePackage{graphicx}%
\fi%
% les symboles
% ==============================================================================
\iftikz%
% la fleur
\newcommand\bcfleur{\includegraphics[width=17pt]{fleur}}
% une note (Thomas Laburussias)
\newcommand\bcnote{\includegraphics[width=17pt]{note}}
% panneau chantier (Jean-Michel Sarlat)
\newcommand\bcpanchant{\includegraphics[width=17pt]{aux-301}}
% ours
\newcommand\bcours{\includegraphics[width=17pt]{ours}}
% etoile
\newcommand\bcetoile{\includegraphics[width=17pt]{etoile}}
% attention
\newcommand\bcattention{\includegraphics[width=17pt]{attention}}
% attention P.Fradin
\newcommand\bctakecare{\begingroup\input{takecare.pgf}\endgroup}
% lampe P.Fradin
\newcommand\bclampe{\begingroup\input{lampe.pgf}\endgroup}
% coeur
\newcommand\bccoeur{\includegraphics[width=17pt]{coeur}}
% ornement (tire du site http://openclipart.org )
\newcommand\bcorne{\includegraphics[width=17pt]{orne}}
% danger (Francois)
\newcommand\bcdanger{\includegraphics[width=17pt]{danger}}
% smiley bonne humeur (Francois)
\newcommand\bcsmbh{\includegraphics[width=17pt]{smiley_bonnehumeur}}
% smiley bonne humeur (Francois)
\newcommand\bcsmmh{\includegraphics[width=17pt]{smiley_mauvaisehumeur}}
% le trefle
\newcommand\bctrefle{\includegraphics[width=17pt]{trefle}}
% livre P.Fradin
\newcommand\bcbook{\begingroup\input{book.pgf}\endgroup}

\else%pstricks
% la fleur
\newcommand\bcfleur{\begingroup\input{fleur.tex}\endgroup}
% une note (Thomas Laburussias)
\newcommand\bcnote{\begingroup\input{note.tex}\endgroup}
% panneau chantier (Jean-Michel Sarlat)
\newcommand\bcpanchant{\includegraphics[width=17pt]{aux-301.eps}}
% ours
\newcommand\bcours{\begingroup\input{ours.tex}\endgroup}
% etoile
\newcommand\bcetoile{\begingroup\input{etoile.tex}\endgroup}
% attention
\newcommand\bcattention{\begingroup\input{attention.tex}\endgroup}
% attention P.Fradin
\newcommand\bctakecare{\begingroup\input{takecare.pst}\endgroup}
% lampe P.Fradin
\newcommand\bclampe{\begingroup\input{lampe.pst}\endgroup}
% coeur
\newcommand\bccoeur{\begingroup\input{coeur.tex}\endgroup}
% ornement (tire du site http://openclipart.org )
\newcommand\bcorne{\begingroup\input{orne.tex}\endgroup}
% danger (Francois)
\newcommand\bcdanger{\begingroup\input{danger.tex}\endgroup}
% smiley bonne humeur (Francois)
\newcommand\bcsmbh{\begingroup\input{smiley_bonnehumeur.tex}\endgroup}
% smiley bonne humeur (Francois)
\newcommand\bcsmmh{\begingroup\input{smiley_mauvaisehumeur.tex}\endgroup}
% le trefle
\newcommand\bctrefle{\begingroup\input{trefle.tex}\endgroup}
% livre P.Fradin
\newcommand\bcbook{\begingroup\input{book.pst}\endgroup}
\fi

% =========================== La fonction listable =============================
\newcommand{\titrebclogo}{Liste des \texttt{bclogo}}
\newcommand\bccaption[1]{\addcontentsline{bcl}{bclogo}{#1}}
\newcommand\listofbclogo{\section*{\titrebclogo}\@starttoc{bcl}}
\newcommand\l@bclogo[2]{\par\noindent #1,~\textit{page~#2}}
% ======================================= les keys =============================

\define@key{bclogo}{logo}[\bcfleur]{\def\val@logo{#1}}
\define@key{bclogo}{couleur}[white]{\def\val@couleur{#1}}
\define@key{bclogo}{arrondi}[0]{\def\val@arrondi{#1}}
\define@key{bclogo}{epOmbre}[0.125]{\def\val@epOmbre{#1}}
\define@key{bclogo}{arrondi}[0]{\def\val@arrondi{#1}}
\define@key{bclogo}{couleurOmbre}[black]{\def\val@couleurOmbre{#1}}
\define@boolkey{bclogo}{cadretitre}[true]{}
\define@boolkey{bclogo}{ombre}[true]{}

% selection par defaut
\presetkeys{bclogo}{logo, couleur, arrondi, couleurOmbre, epOmbre, ombre=false, cadretitre=false}{}%

%===============================================================================

\newsavebox{\envbox}
%%% precaution JCC
\newcommand*\bclogotitre{}
\newlength{\pgfframesep}
\setlength{\pgfframesep}{\iftikz3pt\else\psframesep\fi}

\newenvironment*{bclogo}[2][]{%
  \setkeys{bclogo}{#1} %on recupere les options
  \par\noindent % attention au retrait d'alinea
  %%% Ajout de JCC : il faut definir les commandes qui seront
  %%% utilisees dans la deuxieme partie de l'environnement
  %%% commande titre
  \renewcommand*\bclogotitre{#2}
  % La commande pour les coins arrondis
  \newcommand{\arr}{\val@arrondi}
  %%% deux types de titres
  \ifKV@bclogo@cadretitre %si cadretitre = true
  \newcommand{\structitre}{%
    \iftikz% cadretitre tizk
    \hfil
    \raisebox{-0.0ex}{%
      \begin{tikzpicture}\node[rectangle, thick, top color=red!60!green!40, bottom color=white,draw]{\large #2};
      \end{tikzpicture}}
    \hfil%
    \else% cadretitre pstricks
    \hfil
    \psframebox[fillstyle=gradient,gradmidpoint=0.2, gradangle=0,gradbegin=red!60!green!40, gradend=white]{\large  #2}
    \hfil%
    \fi
  }
  \else %sinon
  \newcommand{\structitre}{\large \textbf{#2}}%
  \fi%
  \begin{lrbox}{\envbox}
    \ifKV@bclogo@ombre % si l'ombre, on reduit pour que ca loge sur la
                       % largeur de la page (-\val@epOmbre)
    \begin{tabular}{@{}c@{}p{\dimexpr\linewidth-2\pgfframesep-4pt-17pt-\val@epOmbre cm}@{}}
    \else
    \begin{tabular}{@{}c@{}p{\dimexpr\linewidth-2\pgfframesep-4pt-17pt}@{}}
    \fi
      \begin{minipage}{20pt}{\val@logo}\end{minipage}&
      \begin{minipage}{\dimexpr\linewidth-2\pgfframesep-4pt-17pt}{\structitre}\end{minipage}\\%[0ex]
      \vrule width 0.05cm&%
}
{%
      \bccaption{\bclogotitre}
    \end{tabular}%
  \end{lrbox}%
  % Affiche le texte dans un cadre en couleur.
  \iftikz% texte tikz
  \par\noindent
  \begin{tikzpicture}%
    \ifKV@bclogo@ombre %cadre ombre
    \node[fill=\val@couleur,thick, shape=rectangle, inner sep=\pgfframesep, rounded corners=\arr cm,%
    general shadow={fill=\val@couleurOmbre},shadow xshift=\val@epOmbre cm, shadow yshift=-\val@epOmbre cm, draw]{\usebox{\envbox}};
    \else %cadre sans ombre
    \node[fill=\val@couleur,thick, shape=rectangle, inner sep=\pgfframesep,rounded corners=\arr cm, draw]{\usebox{\envbox}};
    \fi
  \end{tikzpicture}
  \par%
  \else% texte pstricks
  \noindent
  \ifKV@bclogo@ombre%cadre ombre
  \rput[tl](-0.21,0){\psframebox[fillstyle=solid, shadow=true, shadowsize=\val@epOmbre cm,%
    shadowcolor=\val@couleurOmbre, fillcolor=\val@couleur,framearc=\arr]{\usebox{\envbox}}}%
  \else%cadre sans ombre
  \rput[tl](-0.21,0){\psframebox[fillstyle=solid, fillcolor=\val@couleur,framearc=\arr]{\usebox{\envbox}}}%
  \fi%
  \par\vspace*{\dimexpr\ht\envbox+\dp\envbox+2\psframesep+2\pslinewidth}
  \fi%fin
  \ifKV@bclogo@ombre\vspace*{\val@epOmbre cm}\fi
}%
</code>
Le wiki de Syracuse

Outils d'utilisateurs

Outils du Site

Outils de la Page
