Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fichiers:ecrire_un_fichier_texte_a_partir_de_tex [2018/05/22 11:37] – créée joseph.wright
+++ 5_fichiers:ecrire_un_fichier_texte_a_partir_de_tex [2021/03/29 10:24] (Version actuelle) – Traduction en français. jejust
@@ Ligne 1: / Ligne 1: @@
-# Writing (text) files from TeX
+====== Comment écrire des fichiers texte avec TeX? ======
-TeX allows you to write to output files from within your document.
-The facility is handy in many circumstances, but it is vital for
-several of the things LaTeX (and indeed almost any higher-level
-TeX-based macro package) does for you.
-The basic uses of writing to an external file are ''obvious''&nbsp;&mdash;
+Indépendamment de sa sortie en PDF ou DVI, TeX peut écrire
-remembering titles of sections for a table of contents, remembering
+dans des fichiers à partir de votre document.
-label names and corresponding section or figure numbers, all for a
+Cette fonction est souvent pratique, mais elle est surtout vitale
-later run of your document.  However, the ''non-obvious'' thing is
+pour les fonctions de base de LaTeX (et en fait pour presque
-easy to forget: that page numbers, in TeX, are slippery beasts, and
+toutes les extensions TeX de haut niveau).
-have to be captured with some care.  The trick is that `\write`
-operations are only executed as the page is sent to the DVI
-or PDF file.  Thus, if you arrange that your page-number macro
-(`\thepage`, in LaTeX) is not expanded until the page is
-written, then the number written is correct, since that time is where
-TeX guarantees the page number tallies with the page being sent
-out.
-Now, there are times when you want to write something straight away:
+Les usages de base de la création de fichiers externes sont évidentes:
-for example, to interact with the user.  TeX captures that
+mémoriser les titres des sections pour construire la table des matières,
-requirement, too, with the primitive command `\immediate`:
+se souvenir des noms d'étiquettes et des numéros des sections ou des figures correspondantes,
-```latex
+tout cela pour que la compilation suivante de votre document puisse les utiliser.
-\immediate\write\terminal{I'm waiting...}
+Un usage moins évident concerne les numéros de pages: dans TeX, ils changent au cours
-```
+de la compilation, au fur et à mesure que le texte et les flottants sont positionnés.
-writes a ''computer-irritates-user'' message, to the terminal.
+Il faut donc un certain soin pour les enregistrer.
+L'astuce est que les opérations d'écriture, faites par la commande ''\write''
+ne sont exécutées qu'au moment où la page est envoyée vers le fichier DVI ou PDF.
+Ainsi, si vous faites en sorte que votre macro contenant le numéro de page (''\thepage'', en LaTeX)
+ne soit pas développée avant que la page ne soit écrite, le numéro écrit est correct,
+puisqu'à ce moment-là TeX peut garantir que le numéro de page correspond réellement à la page envoyée.
-Which brings us to the reason for that `\terminal`.  TeX can
+Maintenant, il y a des moments où vous voulez écrire quelque chose **immédiatement**:
-`\write` up to 16 streams simultaneously, and that argument to
+par exemple, pour interagir avec l'utilisateur. TeX se plie à cette exigence
-`\write` says which is to be used.  Macro packages provide the
+avec la primitive ''\immediate'':
-means of allocating streams for your use: Plain TeX provides a macro
+<code latex>
-`\newwrite` (used as `\newwrite``\streamname`, which sets
+\immediate\write\terminal{J'attends...}
-`\streamname` as the stream number).  In fact, `\terminal` (or
+</code>
-its equivalent) is the first output stream ever set up (in most macro
+qui écrit sur le terminal son message à destination de l'utilisateur.
-packages): it is never attached to a file, and if TeX is asked to
-write to _any_ stream that isn't attached to a file it will send
-the output to the terminal (and the log).
+Ce qui nous amène à la raison de ce ''\terminal''.
+TeX peut écrire jusqu'à 16 flux simultanément, et l'argument de ''\write''
+indique lequel doit être utilisé. Des macros existent pour allouer des flux à vos usages:
+Plain TeX fournit une macro ''\newwrite'' (utilisée comme ''\newwrite\streamname'',
+qui définit ''\streamname'' comme numéro du flux).
+En fait, ''\terminal'' (ou son équivalent) est le premier flux de sortie qui n'a pas été configuré:
+il n'est pas attaché à un fichier, et si on demande à TeX d'écrire dans un flux
+qui n'est pas attaché à un fichier, il enverra la sortie vers le terminal
+(et le fichier ''.log'').
+-----
+//Sources://
+  * [[faquk>FAQ-write|Writing (text) files from TeX]],
+  * [[https://tex.stackexchange.com/questions/290054/write-values-to-a-file|Write values to a file]].
+{{htmlmetatags>metatag-keywords=(LaTeX,fichiers externes,créer un fichier depuis TeX,primitive \write)
+metatag-og:title=(Écrire des fichiers texte avec TeX)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}