8.11 filecontents: Écrire un fichier externe

Synopsis :

\begin{filecontents}[option]{nomfichier}
texte
\end{filecontents}

ou

\begin{filecontents*}[option]{nomfichier}
texte
\end{filecontents*}

Crée un fichier nommé nomfichier dans le répertoire courant (ou dans le répertoire de sortie s’il a été spécifié ; voir output directory) et y écrit texte. Par défaut un fichier déjà existant n’est pas écrasé.

La version non étoilée de l’environnement filecontent préfixe le contenu du ficher créé d’une en-tête de commentaires TeX ; voir l’exemple ci-dessous. La version étoilée filecontent* n’inclut par l’en-tête.

Les options possibles sont :

force

overwrite

Écrase le fichier s’il existe.

noheader

Omet l’en-tête. Équivalent à utiliser filecontents*.

nosearch

Vérifie uniquement si un fichier existe dans le répertoire courant (et le répertoire de sortie, s’il a été spécifié), non dans le chemin complet de recherche.

Ces options ont été ajoutées à la parution 2019 de LaTeX.

Cet environnement peut être utilisé n’importe où dans le préambule, bien qu’il apparaisse souvent avant la commande \documentclass. Elle est classiquement utilisée pour créer un fichier .bib ou d’autre fichier de données similaire à partir du document source principale, de sorte à rendre le fichier source autonome. De même, il peut être utilisé pour créer un fichier personnalisé de style ou de classe, rendant ainsi encore le source autonome.

Par exemple, ce document :

\documentclass{article}
\begin{filecontents}{JH.sty}
\newcommand{\monnom}{Jim Hef{}feron}
\end{filecontents}
\usepackage{JH}
\begin{document}
Un article de \monnom.
\end{document}

produit ce fichier JH.sty :

%% LaTeX2e file `JH.sty'
%% generated by the `filecontents' environment
%% from source `test' on 2015/10/12.
%%
\newcommand{\monnom}{Jim Hef{}feron}