Différences

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

--- composition:texte:document:utiliser_des_fichiers_dans_differents_repertoires [2018/05/24 08:41] – joseph.wright
+++ 2_composition:texte:document:utiliser_des_fichiers_dans_differents_repertoires [2021/02/23 13:05] (Version actuelle) – Traduction de l'article anglais, ajout de liens et correction de la structure. yannick.tanguy
@@ Ligne 1: / Ligne 1: @@
----
+====== Comment inclure des fichiers sans modifier leurs liens internes? ======
-title:  Bits of document from other directories
-section: How do I do&hellip;?
-subsection: Document management
-date: 2014-06-10
----
-A common way of constructing a large document is to break it into a
+La construction d'un document volumineux se fait souvent par division de celui-ci en un ensemble de fichiers (par exemple, un par chapitre) et par conservation de tout ce qui concerne chacun de ces fichiers dans un sous-dossier dédié. Malheureusement, <latex>\TeX</latex> n'a pas de « répertoire courant » modifiable, de sorte que tous les fichiers auxquels vous faites référence doivent être rédigés (ou amendés) en tenant compte du dossier où est présent le fichier principal et non là où est leur propre dossier. Ce qui est plutôt contre-intuitif.
-set of files (for example, one per chapter) and to keep everything
-related to each of these subsidiary files in a subdirectory.
-Unfortunately, TeX doesn't have a changeable ''current directory'',
+Il peut être approprié d'utiliser la technique « d'extension de chemin » [[5_fichiers:tds:installation_temporaire|utilisée dans les installations temporaires]] pour résoudre ce problème. Cependant, s'il y a plusieurs fichiers avec le même nom dans votre document, tels que ''chapitre1/fig1.eps'' et ''chapitre2/fig1.eps'', vous n'aidez guère <latex>\TeX</latex> au moment où, dans le fichier du chapitre principal, vous utiliser une commande ''\input{fig1}''. Bien que la résolution soit évidente avec des fichiers préparés manuellement (ne les nommez juste pas tous de la même manière), les fichiers produits automatiquement ont souvent des noms répétitifs et les renommer peut causer bien des erreurs.
-so that all files you refer to have to be specified relative to the
-same directory as the main file.  Most people find this
-counter-intuitive.
-It may be appropriate to use the ''path extension'' technique
+===== Avec l'extension import =====
-[used in temporary installations](FAQ-tempinst.md) to deal with
-this problem.  However, if there several files with the same name in
-your document, such as `chapter1/fig1.eps` and
-`chapter2/fig1.eps`, you're not giving TeX any hint as to
-which you're referring to when in the main chapter file you say
-`\input{sect1}`; while this is readily soluble in the case of
-human-prepared files (just don't name them all the same),
-automatically produced files have a way of having repetitious names,
-and changing _them_ is a procedure prone to error.
-The [`import`](https://ctan.org/pkg/import) package comes to your help here: it defines an
+L'extension [[ctanpkg>import]] vient à votre aide ici : elle définit une commande ''\import'' qui accepte un nom de chemin complet avec le nom d'un fichier dans ce répertoire et organise tout pour que cela fonctionne correctement. Ainsi, par exemple, si ''/home/ami/results.tex'' contient :
-`\import` command that accepts a full path name and the name of a
-file in that directory, and arranges things to ''work properly''.
-So, for example, if `/home/friend/results.tex` contains
-```latex
-Graph: \includegraphics{picture}
-\input{explanation}
-```
-then `\import{/home/friend/}{results}` will include both
-graph and explanation as one might hope.  A `\subimport` command
-does the same sort of thing for a subdirectory (a relative path rather
-than an absolute one), and there are corresponding `\includefrom`
-and `\subincludefrom` commands.
-The [`chapterfolder`](https://ctan.org/pkg/chapterfolder) package provides commands to deal with its
+<code latex>
-(fixed) model of file inclusion in a document.  It provides commands
+Graphique : \includegraphics{image}
-`\cfpart`, `\cfchapter`, `\cfsection` and `\cfsubsection`,
+\input{explication}
-each of which takes directory and file arguments, e.g.:
+</code>
-```latex
-\cfpart[pt 1]{Part One}{part1}{part}
-```
-which command will issue a ''normal'' command
-`\part[pt 1]{Part One}` and then input the file
-`part1/part.tex`, remembering that `part1/` is now the
-''current folder''.  There are also commands of the form
-`\cfpartstar` (which corresponds to a `\part*` command).
-Once you're ''in'' a [`chapterfolder`](https://ctan.org/pkg/chapterfolder)-included document, you
+alors ''\import{/home/ami/}{results}'' inclura à la fois un graphique et une explication présents dans le dossier ''/home/ami/''. Une commande ''\subimport'' fait le même genre de chose pour un sous-répertoire (un chemin relatif plutôt qu'un chemin absolu). L'extension définit également les commandes ''\include'' et ''\subincludefrom''.
-may use `\cfinput` to input something relative to the ''current
-folder'', or you may use `\input`, using `\cfcurrentfolder` to
-provide a path to the file.  (There are also
-`\cfcurrentfolderfigure` for a `figure/` subdirectory and
-`\cfcurrentfolderlistings` for a `listings/` subdirectory.)
-Documentation of [`chapterfolder`](https://ctan.org/pkg/chapterfolder) is in French, but the
+===== Avec l'extension chapterfolder =====
-`README` in the directory is in English.
+L'extension [[ctanpkg>chapterfolder]] fournit des commandes pour gérer son modèle d'inclusion de fichier dans un document. Elle fournit les commandes ''\cfpart'', ''\cfchapter'', ''\cfsection'' et ''\cfsubsection'', chacune prenant des arguments de répertoire et de fichier, par exemple :
+<code latex>
+\cfpart[pt 2]{Partie deux}{partie2}{partie}
+</code>
+Cette commande va émettre une commande classique ''\part[pt 2]{Partie deux}'' puis inclure le fichier ''partie2/partie.tex'' pour lequel ''partie2/'' est le dossier courant. Il existe également des commandes de la forme ''\cfpartstar'' qui correspondent aux versions « étoilées » (''\part*'' dans le cas présent).
+Une fois que vous êtes au sein d'un document [[ctanpkg>chapitrefolder]], vous pouvez utiliser la commande ''\cfinput'' pour inclure un élément relatif au dossier courant ou vous pouvez utiliser la commande ''\input'', en utilisant ''\cfcurrentfolder'' pour obtenir un chemin vers le fichier. De manière similaire, sont définis quelques autres chemins, par exemple ''\cfcurrentfolderfigure'' pour un sous-dossier ''figure/''.
+-----
+//Source:// [[faquk>FAQ-docotherdir|Bits of document from other directories]]
+{{htmlmetatags>metatag-keywords=(LaTeX,usage)
+metatag-og:title=(Comment inclure des fichiers sans modifier leurs liens internes)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}