Différences

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

--- composition:texte:document:que_fait_vraiment_include [2018/06/03 13:06] – samcarter
+++ 2_composition:texte:document:que_fait_vraiment_include [2021/03/01 12:39] (Version actuelle) – Correction d'un lien suite au déplacement de pages. yannick.tanguy
@@ Ligne 1: / Ligne 1: @@
----
+====== Que fait la commande “\include”? ======
-title: What's going on in my `\include` commands?
-category: usage
-permalink: /FAQ-include
-date: 2014-06-10
----
-The original LaTeX provided the `\include` command to address the
+À ses débuts, <latex>\LaTeX</latex> fournissait la commande ''\include'' pour résoudre le problème des documents longs. Avec les ordinateurs relativement lents de l'époque, la commande associée ''\includeonly '' représentait une véritable aubaine. Même si, de nos jours, ''\includeonly'' semble moins intéressant, elle reste utile à certains grands projets. Toutefois, certains utilisateurs sont surpris par le comportement de ces deux commandes : elles sont en fait plus élaborées qu'on le pense.
-problem of long documents: with the relatively slow computers of the
-time, the companion `\includeonly` facility was a boon.  With the
-vast increase in computer speed, `\includeonly` is less valuable
-(though it still has its place in some very large projects).
-Nevertheless, the facility is retained in current LaTeX, and causes
-some confusion to those who misunderstand it.
-In order for `\includeonly` to work, `\include` makes a separate
+Pour que ''\includeonly'' fonctionne, ''\include'' crée un fichier ''aux'' pour chaque fichier inclus et constitue un « point de contrôle » des paramètres importants (tels que les numéros de page, figure, tableau et note de bas de page). Or, [[3_composition:texte:pages:numerotation_des_pages:le_numero_de_page_est_incorrect|évaluer un numéro de page]] peut être délicat. Aussi, en conséquence, la commande ''\include'' //efface// la page en cours avant et après elle. Par ailleurs, ce mécanisme d'inclusion ne fonctionne pas si une commande ''\include'' apparaît dans un fichier qui est lui-même objet d'une commande ''\include'' : <latex>\LaTeX</latex> le diagnostique comme une erreur.
-`aux` file for each included file, and makes a "checkpoint" of
-important parameters (such as page, figure, table and footnote
-numbers).  As a direct result, it _must_ clear the current page
-both before and after the `\include` command.  (The requirement
-derives from the difficulties of
-  [observing page numbers](FAQ-wrongpn).)
-What's more, this mechanism doesn't work if a `\include` command
-appears in a file that was `\include`d itself: LaTeX diagnoses
-this as an error.
-So, we can now answer the two commonest questions about `\include`:
+Ces principes précisés, nous pouvons maintenant répondre aux deux questions les plus courantes sur ''\include'' :
+  * Pourquoi <latex>\LaTeX</latex> place-t-il une page avant et après les commandes ''\include'' ? Parce qu'il le faut, comme vu plus haut. Si cela vous pose difficulté, remplacez la commande ''\include'' par ''\input''. Vous ne pourrez plus utiliser ''\includeonly'' mais il est probable que vous n'en ayez pas besoin.
+  * Pourquoi ne puis-je pas imbriquer les fichiers avec ''\include'' puisque j'ai toujours pu le faire sous LaTeX 2.09 ?  En fait, vous ne pouviez pas, même sous LaTeX 2.09, mais l'échec n'était pas diagnostiqué. Cependant, puisque vous étiez satisfait du comportement sous LaTeX 2.09, remplacez une nouvelle fois les commandes ''\include'' par des commandes ''\input'' (avec, selon le cas des commandes ''\clearpage'' en plus).
--  Why does LaTeX throw a page before and after `\include`
+-----
-    commands?
+//Source:// [[faquk>FAQ-include|What's going on in my “\include” commands?]]
-    Answer: because it has to.  If you don't like it, replace the
-    `\include` command with `\input`&nbsp;&mdash; you won't be able to use
-    `\includeonly` any more, but you probably don't need it anyway, so
-    don't worry.
--  Why can't I nest `\include`d files?&nbsp;&mdash; I always used to be
-    able to under LaTeX 2.09.
-    Answer: in fact, you couldn't, even under LaTeX 2.09, but the failure
-    wasn't diagnosed.  However, since you were happy with the behaviour
-    under LaTeX 2.09, replace the `\include` commands with `\input`
-    commands (with `\clearpage` as appropriate).
+{{htmlmetatags>metatag-keywords=(LaTeX,commande \input,command \include,inclure un document LaTeX,document en plusieurs parties,document maître)
+metatag-og:title=(Que fait la commande \include)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}