====== Environnement bclogo ======

===== Attention =====
Cette page n'est pas à jour, il est préférable de regarder la doc (voir fin de la page pour télécharger le tout)
===== description =====


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.

==== La barre verticale ====

En générale, le style de barre verticale se choisit grâce àa la commande ''barre = <style>''.

=== Barre droite ===

C'est celle par défaut (''barre = line''), tous les exemples précedents l'illustre.

== Epaisseur de la barre ==

On peut modifier l'épaisseur de la barre avec la commande ''epBarre = <valeur en pt>''.

<code latex>
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, epBarre = 3.5]{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}
</code>

donne :

{{ :mc:epbarre.png }}

Par défaut la valeur est à 1.5 pt.

==== La barre «~zigzag~» ====

Ce style de barre s'obtient avec la commande ''barre=zigza''. Par exemple :
<code latex>
\begin{bclogo}[couleur = blue!30, arrondi = 0.1, logo = \bcquestion, barre = zigzag]{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}
</code>

donne :

{{ :mc:zigzag.png }}




==== 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-24.zip|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}}

  * {{:mc:bclogo-v2-22bis.zip|bclogo v2.22 (18 janvier 2009) : toujours la même version, j'avais oublié de documenter l'option noborder}}

  * {{:mc:bclogo-v2-22.zip|bclogo v2.22 (15 janvier 2009) : Réglages arrondis absolu en pstricks, les logos (fichiers) sont renommés bc-<logo>.<ext>}}

  * {{:mc:bclogo-v2-21.zip|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}}

  * {{:mc:bclogo-v2-2bis.zip|bclogo v2.2 (11 janvier 2009) : Options sur la barre verticale, nouveau logo question}}

  * {{: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)}}