[latexrefman-commits] [SCM] latexrefman updated: r792 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Thu Apr 16 13:27:00 CEST 2020
Author: vincentb1
Date: 2020-04-16 14:27:00 +0300 (Thu, 16 Apr 2020)
New Revision: 792
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Log:
[fr] node \write18 translation.
* latex2e-fr.texi (Class and package construction): Typoes.
(\write): Clarify example comment, ?\194?\171?\194?\160courant?\194?\160?\194?\187 ?\226?\134?\146 ?\194?\171?\194?\160racine?\194?\160?\194?\187.
(\wlog): Suppress spurious space in example.
(\write18): Translate node with fixing statement on \jobname.
* latex2e.texi (\write): Clarify example comment, ?\194?\171?\194?\160main?\194?\160?\194?\187 ?\226?\134?\146 ?\194?\171?\194?\160root?\194?\160?\194?\187.
(\write18): Fix statement on ?\194?\171?\194?\160\jobname?\194?\160?\194?\187.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-04-15 17:20:43 UTC (rev 791)
+++ trunk/ChangeLog 2020-04-16 11:27:00 UTC (rev 792)
@@ -1,3 +1,13 @@
+2020-04-16 Vincent Belaïche <vincentb1 at users.sourceforge.net>
+
+ * latex2e-fr.texi (Class and package construction): Typoes.
+ (\write): Clarify example comment, « courant » → « racine ».
+ (\wlog): Suppress spurious space in example.
+ (\write18): Translate node with fixing statement on \jobname.
+
+ * latex2e.texi (\write): Clarify example comment, « main » → « root ».
+ (\write18): Fix statement on « \jobname ».
+
2020-04-15 Vincent Belaïche <vincentb1 at users.sourceforge.net>
* latex2e.texi (\makeatletter & \makeatother): Suppress confusing
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-04-15 17:20:43 UTC (rev 791)
+++ trunk/latex2e-fr.texi 2020-04-16 11:27:00 UTC (rev 792)
@@ -935,7 +935,7 @@
@cindex classe et paquetage, différence
@cindex différence entre classe et paquetage
-Au sein d'un fichier classe pour paquetate on peu utiliser l'arobe
+Au sein d'un fichier classe ou paquetage on peut utiliser l'arobe
@code{@@} comme un caractère dans les noms de commande sans avoir à
entourer le code contenant la commande en question par
@code{\makeatletter} et @code{\makeatother}. @xref{\makeatletter &
@@ -14326,7 +14326,7 @@
@example
\newwrite\monfichier
-\immediate\openout\monfichier=\jobname.jh % \jobname le the nom du fichier courant
+\immediate\openout\monfichier=\jobname.jh % \jobname le the nom de base fichier racine
...
\immediate\write\monfichier@{Bonjour tout le monde !@}
...
@@ -14547,7 +14547,7 @@
@example
\wlog@{C'est Helvetica qui téléphone à Times Roman :@}
-\wlog@{Change de ligne^^J je t'entends très mal.@}
+\wlog@{Change de ligne !^^JJe t'entends très mal.@}
@end example
@@ -14567,78 +14567,94 @@
\write18@{@var{commande_shell}@}
@end example
+Émet une commande vers l'interpréteur du système d'exploitation. Le
+système d'exploitation exécute la commande et l'exécution de @LaTeX{}
+est bloquée jusqu'à ce que cela soit fini.
- at c xxx continuer la traduction
-Issue a command to the operating system shell. The operating system
-runs the command and @LaTeX{}'s execution is blocked until that
-finishes.
-
@PkgIndex{Asymptote}
-This
+La séquence suivante (sur Unix)
@example
-\usepackage@{graphicx@} % in preamble
+\usepackage@{graphicx@} % dans le préambule
...
-\newcommand@{\fignum@}@{1@}
-\immediate\write18@{cd pix && asy figure\fignum@}
-\includegraphics@{pix\figure\fignum.pdf@}
+\newcommand@{\numerofig}@{1@}
+\immediate\write18@{cd pix && asy figure\numerofig}
+\includegraphics@{pix\figure\numerofig.pdf@}
@end example
@noindent
-will run @file{Asymptote} on @file{pix/figure1.asy}, so that the
-document can later read in the resulting graphic
-(@pxref{\includegraphics}). Like any @code{\write}, here @LaTeX{}
-expands macros in @var{commande_shell} so that @code{\fignum} is replaced
-by @samp{1}.
+exécute Asymptote (le programme @code{asy}) sur le fichier
+ at file{pix/figure1.asy}, de sorte que le document peut par la suite lire
+le graphique en résultant (@pxref{\includegraphics}). Comme pour tout
+ at code{\write}, ici @LaTeX{} développe les macros contenues dans
+ at var{commande_shell} de sorte que @code{\numerofig} est remplacé par
+ at samp{1}.
-Another example is that you can automatically run Bib at TeX{} at the start
-of each @LaTeX{} run (@pxref{Using BibTeX}) by including
- at code{\immediate\write18@{bibtex8 \jobname@}} as the first line of the
-file. Note that @code{\jobname} gives the base name of the current
-file.
+Un autre exemple est que vous pouvez exécuter automatiquement Bib at TeX{}
+au début de chaque exécution de @LaTeX{} (@pxref{Using BibTeX}) en
+incluant @code{\immediate\write18@{bibtex8 \jobname@}} comme première
+ligne du fichier. Notez que @code{\jobname} se développe par défaut en
+le nom de base du fichier racine, ou bien l'argument de l'option
+ at code{--jobname} si celle-ci est passée sur la ligne de commande.
-You sometimes need to do a multi-step process to get the information
-that you want. This will insert into the input a list of all PDF files
-in the current directory (but see @file{texosquery} below):
+Il peut arriver que vous ayez besoin de plusieurs étapes pour obtenir
+l'information désirée. L'exemple suivant insère en entrée une liste de
+tous les fichiers PDF du répertoire courant (voir aussi
+ at file{texosquery} plus bas) :
@example
\immediate\write18@{ls *.pdf > tmp.dat@}
\input@{tmp.dat@}
@end example
-The standard behaviour of any @code{\write} is to wait until a page is
-being shipped out before expanding the macros or writing to the stream
-(@pxref{\write}). But sometimes you want it done now. For this, use
+Le comportement standard de tout @code{\write} est d'attendre jusqu'à la
+prochaine éjection de page avant de développer les macros ou d'écrire
+dans le flux (@pxref{\write}). Mais il se peut que vous désiriez que
+cela soit immédiat. Pour cela, utilisez
@code{\immediate\write18@{@var{commande_shell}@}}.
-There are obvious security issues with allowing system commands inside a
- at LaTeX{} file. If you download a file off the net and it contains
-commands to delete all your files then you would be annoyed. The
-standard settings in modern distributions turn off full shell
-access. You can turn it on, if you are sure the shell commands are safe,
-by compiling with @code{latex --shell-escape @var{nomfichier}} for @TeX{}
-Live or Mac at TeX{} or @code{latex --enable-write18 @var{nomfichier}} for
-MiK at TeX{} (@pxref{Command line options}).
+Autoriser l'usage de commandes système au sein d'un fichier @LaTeX{}
+pose des problème de sécurité évidents. Si vous télécharger un fichier
+depuis la Toile et qu'il contient des commandes pour détruire tous vos
+fichier, cela vous rendrait bien malheureux. Le réglage standard dans
+les distributions modernes est d'interdire l'accès complet à
+l'interpréteur de commande du système d'exploitation. Vous pouvez
+l'autoriser, si vous êtes sûr qu'il n'y a pas de danger, en compilant
+avec @code{latex --enable-write18 @var{filename}} (@pxref{Command line
+options}). (L'option @code{--shell-escape} est un synonyme dans @TeX{}
+Live.)
- at cindex restricted shell access
-In the place of full shell access, modern distributions by default use a
-restricted version that allows some commands to work, such as those that
-run Metafont to generate missing fonts, even if you do not use the
- at code{shell-escape} or @code{enable-write18} option. By default this
-list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers (@pxref{Command line
-options}).
+ at cindex restreint, accès shell
+ at cindex restreint, accès interpréteur de commande du système d'exploitation
+ at c xxx Compléter la traduction
+Au lieu de l'accès complet, les distributions modenre par défaut
+utilisent une version restreinte qui permet à certaines commandes de
+fonctionner, telles que celles qui font tourner Metafont pour générer
+les polices manquantes, même si vous n'utilisez pas l'option
+ at code{enable-write18}. Par défaut cette liste de commandes autorisées
+est courte et ne fait figurer que les commandes qui sont sous contrôle
+des mainteneurs de la distribution (@pxref{Command line options}).
-Some packages need to run external system commands. For instance
- at file{sagetex} allows you to have the mathematics software system
- at i{Sage} do calculations or draw graphs and then incorporate that
-output in your document. For this you must run @LaTeX{} with full
- at code{\write18} capability turned on.
+Certains paquetage ont besoin d'exécuter des commandes système
+externes. Par exemple @file{sagetex} vous permet de faire faire des
+calcul ou tracer des graphiques au logiciel de mathématiques @i{Sage},
+puis d'incorporer ces sorties dans votre document. Pour cela vous devez
+exécuter @LaTeX{} avec la fonction @code{\write18} pleinement débridée.
- at PkgIndex{texosquery} If what you need is system information, such as
-the operating system name, locale information, or directory contents,
-take a look at the @file{texosquery} package, which provides a
-convenient and secure interface for this:
+ at findex sh at r{, utilisé par @code{\write18}}
+ at findex cmd.exe at r{, utilisé par @code{\write18}}
+Le texte @var{commande_shell} est toujours passé à @file{/bin/sh} sur
+les système d'exploitation unixiens, et à l'interpréteur de commande DOS
+ at file{cmd.exe} sur Windows. @LaTeX{} ignore tout réglage d'un autre
+interpréteur de commande par l'utilisateur, ainsi que la variable
+d'environnement @code{SHELL}.
+
+ at PkgIndex{texosquery}
+Si votre besoin c'est d'avoir de l'information sur le système, comme le
+nom du système d'exploitation, celui de la locale, ou le contenu d'un
+répertoire, alors jeter un coup d'œil au paquetage @file{texosquery} qui
+fournit une interface commode et sûre pour cela, contrairement aux
+exemples donnés plus haut utilisant @code{\write18} à l'état brut :
@url{https://ctan.org/pkg/texosquery}.
@node Command line
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-04-15 17:20:43 UTC (rev 791)
+++ trunk/latex2e.texi 2020-04-16 11:27:00 UTC (rev 792)
@@ -19742,7 +19742,7 @@
@findex \jobname
@example
\newwrite\myfile
-\immediate\openout\myfile=\jobname.jh % \jobname is the main filename
+\immediate\openout\myfile=\jobname.jh % \jobname is the root file basename
...
\immediate\write\myfile@{Hello world!@}
...
@@ -19991,8 +19991,9 @@
Another example is that you can automatically run Bib at TeX{} at the start
of each @LaTeX{} run (@pxref{Using BibTeX}) by including
@code{\immediate\write18@{bibtex8 \jobname@}} as the first line of the
-file. Note that @code{\jobname} gives the base name of the current
-file.
+file. Note that @code{\jobname} expands in the basename of the root
+file unless the @code{--jobname} option is passed on the command line,
+in which case this is the option argument.
You sometimes need to do a multi-step process to get the information
that you want. This will insert into the input a list of all PDF files
More information about the latexrefman-commits
mailing list.