[latexrefman-commits] [SCM] latexrefman updated: r770 - trunk

[vincentb1 at gnu.org.ua]

Author: vincentb1
Date: 2020-03-29 16:56:01 +0300 (Sun, 29 Mar 2020)
New Revision: 770

Modified:
   trunk/latex2e-fr.texi
Log:
[fr] Merge nodes ?\194?\171?\194?\160\include?\194?\160?\194?\187 and ?\194?\171?\194?\160\includeonly?\194?\160?\194?\187, like in [en].

* latex2e-fr.texi (Splitting the input): Align on English.
(\include & \includeonly): Merges nodes ?\194?\171?\194?\160\include?\194?\160?\194?\187 and
?\194?\171?\194?\160\includeonly?\194?\160?\194?\187 aligning partially on English ?\226?\128?\148 still some work
to be done.


Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2020-03-29 13:50:42 UTC (rev 769)
+++ trunk/latex2e-fr.texi	2020-03-29 13:56:01 UTC (rev 770)
@@ -12314,24 +12314,64 @@
 @cindex partitionner le fichier d'entrée
 @cindex fichier d'entrée
 
-Un document de grande taille nécessite beaucoup de données en
-entrée. Plutôt que de mettre toutes les entrées dans un seul grand
-fichier, il est plus efficace de les partitionner en plusieurs fichiers
-plus petits. Indépendamment du nombre de fichiers distincts que vous
-utilisez, il y en a un seul qui est le
+ at LaTeX{} vous permet de partitionner un document de grande taille en
+plusieurs plus petits. Ceci peut simplifier son édition et permette à
+plusieurs auteur d'y travailler. Cela peut aussi accélerer le
+traitement.
+
+Indépendamment du nombre de fichiers distincts que vous
+utilisez, il y a toujours un seul
 @cindex racine, fichier
 @cindex fichier racine
- at dfn{fichier racine} ; c'est le fichier dont vous passer le nom à la
-ligne de commande quand vous exécutez @LaTeX{}.
+ at dfn{fichier racine} sur lequel la compilation @LaTeX{}
+démarre. L'exemple ci-dessous illuste un tel fichier avec cinq fichiers
+inclus.
 
- at xref{filecontents}, pour un environnement qui permet de grouper un
-fichier externe à créer avec le document principal.
+ at example
+\documentclass@{book@}
+\includeonly@{
+  % mettre en commentaire les lignes ci-dessous pour ne pas compiler le fichier
+  pref,
+  chap1,
+  chap2,
+  append,
+  bib
+  @}
+\begin@{document@}
+\frontmatter
+\include@{pref@} 
+\mainmatter
+\include@{chap1@} 
+\include@{chap2@}
+\appendix
+\include@{append@}
+\backmatter
+\include@{bib@} 
+\end@{document@}
+ at end example
 
+ at noindent
+Dans cet example on prend le matériel de @file{pref.tex},
+ at file{chap1.tex}, @file{chap2.tex}, @file{append.tex}, et
+ at file{bib.tex}.  Si vous compilez ce fichier, et ensuite mettez en
+commentaire toutes les lignes au sein de @code{\includeonly@{...@}}
+hormis @code{chap1}, et compiler de nouveau, alors @LaTeX{} traite
+seulement le matériel du premier chapitre.  Ainsi, la sortie apparaît
+plus rapidement et est plus brève à imprimer.  Malgré cela, l'avantage
+de la commande @code{\includeonly} et que @LaTeX{} retient les numéros
+de page et toute l'information de renvoi des autres parties du document
+de sorte qu'elles apparaissent correctement en sortie.
+
+ at xref{Larger book template} pour un autre exemple de @code{\includeonly}.
+
+ at c xxx Pourquoi avoir supprimer cette ref.
+ at c @xref{filecontents}, pour un environnement qui permet de grouper un
+ at c fichier externe à créer avec le document racine.
+
 @menu
 * \endinput::                 Ne plus include le matériel d'un fichier.
-* \include::            Inclure conditionnellement un fichier.
-* \includeonly::        Determiner quels fichiers sont à inclure.
-* \input::              Inclure inconditionnellement un fichier.
+* \include & \includeonly::   Inclure conditionnellement des fichiers.
+* \input::                    Inclure inconditionnellement un fichier.
 @end menu
 
 
@@ -12376,33 +12416,164 @@
 quelque-chose qui sera tout de même lu.  Ceci vous permet entre autre de
 fermer un @code{\if...} par un @code{\fi}.
 
- at node \include
- at section @code{\include}
+ at node \include & \includeonly
+ at section @code{\include} & @code{\includeonly}
 @findex \include
+ at findex \includeonly
 
 Synopsis :
 
 @example
-\include@{@var{fichier}@}
+\includeonly@{  % dans le préambule du document
+  ...
+  @var{nomfichier},
+  ...
+  @}
+  ...
+\include@{@var{nomfichier}@}  % dans le corps du document
 @end example
 
-Si aucune commande @code{\includeonly} n'est présente, la commande
- at code{\include} exécute un @code{\clearpage} pour commencer une nouvelle
-page (@pxref{\clearpage & \cleardoublepage}), puis elle lit @var{fichier}, et ensuite fait
-encore un @code{\clearpage}.
+Apporte du matériel d'un fichier externe @file{@var{nomfichier}.tex}
+dans un document @LaTeX{}.
 
-Précédé d'une commande @code{\includeonly}, les actions de
- at code{\include} ne sont exécutées que si @var{fichier} est un élément des
-fichiers listés en argument de l'@code{\includeonly}.  Voir @ref{\includeonly}.
+La commande @code{\include} fait trois choses : elle exécute
+ at code{\clearpage} (@pxref{\clearpage & \cleardoublepage}), puis elle
+insère le matériel à partir du fichier @file{@var{nomfichier}.tex} dans
+le document, ensuite fait encore un @code{\clearpage}. Cette commande ne
+peut apparaître que dans le corps du document.
 
+La commande @code{\includeonly} contrôle quels fichier seront lu par
+ at LaTeX{} lors des commandes @code{\include} suivantes. Sa liste de noms
+de fichier est séparée par des virgules, et la commande ne peut
+apparaître que dans le préambule, ou même plus tôt, par ex. dans la
+ligne de commande : elle ne peut pas apparaître dans le corps du
+document.
+
+Dans le document racine en exemple ci-dessous, @file{constition.tex}, on
+inclut trois fichiers, @file{preambule.tex}, @file{articles.tex}, et
+ at file{amendements.tex}.
+
+ at example
+\documentclass@{book@}
+\includeonly@{
+  preambule,
+  articles,
+  amendements
+  @}
+\begin@{document@}
+\include@{preambule@}
+\include@{articles@}
+\include@{amendements@}
+\end@{document@}
+ at end example
+
+ at noindent
+Le fichier @file{preamble.tex} ne contient aucun code spécial ; vous
+avez juste extrait ce chapitre de @file{consitution.tex} pour le mettre
+dans un fichier séparé pour rendre son édition plus commode.
+
+ at example
+\chapter@{Préambule@}
+Le peuple français proclame solennellement son attachement aux Droits de
+l’Homme et aux principes de la souveraineté nationale tels qu’ils ont
+été définis par la Déclaration de 1789, ...
+ at end example
+
+ at noindent
+Exécuter @LaTeX{} sur @file{constitution.tex} fait apparaître le
+matériel issu de ces trois fichiers dans le document mais gén_re
+également les fichiers auxiliaires @file{preamble.aux},
+ at file{articles.aux}, et @file{amendments.tex}. Ceux-ci contiennent de
+l'information telle que les numéros de page et les renvois (@pxref{Cross
+references}).  Si maintenant vous mettez en commentaires les lignes de
+ at code{\includeonly} contenant @code{preamble} et @code{amendments}
+et exécuter @LaTeX{} de nouveau alors le document résultant
+ at c xxxx compléter la trad.
+again then the resulting document shows only the
+material from @file{articles.tex}, not the material from
+ at file{preamble.tex} or @file{amendments.tex}.  Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+
+If the document preamble does not have @code{\includeonly} then
+ at LaTeX{} will include all the files you call for with @code{\include}
+commands.
+
+The @code{\include} command makes a new page.  To avoid that, see
+ at ref{\input} (which, however, does not retain the auxiliary
+information).
+
+ at xref{Larger book template} for another example using @code{\include}
+and @code{\includeonly}.  That example also uses @code{\input} for some
+material that will not necessarily start on a new page.
+
+File names can involve paths.
+
+ at example
+\documentclass@{book@}
+\includeonly@{
+  chapters/chap1,
+  @}
+\begin@{document@}
+\include@{chapters/chap1@}
+\end@{document@}
+ at end example
+
+To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores.  Nevertheless, for the name @samp{amo amas amat},
+this works under @TeX{} Live on GNU/Linux:
+
+ at example
+\documentclass@{book@}
+\includeonly@{
+  "amo\space amas\space amat"
+  @}
+\begin@{document@}
+\include@{"amo\space amas\space amat"@}
+\end@{document@}
+ at end example
+
+and this works under MiK at TeX{} on Windows:
+
+ at example
+\documentclass@{book@}
+\includeonly@{
+  @{"amo amas amat"@}
+  @}
+\begin@{document@}
+\include@{@{"amo amas amat"@}@}
+\end@{document@}
+ at end example
+
+ at cindex nested @code{\include}, not allowed
+You cannot use @code{\include} inside a file that is being included or
+you get @samp{LaTeX Error: \include cannot be nested.}  The
+ at code{\include} command cannot appear in the document preamble; you will
+get @samp{LaTeX Error: Missing \begin@{document@}}.
+
+If a file that you @code{\include} does not exist, for instance if you
+ at code{\include@{athiesm@}} but you meant @code{\include@{atheism@}},
+then @LaTeX{} does not give you an error but will warn you @samp{No file
+athiesm.tex.}  (It will also create @file{athiesm.aux}.)
+
+If you @code{\include} the root file in itself then you first get
+ at samp{LaTeX Error: Can be used only in preamble.}  Later runs get
+ at samp{TeX capacity exceeded, sorry [text input levels=15]}.  To fix
+this, you must remove the inclusion @code{\include@{root@}} but also
+delete the file @file{@var{root}.aux} and rerun @LaTeX{}.
+
+
+ at c xxx \includeonly omis = tout prendre
+ at c xxx \includeonly sur la ligne de commande
+ at c xxx qu'est-ce qu'il se passe si plusieurs \includeonly
+ at c xxx Revoir la traduction
+
 @cindex @code{\include} emboîtés interdits
 La commande @code{\include} ne doit apparaître ni dans le préambule, ni
 au sein d'un fichier lu par une autre commande @code{\include}.
 
 
- at node \includeonly
- at section \@code{includeonly}
- at findex \includeonly
 
 Synopsis :