====== Que sont les environnements LaTeX? ======

Les //environnements// ont été mis en place avec <latex>\LaTeX</latex> : ils effectuent une action sur la totalité d'un bloc délimité dans le document plutôt que d'agir en un point donné de votre document.

===== Environnement sans paramètre =====

Un environnement simple pourrait changer la police utilisée pour une partie du texte. En voici un exemple de définition :

<code latex>
\newenvironment{chassefixe}%
  {% Code exécuté au début de l'environnement
   \ttfamily}%
  {% Code exécuté en fin d'environnement
  }
</code>

L'environnement ''chassefixe'' ainsi défini peut ensuite être utilisé de la manière suivante :

<WRAP column 50ex>
<code latex>
Voici un exemple%
\begin{chassefixe}
de texte à chasse fixe.
\end{chassefixe}
</code>
</WRAP>
<WRAP column 30ex>
<latexdoc>
\documentclass{article}
  \usepackage{lmodern}
  \pagestyle{empty}

\newenvironment{chassefixe}%
  {\ttfamily}%
  {}

\begin{document}
Voici un exemple%
\begin{chassefixe}
de texte à chasse fixe.
\end{chassefixe}
\end{document}
</latexdoc>
</WRAP>
<WRAP clear />

Certains environnements s'avèrent autrement plus complexes tel ''document''. Simple d'usage, il n'en appelle pas moins des codes <latex>\TeX</latex> peu évidents. De fait, la plupart des environnements sont plus élaborés que ''chassefixe'' et //beaucoup// plus simples que ''document''.

Un environnement place son contenu dans un //groupe// <latex>\TeX</latex>, de sorte que les commandes utilisées à l'intérieur de l'environnement « ne s'en échappent pas ». Ainsi, l'environnement ''chassefixe'', ci-dessus, restreint son effet à son propre contenu (ce qui figure entre ''\begin{chassefixe}'' et ''\end{chassefixe}''), ce qui correspond exactement à notre besoin.

<note tip>
Certains environnements simples ne nous font pas gagner beaucoup de temps en matière de saisie. De fait, notre environnement ''chassefixe'' pourrait être remplacé par : 

<code latex>
Voici un exemple {\ttfamily de texte à chasse fixe.}
</code>

Cependant, ces environnements :
  * peuvent rendre votre code plus lisible ;
  * permettent de mieux gérer la mise en forme de votre document. Ainsi, modifier la définition de votre environnement modifiera la mise en forme de tous les environnements présents dans votre document.
</note>

===== Environnement avec paramètres =====

<latex>\LaTeX</latex> permet également d'utiliser des paramètres avec les environnements. Voici un exemple d'environnement demandant un paramètre : 

<code latex>
\newenvironment{blocfonte}[1]%
  {#1\selectfont}%
  {}
</code>

Cet environnement s'utilise alors ainsi (et produit ici le même résultat que l'environnement ''chassefixe'' vu plus haut) :

<code latex>
Voici un exemple%
\begin{blocfonte}{\ttfamily}
de texte à chasse fixe.
\end{blocfonte}
</code>

==== Les paramètres optionnels ====

Les environnements peuvent également avoir des paramètres optionnels, à l'image des commandes. Voici un exemple : 

<code latex>
\newenvironment{textespecial}[1][\itshape]%
  {#1}%
  {}
</code>

En temps normal, cet environnement compose son contenu en italique mais, dès qu'un paramètre lui est transmis, il modifie la mise en forme (ici, une nouvelle fois pour restituer la mise en forme obtenue avec ''chassefixe'') :

<code latex>
Voici un exemple%
\begin{textespecial}{\ttfamily}
de texte à chasse fixe.
\end{textespecial}
</code>

==== La gestion des paramètres en fin d'environnement ====

Les paramètres d'environnement //ne sont pas transmis// au code en fin d'environnement. Dès lors, le code suivant pose problème :

<code latex>
\newenvironment{textespecial}[1][extrait]%
  {Ici commence notre #1.}%
  {Ici finit notre #1.}
</code>

Il se produit ici l'erreur suivante (détaillée à la question « [[2_programmation/erreurs/i/illegal_parameter_number_in_definition_of_command|Que signifie l'erreur: “Illegal parameter number in definition of ⟨commande⟩” ?]] » :

<code text>
! Illegal parameter number in definition of \endtextespecial.
</code>

Aussi, si vous devez passer un paramètre d'environnement dans le code de fin d'environnement, vous devez le transmettre par le biais d'une commande intermédiaire contenant votre paramètre placée dans le code de début d'environnement :

<code latex>
\newenvironment{textespecial}[1][extrait]%
  {Ici commence notre #1.%
   \newcommand{\transfert}{#1}}%
  {Ici finit notre \transfert.}
</code>

-----
//Source:// [[faquk>FAQ-whatenv|What are LaTeX “environments”]]

{{htmlmetatags>metatag-keywords=(LaTeX,programmation,environnements,environnement,environnements personnalisés)
metatag-og:title=(Que sont les environnements LaTeX)
metatag-og:site_name=(FAQ LaTeX francophone)
}}