Différences

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

--- composition:texte:document:utiliser_le_nom_de_fichier_dans_le_document [2018/06/03 13:15] – samcarter
+++ 3_composition:document:utiliser_le_nom_de_fichier_dans_le_document [2022/10/10 13:40] (Version actuelle) – Usage de ⟨...⟩ dbitouze
@@ Ligne 1: / Ligne 1: @@
----
+====== Comment afficher le nom du fichier compilé? ======
-title: What's the name of this file
-category: usage
-permalink: /FAQ-filename
-date: 2014-06-10
----
-One might want this so as to automatically generate a page header or
+Vous souhaitez générer automatiquement un en-tête ou un pied de page intégrant le fichier en cours de traitement ?
-footer recording what file is being processed.  It's not easy&hellip;
+Ce n'est pas toujours trivial, voici pourquoi...
-TeX retains what it considers the name of the _job_, only, in
+<latex>\TeX</latex> conserve ce qu'il considère comme le nom de sa //tâche// (son «//job//»), dans la primitive ''\jobname''.
-the primitive `\jobname`; this is the name of the file first
+Il s'agit en général du nom du fichier passé à <latex>\TeX</latex> sur la ligne de commande, dépouillé de l'éventuel nom de répertoire
-handed to TeX, stripped of its directory name and of any extension
+et de toute extension (telle que ''.tex''). Mais dans deux cas, ça ne sera pas un nom de fichier:
-(such as `tex`).  If no file was passed (i.e., you're using
+  * si aucun fichier n'a été passé (c'est-à-dire que vous utilisez <latex>\TeX</latex> de manière interactive), ''\jobname'' a la valeur fixe ''texput'' (c'est aussi le nom qui est donné au fichier ''log'' dans ce cas);
-TeX interactively), `\jobname` has the value `texput`
+  * si vous avez utilisé l'option  ''-jobname=⟨//nom//⟩'' du compilateur, ''\jobname'' aura la valeur ''//nom//'', indépendamment du nom réel du fichier compilé.
-(the name that's given to `log` files in this case).
-This is fine, for the case of a small document, held in a single file;
+Si votre document est stocké dans un unique fichier, utiliser ''\jobname'' est la bonne solution.
-most significant documents will be held in a bunch of files, and
+Mais les documents plus importants seront souvent stockés dans un ensemble de fichiers et
-TeX makes no attempt to keep track of files input to the
+<latex>\TeX</latex> ne fait aucune tentative pour garder trace des différents fichiers lus au cours de sa //tâche// de compilation.
-_job_.  So the user has to keep track, himself&nbsp;&mdash; the only way
+L'utilisateur doit donc faire le suivi lui-même et le seul moyen consiste à modifier les commandes d'entrée
-is to patch the input commands and cause them to retain details of the
+et à leur faire conserver les détails des noms de fichiers.
-file name.  This is particularly difficult in the case of Plain TeX,
+Cette opération est particulièrement difficile dans le cas de Plain <latex>\TeX</latex> du fait
-since the syntax of the `\input` command is so peculiar.
+de la syntaxe particulière de la commande ''\input''.
-In the case of LaTeX, the input commands have pretty regular
+Dans le cas de <latex>\LaTeX</latex>, les commandes d'entrée ont une syntaxe plus classique
-syntax, and the simplest [patching techniques](FAQ-patch) can be
+et les [[2_programmation:macros:patcher_une_commande_existante|techniques de correction]] usuelles peuvent y être appliquées.
-used on them.  (Note that LaTeX's `\input` command is itself a
+Pour information, la commande ''\input'' de <latex>\LaTeX</latex> est elle-même une modification de la commande Plain <latex>\TeX</latex>.
-patch on top of the Plain TeX command.  Our patches apply to the
+Nos patchs s'appliquent à la version <latex>\LaTeX</latex> de la commande, utilisée sous la forme ''\input{⟨//fichier//⟩}''.
-LaTeX version of the command, which is used as `\input{file}`)
+Ce type de manipulation reste cependant peu recommandé par rapport aux méthodes suivantes.
-It is possible to keep track of the name of the file currently being
+===== Avec l'extension “currfile” =====
-processed, but it's surprisingly difficult (these FAQs offered
-code, for a long time, that just didn't work in many cases).
-The [`currfile`](https://ctan.org/pkg/currfile) package provides a regular means of keeping
+L'extension [[ctanpkg>currfile]] fournit un moyen de garder une trace des détails du fichier courant
-track of the details of the current file (its name in
+(son nom dans ''\currfilename'', son répertoire dans ''\currfiledir'', ainsi que son nom de fichier
-`\currfilename`, directory in `\currfiledir`, as well as the
+sans extension et son extension). Pour y arriver, elle utilise une deuxième extension, [[ctanpkg>filehook]],
-file "base" name (less its extension) and its extension).
+qui repère les opérations sur fichiers qui utilisent ''\input'', ''\InputIfFileExists'' et ''\include'',
-[`Currfile`](https://ctan.org/pkg/Currfile) does this with the help of a second package,
+ainsi que les chargements d'extensions et de classes.
-[`filehook`](https://ctan.org/pkg/filehook), which spots file operations that use `\input`,
-`\InputIfFileExists` and `\include`, as well as package and
-class loading.
-The [`FiNK`](https://ctan.org/pkg/FiNK) ("File Name Keeper") package keeps track of the
+===== Avec l'extension “FiNK” =====
-file name and extension, in a macro `\finkfile`.  [`FiNK`](https://ctan.org/pkg/FiNK) is
-now deprecated, in favour of [`currfile`](https://ctan.org/pkg/currfile), but remains available
-for use in old documents.
-The [`FiNK`](https://ctan.org/pkg/FiNK) bundle includes a `fink.el` that provides
-support under Emacs with AUC-TeX.
+:!: L’extension [[ctanpkg>FiNK|FiNK]] est classée comme [[1_generalites:histoire:liste_des_packages_obsoletes|obsolète]].
+Ce qui suit est informatif.
+L'extension [[ctanpkg>FiNK|FiNK]] (pour //File Name Keeper//, autrement dit « gardien de nom de fichier ») garde la trace du nom
+et de l'extension du fichier, dans une commande ''\finkfile''. [[ctanpkg>FiNK|FiNK]] est désormais obsolète, au profit de [[ctanpkg>currfile]],
+mais reste disponible pour une utilisation dans les anciens documents.
+En bonus, [[ctanpkg>FiNK|FiNK]] fournit un script en [[wpfr>Lisp]], ''fink.el'', qui offre un support sous Emacs avec AUC-TeX.
+-----
+//Source:// [[faquk>FAQ-filename|What's the name of this file]]
+{{htmlmetatags>metatag-keywords=(LaTeX,noms des fichiers chargés,nom des fichiers compilés,nom du job,exécution)
+metatag-og:title=(Comment afficher le nom du fichier compilé)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}