From 87726fc3a89b76b6f2bb1866e0a806a7d2d05c2b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 6 Sep 2020 21:12:06 +0000 Subject: latex2e-help-texinfo-fr (6sep20) git-svn-id: svn://tug.org/texlive/trunk@56275 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/latex2e-help-texinfo-fr/ChangeLog | 1580 +- .../doc/latex/latex2e-help-texinfo-fr/NEWS-fr | 17 +- .../doc/latex/latex2e-help-texinfo-fr/common.texi | 59 +- .../latex/latex2e-help-texinfo-fr/latex2e-fr.dbk | 6976 +++++- .../latex/latex2e-help-texinfo-fr/latex2e-fr.html | 23704 ++++++++++++------- .../latex/latex2e-help-texinfo-fr/latex2e-fr.pdf | Bin 1278684 -> 1143753 bytes .../latex/latex2e-help-texinfo-fr/latex2e-fr.texi | 16297 ++++++++----- .../latex/latex2e-help-texinfo-fr/latex2e-fr.txt | 9794 +++++--- .../latex/latex2e-help-texinfo-fr/latex2e-fr.xml | 18332 ++++++++------ 9 files changed, 50986 insertions(+), 25773 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/ChangeLog b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/ChangeLog index 81d3a6676f9..40df5de5c8a 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/ChangeLog +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/ChangeLog @@ -1,4 +1,1313 @@ -2017-08-09 Vincent Belache +2020-09-06 Vincent Bela\"iche + + * NEWS-fr: September 2020 version delivery note. + + * latex2e-fr.texi (Starting and ending): Minor typo. + +2020-09-06 Vincent Bela\"iche + + * latex2e-fr.texi: Finalize propagating Jim's r649, notably + include article template. Fix lots of typoes. + + * latex2e.texi: Insert a comma after @xref{...} wherever + applicable. + (Sectioning): @findex \subsubsection. Typo \og a something\fg -> + \og something\fg. + \og appearance of sectioning commands\fg -> \og + appearance of headings made by sectioning commands\fg. + \og Layout of sectional units\fg -> \og Typesetting + sectional unit headings\fg. + (\@@startsection): \og redefines @code{\section} to have the + form\fg -> \og redefines @code{\section} with keeping its standard + calling form\fg. Typo. + (\@@startsection): \og top of a fresh page\fg -> \og beginning of + a page\fg. It is not really the *top* of the page, but that of the + text content area. + Itemize list of default arguments. + +2020-09-04 Vincent Bela\"iche + + * latex2e-fr.texi (Larger book template): Propagate Karl's r828. + + * latex2e.texi (beamer template): {...}-fiy @PkgIndex argument. + (book template, Larger book template): Revert r828 for \og see + next\fg becoming again \og @xref\fg. + +2020-08-25 Karl Berry + + * latex2e.texi (Document classes) : reword. + (\newcommand & \renewcommand): try to be clearer about + when arguments can be multiple paragraphs; mention \long. + (tugboat template): remove node, is stale. + thoughout: behaviour -> behavior. + +2020-08-07 Vincent Bela\"iche + + * latex2e-fr.texi: Propagate Karl's r810 changes. + + * latex2e.texi (Document templates), + * latex2e-fr.texi (Document templates): \og not reference + material\fg now replaced by \og illustrative\og. Actually the + templates and example *are* reference material, as one may use + them for reference. + +2020-08-06 Vincent Bela\"iche + + * latex2e-fr.texi: Propagate Karl's r811 changes. + (Font sizes): Refresh translation. + + * latex2e.texi: @dfn{...}-ify phases \og declaration form\fg and + \og environment form\fg. + +2020-08-06 Vincent Bela\"iche + + * latex2e-fr.texi: Propagate Karl's r812 changes. + +2020-08-06 Vincent Bela\"iche + + * latex2e-fr.texi (minipage): Fix example using siunitx. + +2020-08-06 Vincent Bela\"iche + + * latex2e-fr.texi (Lengths): Refresh translation. + +2020-08-05 Vincent Bela\"iche + + * latex2e-fr.texi (\frontmatter & \mainmatter & \backmatter): Translate node. + +2020-08-05 Vincent Bela\"iche + + * latex2e-fr.texi (minipage): Re-align on English translation. + + * latex2e.texi (minipage): Typoes + insert a few TODO comments. + +2020-07-13 Vincent Bela\"iche + + * latex2e.texi (\appendix): Fix \og\appendixname\fg description. + (\includegraphics): \og@ci\fg \rightarrow \og@cindex\fg. + + * latex2e-fr.texi (About this document): Typo. + (\appendix): Translate this node. + (\includegraphics): \og@ci\fg \rightarrow \og@cindex\fg. + +2020-07-01 Karl Berry + + * latex2e.texi (Upper and lower case): avoid "American" + characters, and mention expl3's implementation of the Unicode + algorithm. + +2020-06-10 Karl Berry + + * latex2e.texi: consistently use "plain" not "Plain". + + * latex2e.texi (displaymath): reword details about not using $$. + More index entries. + +2020-06-07 Karl Berry + + * latex2e.texi (Font sizes): words of warning about the env form + of font size commands. Suggestion from Denis B. + https://tug.org/pipermail/latexrefman/2020q2/000579.html + + * latex2e.texi (CTAN): reword. + +2020-05-10 Karl Berry + + * latex2e.texi: use @kbd{RETURN}, etc., throughout, + not . + (Sectioning) : reword to avoid bad line breaks. + +2020-05-07 Vincent Bela\"iche + + * latex2e-fr.texi (\subsubsection & \paragraph & \subparagraph): + Translate this node. + (throught the source): Replace \og@tie{}\fg by a non breakable space + character. + +2020-05-03 Vincent Bela\"iche + + * latex2e-fr.texi (\chapter): Typo. + (\section): Translate leftover English text. Typo. + (\subsection): Translate node. + + * latex2e.texi (Recovering from errors): Fix typo, reported by + Werner Lemberg. + (\subsection): \og section\fg \rightarrow \og subsection\fg. + +2020-05-02 Vincent Bela\"iche + + * latex2e-fr.texi (\section): Translate this node. + +2020-04-30 Vincent Bela\"iche + + * latex2e-fr.texi (Larger book template): Translate this node. + +2020-04-30 Vincent Bela\"iche + + * latex2e.texi (Recovering from errors): A few @code{\ldots} or + @samp{\ldots} replaced by @kbd{\ldots}. + + * latex2e-fr.texi (Recovering from errors): Translate node. + (Document templates): Typos. + +2020-04-29 Vincent Bela\"iche + + * latex2e-fr.texi (TODO comment): Remove Patrick Bidault's + suggestion about @value{UPDATED}, agreed with Patrick. + (Top): Typo. + (Command line input): Translate this node. + + * latex2e.texi (Command line input): Insert \og bouding box\fg before + \og size\fg. + +2020-04-26 Vincent Bela\"iche + + * latex2e-fr.texi (TODO comment): add --shell-escape & + --file-line-no wrt MiKTeX, etc. + (external reference comment): Add French version of \og TeX for the + Impatient\fg. + (Low-level font commands): \fontshape, @var{\ldots}-ify \og allure\fg. + (Low-level font commands): \fontsize, revise translation. + (Sectioning): Translate menu description. + (\chapter): Translate node. + + * latex2e.texi (\chapter): Typo in examplicifation of toc title + w/o line skip. + (\write18): as per Karl's comment, \og expands in\fg \rightarrow \og expands to\fg. + +2020-04-22 Vincent Bela\"iche + + * latex2e-fr.texi: Typos. + +2020-04-22 Vincent Bela\"iche + + * latex2e.texi (Command line options): @code{\ldots} \rightarrow @kbd{\ldots} where applicable. + \og@code{jobname}\fg \rightarrow \og@dfn{jobname}\fg. Typo. + + * latex2e-fr.texi (Command line): Typos. + (Command line options): Translate the node. + +2020-04-22 Vincent Bela\"iche + + * latex2e-fr.texi (\accent, \openin & \openout): Insert space before + @var{number}. + (\write): Undo misalignment of %1 %2 %3 comments in + example. + (\write and security): Remove leftover English text. + (Command line): Remove leftover @ignore'd text. + + * latex2e.texi (\accent, \openin & \openout): Insert space before + @var{number}. + (\write): Undo misalignment of %1 %2 %3 comments in + example. + +2020-04-20 Vincent Bela\"iche + + * latex2e.texi (\read): Insert space before @var{number} + (\write): Align vertically the %1, %2, %3 comments in example. + (\write): Typo \og19\fg \rightarrow \og18\fg in stream number cindex entry. + (\write): Fix Security menu entry. + + * latex2e-fr.texi: See Karl's r798 in previous revision. + +2020-04-19 Karl Berry + + * latex2e.texi (\write): edits throughout; more index entries. + (\write and security): new node. + +2020-04-17 Vincent Bela\"iche + + * latex2e-fr.texi (picture): Refresh outdated node translation, + triggered by Karl's r795.. + (\write18): Take Karl's r795. + +2020-04-17 Vincent Bela\"iche + + * latex2e.texi (\makeatletter & \makeatother): Insert + \og typically\fg concerning using the commands in the preamble. + + * latex2e-fr.texi (\makeatletter & \makeatother): Insert + \og typiquement\fg concerning using the commands in the preamble. + +2020-04-16 Karl Berry + + * latex2e.texi (\write18): omit sagetex example, as often not + needed directly. Vincent, 16 Apr 2020 13:11:19 +0200. + Don't use typewriter for the big graphics packages' names. + More index entries. + +2020-04-16 Vincent Bela\"iche + + * latex2e.texi (Command line): Fix menu descriptions, as per + Karl's suggestion --- email of 2020-04-16T14:12:15-07. + + * latex2e-fr.texi (Command line): Propagate the change in + latex2e.texi. + +2020-04-16 Vincent Bela\"iche + + * latex2e-fr.texi (\write18): Fix texinfo compile error. + (\write18): Typo. + (Command line): Translate node. + + * latex2e.texi (Command line): \og file extension\fg \rightarrow \og file name extension\fg. + (Command line): @code{\ldots} \rightarrow @kdb{\ldots}, for -D. + +2020-04-16 Vincent Bela\"iche + + * latex2e-fr.texi (Class and package construction): Typoes. + (\write): Clarify example comment, \og courant\fg \rightarrow \og racine\fg. + (\wlog): Suppress spurious space in example. + (\write18): Translate node with fixing statement on \jobname. + + * latex2e.texi (\write): Clarify example comment, \og main\fg \rightarrow \og root\fg. + (\write18): Fix statement on \og\jobname\fg. + +2020-04-15 Vincent Bela\"iche + + * latex2e.texi (\makeatletter & \makeatother): Suppress confusing + and redundant text. + + * latex2e-fr.texi (\makeatletter & \makeatother): Refurbish translation. + +2020-04-14 Vincent Bela\"iche + + * latex2e-fr.texi (\message): Get refinements from Karl's r788. + + * latex2e.texi (\message): Fix indentation after example. + (\wlog): @code{\ldots} \rightarrow @var{\ldots}. + +2020-04-14 Vincent Bela\"iche + + * latex2e-fr.texi (\message): Translation. + (\wlog): Translation. + +2020-04-12 Karl Berry + + * latex2e.texi (\message): remove "interaction lines", + other wording. + +2020-04-12 Vincent Bela\"iche + + * latex2e-fr.texi (\include & \includeonly): Complete translation. + + * latex2e.texi (\include & \includeonly): Typoes. + +2020-04-06 Vincent Bela\"iche + + * latex2e-fr.texi (Sectioning): Typoes. + + * latex2e.texi (Sectioning): Fix \og secnumdepth\fg \rightarrow \og tocdepth\fg + + * latex2e-fr.texi (\newpage): Refresh translation. + +2020-04-05 Vincent Bela\"iche + + * latex2e-fr.texi (\write): Align menu description on Karl's r782. + (\write18, Command line options): Recopy nodes from English --- they still need translation. + +2020-04-05 Vincent Bela\"iche + + * latex2e-fr.texi (\includegraphics): Recopy latest version. + +2020-04-04 Vincent Bela\"iche + + * latex2e-fr.texi (Top, Front/back matter): Change \og Front/back + matter\fg translation to \og Parties pr\'e/post-liminaires\fg. + (CTAN): Typoes. + (Document classes): Refresh translation. + (\part): Translate node. + (\subsubsection & \paragraph & \subparagraph): Typo. + +2020-04-03 Karl Berry + + * latex2e.tex (\write): tweak menu descriptions. + (\write18): mention /bin/sh and cmd.exe; --enable-write18 + supported by all distributions. + (Command line options): similarly; remove some duplication. + (throughout): @xref must be followed by punctuation. + +2020-04-03 Vincent Bela\"iche + + * latex2e.texi (Sectioning): in \og*-form of sectioning commands\fg, + rephrase \og is not numbered\fg \rightarrow \og does not number it\fg. + (Sectioning): \og in a book\fg \rightarrow \og in the @code{book} class document\fg + (Sectioning): for item \og secnumdepth\fg, insert \og with\fg before + inlined example. + + * latex2e-fr.texi (Sectioning): Complete translation. + (\write): Align menu entry description on karl's r779 update. + +2020-03-31 Vincent Bela\"iche + + * latex2e-fr.texi (CTAN): Translate node. + (\subsubsection & \paragraph & \subparagraph): Progress translation. + +2020-03-30 Karl Berry + + * latex2e.texi (\write): menu item descriptions + for \message and \write18. + +2020-03-30 Vincent Bela\"iche + + * latex2e.texi (Table of contents etc.): Fix description of \og\contentsline\fg. + + * latex2e-fr.texi (Table of contents etc.): Fix description of \og\contentsline\fg. + +2020-03-30 Vincent Bela\"iche + + * latex2e-fr.texi (\write): \og master\fg \rightarrow \og root\fg for consistency. + + * latex2e.texi (\endinput): clarify \og during mailing\fg. + (Table of contents etc.): Move package index reference to the + concerned paragaph. + (\openin & \openout): Typoes. + (\read): \og\file\fg \rightarrow \og\recipient file\fg + (\write): \og@code{\ldots}\fg \rightarrow \og@var{\ldots}\fg. + (\write): typo. + (\write): \og command\fg \rightarrow \og macro\fg, well when talking about + expansion, it is certainly better to use the word \og macro\fg than + the word \og command\fg. + (\write): \og master\fg \rightarrow \og root\fg for consistency. + (\message): \og@code{\ldots}\fg \rightarrow \og@var{\ldots}\fg. + +2020-03-30 Vincent Bela\"iche + + * latex2e-fr.texi (\makeatletter & \makeatother): Update translation. + +2020-03-30 Vincent Bela\"iche + + * latex2e-fr.texi (filecontents, \write18): update translation along r758 + (Low-level font commands): Leftover from r754. + (): + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Sectioning): Progress translation alignment on [en]. + (\part, \chapter, \section, \subsection) + (\subsubsection & \paragraph & \subparagraph, \appendix) + (\frontmatter & \mainmatter & \backmatter): Insert nodes w/o translation. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (\@@startsection): Move node to the same place as in [en]. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Table of contents etc.): Finish translation of + this node. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Table of contents etc.): Make some work to + align translation on [en], still some translation work to be + completed. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Splitting the input): Align on English. + (\include & \includeonly): Merges nodes \og\include\fg and + \og\includeonly\fg aligning partially on English --- still some work + to be done. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Larger book template): Insert w/o translation. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (Command line): Update translation --- not yet + complete though. + (Command line options, Command line input) + (Recovering from errors): Inserted w/o translation. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Insert & translates nodes \og\openin & + \openout\fg, \og\read\fg & \og\write\fg Subnodes of \og\write\fg, i.e. + \og\message\fg, \og\wlog\fg, and \og\write18\fg, are just inserted w/o + translation for the time being. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Insert & translate node \nofiles. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Insert & translate node \endinput. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Merge nodes \og\clearpage\fg & + \og\cleardoublepage\fg to align structure on English. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Fix bad translation of \og cross reference\fg + + align \og Table of contents etc.\fg node name on English. The French + for \og cross reference\fg is \og renvoi\fg. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi: Move nodes \og\makeatletter & \makeatother\fg and + \og\@ifstar\fg to the same place as in English version. + +2020-03-29 Vincent Bela\"iche + + * latex2e-fr.texi (CTAN): Insert node w/o translation. + (Environment): node is moved up in the hierarchy to align on the + English version. + +2020-03-15 Karl Berry + + * latex2e.texi (\include & \includeonly): \includeonly can + appear before the preamble, too. From Vincent. + +2020-03-14 Karl Berry + + * latex2e.texi (\read): exception for non-interactive jobs. + (interaction modes): new anchor. + Some "file name" -> "filename". + Todo: non-ASCII \write; \nonstopmode etc. From Vincent. + +2020-03-11 Karl Berry + + * latex2e.texi (output directory): new anchor, for the + the --output-directory option. More fully describe it, + and reference it where needed. Mentioned by Vincent. + (\write18): mention the texosquery package. + +2020-03-02 Karl Berry + + * latex2e.texi (filecontents): update for the new filecontents + built into LaTeX. Report from John Lienhard, 1 Mar 2020 23:19:39. + +2020-02-04 Vincent Bela\"iche + + * latex2e-fr.texi (\@@startsection): \og scenumdepth\fg \rightarrow \og tocdepth\fg where applicable. + (Class and package commands): Translate index entries. + (figure): \og figure\fg \rightarrow \og figure*\fg. + (list): Typoes. + (quotation & quote): Typo. + (Color): Translate menu entry. + (Commands for color): Translate node. + (Define colors): Translate node. + (Colored text): Translate node. + (Colored boxes): Translate node. + (Colored pages): Translate node. + (Graphics package options): Translate node. + (Graphics package configuration): Translate node. + (\graphicspath): Translate node. + (\DeclareGraphicsExtensions): Translate node. + (\DeclareGraphicsRule): Translate node. + (Text symbols): Typo. + + * latex2e.texi (Colored text): Remove spurious space in example. + (\DeclareGraphicsRule): \og blank\fg \rightarrow \og empty\fg, concerning argument + \og command\fg. + +2019-06-17 Vincent Bela\"iche + + * latex2e-fr.texi (Color models): Translate to French. + +2019-06-06 Vincent Bela\"iche + + * latex2e-fr.texi (Top): Fix menu entries Color & Graphics. + (Color package options): Translate this node. + +2019-06-04 Karl Berry + + * latex2e.texi (Units of length): failed to divide for cm. + Report from Felipe Maia, 29 May 2019 19:51:54. + + (Math symbols) <\vert, \Vert>: refer to Delimiters + instead of repeating text. + Also fix a couple overfull lines. + +2019-05-30 Karl Berry + + * latex2e.texi (\indexspace): a command inserting glue, + not glue itself. + +2019-02-10 Karl Berry + + * latex2e.texi: comma outside macro invocations like @BES and @samp. + +2019-01-22 Vincent Bela\"iche + + * latex2e.texi (trivlist): Typo. + (\parbox): @dfn{\ldots}-ize word \og parbox\fg, and de-@code{\ldots}-ize + it. \og adjacent line\fg \rightarrow \og adjacent text line\fg. + + * latex2e-fr.texi (trivlist): typo. + (\linethickness): typo + (tabular): typoes. + (\newcommand & \renewcommand): use @var{\ldots}. + (\parbox): Re-align French on English version. + (Color package options): progress translation. + +2018-11-26 Karl Berry + + * latex2e.texi (\left & \right): spurious space inside @ref. + +2018-11-30 Vincent Bela\"iche + + * latex2e-fr.texi (list): Translate \topsep description as well as + figure description. + (trivlist): Translate this node. + +2018-11-25 Jim Hefferon + + * latex2e.texi (\DeclareTextAccentDefault): Added. + (\DeclareTextSymbolDefault): Added. + (\UseTextAccent & \UseTextSymbol): Added. + +2018-11-24 Jim Hefferon + + * latex2e.texi (\DeclareTextCommandDefault & \ProvideTextCommandDefault): Added. + +2018-11-24 Jim Hefferon + + * latex2e.texi (\DeclareFontEncoding): Added. + (\DeclareTextCompositeCommand): Added. + (\LastDeclaredEncoding): Added. + +2018-11-23 Jim Hefferon + + * latex2e.texi (\DeclareTextComposite): Added. + +2018-11-22 Jim Hefferon + + * latex2e.texi (\DeclareTextAccent): Added. + +2018-11-21 Jim Hefferon + + * latex2e.texi (\DeclareTextSymbol): Added. + +2018-11-21 Jim Hefferon + + * latex2e.texi (Delimiters): Add section. Put in list of + common delimiters. + (\left & \right) Move to below Delimiters, add material on grouping. + (\bigl & \bigr etc) Add below Delimiters. + +2018-11-19 Vincent Bela\"iche + + * latex2e.texi (itemize): Add @PkgIndex{enumitem}. + (list): \og...\fg \rightarrow \og@dots{}\fg. + (list): @code{\ldots}-ify word \og list\fg in \og When making an instance of + a @code{list}\fg. + (list): \og items\fg \rightarrow \og labels\fg + (list): Typo --- add a \og\\fg. + (list): Cleanup leftover redundant words. + + * latex2e-fr.texi (itemize): Add anchors. + (itemize): Align translation on English version. + (list): Align translation on English version. + (trivlist): New node, in English, needs translation. + (quotation & quote): Node renamed from \og quotation and quote\fg to + align on English. + (\footnotemark): Typo. + +2018-11-13 Karl Berry + + * src/easyurls.py: wording, link to pdf and writing.html. + * common.texi: define lasy math symbols + (from Jim and wasyfont.tex and latexsym.dtx). + * latex2e.texi (Math symbols): use them, in the long list. + +2018-11-11 Jim Hefferon + + * latex2e.texi (Arrows): Add \to, omit \leadsto. + +2018-11-09 Jim Hefferon + + * latex2e.texi (Arrows): Add subsection + +2018-11-03 Jim Hefferon + + * latex2e.texi (fontenc package): Add \DeclareTextCommand & + \ProvideTextCommand. + * Makefile (htmlsplit) Add latex2e-figures subdir so list's figure + shows up. + * easyurls.py Omit traversal of subdirectories to make soft links + because no .html files go in subdirs. + +2018-11-02 Jim Hefferon + + * latex2e.texi (fontenc package): Move subsection to under Fonts. + Adjust wording, add kernel defaults. Remove lmodern from the + sample example. + (Fonts) Expand introductory text, pointing to NFSS commands and to + online docs on available fonts. + +2018-10-27 Jim Hefferon + + * latex2e.texi (fontenc package): Added this subsection. + +2018-10-26 Jim Hefferon + + * latex2e.texi (Greek letters): Added this subsection, just as + a convenience over the large symbol list. + +2018-10-23 Jim Hefferon + + * latex2e.texi (\openin & \openout): Add Phi to symbols. + * keeptrack.csv Change Cyrillic to notdoing. + +2018-10-22 Jim Hefferon + + * latex2e.texi (\openin & \openout): Change description of \openin + to say it handles number allocation. + +2018-10-22 Karl Berry + + * latex2e.texi (\write, etc.): small changes to text and examples. + +2018-10-22 Jim Hefferon + + * latex2e.texi Add \read. + +2018-10-21 Jim Hefferon + + * latex2e.texi Add \openin & \openout. Adjust wording of \write, + \write18, and others. + +2018-10-21 Jim Hefferon + + * latex2e.texi Add \write, \message, \wlog, and \write18. + Change title from Terminal input/output to just Input/output. + Also adjust wording of command line options. + +2018-10-6 Jim Hefferon + + * latex2e.texi Add \accent. Also adjust wording of + sectional unit introduction. + +2018-10-15 Jim Hefferon + + * NEWS Version for CTAN + +2018-10-14 Jim Hefferon + + * easyurls.py Make links be to latexref.xyz + * mirroring.html Make links be to latexref.xyz + * writing.html Make links be to latexref.xyz + +2018-10-14 Jim Hefferon + + * easyurls.py Broken link in header to index.html. + * writing.html Minor wording change. + +2018-10-13 Jim Hefferon + + * index.html Link to writing.html. + * latex2e.texi Minor wording changes. + * mirroring.html Wording changes. Suggest url "latexref/" rather than + "latexrefman/" as it is shorter and matches latexref.xyz. + * writing.html Shorten some parts, fix list bullets. + +2018-10-12 Jim Hefferon + + * latex2e.texi Fix overfull lines in PDF. + +2018-10-12 Jim Hefferon + + * latex2e.texi Add \phantom, etc. Move it and \smash to menu + under Spacing in math mode. + * keeptrack.csv Mark \phantom, \vphantom as done (\hphantom not there). + * Makefile Change svn commands in commitready target. + +2018-10-10 Jim Hefferon + + * latex2e.texi New entry for \smash, starting from Bob's upload. + Change to October. + * keeptrack.csv Mark \smash as done. + * Makefile Commented out commitready target as it did work for the + addtion of _005csmash.html and bs-smash.html. + +2018-10-07 Jim Hefferon + + * writing.html Link to keeptrack.csv, wording changes. + * common.texi Put https on start of home page address, so it works + when accessing via a file:// url. + +2018-10-07 Jim Hefferon + + * keeptrack.csv File to keep track of which commands have been done, + and which need doing. + * keeptrack.py Script to make and update keeptrack.csv. + * Makefile Add code to commitready target for just before committing. + Takes the split .html files and adds any new ones, and drops any ones + that are gone. + * source2e.ind Reference index, from compiling source2e.tex. + +2018-10-05 Karl Berry + + * latex2e.texi (Class and package structure): @item + before first text in @enumerate. + +2018-10-05 Jim Hefferon + + * writing.html Written. Brief outline of how to contribute an entry. + +2018-09-23 Jim Hefferon + + * latex2e.texi Add text to "About this document" pointing to + latexref.xyz. + * mirroring.html Adjust wording, drop CSS for LaTeX. + +2018-09-23 Jim Hefferon + + * latex2e.texi Some wording changes to backslash-space. + * Makefile Add "
" at the bottom of split pages. + * mirroring.html Written. Brief instructions on mirroring. + +2018-09-21 Jim Hefferon + + * latex2e.texi Move \makeatletter & \makeatother and \@ifstar to + section on defining commands. Promote Environments to a section. + Some wording changes. + * latex2e-help-texinfo-tree/latex2e Delete .html files that no longer + apply (declarations). + * Makefile Need a target to automatically do html files + that need to be added and deleted to/from the svn, just before + committing. Commented out for the moment. + +2018-09-19 Jim Hefferon + + * latex2e-help-texinfo-tree/latex2e Add directory, with all its + HTML files, to repo. + * latex2e.texi Change to September 2018 date. + * Makefile Add easyurls to htmlsplit target. + +2018-09-15 Jim Hefferon + + * easyurls.py Added ability to inject text into top of index.html. + Added that it does not make pointers to files created by @anchor(..). + * latex2e.texi Restore Starting & ending anchor. + * latex2elocal.css Changed name to latexreflocal.css + * latex.css Add quotes on @import ... + * Makefile Keep split files from having a footer. + * _version.py Incorporated contents into easyurls.py, to make it + self-contained. + +2018-09-08 Karl Berry + + * Makefile (t2html_home): use https://latexref.xyz. + +2018-08-09 Jim Hefferon + + * latex2e.texi Correct wording in a couple of spots. + * latex2elocal.css Add for hosts to put in local styling. + * latex.css Move optional stylings to prior file. + +2018-08-09 Jim Hefferon + + * latex2e.texi (\cite) Add reference to bibliographic styles. + (\rotatebox) Correct displayed command, adjust wording. + +2018-08-03 Karl Berry + + * index.html: new file to make the checkout a web site; + used for new domain http://latexref.xyz. + +2018-07-25 Jim Hefferon + + * latex2e.texi (copying) Acknowledge Martin Herbert Dietze for + latex2e-reference material. + (Lengths) Adjust wording. + +2018-07-16 Karl Berry + + * latex2e.css (div.referenceinfo): try not floating right, + maybe it will look better at the start of the line. + + * latex2e.texi: (\alph ...): \ast rather than @ast, since @ast is + not a Texinfo command. + +2018-07-08 Karl Berry + + * Makefile (t2html_home): use PRE_BODY_CLOSE; Texinfo's About + button is something else. + (check-dw): better removal of intentional doubles in text. + * latex2e.texi: remove doubled words. + +2018-07-05 Jim Hefferon + + * Makefile Try out making split HTML's. + * latex2e.css Put a minimal amount of styling in the split pages. + +2018-07-03 Jim Hefferon + + * latex2e.texi Do a CTAN release following the checklist in the + file CTAN. Zip file contents from "make dist" looks OK to me. + +2018-07-02 Karl Berry + + * latex2e.texi: typos, underfull boxes, mirror wording. + +2018-07-02 Jim Hefferon + + * latex2e.texi: Finished checking entries against + latex2e-reference. Removed that item from xx list. + (CTAN) Added section. + +2018-07-02 Jim Hefferon + + * latex2e.texi:Check entries against + latex2e-reference. Through "Modes". + +2018-07-01 Jim Hefferon + + * latex2e.texi:Check entries against + latex2e-reference. Through the \t's. + +2018-07-01 Jim Hefferon + + * latex2e.texi:Check entries against + latex2e-reference. Through the \m's. + +2018-06-30 Karl Berry + + * latex2e.texi (Index): Merge General Index and Concept Index. + + * latex2e.texi (\bigskip & \medskip & \smallskip): one + anchor for each. + +2018-06-30 Jim Hefferon + + * latex2e.texi:Try adding anchors that have URL's that + are easy to figure out. Add them in a couple of places, notably + in lists of parameters. + (Predefined lengths) Delete, moving contents to \mbox & \makebox. + +2018-06-29 Jim Hefferon + + * latex2e.texi: Put @noindent's following + @end examples where they are needed in PDF. + +2018-06-29 Karl Berry + + * latex2e.texi (Command line options) <-interaction>: + use @var{mode} to avoid overfull box in index. Use - for printed + output, and no @ftable. + (common.texi): minimize url. + +2018-06-28 Karl Berry + + * latex2e.texi (Command line): both - and -- work in TL, + and, I hope, in MiKTeX. + +2018-06-29 Jim Hefferon + + * latex2e.texi: Under- and underfull lines in PDF + are gone. + +2018-06-29 Jim Hefferon + + * latex2e.texi: Fix over- and underfull lines in PDF. + Through page 100. + +2018-06-28 Jim Hefferon + + * latex2e.texi (Command line) Fix synopsis calling syntax. Added + examples of putting commands on the command line, + and of recovering from errors. This finishes latex-info; I have + removed it from the todo's. + +2018-06-27 Jim Hefferon + + * latex2e.texi (Terminal input/output) Added synopsis, examples. + (Command line) Give synopsis calling syntax. Expanded + into sections the command options, including a discussion of shell + escape. Put in stub for putting commands on the command line, + and for recovering from errors. + +2018-06-26 Jim Hefferon + + * latex2e.texi (Front/back matter) Expanded the entries for the + table of contents, for the index, and for the glossaries. Added + many examples, adjusted wording. Added description of options for + .isty files. + +2018-06-21 Jim Hefferon + + * latex2e.texi (Special insertions) Rearranged the lists so that + the examples come first. That eases finding things for readers, since + all examples are in the same place vertically. Added Unicode for + HTML where available. + +2018-06-20 Jim Hefferon + + * latex2e.texi (\sbox & \savebox) Combined the two. Added examples, + adjusted wording + (lrbox) Adjust wording. + (\usebox) Adjust wording, add error messages. + +2018-06-19 Jim Hefferon + + * latex2e.texi (\strut) Added. + (\mbox & \makebox) Add examples, cross-references, adjust wording. + (\fbox & \framebox) Change name, add examples, adjust wording. + +2018-06-18 Karl Berry + + * latex2e.texi: let's make "uppercase" and "lowercase" one word? + Break some long (>=80 chars) lines, though many remain. + +2018-06-17 Jim Hefferon + + * latex2e.texi (Spaces) Do vertical spacing commands. + Add subsections for \bigskip & \medskip & \smallskip, and the + \bigbreak, etc. Add examples, particularly tricky was \addvspace. + +2018-06-16 Jim Hefferon + + * latex2e.texi (Spaces) Did horizontal spacing commands. + Add subsections for \hss and for tie, ~. Change the two subsections + on \(SPACE) to one, giving \@ its own subsection. Add examples, adjust + wording, add error messages. + (\mbox & \makebox) Combine the two sections into one. This needs more + work, including examples and error messages. + +2018-06-12 Jim Hefferon + + * latex2e.texi (Sectioning) Add subsections for \appendix and for + \frontmatter & \mainmatter & \backmatter. List the sectioning + parameters secnumdepth and tocdepth. Add Larger book template in + part as example of frontmatter, appendix, etc. Also add article + template. Adjust wording of some other sections, such as Tables + of Contents, to fit changes. Add examples. Adjust wording of main + Sectioning section. + +2018-06-11 Jim Hefferon + + * latex2e.texi (Sectioning) Make subsections for \part, \chapter, + \section, etc. Add examples. Adjust wording of main section. + +2018-06-09 Jim Hefferon + + * latex2e.texi (Math miscellany) Move dots to separate subsection + under Math symbols. Move \overline, etc. to separate subsection + after Math accents. Move \imath and \jmath to Math symbols. + Change rest to a menu, with synopses and examples, and error + messages where appropriate. Adjust wording. + +2018-06-07 Jim Hefferon + + * latex2e.texi (\pagestyle) Add description of mechanism, + with example. Modify description of \makeboth, \makeright. + * graphics/Makefile Add. Make the graphics. + (list.eps) Have it generated by Asymptote, to make it smaller + and vector. + +2018-06-07 Jim Hefferon + + * latex2e.texi (\pagenumbering) Add gobble, examples, refs to + page styles and counters. + (\maketitle) Improve example to contain all four declarations. + +2018-06-06 Jim Hefferon + + * latex2e.texi (Math spacing) Adjust wording. + (Page styles) Add example, adjust wording. + +2018-06-06 Jim Hefferon + + * latex2e.texi (Math functions) Make the @math{...} stuff not + appear in the HTML. Add comment about amsmath allowing users to + create their own. + (Math accents) Make the @math{...} stuff not + appear in the HTML. + +2018-06-05 Jim Hefferon + + * latex2e.texi (Math formulas) Adjust wording, including a suggestion + that new math docs should use the AMS packages. Add subsection to + symbols for Caligraphic, \boldmath, and blackboard bold. + +2018-06-04 Jim Hefferon + + * latex2e.texi (Modes) Include all six modes, with the vertical ones. + Adjust wording. + (Making paragraphs) Add \par. Combine \noindent and \indent. + Add \parindent to \parskip. + +2018-06-01 Jim Hefferon + + * latex2e.texi (Page breaking) Next in latex-info. Adjust wording. + Add examples and a few error messages. + (\clearpage & \cleardoublepage) Combine the two into one. + +2018-06-01 Jim Hefferon + + * latex2e.texi (Line breaking) Next in latex-info (split with + page breaking). Adjust wording. Add examples and a few error + messages. Adjust wording. + (sloppypar) Add. + +2018-06-01 Jim Hefferon + + * latex2e.texi (Letters) Next in latex-info. Adjust wording. + (\mlabel) Brought text from fr on customization of label + printing, added example. + +2018-05-31 Jim Hefferon + + * latex2e.texi (Lengths) Next in latex-info is Lengths. + Adjust entries, adding examples and error messages. + (Definitions) \newlength adjusted, examples added. Make + synopses fit pattern elsewhere, including adding case of + no square brackets. Adjust wording of optargdefault in both + \newcommand and \newenvironment. + +2018-05-30 Jim Hefferon + + * latex2e.texi (footnote) Next in latex-info is Footnotes. + Fold examples together into Footnotes in Tables subsection. Move + Parameters subsection material to \footnote. Adjust wording. + +2018-05-29 Jim Hefferon + + * latex2e.texi (thebibliography) Add examples. Adjust wording. + +2018-05-28 Jim Hefferon + + * latex2e.texi (picture) Add examples. Adjust wording. + Add menu items, readjust menu order. Add examples for many + menu subjects and adjust wording. + +2018-05-24 Jim Hefferon + + * latex2e.texi (verbatim) Expand on problems putting + it in argument of macros, add examples. + (verse) Adjust wording. + +2018-05-23 Jim Hefferon + + * latex2e.texi Continue going through latex-info. Through that + doc's Environments. Adjust wording as it arises. + (minipage, parbox) Expand on options, add examples. + +2018-05-19 Jim Hefferon + + * latex2e.texi Continue going through latex-info. Through that + doc's Cross References, Commands, Page Layout. Adjust wording + as it arises, including adding error messages. + +2018-05-18 Karl Berry + + * text: "GNU/Linux", @TeX{} Live, MiK@TeX{}, just @samp. + +2018-05-17 Jim Hefferon + + * latex2e.texi Going through http://ctan.org/pkg/latex-info + (CTAN package latex-info), making sure this doc has everything + the older one has. So far, Counters done. Also adjust wording + as it arises. + +2018-05-17 Jim Hefferon + + * latex2e.texi (\include & \includeonly) Combine the two. Include + discussion of many edge cases, with examples. + (Splitting the input) Add typical case example. + (\endinput) Added. + (\input) Adjust wording to fit changes. + +2018-05-04 Vincent Bela\"iche + + * latex2e-fr.texi (Color): Translate node Color from Jim's r609 --- + subnodes need further translation work. + +2018-04-30 Jim Hefferon + + * Makefile (dist) Add latex2e-es.pdf. + * latex2e.texi (list) Add h0 description accidentally omitted. + (picture) Add additional synopsis, adjust wording. + +2018-03-22 Vincent Bela\"iche + + * latex2e-fr.texi (All document): Use \og tapuscrit\fg instead or as + an alternartive to \og machine \`a \'ecrire\fg for tt font family. + (Top, Color, Graphics): Add Color and Graphics nodes and sub-nodes + thereof, without translation. + (description): Translate edits from Jim r609 2018-03-04 + + * latex2e.texi (description): @var{}-ify \og text of first item\fg + and \og text of second item\fg + (description): \og labeled list of items\fg -> \og list of labeled items\fg + (Color package options): @code{}-ify \og color\fg in title, as it is + the package name. + (Graphics package options, Graphics package configuration): + @code{}-ify \og graphics\fg in title, as it is the package name. + +2018-03-21 Jim Hefferon + + * -- Prepare upload distribution to CTAN with correct file mtimes. + * makedist.sh Delete. (Better to use Makefile) + * CTAN Create Notes on uploading a distribution. + +2018-03-28 Karl Berry + + * Makefile (dist): rm zip file before remaking it; + unzip -l rather than -t for more useful info. + +2018-03-21 Jim Hefferon + + * latex2e.texi (Graphics): Couple of typos, small rewordings. + * makedist.sh Create. Bash script for making .zip for + a distribution for CTAN. + +2018-03-04 Jim Hefferon + + * latex2e.texi (Graphics): Create as a new chapter. Include all + commands and options from grfguide.pdf. + * list.txt Create. ASCII graphic of the list illustration. + +2018-03-04 Jim Hefferon + + * latex2e.texi (Color): Create. Include all commands and + options from grfguide.pdf. + * latex2e.css (code) Create file, so in HTML inside of @math{} the + code elements will be in monotype. + * Makefile Include CSS file in texi2html line; put in dependence + to css file in %.html line. + +2018-02-22 Jim Hefferon + + * latex2e.texi (\spacefactor): Create. Describe the space factor + along with the command. Create sub-menu. + (\(SPACE) and \@) Move to live below \spacefactor. + (\frenchspacing) Also move to below \spacefactor. + (\normalsfcodes) Create, below \spacefactor. + +2018-02-22 Jim Hefferon + + * latex2e.texi (list): Convert legend for picture from caption + to a table. + +2018-02-21 Jim Hefferon + + * latex2e.texi (\ignorespaces & \ignorespacesafterend): Create. + +2018-02-19 Karl Berry + + * latex2e.texi (\list), + (\item), + (trivlist): minor wording and formatting updates. + (\AtBeginDocument, \AtEndDocument): @subsection commands needed. + Various typos etc. throughout. + +2018-02-11 Jim Hefferon + + * latex2e.texi (list environment): Move list parameters to this + entry. + +2018-01-02 Vincent Bela\"iche + + * latex2e-fr.texi (thebibliography, Upper and lower case): Align + on Karl's r598 edits of 2017-10-29. + (\protect, Text symbols): Typos. + +2017-10-29 Karl Berry + + * latex2e.texi: typos, wording. + * aspell.en.pws: more exceptions. + +2017-10-17 Vincent Bela\"iche + + * latex2e-fr.texi (document header): Uppercase title 1st + letter. Make PlainTeX a flag, not sure what the best translation + of this is. + (@TeX{} engines, Class and package commands): use @value{PlainTeX} flag. + (Document class options): Add @PkgIndex{geometry}. + (\newlenth, \newsavebox, \value): Add Jim's edits of r366 2015-06-20. + (\providecommand): Add Jim's edits of r348 2015-05-29. + (\newcommand & \renewcommand): Typo. + (\newenvironment & \renewenvironment): typo. + (\newsavebox): Use \og baquet\fg rather than \og bac\fg to translate + \og bin\fg. + (Special insertions, Non-English characters): Rename node + \og Non-English characters\fg to \og Additional Latin letters\fg. Add an + anchor for backward compatibility. + + * latex2e.texi (Document class options): Add @PkgIndex{geometry}. + +2017-10-08 Vincent Bela\"iche + + * latex2e.texi: Mark tabbing node translation from French as TODO. + (thebibliography): Fix description about \refname, as sometimes it + is also \bibname. + + * latex2e-fr.texi (Environments): Typo in thebibliography entry. + (tabbing): Typo. + (thebibliography): Fix description about \refname, as sometimes it + is also \bibname. + +2017-10-06 Vincent Bela\"iche + + * latex2e-fr.texi: Make EnvIndex and PkgIndex macro usable on the + same line as text. + (Low-level font commands): Fix table column width. Fix translation from English. + (tabbing): Mention algorithm2e and listings packages. + (Upper and lower case): Mention textcase package. + + * latex2e.texi: Make EnvIndex and PkgIndex macro usable on the + same line as text. + (tabbing): Some more translation of the French version. Plus mention + algorithm2e and listings packages. + (Upper and lower case): Mention textcase package. + +2017-10-04 Vincent Bela\"iche + + * latex2e.texi (tabbing): Partial translation of tabbing node + rewrite, and add examples. + (Upper and lower case): Use @samp{...} rather than ``...''. Add + closing @}. Solve overfull box in @example. + + * latex2e-fr.texi (Class and package commands, Special insertions) + (Upper and lower case): Translate Jim's edits from r578 of + 2017-08-06. + (tabbing): Rewrite this node, and add examples. + (table): Typo. + + +2017-10-03 Vincent Bela\"iche + + * latex2e-fr.texi (Class and package commands): Typo. + (quotation and quote): Typoes. + +2017-08-24 Karl Berry + + * latex2e.texi, + * latex2e-fr.texi (Low-level font commands): remove width percentages. + +2017-08-22 Vincent Bela\"iche + + * latex2e.texi: push iftexthenelse macro and HAS-MATH flag to common.texi + (Low-level font commands): Restore cmss & cmtt. `@dmn{}%' -> `%'. + + * latex2e-fr.texi: push iftexthenelse macro and HAS-MATH flag to common.texi + (Low-level font commands): Restore cmss & cmtt. `@dmn{}%' -> `@dmn{%}'. + + * common.texi: push iftexthenelse macro and HAS-MATH flag to common.texi + +2017-08-22 Vincent Bela\"iche + + * latex2e.texi (Low-level font commands): Refer to + https://ctan.org/pkg/encguide. Use multitables to achieve Jim's + goal of having 1st column entry on the same line as 2nd column + entry, it seems cleaner than itemize + '@t{@ }'. Add comment why + cmss & cmtt were dropped ? + (Low-level font commands/\baselinestretch): Some rewording + say + explicitely that the given example is doubling line skip. + + * latex2e-fr.texi (Layout, Low-level font commands): Translate + Jim's r363 edits of 2015-06-16, as well as my edits on top of them + to latex2e.texi made in this revision. + +2017-08-09 Vincent Bela\"iche * NEWS-fr: Typoes. @@ -10,12 +1319,12 @@ * latex2e.texi: (\@startsection) Added defaults for book, article, and report classes. -2017-08-08 Vincent Belache +2017-08-08 Vincent Bela\"iche * README-fr: Convert from latin-9 to utf-8 to comply with CTAN requirements. -2017-08-08 Vincent Belache +2017-08-08 Vincent Bela\"iche * Makefile.1: rename README-fr to README in the zipped archive. @@ -25,13 +1334,13 @@ * README-fr: Typoes. Extend the leading English part fo the French readme to comply with CTAN requirements. -2017-08-08 Vincent Belache +2017-08-08 Vincent Bela\"iche * README-fr: Port GNA! -> Puszcza. `non officiel' -> `officieux' for consistency with manual. Mention other people translate `moving argument' by `argument mouvant'. -2017-08-08 Vincent Belache +2017-08-08 Vincent Bela\"iche * NEWS-fr: Add delivery note --- translated from Jim's, thank you Jim! @@ -46,7 +1355,7 @@ * latex2e-fr.{dbk,.dvi,.html,.info,.pdf,.texi,.txt,.xml}: Compilation for August 2017 delivery to CTAN. -2017-08-08 Vincent Belache +2017-08-08 Vincent Bela\"iche * latex2e-fr.texi: Update version & copyright notice for August 2017 delivery to CTAN. @@ -64,7 +1373,7 @@ * latex2e.texi: copyright 2017. -2017-08-01 Vincent Belache +2017-08-01 Vincent Bela\"iche * latex2e.texi (Environment, Declaration, \makeatletter and \makeatother) (\@@ifstar, \@@startsection): put a sectionning title to node. @@ -99,7 +1408,7 @@ (Sectioning): Add anchor to secnumdepth counter for reference from \@@startsection node. -2017-07-31 Vincent Belache +2017-07-31 Vincent Bela\"iche * latex2e-fr.texi (Class and package commands): Add \CheckCommand and \DeclareRobustCommand as per Jim's r568 2017-07-30 edits + my @@ -110,7 +1419,7 @@ (Class and package commands/\DeclareRobustCommand): Improve existing description. Add mention to etoolbox macros. -2017-07-31 Vincent Belache +2017-07-31 Vincent Bela\"iche * Makefile.1: Extend check-dw to handle other languages. Add target help. @@ -123,7 +1432,7 @@ * latex2e.texi (document header): update version. -2017-07-31 Vincent Belache +2017-07-31 Vincent Bela\"iche * Makefile.1: Add targets , like enpdf, frpdf, eninfo, etc... @@ -135,8 +1444,8 @@ `http://ctan.org/...'. Reword `non officiel' -> `officieux'. (Overview): Take edits from Jim's r412+413 of 2015-08-21. (Starting and ending): Typo. rewording `sections' -> `rubriques'. - (Output files): English quotes ``'' to French quotes - . Concerning .log, add @dfn{fichier journal} (the French for + (Output files): English quotes ``~'' to French quotes + \og~\fg. Concerning .log, add @dfn{fichier journal} (the French for ``log file''). Typo. Translate leftover English in .lot/.lof/.toc cindex. (@TeX{} engines): @TeX{} -> @TeX{} de base --- ie Plain-@TeX{}. Typo. @@ -153,7 +1462,7 @@ (displaymath): Take edits from Jim's r412 2015-08-21, plus my modifications to latex2e.texi. (picture): `sections' -> `rubriques'. - (\oval): English quotes ``'' to French quotes . + (\oval): English quotes ``~'' to French quotes \og~\fg. (table): Exchange order of \caption and \label in example to align on the English version. (Units of length): Translate to French leftover English @cindex @@ -210,14 +1519,14 @@ * latex2e.texi: (\@ifstar): Translate from the French version. (\@startsection): Move to Sectioning. -2017-07-27 Vincent Belache +2017-07-27 Vincent Bela\"iche * Makefile.1 (compare-nodes, compare-nodes-fr, compare-nodes-es): new targets to compare node lists between languages. compare-nodes is made a synonym of compare-nodes-fr because the Spanish translation does not reuse the same node names. -2017-07-26 Vincent Belache +2017-07-26 Vincent Bela\"iche * latex2e-fr.texi (
): Add reference to https://www.latex-project.org/help/books/lc2fr-apb.pdf, as far as @@ -302,7 +1611,7 @@ * latex2e.texi: added class and package commands from clsguide.pdf. -2017-06-09 Vincent Belache +2017-06-09 Vincent Bela\"iche * latex2e-fr.texi (abstract): typo. (\raggedleft): typo. @@ -330,7 +1639,7 @@ (tugboat template): update. -2016-11-24 Vincent Belache +2016-11-24 Vincent Bela\"iche * latex2e-es.texi: Place the English license in the @copying section, and push the translation to an annex. @@ -347,7 +1656,7 @@ * Makefile (txt_files): Remove license.texi from the list of files to zip into the distributed archive. -2016-11-23 Vincent Belache +2016-11-23 Vincent Bela\"iche * license.texi: dos2unix + svn propset svn:eol-style to LF. @@ -370,7 +1679,7 @@ * Makefile.1: Add check-license- targets to check that the license is same as in license.texi -2016-11-21 Vincent Belache +2016-11-21 Vincent Bela\"iche * ltx-help.el (latex-help-file): Make this variable a defcustom for selecting the manuel translation. @@ -390,11 +1699,11 @@ license.texi, make it delimited by @comment's. (\cc): Add `, as in:' before example. -2016-11-19 Vincent Belache +2016-11-19 Vincent Bela\"iche * license.texi: Ooops... add this file. -2016-11-19 Vincent Belache +2016-11-19 Vincent Bela\"iche * latex2e-fr.{xml,dvi,html,info,pdf,txt}: Make these files again for the license. @@ -412,7 +1721,7 @@ * Makefile (txt_files): Add license.texi file. -2016-11-18 Vincent Belache +2016-11-18 Vincent Bela\"iche * Makefile.1: Make variable txt_tiles a macro, so that NEWS-fr and README-fr be delivered instead of NEWS and README for target @@ -420,7 +1729,7 @@ * NEWS-fr: add news for November 2016 CTAN delivery. -2016-11-18 Vincent Belache +2016-11-18 Vincent Bela\"iche * latex2e-fr.{xml,dvi,html,info,pdf,txt}: Make these files. @@ -438,7 +1747,7 @@ * Makefile.1 (spell-$(1)): Take in edit by Karl (rev 546) on Makefile -2016-11-15 Vincent Belache +2016-11-15 Vincent Bela\"iche * latex2e.texi (Math miscellany): Use `math' instead of `text' for the @var{...} name. @@ -453,24 +1762,24 @@ * Makefile (spell): A-Z intended in range. -2016-09-14 Vincent Belache +2016-09-14 Vincent Bela\"iche * latex2e-fr.{dbk,html,info,txt,xml,pdf}: Update French manuals. -2016-09-13 Vincent Belache +2016-09-13 Vincent Bela\"iche * latex2e-fr.texi (\@@ifstar): New node. * latex2e.texi (\makeatletter and \makeatother): Comment that documenting \@ifstar is TODO. -2016-09-13 Vincent Belache +2016-09-13 Vincent Bela\"iche * latex2e-fr.texi (\newcommand & \renewcommand, Spaces) (\(SPACE) and \@@, \(SPACE) after control sequence): Complete taking on Karl's rev497 edits. -2016-09-13 Vincent Belache +2016-09-13 Vincent Bela\"iche * latex2e-fr.texi (\discretionary, Footnotes in section headings) (\newcommand & \renewcommand, Math miscellany, \(SPACE) and \@@) @@ -478,7 +1787,7 @@ (\(SPACE) after control sequence): Rename node --- old name was ``\(SPACE) after CS'' --- as per Karl's rev497 edits. -2016-09-12 Vincent Belache +2016-09-12 Vincent Bela\"iche * latex2e.texi (Document class options): Remove @dmn{...} for ``inches''. @@ -489,7 +1798,7 @@ (Floats): Indicate that ``Here'' means ``Ici'', and fix left-over non translated word ``For''. -2016-09-09 Vincent Belache +2016-09-09 Vincent Bela\"iche * latex2e.texi (Document class options): @dmn{...}-ize the units in the text from Jim's rev383 changes. @@ -508,14 +1817,14 @@ @dmn{...}-ize the units. (Math symbols): Fix typo in \uplus entry. -2016-09-07 Vincent Belache +2016-09-07 Vincent Bela\"iche * latex2e-fr.texi: Same changes as in latex2e.texi (Document class options): Minor editorial change. (\newenvironment & \renewenvironment): Align on Karl's rev538 - change, ie clarify that @var{dbutdf} and @var{findf} are - executed within a group. Rename @var{dbutdf} and @var{findf} to - @var{dfdbut} and @var{dffin} + change, ie clarify that @var{d\'ebutd\'ef} and @var{find\'ef} are + executed within a group. Rename @var{d\'ebutd\'ef} and @var{find\'ef} to + @var{d\'efd\'ebut} and @var{d\'effin} * latex2e.texi: new iftexthenelse macro. (Footnotes in a table): Minor editorial change to avoid overfull hbox. @@ -528,7 +1837,7 @@ by ``processed'' because not only execution but also expansion prior to it happens within a group. -2016-09-05 Vincent Belache +2016-09-05 Vincent Bela\"iche * latex2e.texi (\newenvironment & \renewenvironment): Add an @findex for ``group''. @@ -544,11 +1853,11 @@ https://mail.gna.org/listinfo/latexrefman-discuss is for archives and subsription. -2016-09-04 Vincent Belache +2016-09-04 Vincent Bela\"iche * latex2e-fr.texi: Whole file, suppress any trailing blanks. -2016-09-04 Vincent Belache +2016-09-04 Vincent Bela\"iche * latex2e-fr.texi (Top): Fix translation of sub node menu entry text. (Overview): Fix spelling. Fix leftover English. ``paquetage de @@ -589,7 +1898,7 @@ \mathsection \mathsterling \mathunderscore \mathunderscore. (Text symbols): add \textsection, \textquotesingle. -2016-04-12 Vincent Belache +2016-04-12 Vincent Bela\"iche * latex2e.texi (Document class options): Improve wording by reusing package variable @var{pkg} in the synopsis description. @@ -608,11 +1917,11 @@ `\@var{cmd}'. Fix typoes. (\newenvironment & \renewenvironment): nargs starting from 0 rather than from 1. Fix typoes. `argument positionnel' -> - `paramtre positionnel'. + `param\`etre positionnel'. (Reserved characters): `\backslash' -> `\textbackslash' in the @findex in accordance with description. Fix typoes. -2016-04-12 Vincent Belache +2016-04-12 Vincent Bela\"iche * latex2e-fr.texi (top comment, Top): Make version under quotes to avoid incorrect French ``de Avril 2016'' or ``du Avril 2016'' @@ -623,24 +1932,24 @@ notice up to 2016. * latex2e-fr.texi (top comment): `Copyright' -> `Tous droits - rservs ' + add ``Vincent Belache'' as translator. + r\'eserv\'es \textcopyright' + add ``Vincent Bela\"iche'' as translator. -2016-04-11 Vincent Belache +2016-04-11 Vincent Bela\"iche * latex2e-es.texi (top comment, Using BibTeX): Replace CTAN central server URLs by mirror URLs, after a comment by Petra - Rbe-Pugliese. + R\"ube-Pugliese. * latex2e-fr.texi (top comment, Output files, Using BibTeX): Replace CTAN central server URLs by mirror URLs, after a comment - by Petra Rbe-Pugliese. + by Petra R\"ube-Pugliese. (Output files, Using BibTeX): Typoes. * latex2e.texi (top comment, Output files): Replace CTAN central server URLs by mirror URLs, after a comment by Petra - Rbe-Pugliese. + R\"ube-Pugliese. -2016-04-08 Vincent Belache +2016-04-08 Vincent Bela\"iche * NEWS: Add NEWS entry for the Apr 2016 release --- assuming English will be released also. @@ -648,12 +1957,12 @@ * Makefile.1 (dist-xx, dist): Fix pior check that there aren't any uncommited changes before making the zip. -2016-04-07 Vincent Belache +2016-04-07 Vincent Bela\"iche * latex2e-fr.{dbk,html,info,txt,xml,pdf}: Update French manuals for distribution 2016-04-08 to CTAN. -2016-04-07 Vincent Belache +2016-04-07 Vincent Bela\"iche * latex2e-fr.texi: Updated @set UPDATED. @@ -704,7 +2013,7 @@ make tag TAG=foo "MESSAGE=Some message" -2016-04-04 Vincent Belache +2016-04-04 Vincent Bela\"iche * latex2e.texi: Add EnvIndex macro to make indexing environments consistent and throughout the manual. Replace any @findex of an @@ -720,10 +2029,10 @@ * latex2e-es.texi: Same as latex2e.texi. (filecontents): Align to latest text in latex2e{,-fr}.texi. -2016-04-02 Vincent Belache +2016-04-02 Vincent Bela\"iche * latex2e-es.texi: Add @BES and @BESU macro definitions. - (Smbolos de Texto): Use @BES macro rather than @math for + (S\'\imbolos de Texto): Use @BES macro rather than @math for \textperiodcentered so that the other-than-PDF is clean. `$' -> `\$' for \textdollar. @@ -734,21 +2043,21 @@ \@startsection example for solving the overfull hbox in the PDF output. * latex2e-fr.texi (Text symbols): \textquestiondown - Typo. \textexclamdown `haut en bas' -> `culbut'. Use @BES macro + Typo. \textexclamdown `haut en bas' -> `culbut\'e'. Use @BES macro rather than @math for \textperiodcentered and \trademark so that the other-than-PDF is clean. `$' -> `\$' for \textdollar. `marque de fabrique' -> `marque de commerce' for \texttrademark. (\@@startsection): re-indent \@startsection example for solving the overfull hbox in the PDF output, and fix some wrong reference. -2016-03-31 Vincent Belache +2016-03-31 Vincent Bela\"iche * latex2e-fr.{dbk,dvi,html,info,pdf,texi,txt,xml}: make fr. -2016-03-29 Vincent Belache +2016-03-29 Vincent Bela\"iche * latex2e-fr.texi (Line breaking): Improve translation of - break/breaking, use `saut/sauter ' rather than `rupture/rompre'. + break/breaking, use `saut/sauter \`a' rather than `rupture/rompre'. (Spaces): Typo. (Special insertions): Typo. (Text symbols): Fix typo adding `comp' into @@ -764,7 +2073,7 @@ `\textcapitalcompwordmark' and `\textascendercompwordmark' -2016-03-17 Vincent Belache +2016-03-17 Vincent Bela\"iche Reword descrition of \epsilon and \varepsilon. @@ -774,15 +2083,15 @@ ``script small letter''. * latex2e-fr.texi (Math symbols): About \varepsilon ``en forme de - 3 retourn'' -> ``minuscule de ronde''. + 3 retourn\'e'' -> ``minuscule de ronde''. -2016-03-15 Vincent Belache +2016-03-15 Vincent Bela\"iche * latex2e.texi (Math symbols): Fix compilation errors. * latex2e-fr.texi (Math symbols): Fix compilation errors. -2016-03-14 Vincent Belache +2016-03-14 Vincent Bela\"iche * latex2e.texi Define flags NotInPlainTeX, NeedsAMSSymb and NeedsSTIX, in order to factorize text of `Math symbols' node. @@ -795,7 +2104,7 @@ * latex2e-fr.texi (Math symbols): Progress translation of this node and make same changes as for latex2e.texi. -2016-03-08 Vincent Belache +2016-03-08 Vincent Bela\"iche * latex2e-fr.texi (Top): Typoe in `Modes' menu entry. (eqnarray): `or' -> `ou'. @@ -816,41 +2125,41 @@ (\ensuremath): new node. (Text symbols): Add pilcrow character for \P, similar change for \S. -2016-03-06 Vincent Belache +2016-03-06 Vincent Bela\"iche * latex2e-fr.texi (Math symbols): Progress translation of this node. -2016-02-29 Vincent Belache +2016-02-29 Vincent Bela\"iche * latex2e-fr.texi (\circle): Use term ``disque'', in addition to ``cercle plein'' (solid circle). @dmn{...}-ify unit. (\makebox (picture)): Typo. (Math symbols): Progress translation of this node. -2016-02-22 Vincent Belache +2016-02-22 Vincent Bela\"iche * latex2e.texi (Text symbols): Fix @code{'}->@code{''} for \textquotedblright (Splitting the input): @dfn{...}-ify `root file' and add it to concept index (\include): Replace `See next section' -> `See @ref{\includeonly}'. (\includeonly): `@var{file}s' -> `@var{file1}, @var{file2}, @dots{}' - * latex2e-fr.texi (\alph \Alph \arabic \roman \Roman \fnsymbol): `croix-mortuaire' -> `oble' + * latex2e-fr.texi (\alph \Alph \arabic \roman \Roman \fnsymbol): `croix-mortuaire' -> `ob\`ele' (Math symbols): Progress translation of this node. (Text symbols): Start translation of this node. - (\thinspace): `imbriqu' -> `embot', as per Cahier GUTenberg #49 glossary + (\thinspace): `imbriqu\'e' -> `embo\^\it\'e', as per Cahier GUTenberg #49 glossary (Text symbols): Fix @code{'}->@code{''} for \textquotedblright (Splitting the input, \include, \includeonly, \input): Translate these nodes. (Splitting the input): @dfn{...}-ify `root file' and add it to concept index (\include): Replace `See next section' -> `See @ref{\includeonly}'. (\includeonly): `@var{file}s' -> `@var{file1}, @var{file2}, @dots{}' -2016-02-15 Vincent Belache +2016-02-15 Vincent Bela\"iche * latex2e.texi (\noindent): `..' -> `...'. * latex2e-fr.texi (About this document, @LaTeX{} command syntax) (Document class options, Document class options) - (Pagelayoutparameters, Sectioning, enumerate, \item, \line) + (Page~layout~parameters, Sectioning, enumerate, \item, \line) (\thicklines, \thinlines, \cite, \newtheorem, \newtheorem, \newtheorem) (\alph \Alph \arabic \roman \Roman \fnsymbol, \signature): @tie{} -> UTF-8 unbreakable space. @@ -861,7 +2170,7 @@ (Math symbols): Progress translation + @tie{} -> UTF-8 unbreakable space. -2016-02-11 Vincent Belache +2016-02-11 Vincent Bela\"iche * latex2e.texi (abstract): @code{...}-ify words `article' & `report' when they refer to classes. @@ -875,10 +2184,10 @@ (\@@startsection): `@var{indent}' -> `@var{retrait}', indent(ation) -> retrait or renfoncement. (Document class options): Added flegn concerns display mode formula only. (Environments): `mise en vedette' -> `en hors texte' - (abstract): `abtracts' -> `rsum', and update translating this + (abstract): `abtracts' -> `r\'esum\'e', and update translating this node as per Jim's rev 486 of 2015-12-05T13:22:45+01 edit. (Environment): Ellipsis `..' -> `...', and add - `Voir@ref{Environments} pour une liste des environnements.' as + `Voir~@ref{Environments} pour une liste des environnements.' as per Jim's rev 486 of 2015-12-05T13:22:45+01 edit. (array): Update translation ad per Jim's edits rev 391 of 2015-08-02T22:57:00+02 and with fixes from rev 469 by Karl of @@ -905,7 +2214,7 @@ * latex2e.texi (array): the directive is just p{...}, not @p{...}. Noted by Vincent. -2016-02-08 Vincent Belache +2016-02-08 Vincent Bela\"iche * latex2e.texi (lrbox): Use Synopsis instead of in-line @code{...}. `cmd' -> `\@var{cmd}'. @ref{...}-ify @code{\sbox}. @@ -934,12 +2243,12 @@ (lrbox): Translate this node. (\raisebox): Complete translation of this node. (Front/back matter): Typo. - (Tables of contents): `article' -> `entre', as per Cahier GUTenberg #49 glossary. + (Tables of contents): `article' -> `entr\'ee', as per Cahier GUTenberg #49 glossary. (\addcontentsline): Translate this node, with same edits as in latex2e.texi. (\addtocontents): Translate this node. (Glossaries): Translate this node. (Indexes): Translate this node, with same edits as in latex2e.texi. - (Letters): Typoes. `clture' -> `salutation'. Typo. Complete + (Letters): Typoes. `cl\^oture' -> `salutation'. Typo. Complete translation with same edits as in latex2e.texi. (\address): Translate this node. (\cc): Translate this node. @@ -949,7 +2258,7 @@ (\makelabels): Typo. (\opening): Typo. -2016-02-05 Vincent Belache +2016-02-05 Vincent Bela\"iche * latex2e.texi (Line breaking, \discretionary): Add node \discreionary, need completion. @@ -963,7 +2272,7 @@ (Page breaking): Translate this node. (\protect): Translate this node, with same changes as in latex2e.texi. -2016-02-04 Vincent Belache +2016-02-04 Vincent Bela\"iche * latex2e-fr.texi (Spacing in math mode): Add @xref{\thinspace} to the \thinspace entry. @@ -980,7 +2289,7 @@ example. Make TeX output only when compilation is with TeX and fix some of the examples. -2016-02-02 Vincent Belache +2016-02-02 Vincent Bela\"iche * latex2e-fr.texi: Reword copyright notice from Automatic-translation French to real French. @@ -1021,7 +2330,7 @@ * latex2e.texi (\newcommand & \renewcommand): mention "\ " after control sequences, as noted by Vincent. -2016-01-27 Vincent Belache +2016-01-27 Vincent Bela\"iche * latex2e-fr.texi (Marginal notes): Typoes. (Subscripts & superscripts): Typo. @@ -1063,7 +2372,7 @@ * aspell.en.pws: add more exceptions. * latex2e.texi: fix typos, refilling. -2016-01-15 Vincent Belache +2016-01-15 Vincent Bela\"iche * latex2e.texi (\setlength, \addtolength, \settodepth) (\settoheight, \settowidth): Place synopsis in a Synopsis @@ -1083,7 +2392,7 @@ (Symbols by font position): Add this node, after update made to latex2e.texi -2015-12-14 Vincent Belache +2015-12-14 Vincent Bela\"iche * latex2e-fr.texi (Top): section->rubrique, sectionement->rubricage (@LaTeX{} command syntax): Add node ``\makeatletter and \makeatother''. @@ -1156,7 +2465,7 @@ * latex2e.texi (\makeatletter and \makeatother): Adjust wording. -2015-11-26 Vincent Belache +2015-11-26 Vincent Bela\"iche * latex2e-fr.texi (\newsavebox, \newtheorem, \newfont): Complete translation of this node, and align on latest English version. @@ -1176,7 +2485,7 @@ position. Distinguish between output in text body font and output in typewriter font. -2015-11-09 Vincent Belache +2015-11-09 Vincent Bela\"iche * latex2e.texi (\newcommand & \renewcommand): Introduce the concept of positional parameter. @@ -1187,7 +2496,7 @@ letters and character `*'. Use the term positional parameter, and tell that expansion is within begdefn, not within environment, which was misleading. @samp{...}-ify `Shakespear' outside of - @example...@endexample. + @example...@end~example. * latex2e-fr.texi (Output files): Typo. (tabular): Typoes. @@ -1195,14 +2504,14 @@ (\newenvironment & \renewenvironment): Complete the translation and make the same text improvements as in latex2e.texi. -2015-11-06 Vincent Belache +2015-11-06 Vincent Bela\"iche * latex2e-fr.texi (\parbox): Tell that `position=m' equates the default behaviour. * latex2e.texi (\parbox): Same as latex2e-fr.texi. -2015-11-05 Vincent Belache +2015-11-05 Vincent Bela\"iche * latex2e.texi (\fussy): Typo. @@ -1210,16 +2519,16 @@ (\verb): Clean-up left over English words. (\obeycr & \restorecr, \fussy, \sloppy): Translate this node. -2015-11-04 Vincent Belache +2015-11-04 Vincent Bela\"iche * latex2e.texi (tabular): wording `@code{*-expression}' -> `@code{*}-expression'. * latex2e-fr.texi (tabular): Complete translation of this node. -2015-11-03 Vincent Belache +2015-11-03 Vincent Bela\"iche * latex2e.texi (\parbox): Correct description of \parbox vertical - alignment after comment from Denis Bitouz. + alignment after comment from Denis Bitouz\'e. * latex2e-fr.texi (\parbox): Same as for latex2e.texi. @@ -1230,11 +2539,11 @@ * latex2e.texi (throughout): consistently use ... instead of .. for code ellipses. -2015-10-27 Vincent Belache +2015-10-27 Vincent Bela\"iche * latex2e-fr.texi (enumerate): Typo. (itemize): Restore missing example. - (thebibliography): `label' -> `tiquette', `cite_key' -> + (thebibliography): `label' -> `\'etiquette', `cite_key' -> `clef_de_cite'. Change wording concerning `\refname' in standard classes. (\bibitem, \cite, \nocite, Using BibTeX, theorem): Translate this node. (\cleardoublepage, \newpage): Improve wording `page actuelle' -> @@ -1279,7 +2588,7 @@ * latex2e.texi (Footnotes): Add remark that getting biblio references in footnotes depends on the bibliographic style. -2015-10-11 Vincent Belache +2015-10-11 Vincent Bela\"iche * latex2e-fr.texi (Page breaking): Translate menu entries (\cleardoublepage, \clearpage, \newpage, \enlargethispage) @@ -1292,7 +2601,7 @@ * latex2e.texi (\cleardoublepage, \clearpage): Clarify that only pending floating tables & figures are cleared. (\newpage): `see @code{\clearpage} above' -> `@pxref{\clearpage}' - (Footnotes): Make the exact quotation of Nol Coward, and correct + (Footnotes): Make the exact quotation of No\"el Coward, and correct his first name spelling. 2015-10-11 Jim Hefferon @@ -1309,7 +2618,7 @@ * latex2e.texi (\makelabels): Add more on how to customize label sizes, etc. -2015-10-09 Vincent Belache +2015-10-09 Vincent Bela\"iche * latex2e-fr.texi (Environments): Merge menu entries for nodes quote & quotations after Jim's edits of 2015-09-28 @@ -1322,7 +2631,7 @@ * latex2e.texi (Footnotes in a section heading): Add node, provide examples. -2015-10-08 Vincent Belache +2015-10-08 Vincent Bela\"iche * latex2e.texi (\makelabels): @var{...}-ify argument 'to addess', and @code{...}-ify class name. @@ -1385,7 +2694,7 @@ * latex2e.texi (Letters): Add synopsis, examples. -2015-09-22 Vincent Belache +2015-09-22 Vincent Bela\"iche * latex2e-fr.texi (filecontents): Add Jim's 2015-09-18 (r439) edits. (\addvspace): Add Jim's 2015-09-13 (r432) edits. @@ -1401,7 +2710,7 @@ * latex2e-{es,fr}.{dbk,html,info,txt,xml}: Compile these files again, because of eol problem. -2015-09-21 Vincent Belache +2015-09-21 Vincent Bela\"iche * latex2e-{es,fr}.{dbk,dvi,html,info,pdf,txt,xml}: Compile these files @@ -1411,7 +2720,7 @@ * latex2e.texi (filecontents): Corrections suggested by JB. -2015-09-17 Vincent Belache +2015-09-17 Vincent Bela\"iche * ChangeLog: Correct typo on Jim's surname Hefferson->Hefferon. @@ -1430,7 +2739,7 @@ * latex2e.texi (Subscripts & superscripts): Add examples. -2015-09-15 Vincent Belache +2015-09-15 Vincent Bela\"iche * latex2e.texi (Starting and ending): Add @cindex environment (Spaces, \(SPACE) and \@@, \(SPACE) after CS): Move text how to @@ -1443,7 +2752,7 @@ changes as for latex2e.texi. (Overview): add @: after some abbrev ending periods. (Font styles): Follow Karl's changes of - 2015-04-26, "deux choses trs diffrentes"->"deux constructions + 2015-04-26, "deux choses tr\`es diff\'erentes"->"deux constructions sans relation l'une avec l'autre" (Starting and ending): Follows Karl's change of 2015-04-26 (\- (hyphenation)): Translate this node. @@ -1467,7 +2776,7 @@ * latex2e.texi (\noindent): Add example. -2015-09-14 Vincent Belache +2015-09-14 Vincent Bela\"iche * latex2e.texi (Spacing in math mode): Add missing @findex entries for \thickspace, \medspace & \thinspace. Typo tht->that. @@ -1530,7 +2839,7 @@ * latex2e.texi (Spacing in math mode): Move math mode lengths to here and add whether they work also in text mode. -2015-09-04 Vincent Belache +2015-09-04 Vincent Bela\"iche * latex2e-fr.texi: Add macroes BES & BESU to support compilation of math symbols with texi2pdf. (Symbolic footnotes): Complete translation of this node @@ -1555,7 +2864,7 @@ (\makebox): reword is specified->can be overriden, because width is optional. (\makebox): @code{...}-ify environment name picture. -2015-08-29 Vincent Belache +2015-08-29 Vincent Bela\"iche * latex2e-fr.texi (\linethickness): Typo. (\thicklines, \thinlines, \shortstack, \/, \hrulefill) @@ -1568,7 +2877,7 @@ (\addvspace): @var{...}-ify word `length'. -2015-08-27 Vincent Belache +2015-08-27 Vincent Bela\"iche * latex2e.texi (Units of length): Use `@dmn{...}' rather than `@tie{}...' in new node added by Jim. @@ -1577,11 +2886,11 @@ * latex2e.texi (Units of length): Add new node in Lengths. -2015-08-25 Vincent Belache +2015-08-25 Vincent Bela\"iche * latex2e.texi (tabular): typo : horozontal->horizontal. -2015-08-24 Vincent Belache +2015-08-24 Vincent Bela\"iche * latex2e.texi (picture): (width,height)(x offset,y offset)->(@var{width},@var{height})(@var{xoffset},@var{yoffset}) (picture): make position a concept index entry, and @dfn{...}-ize it. @@ -1591,7 +2900,7 @@ (picture): Translate this node. (\framebox (picture)): @var{width}->@var{largeur} -2015-08-23 Vincent Belache +2015-08-23 Vincent Bela\"iche * latex2e-fr.texi (file preamble): Add comment about glossary resources useful for French translation @@ -1602,7 +2911,7 @@ (\centering): typo (flushleft, \raggedright): Improve wording. (flushright, \raggedleft): Translate these nodes. - (quotation, Making paragraphs): ligne blanche->ligne blanc + (quotation, Making paragraphs): ligne blanche->ligne \`a blanc * latex2e.texi (Floats): typo insert comma. (Floats): figure->float @@ -1631,7 +2940,7 @@ with issues. Shrink the figure and table nodes by the common material. -2015-08-20 Vincent Belache +2015-08-20 Vincent Bela\"iche * latex2e-fr.texi (Output files, @TeX{} engines, \line) (Glossaries): Remove @acronym on Karl's request @@ -1648,7 +2957,7 @@ * Makefile (xref_suffixes): no auxs or tocs. -2015-08-19 Vincent Belache +2015-08-19 Vincent Bela\"iche * latex2e.texi (flushleft): string->control sequence. @@ -1739,7 +3048,7 @@ * latex2e.texi (center, \centering): Add detail, including distinguishing the two and examples. -2015-08-05 Vincent Belache +2015-08-05 Vincent Bela\"iche * latex2e.texi (\indent): remove "width of" concering concerning \parindent length. @@ -1776,7 +3085,7 @@ * latex2e.texi (vline, cline, hline): Add examples. Also describe how columns are counted. -2015-07-30 Vincent Belache +2015-07-30 Vincent Bela\"iche * latex2e-fr.texi (Top): Correct menu item French translation for "Making paragraphs" (itemize): typo, remove left-over English word "dash" @@ -1785,7 +3094,7 @@ * latex2e.texi (Text symbols): Correct -- for --- for en-dash -2015-07-29 Vincent Belache +2015-07-29 Vincent Bela\"iche * latex2e-es.texi (Acentos): Make references between \underbar and \b. @@ -1828,7 +3137,7 @@ the unicode glyph to the start of each entry to make easier scanning for the desired symbol. -2015-07-08 Vincent Belache +2015-07-08 Vincent Bela\"iche * latex2e-fr.texi (Line breaking, \savebox): Translation to French. (Sectioning): Typo. @@ -2135,7 +3444,7 @@ * latex2e.texi (\alph \Alph \arabic \roman \Roman \fnsymbol): \Roman for second @item. Typo reported by Jose Atria. -2014-11-19 Vincent Belache +2014-11-19 Vincent Bela\"iche * latex2e-fr.texi: Progress translation to French @@ -2145,12 +3454,12 @@ (node filecontents): Make it clear that it is about files not documents. -2014-10-20 Vincent Belache +2014-10-20 Vincent Bela\"iche * Makefile: Add target `check' to compile each manual once with tex and once with makeinfo. This is faster than using target `all'. -2014-10-19 Vincent Belache +2014-10-19 Vincent Bela\"iche * latex2e.texi (\setcounter): replace @var{\counter} by @var{counter} @@ -2159,7 +3468,7 @@ * latex2e-fr.texi (\setcounter): Same change as latex2e.texi. Progress Translation to French. -2014-10-17 Vincent Belache +2014-10-17 Vincent Bela\"iche * latex2e-es.texi (\pagenumbering): use @backslashchar{} within @vincentb in order to compile with tex. @@ -2177,7 +3486,7 @@ * latex2e-es.texi (\put): @vincentb, not @vincenb. -2014-09-25 Vincent Belache +2014-09-25 Vincent Bela\"iche * latex2e.texi (\put): Make coordinates within @var{...} and add explicit reference to them in the text. @@ -2189,7 +3498,7 @@ * latex2e-fr.texi (nodes \put, \usebox): Same as latex2e.texi. Progress translation to French. -2014-09-19 Vincent Belache +2014-09-19 Vincent Bela\"iche * latex2e.texi (document header): Set @documentencoding and @documentlanguage. @@ -2215,7 +3524,7 @@ * latex2e-fr.texi: Similar changes as latex2e.texi. Progress translation to French. -2014-09-10 Vincent Belache +2014-09-10 Vincent Bela\"iche * latex2e.texi (\thinspace): em -> @dmn{em}. @@ -2223,7 +3532,7 @@ * latex2e-fr.texi: Progress translation to French. -2014-09-08 Vincent Belache +2014-09-08 Vincent Bela\"iche * latex2e-fr.texi: Progress translation to French. @@ -2231,14 +3540,14 @@ make by' by `The box made by'. (node Math miscellany): correct typo `for examp*l*e'. -2014-08-30 Vincent Belache +2014-08-30 Vincent Bela\"iche * latex2e-es.texi (\vector): correct bug involved by renaming y-slop/x-slop to declivex/declivey --- as I used @vincentb macro encapsulation to mark my change, it made \ of \vector no longer a "other" character. -2014-08-29 Vincent Belache +2014-08-29 Vincent Bela\"iche * Makefile: add definition of variable all, for clean to work. Add squeaky as a synonym of realclean. Add in comment generic line for @@ -2249,12 +3558,12 @@ * latex2e.texi (node Page layout parameters): correct typo clase -> classes (node array): `in that row' -> `in each row of that column - * latex2e-es.texi (node array): `el nmero de elementos y deben + * latex2e-es.texi (node array): `el n\'umero de elementos y deben tener el formato' -> `cual formato debe tener cada linea en esta columna' -2014-08-24 Vincent Belache +2014-08-24 Vincent Bela\"iche * latex2e.texi (node Boxes): add @code{...} encapsulation. (\dashbox): replace @code{...} by @var{...} for \dashbox @@ -2267,7 +3576,7 @@ * latex2e-es.texi (node Cajas): same as latex2e.texi. (\dashbox): same as latex2e.texi. Rename parameter - @var{dlargo} to @var{glargo}, with 'g' for guin (aka + @var{dlargo} to @var{glargo}, with 'g' for gui\'on (aka dash). (nodes \line & Glossarios): same as latex2e.texi. (\makebox of picture): same as latex2e.texi. @@ -2280,7 +3589,7 @@ (\vector): same as latex2e.texi. Progress further translation to French. -2014-08-17 Vincent Belache +2014-08-17 Vincent Bela\"iche * latex2e.texi: (node Layout) Add @code{...} around \headheight and \footskip in `Page layout parameters' menu entry @@ -2290,7 +3599,7 @@ * latex2e-fr.texi: Same change as in latex2e.texi. Continue progressing translation to French. -2014-08-11 Vincent Belache +2014-08-11 Vincent Bela\"iche * latex2e.texi: Add @code{...} encapsulation in some places to class names letter, slides, book, report, article, and to @@ -2303,23 +3612,23 @@ translation to French. -2014-08-10 Vincent Belache +2014-08-10 Vincent Bela\"iche * latex2e.texi: (Overview) change wording about case sensitivity. - * latex2e-es.texi: (Descripcin) same change change as for latex2e.texi about case sensitivity. + * latex2e-es.texi: (Descripci\'on) same change change as for latex2e.texi about case sensitivity. * latex2e-fr.texi: (Overview) same change change as for latex2e.texi about case sensitivity. (Whole document) Put in place same structure as for original and progress translation. -2014-08-01 Vincent Belache +2014-08-01 Vincent Bela\"iche * latex2e-fr.texi: Creation --- still very approximate & preliminary... * Makefile: Make it generic -2014-07-20 Vincent Belache +2014-07-20 Vincent Bela\"iche * latex2e.texi (\LaTeXe), * latex2e-es.texi (\LaTeXe): document LaTeX2e log. @@ -2334,7 +3643,7 @@ (Font styles): mention my disagreement with the oft-stated notion that \tt, et al., are "obsolete". -2014-02-27 Vincent Belache +2014-02-27 Vincent Bela\"iche * latex2e.texi (filecontents): Clarify that LaTeX2e default filecontents environment DOES NOT overwrite existing files, you @@ -2342,12 +3651,12 @@ * latex2e-es.texi (filecontents): Align on the English version. -2014-02-26 Vincent Belache +2014-02-26 Vincent Bela\"iche * latex2e-es.texi: Align Spanish translation with changes made by Karl on 2014-02-23, and also some changes done before that. -2014-02-25 Vincent Belache +2014-02-25 Vincent Bela\"iche * latex2e.texi: Correct typo, rm duplicate 2014 in copyright notice. @@ -2740,3 +4049,6 @@ of searching. (This ChangeLog file is in the public domain.) +% Local Variables: +% coding: us-ascii +% End: diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/NEWS-fr b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/NEWS-fr index 207e965348c..7193b45d485 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/NEWS-fr +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/NEWS-fr @@ -1,10 +1,25 @@ -$Id: NEWS-fr 588 2017-08-09 16:42:12Z vincentb1 $ +$Id: NEWS-fr 832 2020-09-06 17:14:57Z vincentb1 $ NEWS for latex2e-fr.texi, aka the latex2e-help-texinfo-fr package. Public domain. Originally written 1995, Torsten Martinsen. Spanish translation originally from Nacho Pacheco (currently not maintained) French translation originally from Vincent Belache. +---------------------------------------------------------------- +Changements dans la parution de septembre 2020 : + +Encore beaucoup de coquilles corriges, et la documentation s'est +considrablement enrichie d'exemples, d'explications et de rfrences + des paquetages, notamment sur les points suivants: + +- contrle des rubriques +- inclusion de graphique +- gestion des couleurs +- sortie journal/terminal +- gestion des listes +- parties d'un document book +- prsentation CTAN + ---------------------------------------------------------------- Changements dans la parution d'aot 2017 : diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/common.texi b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/common.texi index 85d1df1b3b7..04824f1c7a4 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/common.texi +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/common.texi @@ -1,2 +1,59 @@ -@set LTXREFMAN_HOME_PAGE http://puszcza.gnu.org.ua/software/latexrefman/ +@c $Id: common.texi 729 2018-11-13 23:22:27Z karl $ +@c Public domain. +@set LTXREFMAN_HOME_PAGE https://latexref.xyz @set LTXREFMAN_BUGS latexrefman@@tug.org +@clear HAS-MATH +@iftex +@set HAS-MATH +@macro iftexthenelse {then,else} +\then\@c +@end macro +@end iftex +@ifnottex +@macro iftexthenelse {then,else} +\else\@c +@end macro +@end ifnottex + +@tex +\globaldefs=1 +% lasyfont characters for Texinfo (latexsym package in LaTeX). +% JH 2018-Nov-12, ideas from wasyfont.tex. Public domain. +% not going to try to make fonts +\font\tenlasy = lasy10 +% \font\ninelasy = lasy9 +% \font\eightlasy = lasy8 +\font\sevenlasy = lasy7 +\font\fivelasy = lasy5 +\newfam\lasyfam +\newcount\lasyfamcount +% family number is third-least-significant hex digit of mathchar +\lasyfamcount=\lasyfam \multiply\lasyfamcount by 256 +% +\textfont\lasyfam=\tenlasy + \scriptfont\lasyfam=\sevenlasy + \scriptscriptfont\lasyfam=\fivelasy +% +\def\lasymathchardef#1#2{% + \count255=\lasyfamcount + \advance\count255 by"#1 + \mathchardef#2\count255 } +% char 1 (math class): 0=ord, 2=bin, 3=rel (taken from latexsym.dtx). +% char 2: family number, added in by \lasymathchardef. +% chars 3-4: character code in font. All in hex. +\lasymathchardef{0030}{\mho} +\lasymathchardef{3031}{\Join} +\lasymathchardef{0032}{\Box} +\lasymathchardef{0033}{\Diamond} +\lasymathchardef{303B}{\leadsto} +\lasymathchardef{303C}{\sqsubset} +\lasymathchardef{303D}{\sqsupset} +\lasymathchardef{2001}{\lhd} +\lasymathchardef{2003}{\rhd} +\lasymathchardef{2002}{\unlhd} +\lasymathchardef{2004}{\unrhd} +% +% must explicitly reset before the (at)end tex, not let the (at)end group +% reset it; else internal Texinfo variables get messed up. +\globaldefs=0 +@end tex diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk index 8771be8b353..70a500266a8 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk @@ -4,16 +4,26 @@ ]> -manuel de référence officieux de &latex;2e (Août 2017) + + + +Manuel de référence officieux de &latex;2e (Septembre 2020) + + + + + + + + + + - - - @@ -25,10 +35,21 @@ + + + + + + + + + + + @@ -40,32 +61,32 @@ + Ce document est un manuel de référence officieux pour &latex;, un -système de préparation de documents, version « Août 2017 ». +système de préparation de documents, version « Septembre 2020 ». Ce manuel a été traduit du fichier LATEX.HLP v1.0a de la -bibliothèque d’aide VMS. La version pré-traduction a été rédigé par -George D. Greenwade de Sam Houston State University. La version +bibliothèque d’aide VMS. La version pré-traduction a été rédigée par +George D. Greenwade de l’université d’État Sam Houston, au Texas (USA). La version &latex; 2.09 a été rédigée par Stephen Gilmore. La version &latex;2e a -été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a +été adaptée à partir de celle-ci par Torsten Martinsen. Karl Berry a fait d’autres mises à jour et ajouts, et reconnaît avec gratitude avoir utilisé Hypertext Help with &latex;, de Sheldon Green, et &latex; Command Summary (pour &latex;2.09) de L. Botway et C. Biemesderfer (publié par le &tex; Users Group en tant que -&tex;niques numéro 10), il l’a utilisé en tant que matériel de -référence (aucun texte n’était directement copié). +&tex;niques numéro 10) ; il a utilisé ces documents en tant que matériel de +référence et n’en a copié aucun texte directement. -Tous droits réservés © 2015-2017 Vincent Belaïche — traduction. +Tous droits réservés © 2015-2020 Vincent Belaïche — traduction. -Tous droits réservés © 2007, 2008, 2009, 2010, 2011, 2012, 2013, -2014, 2015, 2016, 2017 Karl Berry. +Tous droits réservés © 2007-2020 Karl Berry. Tous droits réservés © 1988, 1994, 2007 Stephen Gilmore. Tous droits réservés © 1994, 1995, 1996 Torsten Martinsen. -Ci-après se trouve la licence sous laquelle est distribuée ce manuel, +Ci-après se trouve la licence sous laquelle est distribuée ce manuel ; une traduction en est donnée en annexe, voir License translation. @@ -86,30 +107,29 @@ into another language, under the above conditions for modified versions. Ce document est un manuel de référence officieux pour &latex;, un -système de préparation de documents, version « Août 2017 ». +système de préparation de documents, version « Septembre 2020 ». Ce manuel a été traduit du fichier LATEX.HLP v1.0a de la -bibliothèque d’aide VMS. La version pré-traduction a été rédigé par -George D. Greenwade de Sam Houston State University. La version +bibliothèque d’aide VMS. La version pré-traduction a été rédigée par +George D. Greenwade de l’université d’État Sam Houston, au Texas (USA). La version &latex; 2.09 a été rédigée par Stephen Gilmore. La version &latex;2e a -été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a +été adaptée à partir de celle-ci par Torsten Martinsen. Karl Berry a fait d’autres mises à jour et ajouts, et reconnaît avec gratitude avoir utilisé Hypertext Help with &latex;, de Sheldon Green, et &latex; Command Summary (pour &latex;2.09) de L. Botway et C. Biemesderfer (publié par le &tex; Users Group en tant que -&tex;niques numéro 10), il l’a utilisé en tant que matériel de -référence (aucun texte n’était directement copié). +&tex;niques numéro 10) ; il a utilisé ces documents en tant que matériel de +référence et n’en a copié aucun texte directement. -Tous droits réservés © 2015-2017 Vincent Belaïche — traduction. +Tous droits réservés © 2015-2020 Vincent Belaïche — traduction. -Tous droits réservés © 2007, 2008, 2009, 2010, 2011, 2012, 2013, -2014, 2015, 2016, 2017 Karl Berry. +Tous droits réservés © 2007-2020 Karl Berry. Tous droits réservés © 1988, 1994, 2007 Stephen Gilmore. Tous droits réservés © 1994, 1995, 1996 Torsten Martinsen. -Ci-après se trouve la licence sous laquelle est distribuée ce manuel, +Ci-après se trouve la licence sous laquelle est distribuée ce manuel ; une traduction en est donnée en annexe, voir License translation. @@ -131,12 +151,11 @@ into another language, under the above conditions for modified versions. - &latex;2e : un manuel de référence officieux Ce document est un manuel de référence officieux pour &latex;2e, un -système de préparation de document, dans sa version « Août 2017 ». +système de préparation de document, dans sa version « Septembre 2020 ». @@ -144,14 +163,14 @@ système de préparation de document, dans sa version « Août 2017 ». À propos de ce document -http://puszcza.gnu.org.ua/software/latexrefman/ page d’accueil +https://latexref.xyz page d’accueil Ceci est un manuel de référence officieux pour le système &latex;2e de -préparation de document, ce système est mis en oeuvre sous forme d’un +préparation de document. Ce système est mis en œuvre sous forme d’un paquet de macros pour le programme de composition &tex; -(voir Overview). La page d’accueil de ce document est -http://puszcza.gnu.org.ua/software/latexrefman/. Cette page contient des liens vers -les produits courants de fabrication du document dans différents -formats, les sources, les listes de diffusion, et d’autres +(see Overview). La page d’accueil de ce document est +https://latexref.xyz. Cette page contient des liens vers +différentes versions de ce document, dans différents +formats et langues, mais aussi vers ses sources, vers les archives des listes de diffusion qui lui sont consacrées ainsi que vers d’autres infrastructures. &latex; ou &latex;2e, que choisir ? @@ -172,11 +191,14 @@ par les mainteneurs de &latex;. bogues, rapports anomalies, rapports Ne leur envoyez donc pas de rapports d’anomalie ou quoi que ce soit -d’autre. Au lieu de cela, s’il vous plaît envoyez tous commentaires à +d’autre. + +En revanche, n’hésitez pas à adresser vos commentaires à latexrefman@tug.org. -Ce document est un manuel de référence. Il y a une vaste gamme d’autres sources d’information sur -&latex;, de tous niveaux. Voici quelques introductions : +Ce document est un manuel de référence. Il y a d’autres sources d’information sur +&latex; : elles sont très nombreuses, et s’adressent à des utilisateurs de tous niveaux. +Voici quelques introductions : http://ctan.org/pkg/latex-doc-ptr @@ -215,28 +237,34 @@ est un. Knuth, Donald E. Lamport, Leslie &latex; aperçu -&latex; est un système de composition de document. Il fut à l’origine -créé par Leslie Lamport et est desormais maintenu par un groupe de +&latex; est un système de composition de documents. Il fut à l’origine +créé par Leslie Lamport ; il est désormais maintenu par un groupe de volontaires (http://latex-project.org). Il est largement utilisé, en particulier pour les documents complexes et techniques, tels que ceux impliquant des mathématiques. + + + paquet de macro, &latex; en tant que -Un utilisateur &latex; écrit un fichier d’entrée contenant le texte -d’un document avec des commandes qui y sont intercalées pour décrire -comment le texte doit être formaté. &latex; est mis en œuvre comme un +À l’aide d’un simple éditeur de texte, +un utilisateur &latex; écrit un fichier, dit fichier d’entrée, +qui contient son texte ; des commandes y sont intercalées : +ce sont des instructions servant à décrire la manière dont le texte +doit être formaté. En effet, &latex; est mis en œuvre comme un ensemble de commandes liées s’interfaçant avec le programme de composition &tex; de Donald E. Knuth (le terme technique est que &latex; est un paquet de macros pour le moteur &tex;). -L’utilisateur produit le document de sortie en donnant ce fichier -d’entrée au moteur &tex;. +En donnant le fichier d’entrée au moteur &tex;, +l’utilisateur produit le document de sortie +qui contient son texte mis en page. Le terme &latex; est aussi parfois utilisé pour signifier le langage à -balises dans lequel le code source du document est écrit, c.-à-d. pour +balises dans lequel le code source du document est écrit, c’est-à-dire pour signifier l’ensemble des commandes à la disposition d’un utilisateur de &latex;. @@ -245,7 +273,7 @@ signifier l’ensemble des commandes à la disposition d’un utilisateu Le nom &latex; est l’abréviation de “Lamport &tex;”. On le prononce LA-TÈQUE. Au sein du document, on produit le logo avec \LaTeX. Là où l’utilisation du logo n’est pas raisonnable, comme dans du texte -brut, écrivez le ‘LaTeX’. +brut, écrivez-le ‘LaTeX’. @@ -258,7 +286,8 @@ brut, écrivez le ‘LaTeX’. Bonjour le monde Les fichiers &latex; ont une structure globale simple, avec un début et -une fin standards. Voici un exemple « Bonjour le monde » : +une fin standards. Voici un exemple : il s’agit d’obtenir un document +contenant la phrase « Bonjour le monde ». \documentclass{article} \begin{document} @@ -266,11 +295,11 @@ Bonjour le monde \LaTeX. \end{document} classe de document, définition -Ici ‘article’ et ce qu’on appelle la classe de document, -implémentée dans une fichier article.cls. N’importe quelle classe +Ici ‘article’ est ce que l’on appelle la classe de document ; +elle est implémentée dans une fichier article.cls. N’importe quelle classe de document peut être utilisée. Quelques classes de document sont définies par &latex; lui-même, et un grand nombre d’autres sont -largement disponibles. Voir Document classes. +largement disponibles. See Document classes. préambule, définition Vous pouvez inclure d’autres commandes &latex; entre les commandes @@ -281,12 +310,13 @@ appelée le préambule). environnement appelle un environnement ; l’environnement ‘document’ (et aucun autre) est obligatoire dans tous les documents &latex; -(voir document). &latex; fournit lui-même beaucoup +(see document). &latex; fournit lui-même beaucoup d’environnements, et bien plus encore sont définis séparément. -Voir Environments. +See Environments. -Les rubriques suivantes discutent de la façon de produire des PDF et -d’autres format de sortie à partir d’un fichier d’entrée &latex;. +Les rubriques suivantes sont consacrées aux façons de produire, +à partir d’un fichier d’entrée &latex;, des documents PDF ou +d’autres formats. @@ -304,25 +334,25 @@ soit en .dvi soit en .pdf. commande dvips commande dvipdfmx commande dvitype -Si il est invoqué avec la commande système latex, alors il +S’il est invoqué avec la commande système latex, alors il produit un fichier « DeVice IndependentIndépendant du périphérique de sortie, ce n’est toutefois pas un format portable de document » (.dvi). Vous pouvez visualiser ce fichier avec une commande comme xdvi, ou le convertir en fichier PostScript .ps avec dvips ou en fichier « Portable Document FormatFormat portable de document » .pdf avec -dvipdfmx. Un grand nombre d’autres progammes utilitaires DVI -sont disponibles (http://mirror.ctan.org/dviware). +dvipdfmx. Un grand nombre d’autres progammes utilitaires +pour fichiers DVI sont disponibles (http://mirror.ctan.org/dviware). .pdf .pdf fichier pdf&tex; commande pdflatex Si &latex; est invoqué avec la commande système pdflatex, -parmi d’autres commandes (voir &tex; engines), alors la sortie -principale est un fichier “Portable Document Format” +alors la sortie principale est un fichier “Portable Document Format” (.pdf). Typiquement, il s’agit d’un fichier autonome, avec toutes les polices et images incorporées. +D’autres commandes (see &tex; engines) produisent des fichiers PDF. @@ -351,7 +381,7 @@ les polices et images incorporées. informations sommaires telles que la liste des paquetages chargés. Il contient aussi des messages de diagnostic -et possiblement des informations supplémentaires concernant toutes +et, possiblement, des informations supplémentaires concernant toutes erreurs. .aux @@ -363,12 +393,12 @@ erreurs. De l’information auxiliaire est utilisée par &latex; pour des choses telles que les doubles renvois. Par exemple, la première fois que &latex; trouve un renvoi en aval — une double référence à -quelque-chose qui n’est pas encore apparu dans le code source — il +quelque chose qui n’est pas encore apparu dans le code source — il apparaîtra dans la sortie comme un double point d’interrogation ??. Quand l’endroit auquel le renvoi fait référence finit par -appraître dans le code source, alors &latex; écrit son information de +apparaître dans le code source, alors &latex; écrit son information de localisation dans ce fichier .aux. À l’invocation suivante, -&latex; lit l’inforlation de localisation à partir de ce fichier et +&latex; lit l’information de localisation à partir de ce fichier et l’utilise pour résoudre le renvoi, en remplaçant le double point d’interrogation avec la localisation mémorisée. @@ -402,9 +432,9 @@ fin définie. entrée Unicode, native polices TrueType polices OpenType -&latex; est défini comme un ensemble de commande qui sont exécutées par -une implémentation &tex; (voir Overview). Cette section donne une -vue d’ensemble laconique des principaux programmes. +&latex; est défini comme un ensemble de commandes qui sont exécutées par +une implémentation &tex; (see Overview). Cette section donne une +brève vue d’ensemble des principaux programmes. latex pdflatex @@ -437,9 +467,9 @@ l’hyptohèse que les extension e-&tex; sont disponibles en &latex;. Si &latex; est invoqué avec la commandes systèmes lualatex, alors le moteur Lua&tex; est exécuté (http://ctan.org/pkg/luatex). Ce programme permet que du code -écrit dans le langage script Lua (http://luatex.org) intéragisse +écrit dans le langage script Lua (http://luatex.org) interagisse avec la compostion faite par &tex;. Lua&tex; traite nativement -l’entrée en Unicode UTF-8, peut traiter les polices OpenType et +l’entrée en codage Unicode UTF-8, peut traiter les polices OpenType et TrueType, et produit un fichier .pdf par défaut. Il y a aussi dvilualatex pour produire un fichier .dvi, mais cela est rarement utilisé. @@ -451,10 +481,10 @@ est rarement utilisé. xdvipdfmx Si &latex; est invoqué avec la commandes système xelatex, le moteur Xe&tex; est exécuté (http://tug.org/xetex). Comme -Lua&tex;, Xe&tex; prend en charge nativement UTF-8 Unicode et les -polices TrueType et OpenType, bien que l’implementation soit -complètement différente, utilisant principalement des bibliothèque -externe plutôt que du code interne. Xe&tex; produit un fichier .pdf +Lua&tex;, Xe&tex; prend en charge nativement le codage Unicode UTF-8 et les +polices TrueType et OpenType, bien que leur implémentation soit +complètement différente, en utilisant principalement des bibliothèques +externes plutôt que du code interne. Xe&tex; produit un fichier .pdf en sortie ; il ne prend pas en charge la sortie DVI. En interne, Xe&tex; crée un fichier .xdv file, une variante de @@ -463,8 +493,8 @@ programme (x)dvipdfmx, mais ce processus e Le fichier .xdv n’est utile que pour le débogage. -D’autres vairantes de &latex; et &tex; existent, par ex. pour fournir -une prise en charge supplémentaires du japonais des d’autres langages +D’autres variantes de &latex; et &tex; existent, par exemple pour fournir +une prise en charge supplémentaire du japonais et d’autres langages ([u]p&tex;, http://ctan.org/pkg/ptex, http://ctan.org/pkg/uptex). @@ -478,41 +508,53 @@ une prise en charge supplémentaires du japonais des d’autres langages [...] pour les arguments optionnels {...} pour les arguments obligatoires Dans le fichier d’entrée &latex;, un nom de commande commence avec une -contr’oblique, \. Le nom lui-même consiste soit en (a) une -chaîne de lettres ou (b) une unique non-lettre. +contre-oblique, \. Le nom lui-même consiste soit en (a) une +chaîne de lettres ou (b) un unique caractère, qui dans ce cas n’est pas une lettre. Les noms de commandes &latex; sont sensibles à la casse de sorte que \pagebreak diffère de \Pagebreak (ce dernier n’est pas une -commande standarde). La plupart des noms de commandes sont en bas de -casse, mais en tout cas vous devez saisir toutes les commandes dans la -même casse où elles sont définies. +commande standard). La plupart des noms de commandes sont en bas de +casse, mais elles sont sensibles à la casse : vous devez toujours saisir +les commandes en respectant la casse où elles ont été définies. Une commande peut être suivie de zéro, un ou plus d’arguments. Ces arguments peuvent être soit obligatoires, soit optionnels. Les arguments obligatoires sont entre accolades, {...}. Les -arguments optionnels sont entre crochets, [...]. En général, -mais ce n’est pas universel, si la commande prend un argument optionnel, +arguments optionnels sont entre crochets, [...]. En général +(mais ce n’est pas universel), si la commande prend un argument optionnel, il vient en premier, avant tout argument obligatoire. Au sein d’un argument optionnel, pour utiliser le crochet -fermant (]) cachez le au sein d’accolades, comme +fermant (]) cachez-le au sein d’accolades, comme dans \item[crochet fermant {]}]. De même, si un argument optionnel vient en dernier, sans argument obligatoire à sa suite, alors -pour qie le premier caractère dans le texte suivant soit un crochet -ouvrant, cachez le entre accolades. +pour que le premier caractère dans le texte suivant soit un crochet +ouvrant, cachez-le entre accolades. -&latex; a la convetion que certaines commandes ont une forme en a -* qui est en relation avec la forme sans le *, telles que +&latex; obéit à la convention selon laquelle certaines commandes ont une forme étoilée +(*) qui est en relation avec la forme sans le *, telles que \chapter et \chapter*. La différence exacte de comportement dépend de la commande. -Ce manuel décrit toutes les options accepté et les formes en * -pour les commandes dont il traite (à l’exeption des omissions -involontaires, ou bogues de ce manuel). +Ce manuel décrit toutes les options acceptées et les formes en * +pour les commandes dont il traite (à l’exception des omissions +involontaires ou bogues de ce manuel). + + - + +Les déclarations de commandes + +Certaines commandes changent la valeur ou la signification d’une +autre commande ou d’un paramètre. Par exemple, la commande \mainmatter +change le réglage de la numérotation des pages en passant de chiffres +romains à des chiffres arabes. + + + + Les environnements Synopsis : @@ -526,376 +568,64 @@ comportement différent. Par exemple, pour la poésie en &latex; mettez les lignes entre \begin{verse} et \end{verse}. \begin{verse} - There once was a man from Nantucket \\ + Plus ne suis ce que j'ai été \\ ... \end{verse} Voir Environments pour une liste des environnements. -Le nom environnement au début doit s’accorder exactement avec -celui à la fin. Ceci comprend le cas où nom environnement se -termine par une étoile(*) ; l’argument à la fois de +Le nom environnement du début doit s’accorder exactement avec +celui de la fin. Cela vaut aussi dans le cas où nom environnement se +termine par une étoile (*) ; l’argument à la fois de \begin et \end doit comprendre l’étoile. Les environnements peuvent avoir des arguments, y compris des arguments optionnels. L’exemple ci-dessous produit un tableau. Le premier -argument est optionnel (et implique de la table est alignée -verticalement sur sa première ligne) alors que le second argument et -obligatoire (il spécifie le format des colonnes). +argument est optionnel (il aligne verticalement le tableau +sur sa première ligne) alors que le second argument est +obligatoire (il spécifie le format des colonnes du tableau). \begin{tabular}[t]{r|l} ... lignes du tableau ... \end{tabular} + + +CTAN : The Comprehensive &tex; Archive Network - - -Les déclarations de commandes - -Une commande qui change la valeur, ou change la signification, d’une -autre commande ou paramètre. Par exemple, la commande \mainmatter -change le réglage de la numérotation des pages en passant de numéros -romains à des numéros arabes. - - - -<literal>\makeatletter</literal> et <literal>\makeatother</literal> - -Synopsis : - -\makeatletter - ... définition de commande comprenant @ dans leur nom .. -\makeatother - -Utilisé pour redéfinir des commandes internes de &latex;. -\makeatletter a pour effet que le caractère arobe @ ait -le code de catégorie des lettres, c.-à-d. 11. \makeatother -règle de code de catégorie de @ à 12, sa valeur d’origine. - -À mesure que chaque caractère est lu par &tex; pour &latex;, un code -de catégorie lui est assigné. On appelle aussi ce code -catcode -code de catégorie de caractère -catégorie, code de … de caractère -catcode pour faire court. Par exemple, la contr’oblique \ -reçoit le catcode 0, qui correspond aux catactères qui commencent une -commande. Ces deux commandes altèrent le catcode assigné à @. - -Cette altération est nécessaire parce que beaucoup des commandes de -&latex; utilisent @ dans leur nom, de sorte à empécher les -utilisateurs de définir accidentellement une commande qui remplacerait -l’une des commandes privées de &latex;. Les noms de commandes -consistent en un caractère de catégorie 0, d’ordinaire une -contr’oblique, suivi de lettres, c.-à-d. des caractères de -catégorie 11 (à ceci près q’un nom de commande peut aussi consister d’un -catactère de catégorie 0 suivi d’un seul symbole non-lettre). Ainsi sous -le régime par défaut de codes de catégorie, les commandes définies par -l’utilisateur ne peuvent pas contenir de @. Mais -\makeatletter et \makeatother permettent aux utilisateurs -de définir et re-définir des commandes dont le nom comprend un -@. - -À utiliser dans un fichier .tex, dans le préambule. Ne pas -utiliser dans des fichiers .sty ou .cls puisque les -commandes \usepackage et \documentclass règlent le code de -catégorie de l’arobe à celui d’une lettre. - -paquetage macros2e -macros2e, paquetage -Pour une liste complète des macros contenant un arobe dans leur nom, -voir le document http://ctan.org/pkg/macros2e. Ces macros sont -surtout à l’intention des auteurs de classes et de paquetages. - - -L’exemple ci-après est typique. Une commande -\these@nomuniversite se trouve dans le fichier de classe de -l’utilisateur. L’utilisateur veut changer sa définition. Pour cela, il -suffit d’insérer les trois lignes suivantes dans le préambule, avant le -\begin{document} : - -\makeatletter -\renewcommand{\these@nomuniversite}{Université Lyon III Jean Moulin} -\makeatother - - - - - -<literal>\@startsection</literal> - -Synopsis : - -\@startsection{nom}{niveau}{retrait}{avant}{après}{style} - -Cette commande permet de redéfinir les commandes de rubricage telles que \section ou \subsection. - -Notez que le paquetage titlesec rend la manipulation du rubricage -plus facile. De plus, bien que la plupart des exigences concernant les -commandes de rubricage peuvent être remplies avec -\@startsection, ce n’est pas le cas de toutes. Par exemple, -dans les classes &latex; standardes book et report les -commandes \chapter et \report ne sont pas construite de -cette manière. Pour fabriquer une telle commande il est possible -d’utiliser la commande \secdef. - - -Techniquement, cette commande a la forme : -\@startsection{nom}{niveau}{retrait}{avant}{après}{style} - *[titretdm]{titre} -de sorte que faire : -\renewcommand{\section}{\@startsection{nom}{niveau}{retrait}% - {avant}{après}{style}} -redéfinit \section en gardant sa forme standarde d’appel -\section*[titretdm]{titre}. Voir Sectioning et -les exemples plus bas. - - - -nom -Nom du compteur (qui doit être défini -séparément) utilisé pour numéroter le titre de rubrique. Ceux le plus -communément utilisés sont section, subsection, ou -paragraph. Bien que dans ces trois cas le nom du compteur soit le -même que celui de la commande elle-même, utiliser le même nom n’est pas -exigé. - -Alors \thename affiche le numéro de titre, et -\namemark sert aux en-têtes de page. - -niveau -Un entier donnant la profondeur de la -commande de rubricage, par ex. 0 pour chapter (ceci ne -s’applique qu’aux classes standardes book et report), 1 -pour section, 2 pour subsection, 3 pour -subsubsection, 4 pour paragraph et 5 pour -subparagraph. Dans les classes book et report, -part a pour niveau -1, alors que dans la classe article, -part a pour niveau 0. - -Si niveau est inférieur ou égal à la valeur de secnumdepth -alors les titres pour cette commande de rubricage sont numérotés. Par -ex. dans un article, si secnumdepth vaut 1 alors une -commande \section{Introduction} produira en sortie quelque -chose du genre de 1 Introduction alors que -\subsection{Historique} produit en sortie quelque chose du -genre de Historique, sans numéro en -préfixe. Voir Sectioning/secnumdepth. - -Si niveau est inférieur ou égal à la valeur de secnumdepth -alors la table des matières aura un article pour cette rubrique. Par -exemple, dans un article, si tocdepth vaut 1 alors la -table des matières listera les sections, mais pas les -subsections. - - -retrait -Une longueur donnant le renfoncement de -toutes les lignes du titre relativement à la marge. Pour un -renfoncement nul, utilisez 0pt. - - -Une valeur négative telle que -1em cause un débord du titre dans -la marge. - -avant -Longueur dont la valeur absolue est -la longueur de l’espace vertical à insérer avant le titre de la -rubrique. Cet espacement est ignoré si la rubrique commence au début -d’une page. Si en plus avant est négatif, alors le premier -paragraphe suivant immédiatement le titre n’est pas renfoncé, s’il est -positif ou nul il l’est. (Notez que l’opposé de 1pt plus 2pt -minus 3pt est -1pt plus -2pt minus -3pt). - -Par exemple si avant vaut -3.5ex plus -1ex minus -0.2ex -alors pour commencer la nouvelle rubrique, &latex; ajoute environ 3,5 -fois la hauteur d’une lettre x en espace veritical, et le premier -paragraphe de la rubrique n’est pas renfoncé. Utiliser une longueur -élastique, c.-à-d. comprenant plus et minus, est une -bonne pratique ici car cela donne à &latex; plus de latitude lors de la -fabrication de la page. - -La quantité totale d’espace vertical entre la ligne de base de la ligne -précédant le titre de cette rubrique est la ligne de base du titre est -la somme du \parskip dans la police du corps de texte, du -\baselineskip de la police du titre, et de la valeur absolue de -l’argument avant. Cet espace est typiquement élastique et peut se -dilater ou se contracter. (Si la rubrique commence en début d’une page -de sorte que cet espace soit ignoré, alors la ligne de base du titre -correspond à la ligne de base qu’aurait la première ligne de texte sur -cette page si celle-ci commençait par du texte). - -après -Longueur. Lorsque elle est positive -ou nulle, il s’agit de l’espace vertical à insérer après le titre de la -rubrique. Lorsque elle est négative, alors le titre fait corps avec le -paragraphe le suivant immédiatement. Dans ce cas la valeur absolue de -la longueur donne l’espace horizontal entre la fin du titre et le début -du paragraphe suivant. (Notez que l’opposé de 1pt plus 2pt minus -3pt est -1pt plus -2pt minus -3pt). - -Comme c’est le cas avec avant, utiliser une longueur élastique -avec des composantes plus et minus est une bonne pratique -ici puisque elle donne à &latex; plus de latitude pour assembler la -page. - -Si après est positif ou nul alors la quantité totale d’espace -vertical entre la ligne de base du titre de la rubrique et la ligne de -base de la première ligne du paragraphe suivant est la somme du -\parskip de la police du titre, de \baselineskip de la -police du corps de texte, et de la valeur de après. Cet espace est -typiquement élastique de sorte qu’il puisse se dilater ou se -contracter. (Notez que du fait que le signe d’après contrôle que -le titre soit indépendant du texte le suivant, ou fasse corps avec lui, -vous ne pouvez pas utiliser un après négatif pour annuler une -partie du \parskip). - -style -Contrôle le style du titre, voir les -exemples plus bas. Les commandes typiquement utilisées ici sont -\centering, \raggedright, \normalfont, -\hrule, ou \newpage. La dernière commande au sein de -style peut être une commande prenant un argument, telle que -\MakeUppercase ou \fbox. Le titre de la rubrique est passé -en argument à cette commande. Par exemple régler style à -\bfseries\MakeUppercase a pour effet de produire des titres gras -et en capitales. - -Voici des exemples. Pour les utiliser mettez les soit au sein d’un -fichier de paquetage ou de classe, ou placez les dans le préambule d’un -document &latex; entre des commandes \makeatletter et -\makeatother. (Le message d’erreur You can't use -`\spacefactor' in vertical mode. est le plus probable lorsque on -oublie de faire cela). Voir \makeatletter and \makeatother. - -L’exemple suivant redéfinit la commande de rubricage \section -pour qu’elle centre le titre et le mette en gras : - -\renewcommand\section{% - \@startsection{section}% nom. - {1}% niveau. - {0pt}% retrait. - {-3.5ex plus -1ex minus -.2ex}% avant. - {2.3ex plus.2ex}% après. - {\centering\normalfont\Large\bfseries}}% style. - -Cet exemple met les titres de subsection en petites capitales, et -leur fait faire corps avec le paragraphe suivant. - -\renewcommand\subsection{% - \@startsection{subsection}% nom. - {2}% niveau. - {0em}% retrait. - {-1ex plus 0.1ex minus -0.05ex}% avant. - {-1em plus 0.2em}% après. - {\scshape}% style. - } - -Les exemples précédents redéfinissait les commandes de titre de -rubriques existantes. celui-ci en définit une nouvelle, illustrant la -nécessité d’un compteur et de macros pour son affichage. - - -\setcounter{secnumdepth}{6}% affiche les compteur justqu'à ce niveau -\newcounter{subsubparagraph}[subparagraph]% compteur pour la - % numérotation -\renewcommand{\thesubsubparagraph}% - {\thesubparagraph.\@arabic\c@subsubparagraph}% comment afficher - % la numérotation -\newcommand{\subsubparagraph}{\@startsection - {subsubparagraph}% - {6}% - {0em}% - {\baselineskip}% - {0.5\baselineskip}% - {\normalfont\normalsize}} -\newcommand*\l@subsubparagraph% - {\@dottedtocline{6}{10em}{5em}}% pour la table des matières -\newcommand{\subsubparagraphmark}[1]{}% pour les en-têtes de page - - - - - -<literal>\@ifstar</literal> - -\@ifstar -commandes, variantes étoilées -étoilées, variantes de commandes - - - - +CTAN -Vous l’avez sans doute remarqué, beaucoup d’environnements ou commandes -standards de &latex; existent sous une variante étoilée. Vous pouvez avoir -envie de reprendre cette idée quand vous définissez vos commandes et arguments. - -Si vous avez lu \newenvironment & \renewenvironment, vous aurez compris -que c’est immédiat pour les environnements car l’étoile est un caractère -autorisé dans les noms d’environnements. Il vous suffit donc de faire -\newenvironment{monenv} et -\newenvironment{monenv*} avec les définitions souhaitées. - -Pour les commandes, c’est plus compliqué car l’étoile ne peut pas faire partie -du nom de la commande. Il y aura donc une première commande, qui devra être -capable de regarder si elle est ou non suivie d’une étoile et d’adapter son -comportement en conséquence. Cette première commande ne pourra pas accepter -d’argument, mais pourra faire appel à des commandes qui en acceptent. Par -ailleurs, on utilise la commande \@ifstar interne du noyau &latex; et -vous pouvez vous reportez à « \makeatletter and \makeatother » pour -comprendre pourquoi cela implique l’usage d’un bloc -\makeatletter...\makeatother. - -Dans cet exemple, on définit \ciel comme une commande avec un -argument obligatoire et admettant une variante étoilée \ciel* -également avec un argument obligatoire : - -\makeatletter -\newcommand*\ciel@starred[1]{ciel #1 étoilé} -\newcommand*\ciel@unstarred[1]{ciel #1 non étoilé} -\newcommand\ciel{\@ifstar{\ciel@starred}{\ciel@unstarred}} -\makeatother - -ainsi, \ciel{bleu} composera « ciel bleu non étoilé » tandis que -\ciel*{nocturne} composera « ciel nocturne étoilé ». - -Notez que les commandes intermédiaires \ciel@starred et -\ciel@unstarred comportent un @ dans leur nom ce qui est -possible puisque elles apparaissent au sein d’un bloc -\makeatletter...\makeatother. Ceci assure qu’elles ne puissent pas être -utilisées directement dans le document. L’utilisation de @ dans le nom -comporte certes un risque de collision avec une commande interne du noyeau -&latex;, mais une telle collision est facile à détecter et corriger car -\newcommand*{\cmd} vérifie que si la commande \cmd -n’est pas déjà définie et génère une erreur si c’est le cas. +Le «Comprehensive &tex; Archive +Network», ou CTAN, est le dépôt de matériel libre de la +communauté &tex; et &latex;. C’est un ensemble de sites Internet +réparti dans le monde qui offre de télécharger du matériel en relation +avec &latex;. Visitez CTAN sur la Toile à l’adresse +https://ctan.org. -Voici un autre exemple où la commande \agentsecret comporte deux -arguments et sa variante étoilée \agentsecret* un seul : +Ce matériel est organisé en paquetages, des paquets discrets qui offrent +typiquement une fonctionalité cohérente et sont maintenus par une +personne ou un petit nombre de personnes. Par exemple, beaucoup +d’organismes d’édition on un paquetage qui permet aux auteurs de +formater leurs articles conformément aux spécification de cet organisme. -\makeatletter -\newcommand*\agentsecret@starred[1]{\textsc{#1}} -\newcommand*\agentsecret@unstarred[2]{\textit{#1} \textsc{#2}} -\newcommand\agentsecret{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}} -\makeatother - -Avec cette définition la célèbre réplique de l’agent 007 : +En plus des resources massives, le site ctan.org offre des fonctions telles que +la recherche par nom ou par fonctionalité. -Je m'appelle \agentsecret*{Bond}, \agentsecret{James}{Bond}. - -est équivalente à : +DANTE e.V. +CTAN n’est pas un site unique, mais au lieu de cela un ensemble de +sites. L’un des ces sites est le cœur. Ce site gère activement le +matériel, par exemple en acceptant les téléversements de matériel +nouveau ou mis à jour. Il est hébergé par le groupe &tex; allemand +DANTE e.V. -Je m'appelle \textsc{Bond}, \textit{James} textsc{Bond}. - -Un dernier mot : contrairement aux noms d’environnement où l’étoile fait partie -du nom lui-même, et pourrait donc être à n’importe quelle position, dans le nom -d’une commande l’étoile est comme une sorte d’argument optionnel. D’un point de -vue purement &tex;nique il est donc possible de mettre un nombre indéfini -d’espaces entre la commande et l’étoile. Ainsi \agentsecret*{Bond} et -\agentsecret *{Bond} sont équivalents. Toutefois la pratique commune -est de ne jamais insérer de tels espaces. +mirrors of CTAN +D’autres sites autour du monde apportent leur aide en miroitant, c’est à +dire en synchronisant automatiquement leurs collections sur le site +maître et en rendant à leur tour leurs copies publiquement +disponibles. Ceci donne aux utilisateurs géographiquement proches un +meilleur accès et allège la charge sur le site maître. La liste des +miroirs se trouve à https://ctan.org/mirrors. - - @@ -904,7 +634,8 @@ est de ne jamais insérer de tels espaces. classes de documents \documentclass -La classe d’un document donné est définie avec la commande: +La classe globale d’un document est définie avec cette commande, c’est +normalement la première commande dans une fichier source &latex;. \documentclass[options]{classe} @@ -916,14 +647,37 @@ fichier source &latex;. classe book classe letter classe slides -Les noms de classe &latex; encastrés sont (beaucoup d’autres -classes de documents sont disponibles en modules ; voir Overview): +Les noms de classe de document incorporés à &latex;. (Beaucoup +de classes de document sont disponibles dans des paquetages séparés ; +see Overview.) + +article +Pour un article de journal, une présentation, et diverses utilisations +générales. + +book + +Des livres complets, y compris des chapitres et possiblement incluant +des pièces préliminaires telles qu’une préface, et postliminaires telles +qu’un appendice (see Front/back matter). + +letter +Courrier, incluant optionnellement des étiquettes pour enveloppes +(see Letters). + +report +Pour des documents de longueur entre celle d’un article et celle +d’un book, tels que des rapports techniques ou des thèses, et qui +peuvent contenir plusieurs chapitres. + +slides +Pour des présentations de diapositive — rarement utilisé de nos jours. +À sa place la classe beamer est sans doute celle dont l’usage est +le plus répendu (https://ctan.org/pkg/beamer). See beamer +template, pour un petit partron de document beamer. -article report book letter slides - - - -Les options standardes sont décrites ci-dessous. + +Les options standardes sont décrites dans les rubriques suivantes. @@ -982,13 +736,17 @@ taille du papier (ci-après hauteur sur largeur) : \pdfpagewidth \pdfpageheight paquetage geometry -geometry, paquetage Lorsque on utilise l'un des moteurs pdf&latex;, -Lua&latex;, ou Xe&latex; (voir &tex; engines), les options autres +geometry, paquetage +Lorsque on utilise l’un des moteurs pdf&latex;, +Lua&latex;, ou Xe&latex; (see &tex; engines), les options autres que letterpaper règlent la zone d’impression mais vous devez également régler la taille du papier physique. Un méthode pour faire cela est de placer \pdfpagewidth=\paperwidth et \pdfpageheight=\paperheight dans le préambule de votre document. -Le paquetage geometry fournit des méthodes flexibles pour régler +paquetage geometry +geometry, paquetage + +Le paquetage geometry fournit des méthodes flexibles pour régler la zone d’impression et la taille du papier physique. option draft @@ -1093,7 +851,7 @@ pourriez créer une nouvelle classe cmsnote.cls et commencer documents par \documentclass{cmsnote}. Ce qui distingue un paquetage d’une classe de document c’est que les -commandes d’une paquatage sont utilisables pour différentes classes +commandes d’une paquetage sont utilisables pour différentes classes alors que celles dans une classes de document sont spécifiques à cette classes. Ainsi, une commande qui permet de régler les en-têtes de pages irait dans un paquetage alors qu’une commande intitulant en-têtes de @@ -1102,10 +860,10 @@ une classe. classe et paquetage, différence 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 @ comme un caractère dans les noms de commande sans avoir à entourer le code contenant la commande en question par -\makeatletter et \makeatother. Voir \makeatletter and +\makeatletter et \makeatother. See \makeatletter & \makeatother. Ceci permet de créer des commandes que les utilisateurs ne risquent pas de redéfinir accidentellement. Une autre technique est de préfixer les commandes spécifiques à une classe ou paquetage avec une @@ -1208,7 +966,7 @@ d’appel. Voir aussi \AtBeginDocument \CheckCommand \CheckCommand* nouvelle commande, vérification -Similaire à \newcommand (voir \newcommand & \renewcommand) +Similaire à \newcommand (see \newcommand & \renewcommand) mais ne définit pas cmd ; à la place vérifie que la définition actuelle de cmd est exactement celle donnée par définition et est ou n’est pas longue selon ce que l’on attend. @@ -1270,10 +1028,10 @@ uniquement être utilisé au sein de l’argument code\DeclareOption*{option}{code} \DeclareOption \DeclareOption* -class options -package options -options, class -options, package +classe, options +paquetage, options +options de classe +options de paquetage Rend un option option disponible pour l’utilisateur, de sorte à ce qu’il puisse la passer à leur commande \documentclass. Par exemple, la classe notecms pourrait avoir une option logo @@ -1311,9 +1069,9 @@ l’option à la classe article. \DeclareRobustCommand* nouvelle commande, définition Similaire à \newcommand et \newcommand* -(voir \newcommand & \renewcommand) mais déclare une commande robuste, +(see \newcommand & \renewcommand) mais déclare une commande robuste, même si définition comprend du code fragile. (Pour une discussion -sur les commandes robustes et fragiles voir \protect). Utilisez ces +sur les commandes robustes et fragiles see \protect). Utilisez ces commande pour définir de nouvelles commandes robustes, ou redéfinir des commandes existantes en les rendant robustes. Contrairement à \newcommand elle ne produisent pas d’ereru si la macro cmd @@ -1326,13 +1084,14 @@ le contenu de la commande soit fragile et que la commande soit utilisée au sein d’un argument mouvant, utilisez \newcommand. paquetage etoolbox -etoolbox, paquetage Le paquetage etoolbox offre les commandes -\newrobustcmd, \newrobustcmd*, \renewrobustcmd, +etoolbox, paquetage +Le paquetage etoolbox offre les commandes +\newrobustcmd, \newrobustcmd*, \renewrobustcmd, \renewrobustcmd*, \providerobustcmd, et \providrobustcmd* qui sont similaire aux commandes standardes \newcommand, \newcommand*, \renewcommand, \renewcommand*, \providecommand, et -\providcommand*, mais définissent une commande cmd robuste +\providecommand*, mais définissent une commande cmd robuste avec deux advanges par rapport à \DeclareRobustCommand : Elle utilisent un mécanisme de protection de bas niveau d’e-&tex; au lieu du mécanisme de plus au niveau de &latex; utilisant @@ -1412,7 +1171,7 @@ et le plus souvent elle est utilisée de cette façon : classe est traité, le nom du format donné ici doit s’accorder avec le format qui est en cours d’exécution (y compris le fait que la chaîne format est sensible à la casse). Si il ne s’y accorde pas alors -l’exécution est interrompue par une erruer du genre de ‘This file +l’exécution est interrompue par une erreur du genre de ‘This file needs format `LaTeX2e' but this is `xxx'. Pour spécifier une version du format dont vous savez qu’elle prend en @@ -1479,9 +1238,9 @@ option. L’utilisateur peut commencer son fichier &latex; avec \ProcessOptions*\@options \ProcessOptions \ProcessOptions* -Exécute le code associé à chaque option que l’utilisateur a invoquée. À -include dans le fichier classe sous la forme -\ProcessOptions\relax (à cause de l’existance de la variant +Exécute le code pour chaque option que l’utilisateur a invoquée. À +inclure dans le fichier classe sous la forme +\ProcessOptions\relax (à cause de l’existence de la variante étoilée de la commande). Les options tombent dans deux catégories. Les options locales @@ -1578,10 +1337,10 @@ essai.cls’. \RequirePackage \RequirePackageWithOptions Charge un paquetage, comme la commande \usepackage pour les -auteurs de documents. Voir Additional packages. Voici un exemple : +auteurs de documents. See Additional packages. Voici un exemple : \RequirePackage[landscape,margin=1in]{geometry}. Notez que l’équipe de développement de &latex; recommande fortement l’utilisation -de ces commande de préférence à l’\input de Plain &tex; ; +de ces commandes de préférence à l’\input de &tex; de base ; voir le « Class Guide ». La liste d’options, si présente, est une liste ponctuée de @@ -1696,7 +1455,7 @@ environnement ; par exemple, \begin{ttfamily} … \texttt (\ttfamily) \texttt \ttfamily -Machine à écrire. +Tapuscrit, encore appelé « machine à écrire ». \textnormal (\normalfont) \textnormal @@ -1717,7 +1476,7 @@ environnement ; par exemple, \begin{ttfamily} … \mathtt \mathtt -Machine à écrire, pour une utilisation en mode mathématique. +Tapuscrit, pour une utilisation en mode mathématique. \mathit (\mit) @@ -1745,6 +1504,7 @@ formules. \mathversion{normal} restaure la valeur par défaut chiffres de revêtement paquetage textcomp textcomp, paquetage + Enfin, la commande \oldstylenums{chiffres} sert à composer des chiffres dits de “à l’ancienne”, qui ont des hauteurs et profondeur (et parfois largeurs) distincts de l’alignement standard des @@ -1800,8 +1560,9 @@ l’une avec l’autre. \tt\tt police machine à écrire +police tapuscrit police de largeur fixe -Machine à écrire (largeur fixe). +Tapuscrit, encore appelé « Machine à écrire » (largeur fixe). Certaines personnes considèrent que les commandes commutation @@ -1810,7 +1571,7 @@ inconditionnelles de polices, comme \tt, sont obsolète et qu utilisées. Je (Karl) ne suis pas d’accord. il y a situations tout à fait raisonnables quand un commutateur de police inconditionnelle est précisément ce dont vous avez besoin pour obtenir le résultat souhaité ; -pour un exemple, voir description. Les deux +pour un exemple, see description. Les deux ensembles de commandes ont leur place. @@ -1820,11 +1581,11 @@ ensembles de commandes ont leur place. tailles des polices de caractères tailles de texte -Les commandes de type de taille standard suivants sont pris en charge +Les commandes de type de taille standardes suivantes sont pris en charge par &latex;. Le tableau indique le nom de la commande et taille utilisée (en points) correspondant réellement pour la police avec les options ‘10pt’, ‘11pt’, et ‘12pt’ de classe de document, -respectivement (voir Document class options). +respectivement (see Document class options). \tiny \scriptsize @@ -1860,13 +1621,37 @@ respectivement (voir Document class optio \Huge 24.88 24.88 24.88 -Les commandes énumérées ici sont des “forme déclaratives”. La portée -d’une forme déclarative s’étend jusqu’à la prochaine la commande de type -style ou la fin du groupe courant. Vous pouvez également utiliser la -“forme d’environnement” de ces commandes ; par exemple, -\begin{tiny} ... \end{tiny}. +déclarative, forme des commandes de contrôle de la taille de police +forme déclarative des commandes de contrôle de la taille de police +Les commandes énumérées ici sont des formes déclaratives. On est +utilise en les déclarant comme dans l’exemple qui suit : + +\begin{quotation} \small + Le Tao que l'on peut nommer n'est pas le Tao. +\end{quotation} + +Dans ce qui précède, la portée de \small s’étend jusqu’à la fin +de l’environnement quotation. Elle s’arrêterait également à la +prochaine commande de style ou à la fin du groupe courant, de sorte +qu’on aurait pu la mettre entre accolades {\small Ce texte est en +petits caractères.}. + +forme par environnement des commandes +Une forme par environnement de chacune de ces commandes est également +définie ; par exemple, \begin{tiny}...\end{tiny}. Toutefois, +en pratique cette forme peut aisément mener à des espaces indésirables au +début et/ou à la fin de d’environnement si on n’y prête pas attention, +ainsi on risque en général moins de faire d’erreur si on s’en tient à la +forme déclarative. + +(Digression : techniquement, vu la façon dont &latex; définit +\begin et \end, presque toutes les commandes qui ne +prennent pas d’argument on une forme par environnement. Mais dans +presque tous les cas ce serait juste une source de confusion de +l’utiliser. La raison pour mentionner en particulier la forme par +environnement des déclarations de taille de police est que leur +utilisation s’avère assez courante, en dépit des problèmes qu’il pose). - commandes de fontes de bas niveau @@ -1876,91 +1661,226 @@ style ou la fin du groupe courant. Vous pouvez également utiliser la Ces commandes sont principalement destinés aux auteurs de macros et paquetages. Les commandes indiquées ici sont seulement un sous-ensemble de celles disponibles. + + \fontencoding{codage} \fontencoding -Sélectionnez le codage de police. Les codages valides comprennent OT1 et T1. - -\fontfamily{famille} +Sélectionne le codage de police, le codage de la police utilisée en +sortie. Il y a un grand nombre de codages valides. Les plus usuels sont +OT1, le codage original de D. Knuth pour la police Computer +Modern (la police par défaut), et T1, également désigné par +codage Cork, qui prend en charage les caractères accentués utilisés par +les langues européennes les plus parlées (allemand, français, italien, +polonais et d’autres encore), ce qui permet à &tex; de faire la césure +des mots contenant des lettres accentuées. Pour plus d’information, voir +https://ctan.org/pkg/encguide. + +\fontfamily{famille} \fontfamily -Sélectionnez la famille de polices. Familles valides sont : - -cmr pour Computer Modern Roman -cmss pour Computer Modern Sans Serif -cmtt pour Computer Modern Typewriter - -et de nombreuses autres. - -\fontseries{série} +famille de polices +polices, catalogue +Sélectionne la famille de polices. La page web +https://www.tug.dk/FontCatalogue/ donne un moyen de naviguer +facilement à travers un grand nombre des polices utilisées avec +&latex;. Voici des exemples de quelques-unes des familles les plus +usuelles : + +pag +Avant Garde +fvs +Bitstream Vera Sans +pbk +Bookman +bch +Charter +ccr +Computer Concrete +cmr +Computer Modern +cmss +Computer Modern Sans Serif +cmtt +Computer Modern Typewriter +pcr +Courier +phv +Helvetica +fi4 +Inconsolata +lmr +Latin Modern +lmss +Latin Modern Sans +lmtt +Latin Modern Typewriter +pnc +New Century Schoolbook +ppl +Palatino +ptm +Times +uncl +Uncial +put +Utopia +pzc +Zapf Chancery + +\fontseries{série} \fontseries -Sélectionnez série de police. Les séries valides sont : - -m Moyen (normal) -b Gras -c condensé -bc condensé Gras -bx Gras étendu - -et diverses autres combinaisons. +séries de polices +Sélectionne une série de police. Une série combine une +graisse et une largeur. Typiquement, une police prend en +charge seulement quelques-unes des combinaisons possibles. Les +combinaisons de valeurs de séries comprennent notamment : + +m +Moyen (normal) +b +Gras +c +Condensé +bc +Condensé Gras +bx +Gras étendu + + +graisses de police +Les valeurs possibles de graisses, considérées individuellement, sont : + +ul +Ultra maigre +el +Extra maigre +l +Maigre (Light) +sl +Semi maigre +m +Demi-gras (Medium, normal) +sb +Semi gras +b +Gras (Bold) +eb +Extra gras +ub +Ultra gras + + +Largeurs de police +La valeurs possibles de largeur, considérées individuellement sont : + +uc +Ultra condensé +ec +Extra condensé +c +Condensé +sc +Semi condensé +m +Moyen +sx +Semi étendu +x +étendu +ex +Extra étendu +ux +Ultra étendu + +Quand Lorsqu’on forme la chaîne de caractères série à partir de la +graisse et de la largeur, on laisse tomber le m qui signifie +medium concernant la graisse ou la largeur, auquel cas on en utilise +juste un (‘m’). -\fontshape{forme} +\fontshape{allure} \fontshape -Sélectionnez l’allure de police. Les allures valides sont : - -n Droit (normal) -it Italique -sl Incliné (oblique) -sc Petites capitales -ui Italique droit -ol Plan - +allure de police +Sélectionne l’allure de police. Les allures valides sont : + +n +Droit (normal) +it +Italique +sl +Incliné (oblique) +sc +Petites capitales +ui +Italique droit +ol +Plan + Les deux dernières allures ne sont pas disponibles pour la plupart des -familles de polices. +familles de polices, et les petites capitales sont aussi souvent +absentes. -\fontsize{taille}{interligne} +\fontsize{taille}{interligne} \fontsize \baselineskip -Réglage de la taille de police. Le premier paramètre est la taille de la -police pour basculer et le deuxième est l’espacement d’interligne ; ceci -est stocké dans un paramètre nommé \baselineskip. L’unité des -deux paramètres est par défaut le pt. La valeur par défaut de -\baselineskip pour la police Computer Modern est 1,2 fois le -\fontsize. - -\baselinestretch +Réglage de la taille de police et de l’espacement d’interligne. L’unité +des deux paramètres est par défaut le point (pt). L’espaceement +d’interligne est l’espace vertiical nominal entre ligne, de ligne de +base à ligne de base. Il est stocké dans le paramètre +\baselineskip. La valeur par défaut de \baselineskip pour +la police Computer Modern est 1,2 fois le \fontsize. Changer +directement \baselineskip est déconseillé dans la mesuure où sa +valeur est réinitialisée à chaque fois qu’un changement de taille se +produit ; voir ensuite \baselinestretch. + +\baselinestretch +\baselinestretch +L’espacement des lignes est également multiplié par la valeur du +paramètre \baselinestretch ; la valeur par défaut est 1. Tout +changement prend effet losque \selectfont (voir plus bas) est +appelé. Vous pouvez modifier l’interligne pour tout le document en +faisant, par ex. pour le doubler, +\renewcommand{\baselinestretch}{2.0} dans le préambule, + paquetage setspace setspace, paquetage -interligne double -L’espacement des lignes est également multiplié par la valeur du -paramètre \baselinestretch en cas de changement de taille de -type ; -la valeur défaut est 1. Cependant, la meilleure façon de mettre -un document en “espacement double”, si vous avez la malchance d’avoir -à produire une telle chose, est d’utiliser le paquetage -setspace ; voir -http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace. - -\linespread +interligne double +Cependant, la meilleure façon de mettre un document en « espacement +double » est d’utiliser le paquetage setspace. En plus de +proposer une pluralité d’options d’espacement, ce paquetage conserve un +interligne simple là où c’est typiquement désirable, comme dans les +notes de bas de page et dans les légendes de figure. Voir la +documentation du paquetage. + \linespread{facteur} -Est équivalent à +\linespread +Est équivalent à \renewcommand{\baselinestretch}{facteur}, et doit donc être suivie par \selectfont pour avoir un effet. Il vaut mieux que ce soit dans le préambule, ou utiliser le paquetage setspace, -comme décrit juste au-dessus. +comme on vient de le décrire. -\selectfont +\selectfont +\selectfont Les modifications apportées en appelant les commandes de polices décrites ci-dessus n’entrent en vigueur qu’après que \selectfont -est appelé. +est appelé, comme dans +\fontfamily{nomfamille}\selectfont. La plupart du temps +il est plus pratique de mettre cela dans une macro : +\newcommand*{\mapolice}{\fontfamily{nomfamille}\selectfont} + +(see \newcommand & \renewcommand). -\usefont{codage}{famille}{série}{forme} + +\usefont{codage}{famille}{série}{allure} \usefont Revient à la même chose que d’invoquer \fontencoding, \fontfamily, \fontseries et \fontshape avec les -paramètres donnés, suivi par \selectfont. +paramètres donnés, suivi par \selectfont. Par exemple : +\usefont{ot1}{cmr}{m}{n} + @@ -1969,7 +1889,7 @@ paramètres donnés, suivi par \selectfont. Mise en page commandes de mise en page -Diverses commandes pour contrôler la disposition générale de la page. +Commandes pour contrôler la disposition générale de la page. @@ -2049,7 +1969,7 @@ même hauteur, en ajoutant de k’espace vertical supplémentaire si nécessaire pour remplir le page. C’est la valeur par défaut si le mode twocolumn est sélectionné -(voir Document class options). +(see Document class options). @@ -2091,9 +2011,9 @@ classe book où elle varie avec la taille de la police. \linewidth\linewidth Largeur de la ligne actuelle, diminuée pour chaque list imbriquée -(voir list). Plus précisément, elle est inférieure à +(see list). Plus précisément, elle est inférieure à \textwidth par la somme de \leftmargin et -\rightmargin (voir itemize). La valeur par défaut varie en +\rightmargin (see itemize). La valeur par défaut varie en fonction de la taille de la police, la largeur du papier, le mode à deux colonnes, etc. Pour un document de classe article en taille de police ‘10pt’, elle vaut ‘345pt’ ; dans le mode à deux @@ -2112,13 +2032,13 @@ une classe book, elle vaut ‘41\baselineskipLa hauteur du papier, à ne pas confondre avec la hauteur de la zone d’impression. Elle est normalement réglée avec une option de classe de document, comme dans \documentclass[a4paper]{article} -(voir Options de classe de document). +(see Options de classe de document). \paperwidth\paperwidth La largeur du papier, à ne pas confondre avec la largeur de la zone d’impression. Elle est normalement réglée avec une option de classe de document, comme dans \documentclass[a4paper]{article} -(voir Options de classe de document). +(see Options de classe de document). \textwidth\textwidth La largeur horizontale totale de l’ensemble du corps de la page; la @@ -2130,15 +2050,15 @@ taille de police, ‘360pt’ à ‘11pt En sortie multi-colonne, \textwidth reste de la largeur de tout le corps de la page, tandis que \columnwidth est la largeur d’une -colonne (voir \twocolumn). +colonne (see \twocolumn). -Dans les listes (voir list), \textwidth est le reste la +Dans les listes (see list), \textwidth est le reste la largeur du corps corps de la page entière (et \columnwidth est la largeur d’une colonne entière), alors que \linewidth peut diminuer au sein de listes imbriquées. -À l’intérieur d’une minipage (voir minipage ) ou \parbox -(voir \parbox), tous les paramètres liés à la largeur sont mis à la +À l’intérieur d’une minipage (see minipage ) ou \parbox +(see \parbox), tous les paramètres liés à la largeur sont mis à la largeur spécifiée, et de reviennent à leurs valeurs normales à la fin du minipage ou \parbox. @@ -2170,8 +2090,8 @@ composés en dehors du flux normal du texte, par exemple flottant au sommet d’une page ultérieure &latex; sait gérer plusieurs classes de matériel flottant. Il y a deux -classes définies par défaut, figure (voir figure) et -table (voir table), mais vous pouvez créer une nouvelle +classes définies par défaut, figure (see figure) et +table (see table), mais vous pouvez créer une nouvelle classes avec le paquetage float. Au sein d’une même classe flottante &latex; respecte l’ordre, de sorte @@ -2221,6 +2141,7 @@ autorisé en soi-même ; t est ajouté automatiquement. ici, placer les flottants paquetage float float, paquetage + Pour forcer à tout prix un flottant à apparaître « ici », vous pouvez charger le paquetage float et le spécificateur H qui y est défini. Pour plus ample discussion, voir l’entrée de FAQ à @@ -2260,6 +2181,7 @@ non placés. paquetage flafter flafter, paquetage + &latex; peut composer un flottant avant l’endroit où il apparaît dans le code source (quoique sur la même page de sortie) s’il y a un spécificateur t au sein du paramètre placement. Si ceci @@ -2344,111 +2266,1037 @@ infuence the position of float environments like figure and table in -Des rubriques +Rubricage + +rubricage, commandes +commandes de rubricage, +part +partie +chapter +chapitre +section +subsection +sous-section +subsubsection +sous-sous-section +paragraph +paragraphe +subparagraph +sous-paragraphe +\part +\chapter +\section +\subsection +\subsubsection +\paragraph +\subparagraph + +Structure votre texte en rubriques : parties, chapitres, sections, +etc. Toutes les commandes de rubricage ont la même forme, l’une parmi : + +cmd-de-rubricage{titre} +cmd-de-rubricage*{titre} +cmd-de-rubricage[titre-tdm]{titre} + +Par exemple, déclarez le début d’une sous-section comme dans +\subsection{Motivation}. + +Le tableau suivant comprend chacune des commandes cmd-de-rubricage +de &latex;. Toutes sont disponibles dans toutes les classes de +document standardes de &latex; book, report, +et article, à ceci près que \chapter n’est pas disponible +dans article. + +Type de rubrique Commande Niveau +Part +\part -1 (book, report), 0 (article) +Chapter +\chapter 0 +Section +\section 1 +Subsection +\subsection 2 +Subsubsection +\subsubsection 3 +Paragraph +\paragraph 4 +Subparagraph +\subparagraph 5 + + +*, forme en * des commandes de rubricage +étoilée, forme des commandes de rubricage +forme étoilée de commandes de rubricage +forme en * de commandes de rubricage +Toutes ces commandes ont une forme en *, aussi appelée étoilée, +qui imprime titre comme d’habitude mais sans le numéroter et sans +fabriquer une entrée dans la table des matières. Un exemple +d’utilisation est pour un appendice dans un article. Entrer le +code \appendix\section{Appendice} donne en sortie ‘A +Appendix’ (see \appendix). Vous pouvez ôter le numéro ‘A’ en +entrant à la place \section*{Appendice} (les articles omettent +couramment d’avoir une table des matières et ont des en-têtes de pages +simples alors les autres différences de la commande \section +peuvent être négligées). + +Le titre titre fournit la rubrique en tant que titre dans le texte +principal, mais il peut également apparaître dans la table des matières +et le haut et le bas de bage (see Page styles). Vous pourriez +désirer un texte différent à ces endroits que dans le texte principal. +Toute ces commandes ont un argument optionnel tdm-titre destiné à +ces autres endroits. + +Le numéro dans la colonne «Niveau» de la +table ci-dessus détermine quelles rubriques sont numérotées, et +lesquelles apparaissent dans la table des matières. Si le niveau +de la commande de rubricage est inférieur ou égal à la valeur du +compteur secnumdepth alors les rubriques correspondant à ces +commandes de rubricage sont numérotées (see Sectioning/secnumdepth). +Et, si niveau est inférieur ou égal à la valeur du compteur +tocdepth alors la table des matières comprend une entrée pour +cette rubrique (see Sectioning/tocdepth). + +&latex; s’attend que avant d’avoir une \subsection vous ayez une + \section et, dans un document de classe book, qu’avant + une \section vous ayez un \chapter. Autrement vous + pourriez obtenir quelque-chose comme une sous-sesction numérotée + ‘3.0.1’. + +paquetage titlesec +titlesec, paquetage + +&latex; vous permet de changer l’apparence des rubriques. Un exemple +simple de ceci est que vous pouvez mettre le numéro de rubrique de type +section en lettres majuscules avec +\renewcommand\thesection{\Alph{section}} dans le préambule +(see \alph \Alph \arabic \roman \Roman \fnsymbol). Le CTAN a +beaucoup de paquetages rendant ce genre d’ajustement plus facile, +notamment titlesec. + +Deux compteurs sont en relation avec l’apparence des rubriques fabriquées +par les commandes de rubricage. + +secnumdepthsecnumdepth +secnumdepth compteur +numéros de rubrique, composition +Le compteur secnumdepth contrôle quels titres de rubriques sont +numérotés. Régler le compteur avec +\setcounter{secnumdepth}{niveau} supprime la +numérotation des rubriques à toute profondeur supérieure à niveau +(See \setcounter). Voir la table plus haut pour la valeur des +niveaux. Par exemple, si le secnumdepth vaut 1 dans un +article alors la commande \section{Introduction} produit +en sortie quelque-chose comme ‘1 Introduction’ alors que +\subsection{Discussion} produit quelque-chose comme +‘Discussion’, sans numéro. La valeur par défaut de &latex; pour +secnumdepth vaut 3 dans la classe article et 2 dans les +classes book et report. + +tocdepthtocdepth +tocdepth counter +table des matières, impression des numéros de rubrique +Contrôle quelles rubriques sont listées dans la table des matières. +Régler \setcounter{tocdepth}{niveau} a pour effet que +les rubriques au niveau niveau sont celles de plus petit niveau à +être listées (see \setcounter). Voir la table ci-dessus pour les +numéros de niveau. Par exemple, if tocdepth vaut 1 alors la table +des matières contiendra les rubriques issues de \section, mais pas +celles de \subsection. La valeur par défaut de &latex; pour +tocdepth vaut 3 dans la classe article et 2 dans les +classes book et report. + + -rubricage -Les commandes de rubricage fournissent les moyens de structurer -votre texte en unités sectionnelles, ou rubriques : + +<literal>\part</literal> + +\part +part +rubricage, part + +Synopsis, l’un parmi : + +\part{titre} +\part*{titre} +\part[tdm-titre]{titre} + +Début une partie de document. Les classes standarde &latex; +book, report, et article offrent toutes cette +commande. -\part\part -\chapter (seulement pour classes report et book)\chapter (seulement pour classes report et book) -\section\section -\paragraph\paragraph -\subsubsection\subsubsection -\paragraph\paragraph -\alinea\alinea - -Toutes les commandes ont la même forme générale, par exemple, +L’exemple suivant produit une partie de document dans un livre : -\chapter[titretdm]{titre} + +\part{VOLUME I \\ + PERSONAL MEMOIRS OF U.\ S.\ GRANT} +\chapter{ANCESTRY--BIRTH--BOYHOOD.} +My family is American, and has been for generations, +in all its branches, direct and collateral. -En plus de fournir le titre de rubrique titre dans le texte -principal, le titre peut apparaître dans deux autres endroits : +Dans chaque classe standarde la commande \part produit en sortie +un numéro de partie tel que ‘Première partie’, seul sur sa ligne, +en caractère gras, et en gros caractères. Ensuite &latex; produit en +sortie titre, également seule sur sa ligne, en caractère gras et +en caractères encore plus gros. +Dans la classe book, le comportement par défaut de &latex; est +de mettre chaque titre de partie seule sur sa propre page. Si le livre +est en recto-verso alors &latex; saute une page si nécessaire pour que +la nouvelle partie commence sur une page à numéro impair. Dans un +report il est également seul sur une page, mais &latex; ne force +pas qu’elle soit de numéro impair. Dans un article &latex; ne +le place pas sur une nouvelle page, mais au lieu de cela produit en +sortie le numéro de partie et le titre de partie sur la même page que le +document principal. -La table des matières. -L’en-tête en cours de traitement en haut de la page. - -Vous ne voudrez peut-être pas le même texte dans ces endroits que dans -le texte principal. Pour gérer cela, les commandes de rubricage ont -un argument optionnel titretdm qui, lorsqu’il est fourni, précise -le texte de ces autres endroits. +La forme en * imprime titre mais n’imprime pas le numéro de +partie, et n’incrémente pas le compteur part, et ne produit +aucune entrée dans la table des matières. -forme étoilée de commandes de rubricage -forme en * de commandes de rubricage -En outre, toutes les commandes de rubricage ont des formes en -*, aussi appelée étoilée, qui compose titre comme -d’habitude, mais ne comprennent pas de numéro et ne produisent pas -d’entrée dans la table des matières. Par exemple : +L’argument optionnel tdm-titre apparaît comme le titre de la +partie dans la table des matières (see Table of contents etc.) et +dans les hauts de pages (see Page styles). S’il n’est pas présent +alors titre est utilisé à sa place. Dans l’exemple suivante on met +un saut de ligne dans titre mais on l’enlève dans la table des +matière. -\section*{Préambule} - +\part[Up from the bottom; my life]{Up from the bottom\\ my life} + +Pour déterminer quelles rubrique sont numéroté et lesquelles +apparaissent dans la table des matières, le numéro de niveau d’une +partie vaut -1 (see Sectioning/secnumdepth et +see Sectioning/tocdepth). + +paquetage indentfirst +indentfirst, paquetage + + +Dans la classe article, si un paragraphe suit immédiatement le +titre de partie alors il n’est pas renfoncé. Pour obtenir un +renfoncement vous pouvez utiliser le paquetage indentfirst. + +paquetage titlesec +titlesec, paquetage + +Un paquetage pour changer le comportement de \part est +titlesec. Voir sa documentation sur le CTAN. + + + + +<literal>\chapter</literal> + +\chapter +chapitre + +Synopsis, l’un parmi : + +\chapter{titre} +\chapter*{titre} +\chapter[tdm-titre]{titre} + +Commence un chapitre. Les classes standardes &latex; book et +report ont cette commande, mais article non. + +L’exemple suivant produit un chapitre. + +\chapter{Mirages} +Appelez moi Ismaël. +Voici quelques années --- peu importe combien --- le porte-monnaie vide +ou presque, rien ne me retenant à terre, je songeai à naviguer un peu et +à voir l'étendue liquide du globe. + +Le comportement par défaut de &latex; est de commence chaque chapitre +sur une page neuve, une page à numéro impair si le document est en +recto-verso. Il produit un numéro de chapitre tel que ‘Chapitre 1’ +en gros caractère gras (la taille est \huge). Ensuite il place le +titre sur une nouvelle ligne, en caractère gras encore plus gros +(taille \Huge). Il incrémente également le compteur +chapter, ajoute une entrée à la table des matières (see Table +of contents etc.), et règle l’information de haut de page (see Page +styles). + +La forme étoilée, ou forme en *, affiche titre sur une +nouvelle ligne, en caractère gras. Mais elle n’affiche pas le numéro de +chapitre, ni n’incrément le compteur chapter, et ne produit +aucune entrée dans la table des matières, et n’affecte pas le haut de +page. (Si vous utilise le style de page headings dans un +document recto-version alors le haut de page sera dérivé du chapitre +précédent). Voici un exemple illustrant cela : + +\chapter*{Préambule} + +L’argument optionnel tdm-titre apparaît comme titre de chapitre +dans la tabvle des matières (see Table of contents etc.) et dans les +hauts de page (see Page styles). Si il n’est pas présent alors +titre sera à la place. L’exemple suivant montre le nom complet +dans le titre de chapitre, + +\chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)} + +mais seulement ‘Weyl’ sur la page de table des matières. L’exemple +suivant place un saut de ligne dans le titre, mais ceci ne fonctionne +pas bien avec les haut de page, alors il omet le saut dans la table des +matières + +\chapter[J'ai tout donné ; mon histoire]{J'ai tout donné\\ mon histoire} + +Pour déterminer quelles rubriques sont numérotées et lesquelles +apparaissent dans la table des matières, le numéro de niveau d’un +chapitre est 0 (see Sectioning/secnumdepth et +see Sectioning/tocdepth). + +paquetage indentfirst +indentfirst, paquetage + + +Lorsque chargez un paquetage d’internationalisation tel que +babel, mlp ou polyglossia, et que la langue +sélectionnée est le français, alors le premier paragraphe après le titre +est normalement renfoncé, comme c’est la convention en typographie +française. Par contre, si vous restez en langue par défaut, +c-à-d. en anglo-américain, + +le paragraphe qui suit le titre de chapitre n’est pas renfoncé, étant donné que c’est + +pour l’anglo-américain + +une pratique typographique standarde. Pour obtenir un renfoncement + +dans ce cas + +utilisez le paquetage indentfirst. + +Vous pouvez changer ce qui est affiché pour le numéro de chapitre. Pour +le changer en quelque-chose du genre de ‘Cours 1’, placez dans le +préambule soit \renewcommand{\chaptername}{Cours}, soit +cela (see \makeatletter & \makeatother) : + +\makeatletter +\renewcommand{\@chapapp}{Cours} +\makeatother + +paquetage babel +babel, paquetage + +Pour que cela soit fonction de la langue principale du document, voir le paquetage babel. + +Dans un document recto-verso &latex; commence les chapitres sur des +pages de numéro impair, en laissant si nécessaire une page de numéro +pair blanche à l’exception d’un éventuel haut de page. Pour que cette +page soit complètement blanche, voir \clearpage & +\cleardoublepage. + +paquetage titlesec +titlesec, paquetage + +Pour changer le comportement de la commande \chapter, vous pouvez +copier sa définition depuis le fichier de format &latex; et faire des +ajustements. Mais il y a aussi beaucoup de paquetage sur le CTAN qui +traitent de cela. L’un d’eux est titlesec. Voir sa +documentation, mais l’exemple ci-dessous donne un aperçu de ce qu’il +peut faire. + +\usepackage{titlesec} % dans le préambule +\titleformat{\chapter} + {\Huge\bfseries} % format du titre + {} % étiquette, tel que 1.2 pour une sous-section + {0pt} % longueur de séparation entre l'étiquette et le titre + {} % code crochet exécuté avant + +Ceci omet le numéro de chapitre ‘Chapitre 1’ de la page, mais +contrairement à \chapter* cela conserve le chapitre dans la table +des matière et dans les hauts de page. + + + + +<literal>\section</literal> + +\section +section + +Synopsis, l’un parmi : + +\section{titre} +\section*{titre} +\section[tdm-titre]{titre} + +Commence une section. Les classes &latex; standardes article, +book, et report ont toutes cette commande. + +L’exemple suivant produit une section : + +Dans cette partie nous nous intéressons plutôt à la fonction, au +comportement d'entrée-sortie, qu'aux détails de la réalisation de ce +comportement. + +\section{Machines de Turing} +En dépit de ce désir de rester évasif sur l'implémentation, nous suivons +l'approche d'A.~Turing selon laquelle la première étape pour définir +l'ensemble des fonctions calculables est de réflechir au détails de ce +que des mécanismes peuvent faire. + +Pour les classes standardes &latex; book et report la +sortie par défaut est du genre de ‘1.2 titre’ (pour +chapitre 1, section 2), seul sur sa ligne et fer à gauche, en caractères +gras et plus gros (la taille de police est \Large). La même +chose vaut pour article à ceci près qu’il n’y a pas de chapitre +dans cette classe, et donc cela ressemble à ‘2 titre’. + +La forme en * affiche titre. Mais elle n’affiche pas le +numéro de section, ni n’incrémente le compteur section, ne +produit aucune entrée dans la table des matière, et n’affecte pas le +haut de page. (Si vous utilisez le style de page headings dans +un document recto-verso, alors le titre de haut de page sera celui de la +rubrique précédente). + +L’argument optionnel tdm-titre apparaît comme titre de section +dans la table des matières (see Table of contents etc.) et dans les +titres de haut de page (see Page styles). S’il n’est pas présent +alors titre est à la place. L’exemple suivant montre le nom +complet dans le titre de la section, + +\section[Elisabeth~II]{Elisabeth deux, + Reine par la grâce de Dieu du Royaume Uni, + du Canada et de ses autres Royaumes et Territoires, + Chef du Commonwealth, Défenseur de la Foi.} + +mais seulement ‘Elisabeth II’ dans la table de matière et sur les +hauts de page. Dans l’exemple suivant il y a un saut de ligne dans +titre mais ça ne fonctionne pas pour la table des matières alors +il est omis de la table des matières et des titres de hauts de page. + +\section[La vérité c'est que j'ai menti ; histoire de ma vie]{La vérité +c'est que j'ai menti\\ histoire de ma vie} + +Pour déterminer quelles rubriques sont numérotées et lesquelles +apparaissent dans la table des matières, le numéro de niveau d’une +section est 1 (see Sectioning/secnumdepth et +see Sectioning/tocdepth). + +paquetage indentfirst +indentfirst, paquetage + + +Lorsque chargez un paquetage d’internationalisation tel que +babel, mlp ou polyglossia, et que la langue +sélectionnée est le français, alors le premier paragraphe après le titre +est normalement renfoncé, comme c’est la convention en typographie +française. Par contre, si vous restez en langue par défaut, +c-à-d. en anglo-américain, + +le paragraphe qui suit le titre de section n’est pas renfoncé, étant donné que c’est + +pour l’anglo-américain + +une pratique typographique standarde. Pour obtenir un renfoncement + +dans ce cas + +utilisez le paquetage indentfirst. + +paquetage titlesec +titlesec, paquetage + +En général, pour changer le comportement de la commande \section, +il y a diverses options. L’une d’elles et la commande +\@startsection (see \@startsection). Il y a aussi un grand +nombre de paquetages sur le CTAN traitant de cela, dont +titlesec. Voir sa +documentation, mais l’exemple ci-dessous donne un aperçu de ce qu’il +peut faire. + + +\usepackage{titlesec} % dans le préambule +\titleformat{\section} + {\normalfont\Large\bfseries} % format du titre + {\makebox[1pc][r]{\thesection\hspace{1pc}}} % étiquette + {0pt} % longueur de séparation entre l'étiquette et le titre + {} % code crochet exécuté avant +\titlespacing*{\section} + {-1pc}{18pt}{10pt}[10pc] + +Cela met le numéro de section dans la marge. + + + + +<literal>\subsection</literal> + +\subsection +subsection + +Synopsis, l’un parmi : + +\subsection{titre} +\subsection*{titre} +\subsection[tdm-titre]{titre} + +Commence une sous-section. Les classes &latex; standardes article, +book, et report ont toutes cette commande. + +L’exemple suivant produit une sous-section : + +Nous allons montrer qu'il y a plus de fonction que de machines de Turing +et donc que certaines fonctions n'ont pas de machine associée. + +\subsection{Cardinal} Nous allons commencer par deux paradoxes qui +mettent en scène le défi que pose à notre intuition la comparaison des +tailles d'ensembles infinis. + +Pour les classes &latex; standardes book et report la +sortie par défaut est du genre de ‘1.2.3 titre’ (pour +chapitre 1, section 2, sous-section 3), seul sur sa ligne et fer à +gauche, en caractère gras et un peu plus gros (la taille de police est +\large). La même chose vaut dans article à ceci près +qu’il n’y a pas de chapitre dans cette classe, alors cela ressemble à +‘2.3 titre’. + +La forme en * affiche titre. Mais elle n’affiche pas le +numéro de sous-section, ni n’incrémente le compteur subsection, +et ne produit aucune entrée dans la table des matières. + + +L’argument optionnel tdm-titre apparaît comme le titre de +sous-section dans la table des matières (see Table of contents +etc.). S’il n’est pas présent alors titre est à la place. +L’exemple suivant montre le texte complet dans le titre de sous-section, + +\subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of + Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow} + +mais seulement ‘03B1,03B2,03B3 +paper’ dans la table des matières. + +Pour déterminer quelles rubriques sont numérotées et lesquelles +apparaissent dans la table des matières, le numéro de niveau d’une +sous-section est 2 (see Sectioning/secnumdepth et +see Sectioning/tocdepth). + +paquetage indentfirst +indentfirst, paquetage + + +Lorsque chargez un paquetage d’internationalisation tel que +babel, mlp ou polyglossia, et que la langue +sélectionnée est le français, alors le premier paragraphe après le titre +est normalement renfoncé, comme c’est la convention en typographie +française. Par contre, si vous restez en langue par défaut, +c-à-d. en anglo-américain, + +le paragraphe qui suit le titre de sous-section n’est pas renfoncé, étant donné que c’est + +pour l’anglo-américain + +une pratique typographique standarde. Pour obtenir un renfoncement + +dans ce cas + +utilisez le paquetage indentfirst. + +paquetage titlesec +titlesec, paquetage + + +Il y a diverses façon de changer le comportement de la commande +\subsection. L’une d’elles et la commande \@startsection +(see \@startsection). Il y a aussi divers paquetages sur le CTAN +traitant de cela, dont titlesec. Voir sa documentation, mais +l’exemple ci-dessous donne un aperçu de ce qu’il peut faire. + +\usepackage{titlesec} % dans le préambule +\titleformat{\subsection}[runin] + {\normalfont\normalsize\bfseries} % format du titre + {\thesubsection} % étiquette + {0.6em} % espacement entre l'étiquette et le titre + {} % code crochet exécuté avant + +Cela place le numéro de sous-section et titre sur la première +ligne de texte. + + + + +<literal>\subsubsection</literal>, <literal>\paragraph</literal>, <literal>\subparagraph</literal> + +\subsubsection +subsubsection +\paragraph +paragraph +\subparagraph +subparagraph + +Synopsis, l’un parmi les suivant : + +\subsubsection{titre} +\subsubsection*{titre} +\subsubsection[titre-tdm]{titre} + +ou l’un parmi : + +\paragraph{titre} +\paragraph*{titre} +\paragraph[titre-tdm]{titre} + +ou l’un parmi : + +\subparagraph{titre} +\subparagraph*{titre} +\subparagraph[titre-tdm]{titre} + +Débute une rubrique de type sous-sous-section, paragraphe, ou +sous-paragraphe. Les classes &latex; standardes article, +book, et report disposent toutes de ces commandes, bien +que leur utilisation n’est pas courante. + +L’exemple suivant produit une sous-sous-section : + + +\subsubsection{Piston ring compressors: structural performance} +Provide exterior/interior wall cladding assemblies +capable of withstanding the effects of load and stresses from +consumer-grade gasoline engine piston rings. + +La sortie produite par défaut de chacune de ces trois commande est la +même pour les classes &latex; standarde article, book, et +report. Pour \subsubsection le titre est seul sur +sa ligne, en caractères gras avec la taille normale de police. Pour +\paragraph le titre est sur la même ligne que le texte qui +suit, sans renfoncement, en caractères gras avec la taille normale de +police. Pour \subparagraph le titre est sur la même ligne +que la texte qui suit, avec un renfoncement de paragraphe, en caractère +gras et avec la taille normale de police (comme les documents de classe +article n’ont pas de chapitre, leurs sous-sous-sections sont +numérotées et donc cela ressemble à ‘1.2.3 titre’, pour +section 1, sous-section 2, et sous-sous-section 3. Les deux autres +subdivisions ne sont pas numérotées). + +La forme en * affiche titre. Mais elle n’incrémente pas le +compteur associé et ne produit pas d’entrée dans la table des matières +(et le titre produit pas \subsubsection n’a pas de numéro). + +L’argument optionnel titre-tdm apparaît comme le titre de la +rubrique dans la table des matières (see Table of contents etc.). +S’il est omis, alors titre est utilisé à la place. + +Pour déterminer quelles rubriques sont numérotées et lesquelles +apparaissent dans la table des matières, le numéro de nuveau d’une +sous-sous-section est 3, celui d’un paragraphe est 4, et celui d’un +sous-paragraphe est 5 (see Sectioning/secnumdepth et +see Sectioning/tocdepth). + +paquetage indentfirst +indentfirst, paquetage + + +Lorsque chargez un paquetage d’internationalisation tel que +babel, mlp ou polyglossia, et que la langue +sélectionnée est le français, alors le premier paragraphe après le titre +est normalement renfoncé, comme c’est la convention en typographie +française. Par contre, si vous restez en langue par défaut, +c-à-d. en anglo-américain, + +le paragraphe qui suit le titre de chapitre n’est pas renfoncé, étant donné que c’est + +pour l’anglo-américain + +une pratique typographique standarde. Une façon d’obtenir un renfoncement + +dans ce cas + +est d’utiliser le paquetage indentfirst. + +paquetage titlesec +titlesec, paquetage + +Il y a de nombreuses manières de changer le comportement de ces +commandes. L’une est la commande \@startsection +(see \@startsection). Il y a aussi un grand nombre de paquetages +sur le CTAN traitant de cela, dont titlesec. Voir sa +documentation sur le CTAN. + + + + +<literal>\appendix</literal> + \appendix -annexe, création -La commande \appendix modifie la façon dont les unités -sectionnelles suivantes sont numérotées. La commande \appendix -elle-même ne génère aucun texte et n’affecte pas la numérotation des -parties. L’utilisation normale de cette commande est quelque chose comme -cela : - -\chapter{Un chapitre} -… +appendix +appendices + +Synopsis : + +\appendix + +Ne produit pas directement quelque chose en sortie. Mais dans un +document book ou report cela déclare que toute commande +\chapter qui suit commence une annexe. Pour les documents +article cela fait la même chose mais avec les commandes +\section. Remet également à zéro les compteurs chapter et +section dans un document book ou report, et dans un +article les compteurs section et subsection. + +Dans ce document de classe book : + +\chapter{Un} ... +\chapter{Deux} ... + ... \appendix -\chapter{La première annexe } +\chapter{Trois} ... +\chapter{Quatre} ... + +les deux premières commandes produisent en sortie ‘Chapitre 1’ and +‘Chapitre 2’. Après la commande \appendix la numérotation devient +‘Annexe A’ et ‘Annexe B’. See Larger book template +pour un autre exemple. + +paquetage appendix +appendix, paquetage + +Le paquetage appendix ajoute la commande \appendixpage +pour créer une page de titre de partie intitulée ‘Appendices’ dans +le corps du document avant la première annexe, ainsi que la +commande \addappheadtotoc pour créer l’entrée correspondante dans +la table des matières. On peut régler le nom ‘Appendices’ avec une +commande comme \renewcommand{\appendixname}{Annexes}, et il y +a plusieurs autres fonctions. Voir la documentation sur le CTAN. + + + +<literal>\frontmatter</literal>, <literal>\mainmatter</literal>, <literal>\backmatter</literal> + +\frontmatter +book, pièces préliminaires +livre, pièces préliminaires +\mainmatter +book, pièces principales +livre, pièces principales +\backmatter +book, pièces postliminaires +book, annexes +livre, pièces postliminaires +livre, annexes + +Synopsis, l’un parmi : + +\frontmatter +\mainmatter +\backmatter + +Formate un document de classe book différemment selon la partie +du document en cours de production. Les trois commandes sont toutes +optionnelles. + +Traditionnellement, les pièces préliminaires (\frontmatter) d’un +livre comprennent des choses telles que la page de titre, un abrégé, une +table des matières, une préface, une liste des notations, une liste des +figures et une liste des tableaux. (Certaines des pages des pièces +préliminaires, telles que la page de titres, traditionnellement ne sont +pas numérotée). Les pièces postliminaires (\backmatter) peuvent +contenir des choses telles qu’un glossaire, une bibliographie, et un +index. + +La déclaration \frontmatter rend les numéros de page en chiffres +romains bas de casse, et rend les chapitres non numérotés, bien que les +titres de chaque chapitre apparaissent dans la table des matières ; si +vous utilisez là aussi d’autres commandes de rubricage, alors utilisez +la version en * (see Sectioning). La commande +\mainmatter permet de revenir au comportement attendu, et +réinitialise le numéro de page. La commande \backmatter +n’affecte pas la numérotation des pages, mais commute de nouveau les +chapitres en mode sans numéros. See Larger book template pour un +exemple d’usage des trois commandes. + + + + +<literal>\@startsection</literal>, composer les rubriques. + +\@startsection +section, redéfinir + +Synopsis : + +\@startsection{nom}{niveau}{retrait}{avant}{après}{style} -secnumdepth counter -numéros de rubrique, composition -Le compteur secnumdepth contrôle la composition des numéros de -rubrique. le paramètre +Utilisé pour aider à redéfinir le comportement des commandes de +rubricage telles que \section ou \subsection. + +Notez que le paquetage titlesec rend la manipulation du rubricage +plus facile. De plus, bien que la plupart des exigences concernant les +commandes de rubricage peuvent être remplies avec +\@startsection, ce n’est pas le cas de certaines d’entre elles. Par exemple, +dans les classes &latex; standardes book et report, les +commandes \chapter et \report ne sont pas construites de +cette manière. Pour fabriquer une telle commande, il est possible +d’utiliser la commande \secdef. + + +Techniquement, cette commande a la forme suivante : +\@startsection{nom} + {niveau} + {retrait} + {avant} + {après} + {style}*[titretdm]{titre} +de sorte que faire : +\renewcommand{\section}{\@startsection{nom} + {niveau} + {retrait} + {avant} + {après} + {style}} +redéfinit \section en gardant sa forme standarde d’appel +\section*[titretdm]{titre} (dans laquelle on +rappelle que l’étoile * est optionnelle). +See Sectioning. Ceci implique que quand vous écrivez une commande +comme \renewcommand{\section}{...}, le +\@startsection{...} doit venir en dernier dans la définition. +Voir les exemples ci-dessous. + + +nom +Nom du compteur utilisé pour numéroter les titres de rubrique. Ce +compteur doit être défini séparément. Ceux qui sont utilisés le plus +communément sont section, subsection, ou +paragraph. Bien que dans ces cas-là le nom du compteur soit +identique à celui de la commande elle-même, utiliser le même nom n’est +pas obligatoire. + +Alors \thename affiche le numéro de titre, et +\namemark sert aux en-têtes de page. Voir le +troisième exemple plus bas. + +niveau +Entier donnant la profondeur de la commande de +rubricage. See Sectioning pour une liste des numéros standards de +niveaux. + +Si niveau est inférieur ou égal à la valeur du compteur +secnumdepth, alors les titres pour cette commande de rubricage +sont numérotés (see Sectioning/secnumdepth). Par exemple : dans un +article, si secnumdepth vaut 1, alors une commande +\section{Introduction} produira en sortie une chaîne du type +« 1 Introduction », alors que \subsection{Historique} +produira en sortie une chaîne sans numéro de préfixe : +« Historique ». + +Si niveau est inférieur ou égal à la valeur du compteur +tocdepth, alors la table des matières aura un article pour cette +rubrique. Par exemple, dans un article, si tocdepth vaut +1, la table des matières listera les sections, mais pas les +subsections. + +retrait + +Une longueur donnant le renfoncement de toutes les lignes du titre par +rapport à la marge de gauche. Pour un renfoncement nul, utilisez 0pt. + + + +Une valeur négative telle que -1em cause un débord du titre dans +la marge de gauche. + +avant +Longueur dont la valeur absolue est la longueur de l’espace vertical +inséré avant le titre de la rubrique. Cet espacement est ignoré si la +rubrique commence au début d’une page. Si ce nombre est négatif, alors +le premier paragraphe suivant le titre n’est pas renfoncé, s’il est +positif ou nul il l’est. (Notez que l’opposé de 1pt plus 2pt minus +3pt est -1pt plus -2pt minus -3pt). + +Par exemple si avant vaut -3.5ex plus -1ex minus -0.2ex +alors pour commencer la nouvelle rubrique, &latex; ajoute environ 3,5 +fois la hauteur d’une lettre x en espace vertical, et le premier +paragraphe de la rubrique n’est pas renfoncé. Utiliser une longueur +élastique, c.-à-d. comprenant plus et minus, est une +bonne pratique ici car cela donne à &latex; plus de latitude lors de la +fabrication de la page (see Lengths). + +La quantité totale d’espace vertical entre la ligne de base de la ligne +précédant cette rubrique et la ligne de base du titre de la rubrique est +la somme du \parskip dans la police du corps de texte, du +\baselineskip de la police du titre, et de la valeur absolue de +l’argument avant. Cet espace est typiquement élastique de sorte à +pouvoir se dilater ou se contracter. (Si la rubrique commence en début +d’une page de sorte que cet espace soit ignoré, alors la ligne de base +du titre correspond à la ligne de base qu’aurait la première ligne de +texte sur cette page si celle-ci commençait par du texte). + +après +Longueur. Lorsque après est positif ou nul, il s’agit de l’espace +vertical à insérer après le titre de la rubrique. Lorsque elle est +négative, alors le titre fait corps avec le paragraphe le suivant +immédiatement. Dans ce cas la valeur absolue de la longueur donne +l’espace horizontal entre la fin du titre et le début du paragraphe +suivant. (Notez que l’opposé de 1pt plus 2pt minus 3pt est +-1pt plus -2pt minus -3pt). + +Comme c’est le cas avec avant, utiliser une longueur élastique +avec des composantes plus et minus est une bonne pratique +ici puisque elle donne à &latex; plus de latitude pour assembler la +page. + +Si après est positif ou nul, la quantité totale d’espace vertical +entre la ligne de base du titre de la rubrique et la ligne de base de la +première ligne du paragraphe suivant est la somme du \parskip de +la police du titre, de \baselineskip de la police du corps de +texte, et de la valeur de après. Cet espace est typiquement +élastique de sorte qu’il puisse se dilater ou se contracter. (Notez que, +du fait que le signe d’après contrôle que le titre soit +indépendant du texte qui le suit ou faisant corps avec lui, vous ne +pouvez pas utiliser un après négatif pour annuler une partie du +\parskip). -\setcounter{secnumdepth}{niveau} +style +Contrôle le style du titre : voir les exemples plus bas. Les commandes +typiquement utilisées ici sont \centering, \raggedright, +\normalfont, \hrule, ou \newpage. La dernière +commande au sein de style peut être une commande prenant un +argument, telle que \MakeUppercase ou \fbox. Le titre de +la rubrique est passé en argument à cette commande. Par exemple régler +style à \bfseries\MakeUppercase a pour effet de produire +des titres gras et en capitales. + +Voici les réglages par défaut de &latex; pour les trois premiers +niveaux de rubricage qui sont définis par \@startsection, pour +les classes article, book, et report. +Pour section, le niveau vaut 1, le retrait vaut 0pt, +le avant vaut -3.5ex plus -1ex minus -0.2ex, le après +vaut 2.3ex plus 0.2ex, et le style vaut +\normalfont\Large\bfseries. +Pour subsection, le niveau +vaut 2, le retrait vaut 0pt, le avant vaut +-3.25ex plus -1ex minus -0.2ex, le après vaut 1.5ex +plus 0.2ex, et le style vaut \normalfont\large\bfseries. +Pour subsubsection, le niveau vaut 3, le retrait vaut +0pt, le avant vaut -3.25ex plus -1ex minus -0.2ex, le +après vaut 1.5ex plus 0.2ex, et le style vaut +\normalfont\normalsize\bfseries. + + +Voici des exemples. Pour les utiliser, mettez-les soit au sein d’un +fichier de paquetage ou de classe, soit dans le préambule d’un document +&latex;. Si vous les mettez dans le préambule, elle doivent être entre +une commande \makeatletter et une commande \makeatother. +(Le message d’erreur You can't use `\spacefactor' in vertical +mode. est le plus probable lorsque on oublie de faire +cela). See \makeatletter & \makeatother. + +L’exemple ci-dessous centre les titres de section et les met en gros +caractères gras. Il le fait avec \renewcommand parce que les +classes standardes de &latex; ont déjà une commande \section de +définie. Pour la même raison il ne définit ni un compteur +section, ni les commandes \thesection et +\l@section. + +\renewcommand\section{% + \@startsection{section}% nom. + {1}% niveau. + {0pt}% retrait. + {-3.5ex plus -1ex minus -.2ex}% avant. + {2.3ex plus.2ex}% après. + {\centering\normalfont\Large\bfseries}}% style. + + +L’exemple ci-dessous met les titres de subsection en petites +capitales, et leur fait faire corps avec le paragraphe suivant. + +\renewcommand\subsection{% + \@startsection{subsection}% nom. + {2}% niveau. + {0em}% retrait. + {-1ex plus 0.1ex minus -0.05ex}% avant. + {-1em plus 0.2em}% après. + {\scshape}% style. + } -supprime le numéros de rubrique à n’importe quelle profondeur > niveau, où -chapter est le niveau zéro. (Voir \setcounter.) + +Les exemples précédents redéfinissaient les commandes de titre de +rubriques existantes. L’exemple suivant définit une nouvelle commande, +illustrant la nécessité d’un compteur et de macros pour son affichage. + +\setcounter{secnumdepth}{6}% affiche les compteurs justqu'à ce niveau +\newcounter{subsubparagraph}[subparagraph]% compteur pour la + % numérotation +\renewcommand{\thesubsubparagraph}% + {\thesubparagraph.\@arabic\c@subsubparagraph}% comment afficher + % la numérotation +\newcommand{\subsubparagraph}{\@startsection + {subsubparagraph}% + {6}% + {0em}% + {\baselineskip}% + {0.5\baselineskip}% + {\normalfont\normalsize}} +\newcommand*\l@subsubparagraph% + {\@dottedtocline{6}{10em}{5em}}% pour la table des matières +\newcommand{\subsubparagraphmark}[1]{}% pour les en-têtes de page + + -Des références croisées -références croisées +Des renvois +renvois Une des raisons pour numéroter des choses telles que les figures ou les équations est d’indiquer au lecteur une référence vers elles, comme dans « Voir la figure 3 pour plus de détails. » étiquette -Inclure le numéro de figure dans le code source est une mauvaise -pratique puisque ce si ce noméro change avec l’évolution du document, -alors on doit penser à mettre à jour cet référence manuellement. Au lieu -de cela, &latex; vous fait écrire une étiquette du genre -\label{eq:ThmGreens} et lui faire référence avec Voir -l'équation~\ref{eq:ThmGreens}. - -&latex; écrit l’information provenant des étiquettes dans un fichier -avec le même nom que le fichier conteant le \label{...} mais -avec une extension .aux. (L’information a le format -\newlabel{étiquette}{{étiquette-courante}{numéro-de-page}} -où étiquette-courante est la valeur de la macro -\@currentlabel qui est d’ordinaire mise à jour à chaque vous que -that is vous appelez \refstepcounter{compteur}.) +Souvent on désire écrire quelque chose du genre de ‘Voir +théorème~31’. Mais Inclure manuellement le numéro est une mauvaise +pratique. Au lieu de cela, il vaut mieux écrire une étiquette du +genre \label{eq:ThmGreens} puis lui faire référence avec +Voir l'équation~\ref{eq:ThmGreens}. &latex; se charge de +déterminer automatiquement le numéro, de le produire en sortie, et de le +changer par la suite si besoin est. + +Cela apparaîtra avec le théorème~\ref{th:ThmGreens}. % référence déclarée en aval +... +\begin{theorem} \label{th:ThmGreens} + ... +\end{theorem} +... +Voir le théorème~\ref{th:ThmGreens} page~\pageref{th:ThmGreens}. + + +&latex; garde trace de l’information de renvoi dans un +fichier avec le même nom de base que le fichier contenant le +\label{...} mais avec une extension .aux. Ainsi si +\label est dans calcul.tex alors cette information est +dans calcul.aux. &latex; met cette information dans ce fichier à +chaque fois qu’il rencontre un \label. + référence déclarée en aval aval, référence déclarée en déclaration en aval de référence L’effet secondaire le plus courant du paragraphe précédent se produit lorsque votre document a une référence déclarée en aval, c.-à-d. -un \ref{clef} qui apparaît avant le -\label{clef} associé ; voir l’exemple dans la description -de \pageref{...}. &latex; obtient les référence à partir du -fichier .aux. Si c’est la première fois que vous compilez le -document alors vous obtiendrez un message LaTeX Warning: Label(s) -may have changed. Rerun to get cross references right. et dans la -sortie la référence apparaîtra comme deux points -d’interrogration ‘??’ en caractères gras. Ou, si vous modifiez le -document de telle façon que les références changent alors vous -obtiendrez le même avertissement et la sortie contiendra l’information -de référence de la fois précédente. La solution dans les deux cas est -juste de re-compiler le document encore une fois. +un \ref qui apparaît avant le \label associé. Si c’est la +première fois que vous compilez le document alors vous obtiendrez un +message LaTeX Warning: Label(s) may have changed. Rerun to get +cross references right. et dans la sortie la référence apparaîtra comme +deux points d’interrogration ‘??’ en caractères gras. Ou, si vous +modifiez le document de telle façon que les références changent alors +vous obtiendrez le même avertissement et la sortie contiendra +l’information de référence de la fois précédente. La solution dans les +deux cas est juste de re-compiler le document encore une fois. +paquetage cleveref +cleveref, paquetage + + +Le paquetage cleveref élargit les possibilités de faire des +renvois de &latex;. Vous pouvez faire en sorte que si vous saisissez +\begin{thm}\label{th:Nerode}...\end{thm} alors +\cref{th:Nerode} produit en sortie ‘théorème 3.21’, sans +que vous ayez à saisir le mot « théorème ». + + @@ -2465,7 +3313,7 @@ de la rubrique courante. Au sein d’un environnement numéroté, tel que l’environnement table ou theorem, \label{clef} attribue le numéro de cet environnement à clef. On retire le numéro attribué avec la commande -\ref{clef} (voir \ref). +\ref{clef} (see \ref). Le nom clef peut se composer de n’importe quelle séquence de lettres, chiffres, ou caractères de ponctuation ordinaires. Il est @@ -2510,8 +3358,8 @@ Voir Figure~\ref{fig:test}. <literal>\pageref{<replaceable>clef</replaceable>}</literal> \pageref -référence croisée avec numéro de page -numéro de page, référence croisée +renvoi avec numéro de page +numéro de page, renvoi Synopsis : @@ -2536,18 +3384,18 @@ page~\pageref{eq:principale}. <literal>\ref{<replaceable>clef</replaceable>}</literal> \ref -référence croisée, symbolique -numéro de rubrique, référence croisée -numéro d’équation, référence croisée -numéro de figure, référence croisée -numéro de note en bas de page, référence croisée +renvoi, symbolique +numéro de rubrique, renvoi +numéro d’équation, renvoi +numéro de figure, renvoi +numéro de note en bas de page, renvoi Synopsis : \ref{clef} Produit le numéro de la rubrique, équation, note en bas de page, figure, -…, de la commande correspondante \label (voir \label). +…, de la commande correspondante \label (see \label). Elle ne produit aucun texte, tel que le mot ‘Section’ ou ‘Figure’, juste le numéro lui-même sans plus. @@ -2572,7 +3420,7 @@ que ceci est une référence déclarée en aval puisque elle est faite avant \begin \end -&latex; fournit beacoup d’environnements pour baliser un certain texte. +&latex; fournit beaucoup d’environnements pour baliser un certain texte. Chaque environnement commence et se termine de la même manière : \begin{nomenv} @@ -2586,6 +3434,7 @@ Chaque environnement commence et se termine de la même manière : environnement abstract abstract, environnement + résumé Synopsis : @@ -2595,12 +3444,12 @@ Chaque environnement commence et se termine de la même manière : Produit un résumé, potentiellement contenant plusieurs paragraphes. Cet environnement n’est défini que dans les classes de document -article et report (voir Document classes). +article et report (see Document classes). Utiliser l’exemple ci-dessous au sein de la classe article produit un paragraphe détaché. L’option titlepage de la classe de document a pour effet que le résumé soit sur une page séparée -(voir Document class options) ; ceci est le comportement par défaut +(see Document class options) ; ceci est le comportement par défaut selement dans la classe report. \begin{abstract} @@ -2641,6 +3490,7 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage <literal>array</literal> environnement array array, environnement + tableaux mathématiques Synopsis : @@ -2659,9 +3509,9 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage Les tableaux mathématiques sont produits avec l’environnement array, normalement au sein d’un environnement equation -(voir equation). Les entrées dans chaque colonne sont séparées avec +(see equation). Les entrées dans chaque colonne sont séparées avec une esperluette (&). Les lignes sont terminées par une double -contr’oblique (voir \\). +contr’oblique (see \\). L’argument obligatoire patron décrit le nombre de colonnes, l’alignement en leur sein, et le formatage des régions @@ -2684,6 +3534,7 @@ colonnes. La valeur par défaut est ‘5pt’. paquetage amsmath amsmath, paquetage + Pour otenir des tableaux entre accolades la méthode standarde est d’utiliser le paquetage amsmath. Il comprend les environnements pmatrix pour un tableau entre parenthèses (...), @@ -2760,6 +3611,7 @@ preambule : environnement center center, environnement + centrer du texte, environnement pour Synopsis : @@ -2813,44 +3665,71 @@ second line \\ environnement description description, environnement + lists étiquetée, créer listes de description, créer Synopsis : \begin{description} -\item [étiquette1] article1 -\item [étiquette2] article2 +\item [étiquette du 1er article] texte du 1er article +\item [étiquette du 2e article] texte du 2e article ... \end{description} \item L’environnement description est utilisé pour fabriquer des listes d’articles étiquetés. Chaque étiquette d’article est composée en -gras, alignée à gauche. Bien que les étiquettes sur les articles sont -optionnelles il n’y a pas de valeur par défaut sensée, c’est pourquoi -tous les articles devraient avoir une étiquette. +gras, alignée à gauche de sorte que les étiquettes longues continuent +sur la première lgne du texte de l’article. Il doit y avoir au moins un +article ; sans cela provoque l’erreur &latex; ‘Something's +wrong--perhaps a missing \item’. + +Cet exemple montre l’environnement utilisé pour une séquence de +définitions. Les étiquettes ‘lama’ et ‘llama’ ressortent en +gras avec leur bords gauches alignés sur la marge de gauche. +\begin{definition} + \item[lama] Un prêtre. + \item[lame] Une pièce coupante. + \item -La liste consiste en au moins un article ; voir \item (l’absence -d’article cause l’erreur &latex; ‘Something's wrong--perhaps a -missing \item’). Chaque article est produit avec une commande -\item. +Faites démarrer la liste d’articles avec la commande \item +(see \item). Utilisez l’étiquette optionnelle, comme dans +\item[Point principal], en effet il n’y a pas de valeur par +défaut sensée. Après le \item se trouve du texte optionnel +pouvant contenir plusieurs paragraphes. - - +gras machine à écrire, éviter gras tapuscrit, éviter +étiquette machine à écrire dans les listes étiquette tapuscrite dans les listes -Une autre variation : puisque le style gras est appliqué aux étiquettes, -si vous composez une étiquette en style tapuscrit avec \texttt, -vous obtiendrez du gras tapuscrit : \item[\texttt{gras et -tapuscrit}]. C’est peut-être trop gras, entre autres problèmes. Pour -obtenir juste le style tapuscrit, utilisez \tt, ce qui -reinitialise toutes les autres variations de style : \item[{\tt -tapuscrit de base}]. +Comme les étiquettes sont en gras, si le texte de l’étiquette appelle un +changement de police effectué dans la forme à argument (voir styles des polices) alors il ressortira en gras. Par exemple, +si le texte de l’étiquette est en police machine à écrire comme dans +\item[\texttt{texte étiquette}] alors il apparaîtra en +tapuscrit gras, si cela est disponible. La méthode la plus simple pour +obtenir la police tapuscrit non grasse est d’utiliser la forme +déclarative : \item[{\tt texte étiquette}]. De la même façon, +obtenez la police romaine standarde avec \item[{\rm texte +étiquette}]. -Pour les détails concernant l’espacement des listes, voir itemize. +En ce qui concerne les autres principaux environnements de liste à +étiquettes de &latex;, voir itemize et enumerate. +Contrairement à ces environnements, imbriquer les environnement +description ne change pas l’étiquette par défaut ; elle est en +gras et alignée à gauche à tous les niveaux. +Pour plus d’information sur les paramètres de disposition de liste, y +compris les valeurs par défaut, et sur la personnalisation de la +disposition de liste, voir list. Le paquetage enumitem est +utile pour personnaliser les listes. + +Cet exemple met les étiquettes de description en petites capitales. + +\renewcommand{\descriptionlabel}[1]{% + {\hspace{\labelsep}\textsc{#1}}} + @@ -2860,6 +3739,7 @@ tapuscrit de base}]. environnement displaymath displaymath, environnement + Synopsis : \begin{displaymath} @@ -2873,29 +3753,35 @@ justifie les équations à gauche ; voir Aucun numéro d’équation n’est ajouté au texte de texte displaymath ; pour obtenir un numéro d’équation, vous pouvez -utiliser l’environnement equation (voir equation). +utiliser l’environnement equation (see equation). &latex; ne fait pas de saut de ligne au sein de des maths. paquetage amsmath amsmath, paquetage + Notez que le paquetage amsmath comprend des possibilités beaucoup plus vastes en matière d’affichage d’équations. Par exemple, il offre plusieurs altenatives pour effectuer des sauts de lignes au sein de texte en mode mathématique. -La construction \[des maths\] est essentiellement un -synonyme de \begin{displaymath}des +\[...\] displaymath +La construction \[des maths\] est un synonyme de +l’environnement \begin{displaymath}des maths\end{displaymath}, mais ce dernier est plus pratique à -manipuler dans le code source ; par exemple la recherche d’un caractère -crochet ] peut donner des faux positifs, alors qu’il est plus -probable que le mot displaymath soit unique. (La construction -$$des maths$$ tirée du language &tex; de base est souvent -utilisée à tort comme un synonyme de displaymath. Ce n’en est -pas un, parce que l’environnement displaymath vérifie qu’il ne -commence pas en mode mathérmatique, parce qu’il gère l’espacement -verticial environment différemment, et parce qu’il honore l’option -fleqn.) +manipuler dans le fichier source ; par exemple la recherche d’un +caractère crochet ] peut donner des faux positifs, alors qu’il +est plus probable que le mot displaymath soit unique. + + +$$...$$ displaymath, forme approchée en &tex; de base +(Digression : la construction $$des maths$$ tirée du +language &tex; de base est souvent utilisée à tort comme un synonyme +de displaymath. Elle n’en est pas un, et n’est pas du tout +officiellement prise en charge par &latex; ; $$ ne prend pas en +charge fleqn (see Document class options), gère l’espacement +verticial environment différemment, et n’effectue pas de vérification de +cohérence). Le texte composé par cet exemple est centré et seul sur sa ligne. \begin{displaymath} @@ -2911,8 +3797,9 @@ ligne \( \int_1^2 x^2\,dx=7/3 \) produit. environnement document document, environnement + L’environnement document entoure le corps entier d’un document. -Il est obligatoire dans tout document &latex;. Voir Starting and +Il est obligatoire dans tout document &latex;. See Starting and ending. @@ -2961,6 +3848,7 @@ successives sont exécutée dans l’ordre de passage à la commande. environnement enumerate enumerate, environnement + lists of items, numbered Synopsis : @@ -2991,8 +3879,8 @@ marathon olympique de 1908 : Les énumerations peuvent être imbriquées les unes dans les autres, jusqu’à une profondeur de quatre niveaux. Elles peuvent aussi être imbriquées au sein d’autres environnements fabriquant des paragraphes, -tels que itemize (voir itemize) et description -(voir description). +tels que itemize (see itemize) et description +(see description). Le format de l’étiquette produite dépend du niveau d’imbrication de la liste. Voici les valeurs par défaut de &latex; pour le format à chaque niveau d’imbrication (où 1 est le niveau le plus externe) : @@ -3008,9 +3896,9 @@ niveau d’imbrication (où 1 est le niveau le plus externe) : \enumiii \enumiv L’environnement enumerate utilise les compteurs \enumi, -…, \enumiv (voir Counters). Si vous utilisez l’argument +…, \enumiv (see Counters). Si vous utilisez l’argument optionnel d’\item alors le compteur n’est pas incrementé pour cet -article (voir \item). +article (see \item). \labelenumi \labelenumii @@ -3019,7 +3907,7 @@ article (voir \item). L’environnement enumerate utilise les commandes de \labelenumi jusqu’à \labelenumiv pour produire l’étiquette par défaut. Ainsi, vous pouvez utiliser \renewcommand pour -chancher le format des étiquettes (voir \newcommand & +chancher le format des étiquettes (see \newcommand & \renewcommand). Par exemple, cette liste de premier niveau va être étiquettée avec des lettres capitales, en gras, non suivies point : @@ -3047,6 +3935,7 @@ cela. environnement eqnarray eqnarray, environnement + équations, aligner aligner des équations @@ -3098,6 +3987,7 @@ et le justifie à gauche dans une boîte de largeur nulle. environnement equation equation, environnement + équations, environnement pour formules, environnement pour @@ -3108,7 +3998,7 @@ et le justifie à gauche dans une boîte de largeur nulle. \end{equation} L’environnement equation commence un environnement en -displaymath (voir displaymath), par ex. en centrant le texte +displaymath (see displaymath), par ex. en centrant le texte math sur la page, et aussi en plaçant un numéro d’équation dans la marge de droite. @@ -3118,6 +4008,7 @@ marge de droite. <literal>figure</literal> environnement figure figure, environnement + inserer des figures figures, insertion @@ -3135,9 +4026,9 @@ marge de droite. corpsfigure \caption[titreldf]{texte} \label{étiquette} -\end{figure} +\end{figure*} -Une classe de flottant (voir Floats). Parce qu’elles ne peuvent pas +Une classe de flottant (see Floats). Parce qu’elles ne peuvent pas être coupées à cheval sur plusieurs pages, elles ne sont pas composées en séquence avec le texte normal, mais au contraire sont “flottées” vers un endroit convenable, tel que le sommet d’une page suivante. @@ -3146,7 +4037,7 @@ vers un endroit convenable, tel que le sommet d’une page suivante. l’algorithme de placement des flottants, voir Floats. La version étoilée figure* est utilisée quand un document est en -mode double-colonne (voir \twocolumn). elle produit une figure qui +mode double-colonne (see \twocolumn). elle produit une figure qui s’étend sur les deux colonnes, au sommet de la page. Pour ajouter la possibiltié de la placer à un bas de page voir la discussion de placement b dans Floats. @@ -3156,12 +4047,12 @@ possibiltié de la placer à un bas de page voir la discussion de etc. L’étiquette est optionnelle ; elle est utilisée pour les double renvois -(voir Cross references). +(see Cross references). \caption La commande \caption spécifie la légende texte pour la figure. La légende est numérotée par défaut. Si titreldf est présent, il est utilisé dans la liste des figures au lieu de texte -(voir Tables of contents). +(see Table of contents etc.). Cet exemple fabrique une figure à partir d’un graphique. Il nécessite l’un des paquetage graphics ou graphicx. Le graphique, @@ -3180,42 +4071,68 @@ fin du document, sur une page de flottants. <literal>filecontents</literal>: Écrire un fichier externe environnement filecontents filecontents, environnement + environnement filecontents* filecontents*, environnement + fichier externe, écrire écrire un fichier externe Synopsis : -\begin{filecontents}{nomfichier} +\begin{filecontents}[option]{nomfichier} texte \end{filecontents} ou -\begin{filecontents*}{nomfichier} +\begin{filecontents*}[option]{nomfichier} texte \end{filecontents*} -Crée un fichier nommé nomfichier et le remplit de texte. La -version non étoilée de l’environnement filecontent préfixe le -contenu du ficher crée d’une en-tête ; voir l’exemple ci-dessous. La -version étoilée filecontent* n’inclut par l’en-tête. - -Cet environnement peut être utilisé n’importe-où dans le préambule, bien -qu’elle apparaisse en général avant la commande -\documentclass. Elle est typiquement utilisée quand une fichier -source a besoin d’un fichier non standard de style ou de -classe. L’environnement permet d’écrire ce fichier dans le répertoire -contenant ce fichier et ainsi de rendre le code source autonome. Une -autre utilisation est d’inclure des référence au format bib dans -le fichier source, de même pour le rendre autonome. - -L’environnement vérifie si un fichier de même nom existe déjà, et si -oui, ne fait rien. Il y a un paquetage filecontents qui redéfinit -l’environnement filecontents de sorte qu’au lieu de ne rien faire -dans ce cas, il écrase le fichier existant. +Crée un fichier nommé nomfichier dans le répertoire courant (ou +dans le répertoire de sortie s’il a été spécifié ; see output +directory) et y écrit texte. Par défaut un fichier déjà existant +n’est pas écrasé. + +La version non étoilée de l’environnement filecontent préfixe le +contenu du ficher créé d’une en-tête de commentaires &tex; ; voir +l’exemple ci-dessous. La version étoilée filecontent* n’inclut +par l’en-tête. + +Les options possibles sont : + +force +overwrite +force, option de filecontents +overwrite, option de filecontents +Écrase le fichier s’il existe. + +noheader +noheader, option de filecontents +Omet l’en-tête. Équivalent à utiliser filecontents*. + +nosearch +nosearch, option de filecontents +Vérifie uniquement si un fichier existe dans le répertoire courant (et +le répertoire de sortie, s’il a été spécifié), non dans le chemin +complet de recherche. + + +Ces options ont été ajoutées à la parution 2019 de &latex;. + +sources autonomes +fichiers source, rendre autonomes +Cet environnement peut être utilisé n’importe où dans le préambule, bien +qu’il apparaisse souvent avant la commande \documentclass. Elle +est classiquement utilisée pour créer un fichier .bib ou d’autre +fichier de données similaire à partir du document source principale, de +sorte à rendre le fichier source autonome. De même, il peut être utilisé +pour créer un fichier personnalisé de style ou de classe, rendant ainsi +encore le source autonome. + + Par exemple, ce document : \documentclass{article} @@ -3227,7 +4144,7 @@ dans ce cas, il écrase le fichier existant. Un article de \monnom. \end{document} -produit ce fichier JH.sty. +produit ce fichier JH.sty : %% LaTeX2e file `JH.sty' %% generated by the `filecontents' environment @@ -3241,6 +4158,7 @@ Un article de \monnom. <literal>flushleft</literal> environnement flushleft flushleft, environnement + jsutifier à gauche du texte, environnement pour texte fer à gauche, environnement pour texte ferré à gauche, environnement pour @@ -3289,6 +4207,7 @@ l’unité de paragraphe. <literal>flushright</literal> environnement flushright flushright, environnement + texte drapeau gauche, environnement pour justifier à droite, environnement pour @@ -3332,6 +4251,7 @@ termine l’unité de paragraphe. <literal>itemize</literal> environnement itemize itemize, environnement + \item listes d’articles listes non ordonnées @@ -3349,7 +4269,7 @@ termine l’unité de paragraphe. puces ». Les environnement itemize peuvent être imbriqués l’un dans l’autre, jusqu’à quatre niveaux de profondeur. Ils peuvent aussi être imbriqués avec d’autre environnements fabriquant des paragraphes, -comme enumerate (voir enumerate). +comme enumerate (see enumerate). Chaque article d’une liste itemize commence avec une commande \item. Il doit y avoir au moins une commande \item au @@ -3387,19 +4307,30 @@ utilise des losanges : \leftmarginiv \leftmarginv \leftmarginvi - -Les paramètres de \leftmargini jusqu’à \leftmarginvi +Les paramètres de \leftmargini jusqu’à \leftmarginvi définissent la distance entre la marge de gauche de l’environnement -surjacent et la marge de gauche de la liste. Par convention, -\leftmargin est réglée à la \leftmarginN appropriée -quand on entre dans un nouveau niveau d’imbrication. +surjacent et la marge de gauche de la liste. (Notez la convention de +nommage de la commande avec un nombre romain en bas de casse à la fin +pour désigner le niveau d’imbrication). Les valeurs par défaut sont : +2.5em pour le niveau 1 (2em en mode deux-colonnes), +2.2em pour le niveau 2, 1.87em pour le niveau 3 et +1.7em pour le niveau 4, avec des valeurs plus petites pour les +niveaux plus profondément imbriqués. + +paquetage enumitem +enumitem, paquetage + +Pour les autres environnements majeurs de listes à étiquettes de +&latex;, voir description et enumerate. Pour des +informations concernant les paramètres de contrôle de la disposition des +listes, y compris les valeurs par défaut, ainsi que la personalisaton de +la disposition, voir list. La paquetage enumitem est utile +pour personaliser les listes. -Les valeurs par défaut varient de ‘.5em’ (pour les niveaux -d’imbrication les plus élevés) jusqu’à ‘2.5em’ (premier niveau), et -sont légèrement réduits en mode deux-colonnes. Cet exemple réduit -grandement l’espace de marge pour la liste la plus extérieure : +Dans cet exemple on réduit grandement l’espace de marge pour la liste à +puces la plus externe~: -\setlength{\leftmargini}{1.25em} % par défaut 2.5em +\setlength{\leftmargini}{1.25em} % valeur par défaut 2.5em Quelques paramètres qui affectent le formatage des listes : @@ -3463,7 +4394,7 @@ désirable d’élider l’espace entre les articles. Voici un exemple définissant un environnement itemize* sans espacement supplémentaire entre les articles, ni entre les paragraphes au sein d’un seul article (\parskip n’est pas spécifique aux listes, -voir \parskip): +see \parindent & \parskip): \newenvironment{itemize*}% {\begin{itemize}% @@ -3479,7 +4410,8 @@ voir \parskip): environnement letter letter, environnement -Cet environnement est utilisé pour créer des lettres. Voir Letters. + +Cet environnement est utilisé pour créer des lettres. See Letters. @@ -3487,35 +4419,333 @@ voir \parskip): <literal>list</literal> environnement list list, environnement + listes d’articles, générique -L’environnement list est un environnement générique qui est -utilisé pour définir beaucoup des environnements plus spécifiques. Il -est rarement utilisé dans des documents, mais souvant dans des macros. +Synopsis : -\begin{list}{étiquettage}{espacement} -\item item1 -\item item2 +\begin{list}{étiquetage}{espacement} +\item[étiquette optionnelle du premier article] texte du premier article +\item[étiquette optionnelle du deuxième article] texte du deuxième aticle ... \end{list} -L’argument obligatoire étiquettage spécifie comment les articles -doivent être étiquetés (à moins que son argument optionnel soit fourni à -\item). Cet argument est un morceau de texte qui est inséré dans -une boîte pour former l’étiquette. Il peut contenir, et d’habitude c’est -le cas, d’autres commandes &latex;. +L’environnement list est un environnement générique qui est +utilisé pour construire des listes plus spécialisées. On l’utilise la +plupart du temps pour créer des listes via les environnements +description, enumerate, et itemize +(see description, enumerate, et itemize). Par ailleurs, +beaucoup d’environnements standards de &latex; qui visuellement ne sont +pas des listes sont construits en utilisant list, ceci comprend +quotation, quote, center, verbatim, et bien +d’autres (see quotation & quote, see center, +see flushright). + +Ici, on décrit l’environnement list en définissant un +nouvel environnement personnalisé. + +\newcounter{compteurlistenommage} % numérotes les articles +\newenvironment{nommage} + {\begin{list} + {Article~\Roman{compteurlistenommage}.} % argument d'étiquetage + {\usecounter{compteurlistenommage} % argument d'espacement + \setlength{\leftmargin}{3.5em}} % ...suite argument d'espacement + } + {\end{list}} + +\begin{nommage} + \item Apparaît comme « Article~I. » + \item[Étiquette spéciale.] Apparaît comme « Étiquette spéciale. » + \item Apparaît comme « Article~II. » +\end{nommage} + +L’argument obligatoire étiquetage, qui est le premier argument de +l’environnement list, spécifie comment les articles doivent être +étiquetés par défaut. Il peut contenir du texte et des commandes +&latex;, comme dans l’exemple précédent où il contient à la fois +‘Article’ et ‘\Roman{…}’. &latex; forme l’étiquette +en mettant l’argument étiquetage dans une boîte de largeur +\labeidth. Si l’étiquette est plus large que cela, le matériel +supplémentaire s’étend sur la droite. Lorsque vous fabriquez une +instance de list vous pouvez l’emporter sur l’étiquetage par +défaut en donnant à \item un argument optionnel avec des crochets +et le texte, comme dans l’exemple précédent \item[Étiquette +spéciale.] ; see \item. + +Le second argument obligatoire espacement prend une liste de +commandes. L’une de celle qu’on y retrouve est +\usecounter{nomcompteur} (see \usecounter). Utilisez +la pour dire à &latex; de numéroter les article en utilisant le +compteur fourni. Ce compteur est remis à zéro chaque fois que &latex; +entre dans l’environnement, et le compteiur est incrémenté par un chaque +fois que &latex; rencontre une commande \item. + +\makelabel +Une autre commande qu’on retrouve dans espacement est +\makelabel, pour construire la boîte de l’étiquette. Par défaut +elle positionne le contenu fer à droite. Elle prend un argument, +l’étiquette. Elle compose sont contenu en mode LR. Un exemple de +changement de sa définition consiste dans l’exemple précédent +nommage à ajouter avant la définition de l’environnement +\newcommand{\namedmakelabel}[1]{\textsc{#1}}, et entre la +commande \setlength et la parenthèse cloturant l’argument +espacmeent à ajouter aussi \let\makelabel\namedmakelabel. +Ceci composera les étiquette en petites capitales. De même, en +remplaçant cette seconde ligne de code par \let\makelabel\fbox on +met les étiquettes dans une boîte encadrée. Ci-après voici un autre +exemple de la commande \makelabel, dans la définition de +l’énvironnement etiquetterouge. + +De même on trouve souvent au sein de espacement des commandes pour +redéfinir l’espacement de la liste. Ci dessous on listes les paramètres +d’espacement et leur valeurs par défaut. (Il se peut que les valeurs par +défaut pour les environnements dérivés tels que itemize soient +différentes des valeurs exposées ici). Voir aussi la figure qui suit la +liste. Chaque paramètre est une longueur (see Lengths). Les espaces +verticaux sont d’ordinaire des longueurs élastiques, avec une composante +en plus ou en minus, pour donner à &tex; de la +flexibilité dans le réglage de la page. On change chaque paramètre avec +une commande du genre de as \setlength{itemsep}{2pt plus1pt +minus1pt}. Pour obtenir certains effets, ces longueurs doivent être +mise à zéro, ou à une valeur négative. + +\itemindent\itemindent +Espace supplémentaire horizontal de renfoncement, ajouté à de +leftmargin, de la première ligne de chaque article. Sa valeur par +défaut est 0pt. + +\itemsep\itemsep +Espace vertical entre les articles, ajouté à \parsep. Les +valeurs par défaut pour les trois premiers niveaux dans les classes de +&latex; ‘article’, ‘book’, et ‘report’ à la taille de 10 +point sont : 4pt plus2pt minus1pt, \parsep (c-à-d. +2pt plus1pt minus1pt), et \topsep (c-à-d. 2pt +plus1pt minus1pt). Les valeurs par défaut à 11 points sont : +4.5pt plus2pt minus1pt, \parsep (c-à-d. 2pt +plus1pt minus1pt), et \topsep (c-à-d. 2pt plus1pt +minus1pt). Les valeurs par défaut à 12 points sont : 5pt +plus2.5pt minus1pt, \parsep (c-à-d. 2.5pt plus1pt +minus1pt), et \topsep (c-à-d. 2.5pt plus1pt minus1pt). + +\labelsep\labelsep +Espace horizontal entre l’étiquette et le texte d’un article. La valeur +par défaut pour les classes &latex; ‘article’, ‘book’, et +‘report’ est de 0.5em. + +\labelwidth\labelwidth +Largueur horizontale. La boîte contenant l’étiquette est nominalement de +cette largeur. Si \makelabel renvoie un texte qui est plus larget +que cela, alors le renfoncement de la première ligne de l’article sera +augmenté pour créer l’espace nécessaire à ce matériel supplémentaire. +Si \makelabel renvoie un texte de largeur inférieur ou égale à +\labelwidth alors le comportement par défaut de &latex; est que +l’étiquette est composé fer à droite dans une boîte de cette largeur. + +Le bord de gauche de la boîte de l’étiquette est à +\leftmargin+\itemindent-\labelsep-\labelwidth +de la marge de gauche de l’environnement enveloppant. + +La valeur par défaut pour les classe &latex; ‘article’, +‘book’, et ‘report’ pour les liste de premier niveau vaut +\leftmargini-\labelsep, (c-à-d. 2em en mode à une +colonne et 1.5em en mode à deux colonnes). Au deuxième niveau, +c’est \leftmarginii-\labelsep, et au troisième niveau +\leftmarginiii-\labelsep. Ces définitions ont pour effet +que le bord de gauche de l’étiquette coïncide avec la marge dee gauche +de l’environnement enveloppant. + +r\leftmargin\leftmargin +Espace horizontal entre la marge de gauche de l’environnement envelopant +(ou la marge de gauche de la page pour une liste de premier niveau), et +la marge de gauche de cette liste. Doit être positif ou nul. + +Dans les classes de document &latex; standardes, ce paramètre est réglé +à la valeur \leftmargini pour une liste de premier niveau, alors +que pour une liste de deuxième niveau, c’est à dire imbriquée dans une +liste de premier niveau, il est réglé à \leftmarginii. Pour les +listes aux niveaux d’imbrication suivants les valeurs de +\leftmarginiii à \leftmarginvi sont utilisées. (Imbriquer +des liste au delà de cinq niveaux produit le message d’erreur ‘Too +deeply nested’). + +Les valeurs par défaut des trois premiers niveaux dans les classes +&latex; ‘article’, ‘book’, et ‘report’ sont les +suivantes : \leftmargini vaut 2.5em (ou 2em en mode +à deux colonnes), \leftmarginii vaut 2.2em, et +\leftmarginiii vaut 1.87em. + +\listparindent\listparindent +Espace horizontal de renfoncement supplémentaire, en plus de +\leftmargin, pour le deuxième paragraphes et les suivants au sein +d’un article de liste. A negative value makes this an “outdent”. Its +default value is 0pt. + +\parsep\parsep +Espace vertical entre les paragraphe d’un article. +Les valeurs par défaut pour les trois premierss niveaux dans les classes +&latex; ‘article’, ‘book’ et ‘report’ à la taille de 10 +point sont : 4pt plus2pt minus1pt, 2pt plus1pt minus1pt, +and 0pt. La valeurs par défaut à la taille de 11 point sont : +4.5pt plus2pt minus1pt, 2pt plus1pt minus1pt, et +0pt. La valeurs par défaut à la taille de 12 point sont : +5pt plus2.5pt minus1pt, 2.5pt plus1pt minus1pt, and +0pt. + +\partopsep\partopsep +Espace vertical ajouté, en plus de +\topsep+\parskip, en haut et en bas de l’environnement +tout entier lorsque la liste considérée est précédée d’une ligne à +blanc. (Une ligne à blanc dans le source &latex; avant la liste change +l’espacement à la fois en haut et en bas de la liste ; que la ligne +suivant la liste soit à blanc est sans importance). + +Les valeurs par défaut pour les trois premiers niveaux dans les classes +&latex; ‘article’, ‘book’, anet ‘report’ à la taille de +point sont : 2pt plus1 minus1pt, 2pt plus1pt minus1pt, et +1pt plus0pt minus1pt. Les valeurs par défaut à la taille de 11 +point sont : 3pt plus1pt minus1pt, 3pt plus1pt minus1pt, +et 1pt plus0pt minus1pt). Les valeurs par défaut à la taille de +12 point sont : 3pt plus2pt minus3pt, 3pt plus2pt +minus2pt, et 1pt plus0pt minus1pt. + +\rightmargin\rightmargin + +Espace horizontal entre la marge de droite de la liste et la marge de +droite de l’environnement l’englobant. Horizontal space between the right margin of the list +and the right margin of the enclosing environment. Its default value is +0pt. It must be non-negative. + +\topsep\topsep +Espace vertical ajouté aussi bien au haut qu’au bas +de la lise, en plus de \parskip (see \parindent & \parskip). +Les valeurs par défaut pour les trois premiers niveaux dans les classes +&latex; ‘book’, anet ‘report’ à la taille de 10 point sont : +8pt plus2pt minus4pt, 4pt plus2pt minus1pt, and 2pt +plus1pt minus1pt. Les valeurs par défaut à la taille de 11 point +sont : 9pt plus3pt minus5pt, 4.5pt plus2pt minus1pt, and +2pt plus1pt minus1pt. Les valeurs par défaut à la taille de 12 +point sont : 10pt plus4pt minus6pt, 5pt plus2.5pt +minus1pt, and 2.5pt plus1pt minus1pt. -L’argument obligatoire espacement contient des commandes pour -changer les paramètres d’espacement pour la liste. Cet argument est le -plus souvent vide, c.-à-d. {}, ce qui laisse l’espacement -par défaut. + +La figure suivante illustre les distances horizontales et verticales. + +....................................................................... +..............Surrounding environment, preceding material.............. - + | v0 + |---h0--|-h1-| | + ..Label.. .....First item..................................... - + ............................................................ + ............................................................ - + | v1 + ........First item, second paragraph .................. - + |-h2-| | v2 + | + ..Label.. .....Second item.................................... - + ............................................................ + ............................................................ - +|-h3--|-h4-| |-h5-| |v3 + | +..............Surrounding environment, following material.............. - +....................................................................... + +Les longueurs illustrées sont listées ci-dessous. La relation clef est +que le bord droit du crochet pour h1 est à la même position +horizontale que le bord droit du crochet pour h4, de sorte que le +bord de gauche de la boîte de l’étiquette est à +h3+h4-(h0+h1). + +v0 +vaut \topsep + \parskip si l’environnement +list ne commence pas un nouveau paragraphe, et +\topsep+\parskip+\partopsep sinon + +v1 +\parsep + +v2 +\itemsep+\parsep + +v3 +Même valeur que v0. (Cet espace est affecté selon qu’une ligne à +blanc apparaît dans le source au dessus de l’environnemnt ; la présence +d’une ligne à blanc au dessous de l’environnement est sans effet.) + +h0 +\labelwidth + +h1 +\labelsep + +h2 +\listparindent + +h3 +\leftmargin + +h4 +\itemindent + +h5 +\rightmargin -L’argument utilisé pour composer les articles de la liste est spécifiée -par \linewidth (voir Page layout parameters). + +The list’s left and right margins, shown above as h3 and h5, +are with respect to the ones provided by the surrounding environment, or +with respect to the page margins for a top-level list. The line width +used for typesetting the list items is \linewidth (see Page +layout parameters). For instance, set the list’s left margin to be one +quarter of the distance between the left and right margins of the +enclosing environment with +\setlength{\leftmargin}{0.25\linewidth}. + +Page breaking in a list structure is controlled by the three +parameters below. For each, the &latex; default is +-\@lowpenalty, that is, -51. Because it is negative, +it somewhat encourages a page break at each spot. Change it with, +e.g., \@beginparpenalty=9999; a value of 10000 prohibits a +page break. + +\@beginparpenalty\@beginparpenalty +The page breaking penalty for breaking before the list (default -51). + +\@itempenalty\@itempenalty +The page breaking penalty for breaking before a list item (default -51). + +\@endparpenalty\@endparpenalty +The page breaking penalty for breaking after a list (default -51). + +paquetage enumitem +enumitem, paquetage + +Le paquetage enumitem est utile pour personaliser les +listes. + +Dans l’exemple suivant les étiquettes sont en rouge. Elles sont +numérotées, et le bord gauche des étiquettes est aligné avalt le bord +gauche du texte des articles. See \usecounter. + +\usepackage{color} +\newcounter{cnt} +\newcommand{\makeredlabel}[1]{\textcolor{red}{#1.}} +\newenvironment{redlabel} + {\begin{list} + {\arabic{cnt}} + {\usecounter{cnt} + \setlength{\labelwidth}{0em} + \setlength{\labelsep}{0.5em} + \setlength{\leftmargin}{1.5em} + \setlength{\itemindent}{0.5em} % equals \labelwidth+\labelsep + \let\makelabel=\makeredlabel + } + } +{\end{list} } + - + +<literal>\item</literal>: Une entrée dans une liste Synopsis : @@ -3532,7 +4762,7 @@ de crochets ([ et ]), pour utiliser des c sein de l’argument optionnel vous devez les cacher entre accolades, comme dans \item[Crochet fermant, {]}]. De même, pour utiliser un crochet ouvrant comme premier caractère du texte d’un article, cachez le -aussi au sein d’accolade. Voir &latex; command syntax. +aussi au sein d’accolade. See &latex; command syntax. Dans cet exemple la liste enumerate a deux articles qui utilise l’étiquette par défaut et une qui utilise l’étiquette optionnelle. @@ -3548,11 +4778,55 @@ l’étiquette par défaut et une qui utilise l’étiquette optionnelle ‘2.’ (notez que, à cause de l’étiquette optionnelle dans le second article, le troisième article ne reçoit pas l’étiquette ‘3.’). + + +<literal>trivlist</literal>: Une forme restreinte de <literal>list</literal> + +Synopsis : + +\begin{trivlist} + ... +\end{trivlist} + +Une version restreinte de l’environnement list dans laquelle les +marges sont sans renfoncement et \item sans l’argument optionnel +ne produit pas de texte. Elle est utilisée le plus souvent au sein de +macros, de sorte à définir un environnement où la commande \item +fait partie de la définition de l’environnement. Par exemple, +l’environnement center est défini pour l’essentiel comme ceci : + +\newenvironment{center} + {\begin{trivlist}\centering\item\relax} + {\end{trivlist}} + +Utiliser trivlist de la sorte permet à la macro d’hériter du code +mutualisé : combiner l’espace vertical provenant de deux environnement +adjacent ; détecter si le texte suivant l’environement doit être +considéré comme un nouveau paragraphe ou la suite du paragraphe +précédent ; ajuster les marges de gauche et de droit pour d’éventuels +environnements de liste imbriqués. + +En particulier, trivlist utilise les valeurs courantes des +paramètres de liste (see list), à ceci près que \parsep est +réglé à la valeur de \parskip, et que \leftmargin, +\labelwidth, et \itemindent sont réglés à zéro. + +Cet exemple produit les articles comme deux paragraphes, à ceci près que +(par défaut) ils n’ont pas de renfoncement de paragraphe et sont séparés +verticalement. + +\begin{trivlist} +\item C'est un fameux trois-mâts, fin comme un oiseau +\item Hisse et ho, Santiano. +\end{trivlist} + + <literal>math</literal> environnement math math, environnement + formules en ligne Synopsis : @@ -3561,69 +4835,228 @@ article, le troisième article ne reçoit pas l’étiquette ‘maths \end{math} +$ en ligne, math +\(...\) en ligne, math L’environnement math insert les maths donnés au sein du texte en cours. \(...\)) et $...$ sont des synonymes. -Voir Math formulas. +See Math formulas. <literal>minipage</literal> environnement minipage minipage, environnement + minipage, créer une +Synopsis : + +\begin{minipage}{largeur} + matière +\end{minipage} + +ou + \begin{minipage}[position][hauteur][pos-interne]{largeur} -texte +matière +\end{minipage} + +Place matière dans une boîte qui est largeur de large. C’est +comme une version réduite d’une page ; elle peut contenir ses propres +notes en bas de page, listes à puces, etc. (Il y a quelques +restrictions, notamment qu’elle ne peut pas avoir de flottants). Cette +boîte ne peut pas être coupé sur plusieurs pages. Ainsi minipage +est similaire à la commande \parbox (see \parbox), mais +contrairement à \parbox, d’autres environnements de production de +paragraphe peuvent être utilisés au sein d’une minipage. This example +will be 3 inches wide, and has two paragraphs. + +\begin{minipage}{3in} + Stephen Kleene fut un fondateur de la théorie de la récursivité. + + Il fut l'élève de Church, l'auteur de trois textes qui firent autorité, + et le président de l'Association for Symbolic Logic, et il fut + récompensé par la National Medal of Science. + \end{minipage} + +Voir plus bas pour une discussion sur le renfoncement de paragraphe au +sein d’une minipage. + +L’argument obligatoire largeur est une longueur rigide (see Lengths). +Il donne la largeur de la boîte dans laquelle matière est composée. + +Il y a trois arguments optionnels, position, hauteur, et +pos-interne. Il n’est pas nécessaire de fournir les trois à la +fois. Par exemple, obtenez les valeur par défaut pour position et +réglez hauteur avec \begin{minipage}[c][2.54cm] +matière \end{minipage}. (Obtenez la hauteur naturelle avec un +argument vide, []). + +L’argument optionnel position gouverne la façon dont la +minipage s’aligne verticalement avec la matière l’entourant. + +c + + +(Synonyme m) Valeur par défaut. Positionne la minipage de +sorte que son centre vertical soit aligné avec le centre des lignes de +texte adjacentes. + +t +\vtop &tex; de base +Aligne la ligne du haut de la minipage sur la ligne de base du +texte l’entourant (comme \vtop en &tex; de base). + +b +\vbox &tex; de base +Aligne la ligne du bas de minipage avec la ligne de base du texte +l’entourant (comme \vbox en &tex; de base). + +Pour voir l’effet de ces options, comparez le résultat de la compilation de + +---\begin{minipage}[c]{0.25in} + first\\ second\\ third \end{minipage} -L’environnement minipage compose son corps texte dans un -bloc qui ne peut pas être coupé sur plusieurs pages. C’est similaire à -la commande \parbox (voir \parbox), mais contrairement à -\parbox, d’autres environnements de production de paragraphe -peuvent être utilisés au sein d’une minipage. +avec ce qui se passe en remplaçant c par b ou t. + +L’argument optionnel hauteur est une longueur rigide +(see Lengths). Il règle la hauteur de la minipage. Vous +pouvez donner n’importe quelle valeur supérieure, égale ou inférieure à +la hauteur naturelle de la minipage sans que &latex; ne produise +une erreur ou un avertissement. Vous pouvez aussi la régler à une +hauteur de valeur nulle ou négative. - -Les arguments sont les mêmes que pour \parbox (voir \parbox). +L’argument optionnel final pos-interne contrôle la disposition de +matière au sein de la boîte. Voici les valeurs possibles (la +valeur par défaut est la valeur de l’argument position). -Renfoncement des paragraphes, au sein d’une minipage +t +Place matière en haut de la boîte. + +c +Centre matière verticalement. + +b +Place matière en bas de la boîte. + +s +Dilate matière verticalement ; elle doit contenir de l’espace +dilatable verticalement. + + +L’argument pos-interne a un sens quand l’option hauteur est +réglée à une valeur supérieure à la hauteur naturelle de la +minipage. Pour voir l’effet des options, exécutez l’exemple +suivant avec les différents choix possibles au lieu de b. + +Texte avant +\begin{center} + ---\begin{minipage}[c][8cm][b]{0.25\textwidth} + premier\\ deuxième\\ troisième + \end{minipage} +\end{center} +Texte après + +renfoncement des paragraphes, au sein d’une minipage +paragraphes, renfoncement au sein d’une minipage \parindent Par défaut, les paragraphes ne sont pas renfoncés au sein d’un -environnement minipage. Vous pouvez restaurer le renfoncement avec -une commande telle que \setlength{\parindent}{1pc}. +environnement minipage. Vous pouvez restaurer le renfoncement +avec une commande telle que \setlength{\parindent}{1pc} placé +au début de matière. notes en bas de page au sein des figures figures, notes en bas de page au sein des Les notes en bas de page au sein d’un environnement minipage sont -gérées d’une façon qui est particulièrement utiles pour mettre des notes +gérées d’une façon qui est particulièrement utile pour mettre des notes en bas de page dans des figures ou des tableaux. Une commande -\footnote \footnotetext met la note en bas de page au bas +\footnote ou \footnotetext met la note en bas de page au bas de la minipage au lieu de la mettre au bas de la page, et elle utilise le compteur \mpfootnote au lieu du compteur ordinaire -footnote (voir Counters). +footnote (see Counters). + +L’exemple ci-dessous place la note argument de \footnote en bas +de la table, et non en bas de la page. + +\begin{center} % centre la minipage sur la ligne +\begin{minipage}{6.5cm} + \begin{center} % centre la table au sein de la minipage + \begin{tabular}{ll} + \textsc{Monarque} &\textsc{Reigne} \\ \hline + Elizabeth II &63 ans\footnote{à ce jour} \\ + Victoria &63 ans \\ + George III &59 ans + \end{tabular} + \end{center} +\end{minipage} +\end{center} + +Si vous imbriquez des minipages, alors il y a une bizarrerie dans +l’utilisation des note \footnote. Les notes apparaissement au bas +du texte terminé par la prochaine \end{minipage} ce qui n’est +peut-être pas leur place logique. -Cependant, ne mettez pas une minipage à l’intérieur d’une autre si vous -utilisez les note en bas de page ; elles pourraient terminer en bas de -la mauvaise minipage. +L’exemple suivant place un tableau de données côte à côte d’un +graphique. Ils sont verticalement centrés. +paquetage siunitx +siunitx, paquetage + +% siunitx permet d'avoir le type de colonne S dans les tableaux, pour l'alignement +% et le séparateur décimal +\usepackage[output-decimal-marker={,}]{siunitx} +\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}} + ... +\begin{center} + \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}} + \hspace{0.1\textwidth} + \begin{minipage}{0.5\textwidth} + \begin{tabular}{r|S} + \multicolumn{1}{r}{Quartier} &Pop. (million) \\ \hline + The Bronx &1.5 \\ + Brooklyn &2.6 \\ + Manhattan &1.6 \\ + Queens &2.3 \\ + Staten Island &0.5 + \end{tabular} + \end{minipage} +\end{center} + <literal>picture</literal> environnement picture picture, environnement + créer des images images, créer +Synopsis : + +\begin{picture}(largeur,hauteur) +… commandes picture … +\end{picture} + +ou + \begin{picture}(largeur,hauteur)(décalagex,décalagey) … commandes picture … \end{picture} \unitlength -L’environnement picture vous permet de créer toute sorte de -dessin dans lequel vous voulez du texte, des lignes, des flèches et des -cercles. Vous dîtes à &latex; où mettre les chose dans le dessin en -spécifiant leur coordonnées. Une coordonnée est un nombre qui peut avoir -une séparateur décimal (point et non virgule) et un signe moins — un +L’environnement picture vous permet de créer des dessins simples +contenant des lignes, des flèches, des boîtes, des cercles, et du texte. +Cet environnement n’est pas obsolète, mais les nouveaux documents +utilisent typiquelent des systèmes de création de graphiques bien plus +puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Ceux-ci ne +sont pas couverts dans ce documents ; voir le CTAN. + + +Vous dîtes à &latex; où mettre les chose dans le dessin en spécifiant +leur coordonnées. Une coordonnée est un nombre qui peut avoir une +séparateur décimal (point et non virgule) et un signe moins — un nombre comme 5, 0.3 ou -3.1416. Une coordonnées spécifie une longueur en multiples de l’unité de longueur \unitlength, ainsi si \unitlength a été réglée à @@ -3636,6 +5069,7 @@ commande \setlength, en dehors d’un environnement paquetage picture picture, paquetage + Le paquetage picture redéfinit l’environnement picture de sorte qu’où que soit utilisé un nombre au sein de commandes picture pour spécifier une coordonnée, on puisse alternativement utiliser une @@ -3692,7 +5126,7 @@ référence des divers objets sont décrits plus bas. lR box La commande \put crée une LR box. Vous pouvez mettre tout -ce qui peut aller dans une \mbox (voir \mbox) dans l’argument +ce qui peut aller dans une \mbox (see \mbox) dans l’argument texte de la commande \put. Quand vous faites cela, le point de référence devient le coin inférieur gauche de la boîte . @@ -3745,7 +5179,7 @@ spécificateurs parmi les suivants : Place l’article sur la droite. -Voir \makebox. +See \makebox. @@ -3810,18 +5244,70 @@ cadre. Aucun espace supplémentaire n’est mis entre le cadre et l’ob Synopsis : -\line(xpente,ypente){longueur} - -La commande \line dessine un ligne avec la longueur donnée -et la pente xpente/ypente. - -De base &latex; peut seulement dessiner des ligne dont la -pente = x/y, où x et y prennent des valeurs -entières de −6 jusqu’à 6. Pour des ligne de pente -quelconque, sans parler d’autres formes, voir le paquetage -curve2e et bien d’autres sur le CTAN. +\line(xpente,ypente){excursion} + +Dessine une ligne. Sa pente est telle que la ligne monte de ypente +verticalement pour toute avancée horizontale de +xpente. L’excursion est le déplacement horizontal total — +ce n’est pas la longueur du vecteur, mais la variation en x. Da,s +me cas spécial des ligne vertical, où (xpente,ypente)=(0,1), +l’excursion donne le déplacement en y. + +L’exemple suivant dessine une ligne commençant aux coordonnées (1,3). + +\put(1,3){\line(2,5){4}} + +Pour toute avancée de 2 vers la droite, cette ligne monte de 5. Parce +que excursion spécifie qu’elle avance de 4, elle monte en tout +de 10. De sorte que son extrémité finale est +(1,3)+(4,10)=(5,13). En particulier, notez que +excursion=4 n’est pas la longueur de la ligne, mais c’est +son déplacement en x. + +Les arguments xpente et ypente sont des entiers qui peuvent +être positifs, negatifs, ou nuls zero (si les deux valent 0, alors +&latex; traite le second comme 1). Avec +\put(x_init,y_init){\line(xpente,ypente){travel}}, +si xpente est négatif alors l’extrémté finale d ela ligne a sa +première coordonnée inférieure à x_init. Si ypente est +negatif alors l’extrémité finale a sa seconde coordonnées inférieure à +y_init. + +Si excursion est négatif alors vous obtenez LaTeX Error: Bad \line or +\vector argument. + +pict2e, paquetage +graphiques, paquetages +paquetage pict2e +pict2e, paquetage + +paquetage TikZ +TikZ, paquetage + +paquetage PSTricks +PSTricks, paquetage + +paquetage MetaPost +MetaPost, paquetage + +paquetage Asymptote +Asymptote, paquetage + +De base &latex; peut seulement dessiner des lignes avec une plage +limitées de pentes parce que ces lignes sont constituées par la +juxtaposition de petits segments de droite issus de polices +préfabriquées. Les deux nombres xpente et ypente prennent +des valeurs entières de −6 jusqu’à 6. De plus ils doivent être +premiers entre eux, de sorte que (xpente, ypente)=(2,1) est +licite, mais pas (xpente, ypente)=(4,2) (is vous choisissez +cette dernière forme alors au lieu de lignes vous obtiendrez des +séquences de têtes de flèches ; la solution est de revenir à la première +forme). Pour obtenir des lignes de pente arbitraire et plein d’autres +formes dans un système tel que picture, voir le paquetage +pict2e (https://ctan.org/pkg/pict2e). Une autre solution +est d’utiliser un système graphique complet tel que TikZ, PSTricks, +MetaPost, ou Asymptote. - <literal>\linethickness</literal> @@ -3829,10 +5315,11 @@ quelconque, sans parler d’autres formes, voir le paquetage La commande \linethickness{dim} déclare que l’épaisseur des lignes horizontales et verticales dans un environnement picture -environnement vaut dim, qui doit être une longueur positive. +vaut dim, ce qui doit être une longueur positive. -\linethickness n’affecte pas l’épaisseur des lignes obliques, -cercles, ou quarts de cercles dessinés par \oval. +Elle diffère de \thinlines et \thicklines en ce qu’elle +n’affecte pas l’épaisseur des lignes obliques, cercles, ou quarts de +cercles dessinés par \oval. @@ -3949,16 +5436,18 @@ doivent être comprises entre −4 and +4 y compris. - + <literal>quotation</literal> et <literal>quote</literal> environnement quotation quotation, environnement + citation texte cité avec renfoncement des paragraphes, affichage afficher du texte cité avec renfoncement de paragraphe renfoncement des paragraphes dans du texte cité environnement quote quote, environnement + texte cité sans renfoncement des paragraphes, affichage afficher un texte cité sans renfoncement de paragraphe renfoncement des paragraphes dans un texte cité, omettre @@ -3977,20 +5466,20 @@ doivent être comprises entre −4 and +4 y compris. Cite du texte. -Dans les deux environnement, les marges sont renfoncées à la fois sur la +Dans les deux environnements, les marges sont renfoncées à la fois sur la gauche et la droite. Le texte est justifié des deux côtés sur la marge. De même que dans le texte principal, laisser une ligne à blanc au sein du texte produit un nouveau paragraphe. Pour comparer les deux : dans l’environnement quotation, les paragraphes sont renfoncés de 1,5em et l’espace entre les -paragraphe est petit, 0pt plus 1pt. Dans l’environnement -quote, les paragraphes ne sont pas renfoncés et il y a une espace -verticale entre les paragraphes (c’est la longueur elastique +paragraphes est petit, 0pt plus 1pt. Dans l’environnement +quote, les paragraphes ne sont pas renfoncés et il y a un espace +vertical entre les paragraphes (c’est la longueur élastique \parsep). Ainsi, l’environnement quotation convient mieux -environm aux documents où les nouveaux paragraphes sont marqués par un +aux documents où les nouveaux paragraphes sont marqués par un renfoncement plutôt que par une séparation verticale. De plus, -quote convient meieux pour des citations courtes ou une suite de +quote convient mieux pour des citations courtes ou une suite de citations courtes. \begin{quotation} @@ -4005,7 +5494,8 @@ citations courtes. environnement tabbing tabbing, environnement -taquets des tabulation, utiliser + +taquets de tabulation, utiliser aligner du texte en utilisant des taquets de tabulation alignement au moyen de tabbing @@ -4013,67 +5503,193 @@ citations courtes. \begin{tabbing} row1col1 \= row1col2 \= row1col3 \= row1col4 \\ -row2col1 \> \> row2col3 \\ +row2col1 \> \> row2col3 \\ ... \end{tabbing} - - L’environnement tabbing fournit une technique pour aligner du -texte en colonnes. Il fonctionne en réglant des taquet et en tabulant -jusqu’à eux bien comme on le ferait sur une machine à écrire. Il -convient le mieux pour les cas où la largeur de chaque colonnne est -constante et connue d’avance. +texte en colonnes. Il fonctionne en réglant des taquets et en tabulant +jusqu’à eux à la façon dont on le faisait avec une machine à écrire +ordinaire. Il convient le mieux pour les cas où la largeur de chaque +colonne est constante et connue d’avance. Cet environnement peut être rompu entre plusieurs pages, contrairement à l’environnement tabular. -Les commandes suivante peuvent être utilisée au sein d’un environnement tabbing : +ligne tabulée, tabbing +L’environnement tabbing contient une suite de lignes +tabulées, la première ligne tabulée commence immédiatement après +\begin{tabbing} et chaque ligne se termine par \\ ou +\kill. Il est possible de terminer la dernière ligne juste par +\end{tabbing}, ce qui est équivalent à +\\\end{tabbing}. + +motif courant de taquets de tabulation, tabbing +L’environnement tabbing a un motif courant de taquets de +tabulation qui est une séquence de n taquets, avec n > +0, ce qui crée n colonnes correspondantes. Immédiatement après +\begin{tabbing} on a n=1, c.-à-d. le motif +courant de taquets contient une seul taquet, désigné comme le taquet +N°0, et dont la position est le début de ligne, c.-à-d. que la +première colonne commence au début de la ligne. + +taquet courant, tabbing +L’un des taquets du motif courant ayant été réglé comme le taquet +courant, par défaut tout texte composé par la suite au sein de +l’envionnement tabbing est composé en drapeau droit avec le fer à +gauche sur ce taquet, c’est à dire qu’il est aligné à gauche dans la +colonne courante. La composition est faite en mode LR. + +taquet de début de ligne courant, tabbing +Par ailleurs l’environnement tabbing a un taquet de début de +ligne courant. Par défaut, immédiatement après \begin{tabbing} +c’est le taquet N°0, mais cela peut être changé avec les commandes +\+ et \-. Au début de chaque ligne tabulée, le taquet +courant est initalement égal au taquet de début de ligne courant. + +La marge de droite de l’environnement tabbing est la fin de +ligne, c.-à-d. que la largeur de l’environnement est de longueur +\linewidth. Il n’y a pas par défaut de taquet correspondant à la +marge de droite, même s’il serait possible avec un peu de calcul d’en +définir un à cette position (voir exemples ci-après). + +En ce qui concerne la marge de gauche, ou autrement dit le taquet N°0, +contrairement à l’environnement tabular, il n’est pas nécessaire +de mettre un \noindent devant \begin{tabbing} pour +éviter un renfoncement : un environnement tabbing commence +toujours un nouveau paragraphe sans renfoncement. De plus il est inutile +d’étoiler une commande \hspace en début de ligne tabulée pour que +l’espace soit pris en compte. + +Les commandes suivantes peuvent être utilisées au sein d’un +environnement tabbing : \\ (tabbing)\\ (tabbing) -Finit une ligne. +Finit une ligne tabulée et la compose. Après cette commande une nouvelle +ligne tabulée commence, et donc le taquet courant redevient le taquet +courant de début de ligne. \= (tabbing)\= (tabbing) -Règle un taquet à la position courante. +Règle un taquet à la position courante. La nième commande +\= de la ligne tabulée courante définit le taquet N°n, ou +le redéfinit s’il avait été déjà défini dans une ligne tabulée +précédente. Lorsque le nombre de taquets dans le motif courant est +(n+1), c’est à dire qu’on a des taquets N°0 à N°n, +alors la (n+1)ième commande \= définit le taquet +N°n+1, ce qui porte le nombre de taquets à +n+2. La position des taquets peut être définie avec plus de +liberté que ce qui se passait avec un machine à écrire ordinaire. En +effet il est possible de définir à la même position deux taquets de +numéros N°n et N°m distincts, voire de faire en sorte que +les taquets N°n et N°m, avec n<m, soient +à des positions telles que le taquet N°m soit avant le taquet +N°n. \> (tabbing)\> (tabbing) \> -Avance au taquet suivant. +Change le taquet courant au taquet suivant dans l’ordre logique, +c.-à-d. si le taquet courant est le taquet N°n, alors, en +supposant qu’il y ait au moins n+2 taquets définis, on +passe au taquets N°n+1, sinon cette commande provoque une +erreur. \<\< -Place le texte qui suit à la gauche de la marge locale (sans changer -cette marge). Ne peut être utilisé qu’au début d’une ligne. +Change le taquet courant au taquet précédent dans l’ordre logique. Cette +commande ne peut être utilisée qu’au début d’une ligne tabulée, et que +lorsque le taquet de début de ligne courant est le taquet N°n avec +n>0. Le taquet courant devient alors le taquet +N°n-1. + +Il est en fait possible d’avoir m commandes \< consécutives +à condition que mn, le taquet courant devient +alors le taquet N°(n-m). Si par contre +m>n, alors la n+1 commande \< +provoque une erreur. + +Il est possible, même si c’est absurde, d’avoir ensuite des commandes +\> qui défont ce qu’on fait les commandes \<. Ainsi en +supposant qu’au début d’une ligne tabulée le taquet de début de ligne +courant soit le taquet N°2, faire commencer la ligne par \<\<\>\> +n’a aucun effet. Par contre, \<\<\<\>\>\> provoquera une erreur, +parce que la troisième commande \< est illicite. Dans les mêmes +conditions faire \<\>\<\> provoque également une erreur, car la +seconde commande \< n’est pas consécutive de la première, elle +n’est donc pas, au sens où on l’entend, utilisée en début de ligne. \+\+ -Déplace la marge de gauche d’un taquet vers la droite pour la ligne -suivante et toutes celles qui suivent. +Change le taquet de début de ligne courant au taquet suivant dans +l’ordre logique pour la ligne tabulée suivante, et toutes celles qui +suivent tant qu’une autre commande ne vient pas le modifier. La notion +de taquet suivant dans l’ordre logique suit le même principe que pour la +commande \>, c’est à dire que s’il n’y a que n+1 +taquets défini, et que le taquet de début de ligne courant est le taquet +N°n, alors cette commande provoque une erreur. La commande +\+ peut être invoquée n’importe où dans la ligne tabulée, et on +peut avoir plusieurs commandes \+ au sein de la même ligne, du +moment que pour chacune d’elle un nombre suffisant de taquets est déjà +défini. Par exemple le code suivant provoque une erreur parce que bien +qu’à la fin de la première on ait trois taquets définis, au moment où la +commande \+ est invoquée le nombre de taquets définis ne vaut que +1, on ne peut donc pas passer du taquet N°0 au taquet N°1 : +\begin{tabbing} +Vive \+\=la \=France\\ +Vive \>la\>République\\ +\end{tabbing} +En revanche le code suivant fonctionne, car lorsque la commande +\+ est passée on a trois taquets définis, les taquets N°0 à 2, on +peut donc passer du taquet N°0 au taquet N°1. +\begin{tabbing} +Vive \=la \=France\+\\ +Vive \>la\>République\\ +\end{tabbing} +C’est pourquoi l’usage est que la ou les commandes \+ sont +toujours invoquées juste avant la fin de ligne \\ ou \kill. +Il est possible, même si cela est absurde, d’avoir sur la même ligne à +la fois des commandes \+ et \- s’annulant l’une l’autre, +du moment qu’aucune d’elle ne fasse passer sur un taquet non défini. + \-\- -Déplace la marge de gauche d’un taquet vers la gauche pour la ligne -suivante et toutes celles qui suivent. +Change le taquet de début de ligne courant au taquet précédent dans +l’ordre logique pour la ligne tabulée suivante, et toutes celles qui +suivent tant qu’une autre commande ne vient pas le modifier. C’est à +dire que si le taquet de début de ligne courant est le taquet N°n, +et qu’on a m commandes \- avec mn, +alors le taquet de début de ligne courant de la ligne suivante devient +le taquet N°n-m. Par contre, si +m>n, alors la (n+1)ième commande +\+ provoque une erreur. \' (tabbing)\' (tabbing) Déplace tout ce que vous avez tapé jusqu’alors dans la colonne courante, c.-à-d. tout ce qui suit la plus récente commande \>, -\<, \', \\, ou \kill, à la droite de la -colonne précédente, aligné à droite sur le taquet de la colonne -courante. +\<, \', \\, ou \kill, aligné à droite dans +la colonne précédente, le fer à droite étant espacé du taquet courant +d’une longueur \tabbingsep. Voir aussi \`. \` (tabbing)\` (tabbing) -Vous perme de placer du texte justifié à droite sur n’importe quel -taquet, y compris le taquet 0. Toutefois, ne peut pas placer du texte à -la droite de la dernière colonne parce qu’il n’y a pas de taquet à cet -endroit. La commande \` déplace tout le texte qui la suit, -jusqu’à la commande \\ ou \end{tabbing} qui termine la -ligne. - +Vous permet de placer du texte justifié à droite en face de n’importe +quel taquet, y compris le taquet 0. Les commandes \` et \' +alignent toutes deux le texte à droite, toutefois elles se distinguent +fortement par deux aspects : +Tout d’abord le texte qui est déplacé est, dans le cas de \`, le +texte qui suit la commande \` et qui va jusqu’à la fin de la +ligne tabulée, c.-à-d. jusqu’à \\ ou \end{tabbing}. +Il ne doit y avoir aucune commande \> ou \' entre le +\` et la commande \\ ou \end{tabbing} qui termine +la ligne. Dans le cas de la commande \' au contraire, c’est le +texte qui précède la commande \'. +Par ailleurs, avec \' l’alignement se fait sur un taquet et avec +un espacement relatif de \tabbingspace, alors qu’avec \` +l’alignement se fait sur la marge de droite et sans espacement relatif. + \a (tabbing)\a (tabbing) -\a' (acute accent in tabbing) -\a` (grave accent in tabbing) -\a= (macron accent in tabbing) +\a' (aigu, accent dans tabbing) +\a` (grave, accent dans tabbing) +\a= (macron, accent dans tabbing) Dans un environnement tabbing, les commandes \=, \' et \` ne produisent pas d’accents comme d’habitude -(voir Accents). À leur place, on utilise les commandes \a=, +(see Accents). À leur place, on utilise les commandes \a=, \a' et \a`. \kill\kill @@ -4088,44 +5704,131 @@ produire une sortie. L’effet de toute commande \=, \pushtabs. \pushtabs\pushtabs -Sauvegarde positions courantes de tous les taquets. C’est utile pour -changer temporairement les positions de taquets au milieu d’un -environnement tabbing. - +Sauvegarde dans une pile dédiée à cet effet le motif courant de taquets +de tabulation. C’est utile pour changer temporairement les positions de +taquets au milieu d’un environnement tabbing. Après un +\pushtabs, on a un nouveau motif vierge, c.-à-d. ne contenant +qu’un seul taquet, le taquet N°0 à la position de début de ligne. Pour +toute commande \pushtabs il doit y avoir une commande +\poptabs avant la fin de l’environnement, c’est à dire que la +pile doit être explicitement vidée avant le end{tabbing}. + + \tabbingsep\tabbingsep -Distance à la gauche d’un taquet déplacé par \'. +Distance du texte déplacé par \' à la gauche du taquet courant. -Cet exemple compose un fonction en Pascal function dans un format -traditionnel : - -\begin{tabbing} -function \= fact(n : integer) : integer;\\ - \> begin \= \+ \\ - \> if \= n $>$ 1 then \+ \\ - fact := n * fact(n-1) \- \\ - else \+ \\ - fact := 1; \-\- \\ +Il est à noter que les espaces en début de ligne, où après \=, +\> ou \< sont gobés, qu’il s’agisse d’espaces produits par +la macro \space ou par le caractère espace. Par contre l’espace +produit par la le caractère de contrôle espace (\ , c.-à-d. +une contr’oblique suivie d’un caractère espace) n’est pas gobé. + +Cet exemple compose un fonction en Pascal dans un format traditionnel : + +{\ttfamily +\begin{tabbing} +function \= fact(n : integer) : integer;\+\\ + begin \=\+\\ + if \= n $>$ 1 then\+\\ + fact := n * fact(n-1)\-\\ + else\+\\ + fact := 1;\-\-\\ end;\\ -\end{tabbing} - +\end{tabbing}} + +Le résultat ressemble à cela : +function fact(n : integer) : integer; + begin + if n > 1 then + fact := n * fact(n-1); + else + fact := 1; + end; + +paquetage algorithm2e +algorithm2e, paquetage + +paquetage listings +listings, paquetage + +Ceci n’était qu’un exemple illustrant tabbing, pour formatter du +code considérez plutôt les paquetages algorithm2e pour du +pseudo-code, et listings pour du vrai code. + +Voici un autre exemple où le taquet N°2 est entre le taquet N°0 et le +taquet N°1 : + +{\ttfamily +\begin{tabbing} + 12\=34\=\kill + 12345678\=9\\ + 1\>2\>3\\ +\end{tabbing}} + +Le résultat ressemble à cela : +123456789 +1 3 2 + +Voici un exemple où les taquets N°0 et N°1 sont confondus, ainsi que les +taquets N°2 et N°3, ce qui permet de superposer le texte aux taquets +impairs sur celui au taquets pairs, par exemple pour souligner ou barrer +comme avec une machine à écrire, en superposant un caractère _ ou +un caractère . Evidemment ce n’est qu’une illustration de +la flexivilité des taquets, et non une méthode convenable pour souligner +ou barrer un mot, d’un part parce que tabbing en soi commençant +un nouveau paragraphe ne permet pas d’agir sur un seul mot, et d’autre +part, parce que le paquetage soul fait cela beaucoup mieux. +paquetage soul +soul, paquetage + + +{\ttfamily +\begin{tabbing} + \=souligne \=\=\kill + soulign\a'e\> + \_{}\_{}\_{}\_{}\_{}\_{}\_{}\_{}\> + barr\a'e\>{--}{--}{--}{--}{--}{--}\\ +\end{tabbing}} + + +Finalement, voici un exemple où on a placé le taquet N°5 décalé d’une +longueur \tabbingsep à droite de la marge de droite. + +{\ttfamily +\begin{tabbing} +\hspace{1cm}\=\hspace{1cm}\=\hspace{1cm}\=\hspace{1cm}\= + \hspace{\dimexpr\linewidth-4cm+\tabbingsep}\=\kill +1\>2\>X\'3\>4\>5\>\a`a gauche de de la marge de droite + avec \textbackslash'\'\\ +1\>2\>X\'3\>4\>5\`\a`a gauche de de la marge de droite + avec \textbackslash`\\ +\end{tabbing}} + +Le résultat ressemble à cela : + + +1 2 X 3 4 5 à gauche de la marge de droite avec \' +1 2 X 3 4 5 à gauche de la marge de droite avec \` + <literal>table</literal> environnement table table, environnement + tableaux, créer créer des tableaux Synopsis : \begin{table}[placement] - corps-du-talbeau + corps-du-tableau \caption[titreldt]{titre} \end{table} -Une classe de flottants (voir Floats). Parce qu’ils ne peuvent pas +Une classe de flottants (see Floats). Parce qu’ils ne peuvent pas être coupés à cheval sur plusieurs pages, il ne sont pas composés en séquence avec le texte normale, mais à la place sont « flottés » vers un endroit convenable, tel que le sommet d’une page suivante. @@ -4138,12 +5841,12 @@ l’algorithme de placement des flottants, voir Float etc. L’étiquette est optionnelle ; elle est utilisée pour les double renvois -(voir Cross references). +(see Cross references). \caption La commande \caption spécifie la légende texte pour la figure. La légende est numérotée par défaut. Si titreldt est -présent, il est utilisé dans la liste des talbeaux au lieu de titre -(voir Tables of contents). +présent, il est utilisé dans la liste des tableaux au lieu de titre +(see Table of contents etc.). \begin{table}[b] \centering @@ -4162,6 +5865,7 @@ présent, il est utilisé dans la liste des talbeaux au lieu de tit <literal>tabular</literal> environnement tabular tabular, environnement + lignes dans des tableaux aligner du texte dans des tableaux @@ -4193,9 +5897,9 @@ beaucoup des caractéristiques. Le format vertical de deux colonnes alignées à gauche, avec une barre verticales entre elles, est spécifié par l’argument {l|l} de tabular. -& +& pour cellules de tableau Les colonnes sont séparées avec une esperluette &. On crée un -filet horizontal entre deux ligne avec \hline. +filet horizontal entre deux lignes avec \hline. \\ pour tabular La fin de chaque ligne est marquée avec une double-contr’oblique \\. Cette \\ est optionnelle après @@ -4249,7 +5953,7 @@ de l’environnement. @{texte ou espace} Ceci insère texte ou espace à cette position dans chaque ligne. Le matériel texte ou espace est composé en mode LR. Ce texte est -fragile (voir \protect). +fragile (see \protect). Ce spécificateur est optionnel : à moins que vous mettiez dans votre propre @-expression alors les classes book, article et @@ -4319,8 +6023,8 @@ sont pas permis au sein d’une telle cellule, sauf à l’intérieur d& environnement comme minipage, array, ou tabular, ou à l’intérieur d’une \parbox explicite, ou dans la portée d’une déclaration \centering, \raggedright, ou -\raggedleft (quand elles sont utilisée au sein d’une cellule de -colonne en p ces déclaration doivent apparaître entre accolade, +\raggedleft (quand elles sont utilisées au sein d’une cellule de +colonne en p ces déclarations doivent apparaître entre accolades, comme dans {\centering .. \\ ..}. Sans quoi &latex; prendra la double contr’oblique comme une fin de ligne. @@ -4344,7 +6048,7 @@ peut la changer comme dans \arraystretch\arraystretch Un facteur par lequel l’espacement entre les lignes au sein des -environnement tabular et array est multiplié. La valeur +environnements tabular et array est multiplié. La valeur par défaut est ‘1’ pour aucune dilatation/contraction. On peut la changer comme dans \renewcommand{\arraystretch}{1.2}. @@ -4504,6 +6208,7 @@ utilisée dans une expression @{…}. environnement thebibliography thebibliography, environnement + bibliography, creating (manually) Synopsis : @@ -4516,14 +6221,31 @@ utilisée dans une expression @{…}. L’environnement thebibliography produit une bibliographie ou une liste de références. -Dans la classe article, cette liste de références est intitulée -« Réferences » ; dans la classe report, elle est intitulée -« Bibliographie ». Vous pouvez changer le titre (dans les classes standardes) -en redéfinissant la commande \refname. Par exemple, cela -l’élimine complètement : +Dans la classe article, cette liste de références est intitulée +‘Références’ et ce titre est stocké dans la macro \refname ; +dans la classe report, elle est intitulée ‘Bibliographie’ et +ce titre est stocké dans la macro \bibname. + +Vous pouvez changer le titre en redéfinissant celle des commandes +\refname ou \bibname qui est applicable selon la classe : + +\bibname +Pour les classes standardes dont le niveau le plus élevé de rubricage +est \chapter le titre est dans la macro \bibname, par +exemple les classes book et report tombent dans cette +catégorie. +\refname +Pour les classes standardes dont le niveau le plus élevé de rubricage +est \section le titre est dans la macro \refname, par +exemple la classe article tombe dans cette catégorie. + +paquetage babel +babel, paquetage + +Typiquement il n’est ni nécessaire ni désirable de redéfinir directement +\refname ou \bibname ; les paquetages linguistiques comme +babel s’en chargent. -\renewcommand{\refname}{} - L’argument obligatoire étiquette-la-plus-large est un texte qui, lorsqu’il est composé, est aussi large que la plus large des étiquettes d’article produit pas les commandes \bibitem. C’est typiquement @@ -4555,7 +6277,7 @@ entrée contient les étiquette et clef_ considéré. Lorsque le fichier .aux est lu par la commande \begin{document}, l’étiquette de l’article est associée à sa clef_de_cite, ce qui a pour effet que toute référence à -clef_de_cite avec une commande \cite (voir \cite) +clef_de_cite avec une commande \cite (see \cite) produit l’étiquette associée. @@ -4570,7 +6292,7 @@ produit l’étiquette associée. \cite[subcite]{clefs} L’argument clefs est une liste d’une ou plus de clefs de -références bibliographiques (voir \bibitem), séparées par des +références bibliographiques (see \bibitem), séparées par des virgules. Cette commande génère une référence bibliographique au sein du textes contenant les étiquettes associées aux clefs contenues dans clefs par les entrées respectives au sein du fichier .aux. @@ -4608,7 +6330,7 @@ bibliograhique dans le fichier .aux. fortement recommandé si vous avez besoin d’une bibliographie de plus d’un ou deux titre) pour mainteninr votre bibliographie, vous n’utilisez pas l’environnement thebibliography -(voir thebibliography). Au lieu de cela, vous incluez les lignes : +(see thebibliography). Au lieu de cela, vous incluez les lignes : \bibliographystyle{stylebib} \bibliography{ficbib1,ficbib2} @@ -4650,6 +6372,7 @@ ou \nocite sont listées dans la bibliographie. environnement theorem theorem, environnement + théorèmes, composition des Synopsis : @@ -4660,7 +6383,7 @@ ou \nocite sont listées dans la bibliographie. L’environnement theorem produit « Théorème n » en gras suivi de texte-théorème, où les possibilité de numérotation pour -n sont décrites par \newtheorem (voir \newtheorem). +n sont décrites par \newtheorem (see \newtheorem). @@ -4669,6 +6392,7 @@ suivi de texte-théorème, où les possibilité de nu environnement titlepage titlepage, environnement + fabriquer une page de titre pages de titre, création @@ -4682,9 +6406,9 @@ suivi de texte-théorème, où les possibilité de nu une page sur laquelle ne sont inscrit aucun numéro de page ou libellé de rubrique. Il entraîne aussi que la page suivante a le numéro un. Le formatage de la page de titre vous est laissé. La commande \today -peut être utile sur les pages de titre (voir \today). +peut être utile sur les pages de titre (see \today). -Vous pouvez utiliser la commande \maketitle (voir \maketitle) +Vous pouvez utiliser la commande \maketitle (see \maketitle) pour produire une page de titre standarde sans utiliser l’environnement titlepage. @@ -4695,6 +6419,7 @@ pour produire une page de titre standarde sans utiliser l’environnement environnement verbatim verbatim, environnement + texte verbatim simuler du texte tapuscrit texte tapuscrit, simulation de @@ -4713,8 +6438,8 @@ par exemple le caractère \ produit ‘\ -L’environnement verbatim utilise une police de type machine à -écrire à chasse fixe (\tt). +L’environnement verbatim utilise une police de type tapuscrit +(encore appelé « machine à écrire ») à chasse fixe (\tt). @@ -4746,6 +6471,7 @@ sont tapés avec un caractère « espace visible ». <literal>verse</literal> environnement verse verse, environnement + poésie, un environnement pour la Synopsis : @@ -4815,7 +6541,7 @@ environnement tabular ou array. Dans des circonstances ordinaires (par ex. en dehors d’une colonne spécifiée par p{...} dans un environnement tabular) la commande \newline est un synonyme de \\ -(voir \newline). +(see \newline). En plus de commencer une nouvelle ligne, la forme étoilée \\* dit à &latex; de ne pas commencer une nouvelle page entre les deux lignes, @@ -4850,7 +6576,7 @@ ligne. saut de ligne Dans du texte ordinaire ceci est équivalent à une double-contr’oblique -(voir \\) ; cela rompt la ligne, sans dilatation du texte le +(see \\) ; cela rompt la ligne, sans dilatation du texte le précéndent. Au sein d’un environnement tabular ou array, dans une @@ -4901,7 +6627,7 @@ dans les cas où ne suffisent ni le contrôle standard de la césure fait l’algorithme de césure de &tex; et les règles de césures données par les paquetages de gestion linguistiques, ni les moyens de contrôle explicites offerts par les commandes \hyphenation -(voir \hyphenation) et \- (voir \- (césure +(see \hyphenation) et \- (see \- (césure à gré)). \discretionary indique qu’un saut de ligne est possible à cet @@ -4951,7 +6677,7 @@ effet que &tex; fait le difficile à propos des saut de ligne. Ceci d’occasionnellement une boîte trop pleine (‘overfull \hbox’). Cette commande annule l’effet d’une commande \sloppy précédente -(voir \sloppy). +(see \sloppy). @@ -4962,7 +6688,7 @@ d’occasionnellement une boîte trop pleine (‘overfull \hbox difficile à propos des sauts de ligne. Ceci evite les boîtes trop pleines, au prix d’un espacement lâche entre les mots. -L’effet dure jusqu’à la prochaine commande \fussy (voir \fussy). +L’effet dure jusqu’à la prochaine commande \fussy (see \fussy). @@ -5024,11 +6750,15 @@ désirer influencer les sauts. - -<literal>\cleardoublepage</literal> + +<literal>\clearpage</literal> & <literal>\cleardoublepage</literal> + \cleardoublepage commencer une page de droite +\clearpage +débourrer les flottant et commencer une page +commencer une nouvelles page et débourrer les flottant La commande \cleardoublepage finit la page courante et fait que &latex; imprime tous les flottants, tableaux et figures, qui sont @@ -5038,12 +6768,6 @@ et une page de droite (numérotée impaire), en produisant si nécessaire une page à blanc. - - -<literal>\clearpage</literal> -\clearpage -débourrer les flottant et commencer une page -commencer une nouvelles page et débourrer les flottant La commande \clearpage finit la page actuelle et fait que &latex; imprime tous les flottants, tableaux et figures, qui sont @@ -5051,18 +6775,48 @@ apparus en entrée jusqu’à ce point et sont en attente. - + <literal>\newpage</literal> \newpage nouvelle page, commencer commencer une nouvelle page -La commande \newpage finit la page courante, mais ne débourre pas -tous les flottants (voir \clearpage). +Synopsis : + +\newpage + +La commande \newpage finit la page courante. Cette commande est +robuste (see \protect). + +Les sauts de page de &latex; sont optimisés de sorte que d’ordinaire on +n’utilise cette commande dans le corps d’un document que pour les +finitions sur la version finale, ou à l’interieur de commandes. + +Alors que les commandes \clearpage et \cleardoublepage +finissent également la page courante, en plus de cela elles débourrent +les flottants pendants (see \clearpage & \cleardoublepage). Et, si +&latex; est en mode à deux colonne alors \clearpage et +\cleardoublepage finissent las page courante en laissant +possiblement une colonne vide, alors que \newpage finit seulement +la colonne courante. + +Contrairement à \pagebreak (see \pagebreak & \nopagebreak), +la commande \newpage n’a pas pour effet que la nouvelle page +commence exactement là où la requête est faite. Dans l’exemple suivant + +Four score and seven years ago our fathers brought forth on this +continent, +\newpage +\noindent a new nation, conceived in Liberty, and dedicated to the +proposition that all men are created equal. + +la nouvelle page commence après ‘continent’, et la ligne où se +produit le saut n’est pas justifiée à droite. De plus, \newpage +n’étire pas verticalement la page, contrairement à \pagebreak. - + <literal>\enlargethispage</literal> \enlargethispage agrandir la page courante @@ -5081,7 +6835,7 @@ possible. Ceci est normalement utilisé en même temps qu’un - + <literal>\pagebreak</literal> & <literal>\nopagebreak</literal> \pagebreak \nopagebreak @@ -5157,7 +6911,7 @@ contraire. Changez l’aspect que &latex; donne au compteur de note en bas de page avec quelque chose du genre de \renewcommand{\thefootnote}{\fnsymbol{footnote}}, ce qui -utilise une séquence de symboles (voir \alph \Alph \arabic \roman +utilise une séquence de symboles (see \alph \Alph \arabic \roman \Roman \fnsymbol). Pour rendre ce changement global mettez cela dans le préambule. Si vous faite ce changement local alors vous désirerez sans doute réinitialiser le compte avec @@ -5199,7 +6953,7 @@ rubriques suivantes. utilise le compteur mpfootnote au lieu de footnote, de sorte que les notes sont numérotéee indépendemment. Elles apparaissent au bas de l’environnement, et non au bas de la page. Et par défaut -elles apparaissent alphabétiquement. Voir minipage. +elles apparaissent alphabétiquement. See minipage. @@ -5215,7 +6969,7 @@ elles apparaissent alphabétiquement. Voir minipageSans l’argument optionnel, la commande \footnotemark place dans le texte le numéro de la note courante. Cette commande peut être utilisée en mode paragraphe interne. Vous pouvez donner le texte de la -note séparéement la commande \footnotetext. +note séparément la commande \footnotetext. Cette commande pour produire plusieurs marque de note en bas de page faisant référence à la même note avec @@ -5265,7 +7019,7 @@ dans la cellule du tableau mais rien n’est composé en bas de la page. \end{center} La solution est d’entourer l’environnement the tabular d’un environnement -minipage, comme ci-après (voir minipage). +minipage, comme ci-après (see minipage). \begin{center} \begin{minipage}{.5\textwidth} @@ -5274,7 +7028,7 @@ dans la cellule du tableau mais rien n’est composé en bas de la page. \end{center} La même technique marche au sein d’un environnement table -flottant (voir table). To get the footnote at the bottom of the page +flottant (see table). To get the footnote at the bottom of the page use the tablefootnote package, comme illustré dans l’exemple ci-apès. Si vous placez \usepackage{tablefootnote} dans le préambule et utilisez le code source ci-dessous, alors la note @@ -5306,6 +7060,7 @@ les autres notes en bas de page. paquetage footmisc footmisc, paquetage + stable, option du paquetage footmisc option stable du paquetage footmisc a pour effet que la note en bas de page apparaît à la fois en bas de la @@ -5340,7 +7095,7 @@ n’apparaît pas). \footnotesep\footnotesep La hauteur de l’étai placé au début de la note en bas de page. Par défaut, c’est réglé à l’étai nomal pour des police de taille -\footnotesize (voir Font sizes), donc il n’y a pas d’espace +\footnotesize (see Font sizes), donc il n’y a pas d’espace supplémentaire entre les notes. Cela vaut ‘6.65pt’ pour des polices à ‘10pt’, ‘7.7pt’ pour ‘11pt’, et ‘8.4pt’ pour ‘12pt’. @@ -5377,11 +7132,18 @@ des genres. \newcommand*{\cmd}[nargs][optargdéfaut]{défn} \renewcommand*{\cmd}[nargs][optargdéfaut]{défn} + +Définit ou redéfinit une commande (voir aussi la discussion de +\DeclareRobustCommand dans Class and package commands). + forme en *, définir de nouvelles commandes forme étoilée, définir de nouvelles commandes -La forme étoilée (en *) de ces commandes exige que les arguments -ne contiennent pas de paragraphes de texte (la commande n’est pas -\long, dans la terminologie de &tex; de base). +\long +La forme étoilée (en *) de ces commandes interdit que les +arguments contiennent une multiplicité de paragraphes de texte (la +commande n’est pas \long, dans la terminologie de +&tex; de base). Avec la forme par défaut, il est possible qu’un +argument soit une multiplicité de paragraphes. cmd Obligatoire ; \cmd est le nom de la commande. Pour @@ -5416,10 +7178,10 @@ cas, tout argument obligatoire sera désigné en commençant par #2Omettre [maval] dans un appel n’est pas la même chose qu’avoir les crochets ne contenant rien, comme dans []. Dans le premier cas le paramètre #1 se développe en optargdéfaut ; -alors que dans le secon #1 se développe en une chaîne vide. +alors que dans le second #1 se développe en une chaîne vide. défn -Le texte par lequel substituer chaque occurrence de \cmd ; le +Le texte par lequel substituer chaque occurrence de \cmd ; le paramètre positionnel #n au sein de défn est remplacée par le texte passé comme nième argument. @@ -5472,17 +7234,183 @@ la définition et par conséquent définissent bien un groupe. - + + +<literal>\providecommand</literal> + +\providecommand +commandes, définir de nouvelles +définir une nouvelle commande +nouvelles commandes, définir + +Définit une commande, du moment qu’aucune commande de même nom n’existe déjà. + +Synopsis : + +\providecommand{cmd}[nargs][optargdéfaut]{defn} +\providecommand*{cmd}[nargs][optargdéfaut]{defn} + +Si aucune commande de ce nom n’existe alors ceci a le même effet que +\newcommand (see \newcommand & \renewcommand). Si une +commande de ce nom existe déjà alors cette définition est sans +effet. Ceci est particulièrement utile dans un fichier de style, ou dans +tout fichier susceptible d’être chargé plus d’une fois. + + + +<literal>\makeatletter</literal> et <literal>\makeatother</literal> + +Synopsis : + +\makeatletter + ... définition de commande comprenant @ dans leur nom .. +\makeatother + +Utilisez cette paire de commande quand vous redéfinissser les commandes +&latex; dont le nom comprend un caractère arobe @. La +déclaration \makeatletter a pour effet que le caractère +arobase @ ait le code de catégorie des lettres, c.-à-d. 11. La +déclaration \makeatother règle de code de catégorie de @ +à 12, sa valeur d’origine. + +À mesure que chaque caractère est lu par &tex; pour &latex;, un code +de catégorie lui est assigné. On appelle aussi ce code +catcode +code de catégorie de caractère +catégorie, code de caractère +catcode pour faire court. Par exemple, la contre-oblique \ +reçoit le catcode 0. Les noms de commande consistent en un caractère de +catégorie 0, d’ordinaire une contr’oblique, suivi par des lettres, +c-à-d. des caractères de catégorie 11 (à ceci près qu’une commande +peut également consister en un caractère de catégorie 0 suivi d’un +unique caractère qui n’est pas une lettre). + +Le code source de &latex; suit la convention que certaines commandes +utilisent @ dans leur nom. Ces commandes sont principalement +destinées aux auteurs de paquetages ou de classes. Cette convention +empèche les auteurs qui sont juste utilisateurs d’un paquetage ou d’une +classe de remplacer accidentellement une telle commande par une commande +définie par eux, puisque par défaut l’arobe a le catcode 12 (other). + +Utilisez la paire \makeatletter et \makeatother au sein +d’un fichier .tex, typiquement dans le préambule, quand vous +définissez ou redéfinissez des commandes dont le nom comprend @, +en entourant votre définition par elles. Ne les utilisez pas au sein de +fichiers .sty ou .cls puisque les commandes +\usepackage et \documentclass font déjà le nécessaire pour +que l’arobe ait le catcode d’une lettre, à savoir 11. + +paquetage macros2e +macros2e, paquetage + +Pour une liste complète des macros contenant une arobase dans leur nom, +voir le document http://ctan.org/pkg/macros2e. + + + + +Dans l’exemple suivant une commande \these@nomuniversite se +trouve dans le fichier de classe, et l’utilisateur veut changer sa +définition. Pour cela, il suffit d’insérer les trois lignes suivantes +dans le préambule, avant le \begin{document} : + +\makeatletter +\renewcommand{\these@nomuniversite}{Université Lyon III Jean Moulin} +\makeatother + + + + +<literal>\@ifstar</literal> + +\@ifstar +commandes, variantes étoilées +étoilées, variantes de commandes + + + + +Vous l’avez sans doute remarqué, beaucoup d’environnements ou commandes +standards de &latex; existent sous une variante étoilée. Vous pouvez avoir +envie de reprendre cette idée quand vous définissez vos commandes et arguments. + +Si vous avez lu \newenvironment & \renewenvironment, vous aurez compris +que c’est immédiat pour les environnements car l’étoile est un caractère +autorisé dans les noms d’environnements. Il vous suffit donc de faire +\newenvironment{monenv} et +\newenvironment{monenv*} avec les définitions souhaitées. + +Pour les commandes, c’est plus compliqué car l’étoile ne peut pas faire partie +du nom de la commande. Il y aura donc une première commande, qui devra être +capable de regarder si elle est ou non suivie d’une étoile et d’adapter son +comportement en conséquence. Cette première commande ne pourra pas accepter +d’argument, mais pourra faire appel à des commandes qui en acceptent. Par +ailleurs, on utilise la commande \@ifstar interne du noyau &latex; et +vous pouvez vous reportez à « \makeatletter & \makeatother » pour +comprendre pourquoi cela implique l’usage d’un bloc +\makeatletter...\makeatother. + +Dans cet exemple, on définit \ciel comme une commande avec un +argument obligatoire et admettant une variante étoilée \ciel* +également avec un argument obligatoire : + +\makeatletter +\newcommand*\ciel@starred[1]{ciel #1 étoilé} +\newcommand*\ciel@unstarred[1]{ciel #1 non étoilé} +\newcommand\ciel{\@ifstar{\ciel@starred}{\ciel@unstarred}} +\makeatother + +ainsi, \ciel{bleu} composera « ciel bleu non étoilé » tandis que +\ciel*{nocturne} composera « ciel nocturne étoilé ». + +Notez que les commandes intermédiaires \ciel@starred et +\ciel@unstarred comportent un @ dans leur nom ce qui est +possible puisque elles apparaissent au sein d’un bloc +\makeatletter...\makeatother. Ceci assure qu’elles ne puissent pas être +utilisées directement dans le document. L’utilisation de @ dans le nom +comporte certes un risque de collision avec une commande interne du noyeau +&latex;, mais une telle collision est facile à détecter et corriger car +\newcommand*{\cmd} vérifie que si la commande \cmd +n’est pas déjà définie et génère une erreur si c’est le cas. + +Voici un autre exemple, où la commande \agentsecret comporte deux +arguments, tandis que sa variante étoilée \agentsecret* n’en présente qu’un seul : + +\makeatletter +\newcommand*\agentsecret@starred[1]{\textsc{#1}} +\newcommand*\agentsecret@unstarred[2]{\textit{#1} \textsc{#2}} +\newcommand\agentsecret{\@ifstar{\agentsecret@starred} +                                        {\agentsecret@unstarred}} +\makeatother + +Avec cette définition, la célèbre réplique de l’agent 007 : + +Je m'appelle \agentsecret*{Bond}, \agentsecret{James}{Bond}. + +est équivalente à : + +Je m'appelle \textsc{Bond}, \textit{James} textsc{Bond}. + +Un dernier mot : +dans le nom d’une commande, l’étoile est comme une sorte d’argument optionnel. +Ceci est différent des noms d’environnement, où l’étoile fait partie +du nom lui-même, et peut donc être à n’importe quelle position ! +D’un point de vue purement &tex;nique il est donc possible de mettre un nombre indéfini +d’espaces entre la commande et l’étoile. Ainsi \agentsecret*{Bond} et +\agentsecret *{Bond} sont équivalents. Toutefois la pratique commune +est de ne jamais insérer de tels espaces. + - -<literal>\newcounter</literal> + +<literal>\newcounter</literal> : allouer un compteur \newcounter compteurs, définir de nouveaux Synopsis : -\newcounter{nomcompteur}[super] +\newcounter{nomcompteur} +\newcounter{nomcompteur}[super] La commande \newcounter définit un nouveau compteur nommé nomcompteur. Le nouveau compteur est initialisé à zéro. @@ -5491,50 +7419,57 @@ Le nouveau compteur est initialisé à zéro. nomcompteur est réinitialisé à chaque incrémentation du compteur nommé super. -Voir Counters, pour plus d’information à propos des compteurs. +See Counters, pour plus d’information à propos des compteurs. - -<literal>\newlength</literal> + +<literal>\newlength</literal> : allouer une longueur \newlength -longueurs, définir de nouvelles +longueurs, allouer de nouvelles +longueurs élastiques, définir de nouvelles +élastiques, définir de nouvelles longueurs +pas, registre de, &tex; de base +ressort, registre de, &tex; de base -Synopsis : +Alloue un nouveau registre de longueur. Synopsis : \newlength{\arg} -La commande \newlength définit l’argument obligatoire comme une -commande de longueur avec une valeur de 0mm. L’argument -doit être une séquence de contrôle, comme dans -\newlength{\foo}. Une erreur se produit si \foo est déjà -défini. +Cette commande prnedre un argument obligatoire qui doit commencer par +une contr’oblique (‘\’). Elle crée un nouveau registre de longueur +nommé \arg, ce qui constitue un emplacement où détenir des +longueurs (élastiques) telles que 1in plus.2in minus.1in (ce que +&tex; de base appelle un registre skip, ou regristre de +pas). Le registre est crée avec une valeur initiale de zéro. La séquence +de contrôle \arg doit ne pas être déjà définie. -Voir Lengths, pour comment régler la nouvelle longeur à une valeur non -nulle, et pour plus d’information à propos des longueurs en général. +See Lengths, pour plus d’information à propos des longueurs. - -<literal>\newsavebox</literal> + +<literal>\newsavebox</literal> : allouer une boîte + \newsavebox +boîte, allouer une nouvelle -Synopsis : +Alloue un « baquet » pour détenir une boîte. Synopsis : \newsavebox{\cmd} -Définit \cmd pour se référer à un nouveau bac pour stocker +Définit \cmd pour se référer à un nouveau baquet pour stocker des boîtes. Une telle boîte sert à détenir du matériel composé, pour -l’utiliser plusieurs fois (voir Boxes) ou pour le mesurer ou le +l’utiliser plusieurs fois (see Boxes) ou pour le mesurer ou le manipuler. Le nom \cmd doit commencer par une contr’oblique, et ne doit pas être déjà défini. L’allocation d’une boîte est globale. Cette commande est fragile -(voir \protect). +(see \protect). - + <literal>\newenvironment</literal> & <literal>\renewenvironment</literal> \newenvironment \renewenvironment @@ -5592,7 +7527,7 @@ utilisé avec des crochets à la suite, comme dans être suivi de crochet, alors, au sein de défdébut, le paramètre positionnel paramètre positionnel #1 se développe en la valeur par défaut, -c.-à-d. optargdefault. Dans les deux cas, le premier paramètre +c.-à-d. optargdéfaut. Dans les deux cas, le premier paramètre positionnel faisant référence à argument obligatoire est #2. Omettre [maval] dans l’appel est différent d’avoir des @@ -5648,7 +7583,7 @@ Dans le document, utilisez l’environnement comme ceci : Ce dernier exemple montre comment sauvegarder la valeur d’un argument pour l’utiliser dans déffin, dans ce cas dans une boîte -(voir \sbox). +(see \sbox). \newsavebox{\quoteauthor} \newenvironment{citequote}[1][Corneille]{% @@ -5661,7 +7596,7 @@ pour l’utiliser dans déffin, dans ce cas dans - + <literal>\newtheorem</literal> \newtheorem théorèmes, définition @@ -5702,9 +7637,9 @@ fois. Cette commande crée un compteur nommé name. De plus, à moins que l’argument optionnel numéroté_comme soit utilisé, la valeur courrante de \ref est celle de -\thenuméroté_au_sein_de (voir \ref). +\thenuméroté_au_sein_de (see \ref). -Cette déclaration est globale. Elle est fragile (voir \protect). +Cette déclaration est globale. Elle est fragile (see \protect). nom Le nom de l’environnement. Il ne doit pas commencer avec une @@ -5789,7 +7724,7 @@ utilise le même compteur que defn. Cela donne - + <literal>\newfont</literal>: définit une nouvelle police (obsolète) \newfont polices, commandes pour déclarer de nouvelles @@ -5816,7 +7751,7 @@ exemple, d’associer un gras et un romain) au travers de ce qu’il est convenu de nommer le « Nouveau Plan de Sélection de Polices de caractère », soit en utilisant des fichier .fd ou à travers l’utilisation d’un moteur qui sait accéder au système de polices de -caractère, tel que Xe&latex; (voir Les moteurs +caractère, tel que Xe&latex; (see Les moteurs &tex;). @@ -5842,7 +7777,7 @@ caractères dans chacune d’elles : - + <literal>\protect</literal> \protect @@ -5868,11 +7803,11 @@ comme la table des matières. On appelle argument mouvant tout argument qui est développé en interne par &latex; sans être directement composé en sortie. Une commande est dite fragile si elle se développe pendant ce processus en un code &tex; non -valide. Certains exemples d’arguments mouvants sont ceut qui apparaissent -au sein des commande \caption{...} (voir figure), dans la -commande \thanks{...} (voir \maketitle), et dans les +valide. Certains exemples d’arguments mouvants sont ceux qui apparaissent +au sein des commandes \caption{...} (see figure), dans la +commande \thanks{...} (see \maketitle), et dans les expression en @ des environnements tabular et array -(voir tabular). +(see tabular). Si vous obtenez des erreurs étranges de commandes utilisées au sein d’arguments mouvants, essayez des les précéder d’un \protect. Il @@ -5896,7 +7831,7 @@ mystérieuse Dans l’exemple suivant la commande \tableofcontents produit une erreur à cause du \(..\) dans le titre de section qui se développe en code incorrect &tex; dans le fichier .toc. Vous -pouvez résoudre ceci en remplaçat \(..\) +pouvez résoudre ceci en remplaçant \(..\) par \protect\(..\protect\). \begin{document} @@ -5997,12 +7932,29 @@ pour numéroter les articles de la liste. \value{compteur} -La commande \value produit la valeur de compteur. Ça peut -être utilisé partout là où &latex; attend un nombre, par exemple : +Cette commande se développe en la valeur de compteur. Elle est +souvent utilisé dans \setcounter ou \addtocoutner, mais +\value peut être utilisé partout là où &latex; attend un +nombre. Elle ne doit pas être précédée par \protect +(see \protect). + +La commande \value n’est pas utiliser pour composer la valeur du +compteur. See \alph \Alph \arabic \roman \Roman \fnsymbol. + +Cet exemple produit en sortie ‘Le compteur essai vaut 6. Le +compteur autre vaut 5’. + +\newcounter{essai} \setcounter{essai}{5} +\newcounter{autre} \setcounter{autre}{\value{essai}} +\addtocounter{essai}{1} + +Le comppteur essai vaut \arabic{essai}. +Le compteur autre vaut \arabic{autre}. + +Cet exemple insère \hspace{4\parindent}. -\setcounter{moncompteur}{3} -\addtocounter{moncompteur}{1} -\hspace{\value{moncompteur}\parindent} +\setcounter{moncptr}{3} \addtocounter{moncptr}{1} +\hspace{\value{moncptr}\parindent} @@ -6035,7 +7987,7 @@ quantité spécifiée par l’argument valeur, qu \refstepcounter La commande \refstepcounter fonctionne de la même façon que -\stepcounter Voir \stepcounter, à ceci près qu’elle définit +\stepcounter See \stepcounter, à ceci près qu’elle définit également la valeur courante de \ref comme le résultat de \thecounter. @@ -6063,7 +8015,7 @@ re-initialise tous les compteurs subsidiaires. pas remis à jour pendant que le traitement par &tex; progresse. En relation avec ces compteurs, la commande \today produit une -chaîne représentant le jour courant (voir \today). +chaîne représentant le jour courant (see \today). @@ -6072,10 +8024,118 @@ chaîne représentant le jour courant (voir \todayLongueurs longueurs, définir et utiliser -longueur -Une longeur est une mesure de distance. Beaucoup de commandes +Une longueur est une mesure de distance. Beaucoup de commandes &latex; prennent une longueur en argument. +rigides, longueurs +élastiques, longueurs +dimen &tex; de base +skip &tex; de base +glue &tex; de base +Il y a deux types de longueur. Une longueur rigide telle que +10pt ne contient pas de composante en plus ou +minus. (En &tex; de base on appelle cela une dimen). +Une longueur élastique (ce qu’en &tex; de base on appel un +skip ou une glue) telle que dans 1cm plus0.05cm +minus0.01cm peut contenir l’un ou l’autre de ces composantes ou les +deux. Dans cette longueur élastique, le 1cm est la longueur +naturelle alors que les deux autres, les composantes en plus et +minus, permette à &tex; à dilater ou contracter la longueur pour +optimiser la disposition. + +Les exemples qui suivent utilisent ces deux commandes. + +% Fait une barre noire de 10pt de haut et #1 de large +\newcommand{\blackbar}[1]{\rule{#1}{10pt}} + +% Fait une boîte autour de #2 qui est #1 de large (sans la bordure) +\newcommand{\showhbox}[2]{% + \fboxsep=0pt\fbox{\hbox to #1{#2}}} + +Cet exemple utilise ces commandes pour afficher une barre noire de +100 points de long entre ‘XXX’ et ‘YYY’. Cette longueur est +rigide. + +XXX\showhbox{100pt}{\blackbar{100pt}}YYY + +Quant au longueur élastiques, la contraction est le plus simple des +deux : avec 1cm minus 0.05cm, la longueur naturelle est 1cm +mais &tex; peut la contracter jusqu’à 0,95cm. &tex; refuse de +contracter plus que cela. Ainsi, ci-dessous le premier \showhbox +fonctionne bien, un espace de 98 points étant produit entre les deux +barres. + +XXX\showhbox{300pt}{% + \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY + +XXX\showhbox{300pt}{% + \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY + +Mais le second produit un avertissement du genre de ‘Overfull +\hbox (1.0pt too wide) detected at line 17’. En sortie le premier +‘Y’ est écrasé par la fin de la barre noire, parce que la matière +contenue par la boîte est plus large que les 300pt alloués, et que +&tex; a refusé de contracter le total en deçà de 309 points. + +Dilater est similaire à contracter, à ceci près que si &tex; doit +dilater plus que la quantité disponible, alors il le fait. Ci-dessous +la première ligne fonctionne bien, et produit un espace de 110 points +entre les barres. + +XXX\showhbox{300pt}{% + \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY + +XXX\showhbox{300pt}{% + \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY + +Dans la seconde ligne &tex; a besoin de dilater de 10 points alors que +seulement 1 point a été spécifié. &tex; dilate l’espace jusqu’à la +longueur requise mais il produit un avertissement du genre de +‘Underfull \hbox (badness 10000) detected at line 22’. (On ne +discute pas ici de ce que signifie « badness »). + +Il est possible de mettre à la fois de la dilatation et de la +contraction dans la même longueur, comme dans 1ex plus 0.05ex +minus 0.02ex. + +Si &tex; ajuste plus d’une longueur élastique alors il alloue la +dilatation ou la contraction proportionnellement. + +XXX\showhbox{300pt}{% + \blackbar{100pt}% gauche + \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% milieu + \blackbar{100pt}}YYY % droite + +Les barres de gauche et de droite prennent 100 points, de sorte que celle +du milieu a besoin également de 100. La barre du milieu fait 80 points +et donc les deux \hspace doivent se dilater de 20 points. +Comme les deux sont plus 50pt et plus 10pt, &tex; obtient +5/6 de la dilatation du premier espace et 1/6 du second. + +La composante plus ou minus d’une longueur élastique peut +contenir un composante en fill, comme dans 1in plus2fill. +Cela donne à la longueur une dilatabilité ou contractabilité infinie de +sorte que &tex; puisse l’ajuster à n’importe quelle distance. Dans +l’exemple suivant les deux figures sont également espacées +horizontalement sur la page. + +\begin{minipage}{\linewidth} + \hspace{0pt plus 1fill}\includegraphics{godel.png}% + \hspace{0pt plus 1fill}\includegraphics{einstein.png}% + \hspace{0pt plus 1fill} +\end{minipage} + +&tex; en réalité a trois niveaux d’infinité pour les composantes +élastiques : fil, fill, et filll dans l’ordre +d’infinité croissante. D’ordinaire les auteurs de documents n’utilisent +que celle du milieu (see \hfill et see \vfill). + +Multiplier une longueur élastique par un nombre la transforme en une +longueur rigide, de sorte qu’après \setlength{\ylength}{2.5cm +plus 0.5cm} et \setlength{\zlength}{3\ylength} alors la +valeur de \zlength est 2.5cm. + + Unités de longueur @@ -6159,7 +8219,7 @@ points. En mode mathématique, beaucoup de définitions sont exprimées dans l’unité mathématique mu donnée par 1em = 18mu, où le em est pris de la famille courante des symboles mathématiques. -Voir Spacing in math mode. +See Spacing in math mode. @@ -6252,7 +8312,7 @@ longueur \longueur à la largeur \totalheight Ces paramètres de longueur peuvent être utilisés au sein des arguments -des commandes de fabrication de boîte (voir Boxes). Il spécifient la +des commandes de fabrication de boîte (see Boxes). Il spécifient la largeur naturelle, etc., du texte dans la boîte. \totalheight vaut \height + \depth. Pour frabriquer une boîte dont le texte @@ -6316,8 +8376,8 @@ supprimé. - -<literal>\parskip</literal> + +<literal>\parindent</literal> & <literal>\parskip</literal> \parskip espace vertical avant les paragraphes @@ -6401,10 +8461,13 @@ les notes de déborder hors du bas de la page. mode mathématique, entrer environnement math math, environnement + environnement displaymath displaymath, environnement + environnement equation equation, environnement + Il y a trois environnements qui mettent &latex; en mode mathématique : math @@ -6458,9 +8521,9 @@ dessus et en dessous le signe de sommation. Par exemple Indices inférieurs & supérieurs indice supérieur indice inférieur +^ indice supérieur +_ indice inférieur exposant -_ -^ En mode mathématique, utilisez le caractère caret ^ pour qu’une expression exp apparaisse en indice supérieur, c.-à-d. tapez @@ -6521,7 +8584,6 @@ le mode, voir \ensuremath. - \|\| ∥ Parallèle (relation). Synonyme : \parallel. @@ -7524,7 +9586,7 @@ police romaine et avec l’espacement adéquat. &latex; fournit diverse commandes pour produire des lettres accentuées en math. Elles diffèrent de celles concernant les accents en texte normal -(voir Accents). +(see Accents). \acute\acute accent aigu en math @@ -7612,7 +9674,7 @@ normales pour les textes mathématiques. En mode mathématique, beaucoup de définitions sont exprimées dans l’unité mathématique mu donnée par 1 em = 18 mu, où le em est pris -de la famille courante des symboles mathématiques (voir Units of length). +de la famille courante des symboles mathématiques (see Units of length). \; thickspace @@ -7634,7 +9696,7 @@ de la famille courante des symboles mathématiques (voir \, \thinspace Normalement 3mu. Le nom long est \thinspace. Utilisable à -la fois en mode mathématique et en mode texte. Voir \thinspace. +la fois en mode mathématique et en mode texte. See \thinspace. \! \! @@ -8007,7 +10069,7 @@ change en style pour la page courante seulement. Une autre commande produisant de l’espace est \, pour produire une espace « fine » (d’habitude 1/6quad). Elle peut être utilisée en -mode texte, mais est le plus souvent utile en mode math (voir Espacement en mode mathématique). +mode texte, mais est le plus souvent utile en mode math (see Espacement en mode mathématique). @@ -8022,7 +10084,7 @@ mode texte, mais est le plus souvent utile en mode math (voir \frenchspacing). &latex; suppose que le point finit une phrase +(see \frenchspacing). &latex; suppose que le point finit une phrase à moins qu’il soit précédé d’une lettre capitale, dans quel cas il considère que ce point fait partie d’une abréviation. Il est à noter que si un point final de phrase est immédiatement suivit d’une parenthèse ou @@ -8075,7 +10137,7 @@ contr’oblique-espace (\ ), où d’un tilde (Nat.\ Acad.\ Science, et Mr.~Bean, et (du fumier, etc.)\ à vendre. -Pour une autre utilisation de \ , voir \ après une séquence de contrôle. +Pour une autre utilisation de \ , see \ après une séquence de contrôle. Dans la situation opposée, si vous avez une lettre capitale suivi d’un point qui finit la phrase, alors placez \@ avant ce point. Par ex., @@ -8108,6 +10170,7 @@ d’un signe de ponctuation. Comparez : paquetage xspace xspace, paquetage + Certaines commandes, notamment celles définies avec le paquetage xspace, ne suivent pas ce comportement standard. @@ -8137,7 +10200,7 @@ la même façon. <literal>\thinspace</literal> \thinspace -\thinspace produit une espace insécable et non-elastique qui vaut +\thinspace produit une espace insécable et non-élastique qui vaut 1/6 d’em. C’est l’espace adéquate entre des guillemets anglais simples emboîtés, comme dans ’”. @@ -8166,7 +10229,7 @@ avec f: f;. Lorsque on change de fontes avec des commandes telles que \textit{italic text} ou {\itshape italic text}, &latex; insère automatiquement une correction italique appropriée si -nécessaire (voir Font styles). +nécessaire (see Font styles). Malgré leur nom, les caractères romains peuvent aussi avoir une correction italique. Comparez : @@ -8183,7 +10246,7 @@ l’espacement y est fait d’une façon différente. \hrulefill \dotfill -Produit une longueur elastique infinie (voir Lengths) remplie avec un +Produit une longueur élastique infinie (see Lengths) remplie avec un filled filet horizontal (c.-à-d. une ligne) ou avec des pointillés, au lieu de just de l’espace blanche. @@ -8216,7 +10279,7 @@ défaut de 0.33em à 1.00em. \addvspace{length} Ajoute un espace vertical de longeur length, ce qui est une -longueur élatsique (voir Lengths). Toutefois, si l’espace vertical a +longueur élatsique (see Lengths). Toutefois, si l’espace vertical a déjà été ajouté au même point de la sortie par une commande \addvspace précédente, alors cette commande n’ajoutera pas plus d’espace que nécessaire à fabriquer la longeur naturelle de l’espace @@ -8228,7 +10291,7 @@ exemple, un environnement Theorem est défini pour commencer et finir en \addvspace{..} de sorte que deux Theorem consécutifs sont séparés par un espace vertical, et non deux.) -Cette commande est fragile (voir \protect). +Cette commande est fragile (see \protect). L’erreur ‘Something's wrong--perhaps a missing \item’ signifie que vous n’étiez pas en mode vertical quand vous avez invoqué cette @@ -8273,15 +10336,15 @@ rétrécissement (la valeur par défaut pour les classes book dilatation verticale infinie verticale infinie, dilatation -Finit le paragraphe courante et insère une longueur elastique verticale -(voir Lengths) qui est infinie, de sorte qu’elle puisse se dilater ou -that is se rétrécire autant que nécessaire. +Finit le paragraphe courant et insère une longueur élastique verticale +(see Lengths) qui est infinie, de sorte qu’elle puisse se dilater ou +se rétrécir autant que nécessaire. On l’utilise souvent de la même façon que \vspace{\fill}, à ceci près que \vfill finit le paragraphe courant, tandis que -\vspace{\fill} ajoute une espace verticale infinin sous sa +\vspace{\fill} ajoute un espace vertical infini sous sa ligne sans tenir compte de la structure du paragraphe. Dans les deux -cas cette espace disparaît à la fin de la page ; pour éviter cela +cas cet espace disparaît à la fin de la page ; pour éviter cela voir \vspace. Dans l’exemple qui suit la page est remplie, de sorte que les lignes en @@ -8310,7 +10373,7 @@ Chien perdu ! \vspace*{longueur} Ajout l’espace verticale longueur. Celle-ci peut-être négative ou positive, -et c’est une longueur élastique (voir Lengths). +et c’est une longueur élastique (see Lengths). &latex; enlève l’espace verticale provenant de \vspace aux sauts de page, c.-à-d. au sommet et au bas des pages. La version étoilée @@ -8339,7 +10402,7 @@ chacune d’elle. Boîtes boîtes -Tous les paramètres de longueurs prédéfinies (voir Predefined lengths) +Tous les paramètres de longueurs prédéfinies (see Predefined lengths) peuvent être utilisés au sein des arguments des commandes de fabrication de boîtes. @@ -8383,7 +10446,7 @@ la largeur de la boîte avec l’argument optionnel largeur.4pt’), et laisse un espace de \fboxsep (valant par défaut ‘3pt’) entre le filet et le contenu de la boîte. -Voir \framebox (picture), pour la commande \framebox dans +See \framebox (picture), pour la commande \framebox dans l’environnement picture. @@ -8431,62 +10494,72 @@ texte au sein de la boîte est determinée par l’argument optionnel contenir de l’espace dilatable pour que cela marche. \makebox est aussi utilisé au sein de l’environnement picture, -voir \makebox (picture). +see \makebox (picture). <literal>\parbox</literal> \parbox +paragraphe, mode +paragraphe, dans une boîte -Synopsis : + +Synopsis, l’un parmi les suivants : -\parbox[position][hauteur][pos-interne]{largeur}{texte} +\parbox{largeur}{contenu} +\parbox[position]{largeur}{contenu} +\parbox[position][hauteur]{largeur}{contenu} +\parbox[position][hauteur][pos-interne]{largeur}{contenu} mode paragraphe paragraphe, mode -La commande \parbox produit une boîte dont le contenu est créé en -mode paragraphe. On devrait l’utiliser pour fabriquer une boîte à -partir de petits moreaux de texte, avec rien de trop élaboré à -l’intérieur. En particulier, vous ne devriez utiliser aucun -environnement de fabrication de paragraphe au sein de l’argument -texte d’une \parbox. Pour des morceaux de texte de plus -grande taille, y compris ceux comprenant un environnement de -fabrication de paragraphe, vous devriez utiliser un environnement -minipage (voir minipage). - -\parbox a deux arguments obligatoires : - -largeur -la largeur de la parbox; -texte -le texte qui à mettre dans la parbox. - -Par défault &latex; positionne verticallement un parbox de sorte que -son centre soit aligné avec le centre de la ligne de texte -alentour. Lorsque l’argument optionnel position est présent et -vaut soit ‘t’ soit ‘b’, cela vous permet respectivement -d’aligner soit la ligne du haut, soit la ligne du bas de la parbox avec -la ligne de base du texte alentour. Il est possible de spécifier -position à ‘m’ pour avoir le comportement par défaut. +La commande \parbox produit une boîte de texte de largeur +largeur. Cette commande peut être utilisée pour fabriquer une +boîte à partir de petits morceaux de texte, et contenant un seul +paragraphe. Cette commande est fragile (see \protect). -L’argument optionnel hauteur l’emporte sur la hauteur naturelle de la -boîte. - -L’argument pos-interne contrôle la position du texte au sein de la -boîte, comme suit ; s’il n’est pas spécifié, position est utilisé. +\begin{picture}(0,0) + ... + \put(1,2){\parbox{4.5cm}{\raggedright Le graphique étant une + droite sur une échelle logarithmique, la relation est + exponentielle.}} +\end{picture} + +Le contenu est taité en mode texte (see Modes) ainsi +&latex; fait des sauts de ligne de sorte à former un paragraphe. Mais +il ne fabriquera pas plusieurs paragraphes ; pour cela, utilisez un +environnement minipage (see minipage). + +Les options d’une \parbox (à l’exception du contenu) sont +les mêmes que pour une minipage. Par commodité on rappelle ces +options ici plus bas, mais se référer à minipage pour une +description complète. + +Il y a deux arguments obligatoires. La largeur est une longueur +rigide (see Lengths). Elle règle la largeur de la boîte dans +laquelle &latex; compose le contenu. Le contenu est le +texte qui est placé dans cette boîte. Il ne devrait pas avoir de +composants qui fabriquent des paragraphes. + +Il y a trois arguments optionnels, position, hauteur, et +pos-interne. La position donne l’alignement vertical de la +parbox relativement au texte alentour. La valeurs prises en charge +sont c ou m pour que le centre selon la dimension +verticale de la parbox soit aligné avec le centre de la ligne de texte +adjacente (c’est le réglage par défaut), ou t pour s’accorder la +ligne du haut de la parbox avec la ligne de base du texte alentour, ou +b pour accorder la ligne du bas. + +L’argument optionnel hauteur l’emporte sur la hauteur naturelle de +la boîte. + +L’argument optionnel pos-interne contrôle la position du +contenu au sein de la parbox. Les valeurs possibles sont : +t pour le centrer verticalement, b pour le place en bas de +la boîte, et s pour le dilater verticalement (pour cela, le texte +doit contenir de l’espace vertical eslastique). -t -le texte est placé en haut de la boîte. -c -le texte est centré dans la boîte. -b -le texte est placé en bas de la boîte. -s -dilatation (stretch) verticale ; le texte doit contenir de l’espaces -dilatable verticalement pour que cela fonctionne. - - <literal>\raisebox</literal> @@ -8518,10 +10591,10 @@ profondeur naturelles. \savebox{\boxcmd}[largeur][pos]{texte} Cette commande compose texte dans une boîte de la même façon -qu’avec \makebox (voir \makebox), à ceci près qu’au lieu +qu’avec \makebox (see \makebox), à ceci près qu’au lieu d’imprimer la boîte résultante, elle la sauvegarde dans une boîte étiquettée \boxcmd, ce qui doit avoir été déclaré avec -\newsavebox (voir \newsavebox). +\newsavebox (see \newsavebox). @@ -8534,10 +10607,10 @@ d’imprimer la boîte résultante, elle la sauvegarde dans une boîte \sbox{\boxcmd}{texte} \sbox tape texte au sein d’une boîte tout comme \mbox -(voir \mbox) à ceci près qu’au lieu que la boîte résultante soit +(see \mbox) à ceci près qu’au lieu que la boîte résultante soit incluse dans la sortie normale, elle est sauvegardée dans la boîte étiquetée \boxcmd. \boxcmd doit avoir été préalablement -déclarée avec \newsavebox (voir \newsavebox). +déclarée avec \newsavebox (see \newsavebox). @@ -8550,107 +10623,1396 @@ déclarée avec \newsavebox (voir \savebox). +bac \boxcmd par une commande \savebox (see \savebox). - - -Insertions spéciales + +Couleur -&latex; fournit des commandes pour insérer les caractères qui ont une -signification spéciale mais ne correspondent à aucun caractère simple -que vous pouvez taper. +couleur + +Vous pouvez colorer du texte, des filets, etc. Vous pouvez également +colorer l’intérieur d’une boîte ou une page entière et écrire du texte +par dessus. + +La prise en charge des couleurs se fait via un paquetage +supplementaire. Aussi, toutes les commandes qui suivent ne fonctionnent +que si le préambule de votre document contient +\usepackage{color}, qui fournit le paquetage standard. + +Beaucoup d’autres paquetages complémentent également les possibilité de +&latex; en matière de couleurs. Notamment xcolor est largement +utilisé et étend significativement les possibilités décrites ici, y +compris par l’ajout des modèles de couleur ‘HTML’ et ‘Hsb’. - -Caractères réservés -caractères réservés -réservés, caractères -caractères spéciaux -spéciaux, caractères + +Options du paquetage <literal>color</literal> +color options du paquetage +options, paquetage color -&latex; réserve les caractères suivant à un usage spécial (par exemple, -le signe pourcent % sert aux commentaires) c’est pourquoi on les -appelle caractères réservés ou caractères spéciaux. +Synopsis (à mettre dans le préambule du document) : -# $ % & { } _ ~ ^ \ +\usepackage[liste d'option séparées par des virgules]{color} -\# -\$ -\% -\& -\_ -\{ -\} -Si vous voulez qu’un caractère réservés soit imprimé comme lui-même, -dans la même police que le corps du texte, alors pour tous les -caractères hormis les trois derniers de cette liste il suffit de les -faire précéder d’une contr’oblique \. Ainsi \$1.23 -produit $1.23 en sortie. +Quand vous chargez le paquetage color il y a deux types d’options +disponbiles. -\~ -\^ -\textbackslash -Quant aux trois derniers caractères, pour faire un tilde dans la police -du corps du texte utilisez \~{} (sans les accolades cela -mettrait un accent tilde sur le caractère suivant). De même pour faire -un accent circonflexe dans la police du corps du texte utilisez -\^{}. Une contr’oblique dans la police du corps de texte se -fait avec \textbackslash{}. +Le premier spécifie le pilote d’impression. &latex; ne contient +pas d’information sur les diférents système de sortie, mais au lieu de +cela dépend de l’information stockée dans un fichier. Normalement vous +ne devriez pas spécifier les options de pilote dans le document, mais au +lieu de cela vous vous reposez sur les valeurs par défaut de votre +système. Un avantage de procéder ainsi est que cela rend votre document +portable entre systèmes. Pour être complet nous incluons une liste des +pilotes. Ceux présentement pertinents sont : dvipdfmx, +dvips, dvisvgm, luatex, pdftex, +xetex. Les deux pilotes xdvi et oztex sont pour +l’essentiel des alias de dvips (et xdvi est monochrome). +Ceux qui ne devraient pas être utilisés pour de nouveaux systèmes récent +sont : dvipdf, dvipdfm, dviwin, dvipsone, +emtex, pctexps, pctexwin, pctexhp, +pctex32, truetex, tcidvi, vtex (et +dviwindo est un alias de dvipsone). -Pour produire les caractères réservé dans la police d’une machine à écrire utilisez -\verb!! comme ci-dessous : +Les options du second type, autres que les pilotes, sont listées ci-dessous. -\begin{center} - \# \$ \% \& \{ \} \_ \~{} \^{} \textbackslash \\ - \verb!# $ % & { } _ ~ ^ \! -\end{center} - -Dans cet exemple la double contr’oblique \\ n’est là que pour -sauter à la ligne. + +monochrome +Désactive les commande de couleur, de sorte qu’elles ne produisent pas +d’erreur, mais ne produisent pas non plus de couleurs. +dvipsnames +Rend disponible une liste de 68 noms de couleur qui sont d’usage +fréquent, en particulier dans des documents qui ne sont pas modernes. +Ces noms de couelurs étaient à l’origine fournis par le pilote +dvips, d’où le nom de l’option. + +nodvipsnames +Ne charge pas cette liste de noms de couleur, faisant faire à &latex; +une toute petite économie d’espace mémoire. + + - -Symboles appelés par leur position dans une police + +Modèles de couleur + +modèles de couleur + +Un modèle de couleur est une façon de représenter les couleurs. +Les possibilité de &latex; dépendent du pilote d’impression. Toutefois, +les pilotes pdftex, xetex, et luatex sont de nos +jours de loin les plus largement utilisés. Les modèles ci-après +fonctionnent pour ces pilotes. À une exception près ils sont également +pris en charge par tous les autre pilotes d’impression utilisés +aujourd’hui. + +Il est à noter qu’une combinaison de couleur peut être additive, ou +soustractive. Les combinaisons additives mélangent les couleurs de la +lumière, de sorte que par exemple combiner des instensités pleines de +rouge, vert et bleu produit du blanc. Les combinaisons soustractives +mélangent les pigments, tels que les encres, de sorte que combiner des +intensités pleine de cyan, magenta et jaune produit du noir. + +cmyk +Un liste séparée de virgule avec quatre nombres réel compris entre 0 et +1 inclus. Le premier nombre est l’intensité du cyan, le deuxième celle +du magenta, et les autres celle du jaune et du noir. Un valeur du +nombre de 0 signifie l’intensité minimale, alors que 1 correspond à +l’intensité pleine. Ce modèle est fréquemment utilisé pour l’impression +de couleur. C’est un modèle soustractif. + +gray +Un unique nombre réèl compris entre 0 et 1 inclus. Les couleurs sont +des nuances de gris. Le nombre 0 produit du noir, alors que le 1 donne +du blanc. +rgb +Une liste séparée de virgules avec trois nombres réèls compris entre 0 +et 1, inclusive. Le premier nombre est l’intensité de la composante +rouge, la deuxième correspond au vert, et la troisière au bleu. Une +valeur de 0 donnée au nombre signifie qu’en rien cette composante n’est +ajouté à la couleur, alors que 1 signifie que cela est fait à pleine +intensité. C’est un modèle additif. + +RGB +(pilotes pdftex, xetex, luatex) Une liste séparée +par des vidugles avec trois entiers compris entre 0 et 255 inclus. Ce +modèle est une commodité pour utiliser rgb étant donnée qu’en +dehors de &latex; les couleurs sont souvent décrites dans un modèle +rouge-vert-bleu utilisant des nombres dans cette plage. Les valeurs +entrées sont converties vers le modèle rgb en divisant par 255. + +named +On accède au couleur par des noms tels que ‘PrussianBlue’. La +liste des noms dépend du pilote, mais tous prennennt en charge les noms +‘black’, ‘blue’, ‘cyan’, ‘green’, ‘magenta’, +‘red’, ‘white’, et ‘yellow’ (Voir l’option +dvipsnames dans Color package options). + + -\symbol -accéder à un caractère quelconque d’une police -symboles d’une police, par leur numéro -police, symboles par leur numéro + + +Commandes pour <literal>color</literal> -Vous pouvez accéder à n’importe quel caractère de la police courante en -utilisant son numéro avec la commande \symbol. Par exemple, le -caractère espace visible utilisé dans la commande \verb* a le -code décimal 32, ainsi on peut le taper avec \symbol{32}. - -Vous pouvez également spécifier le numéro en octal (base 8) en utilisant -un préfixe ', ou en hexadécimal (base 16) avec un préfixe -", ainsi l’exemple précédent pourrait tout aussi bien être écrit -comme \symbol{'40} ou \symbol{"20}. +color, commandes du paquetage + +Voici les commandes disponibles avec le paquetage color. - - -Symboles en texte -symboles texte -textcomp, paquetage -&latex; fournit des commandes pour générer divers symboles qui ne sont -pas des lettres dans le cours sein du texte. Certaines d’entre elles, -en particulier les plus obscures, ne sont pas disponible en OT1 ; il se -peut que vous deviez charger le paquetage textcomp. + +Definir des couleurs + +couleur +définir une couleur +couleur, définir + +Synopsis : - -\copyright\copyright -\textcopyright\textcopyright -droit d’auteur, symbole -symbole droit d’auteur -Le symbole « droit d’auteur », ©. +\definecolor{nom}{model}{spécification} + +Donne le nom nom à la couleur. Par exemple, après +\definecolor{silver}{rgb}{0.75,0.75,0.74} vous pouvez +utiliser cette couleur avec Hé ho, +\textcolor{silver}{Silver}~!. -\dag\dag +Cet exemple donne à la couleur un nom plus abstrait, de sort qu’on +puisse la changer sans que cela prête à confusion. + +\definecolor{logocolor}{RGB}{145,92,131} % RGB nécessite pdflatex +\newcommand{\logo}{\textcolor{logocolor}{Les Brioches de Robert}} + +Il est fréquent que les couleurs d’un document soient définies dans son +préambule, ou dans sa classe + +ou style, plutôt que dans le corps du document. + + + +Mettre du texte en couleur + +couleur +coloré, texte +texte en couleur + +Synopsis : + +\textcolor{nom}{...} +\textcolor[modèle de couleur]{spécification de couleur}{...} + +ou + +\color{nom} +\color[modèle de couleur]{spécification} + +Le texte affecté prend la couleur correspondante. La ligne suivante + +\textcolor{magenta}{Je suis Ozymandias, roi des rois~:} Voyez mon œuvre, ô puissants, et desespérez~! + +met la première moitié en magenta alors que le reste est en noir. Vous +pouvez utiliser une couleur déclarée avec \definecolor exactement +de la même façon dont nous venons d’utiliser la couleur prédéfinie +‘magenta’. + +\definecolor{CriseDeLaQuarantaine}{rgb}{1.0,0.11,0.0} +Je considère l'idée de m'acheter une \textcolor{CriseDeLaQuarantaine}{voiture de sport}. + +Les deux formes de commandes \textcolor et \color +diffèrent en ce que la première forme prend le texte à colorer en +argument. Ceci est souvent plus commode, ou tout du moins plus +explicite. La seconde forme est une déclaration, comme dans La +lune est composé de fromage {\color{vert}}, de sorte qu’elle est en +vigueur jusqu’à la fin du groupe ou de l’environnement courant. Ceci +est parfois utile quand on écrit des macros, ou comme ci-dessous où on +colore tout le contenu de l’environnement center, y compris les +lignes verticales et horizontales. + +\begin{center} \color{blue} + \begin{tabular}{l|r} + HG &HD \\ \hline + BG &BD + \end{tabular} +\end{center} + +Vous pouvez utiliser des couleurs dans les équations. Un document peut +avoir \definecolor{couleurvedette}{RGB}{225,15,0} dans le +préambule, et ensuite contenir cette équation : + +\begin{equation} + \int_a^b \textcolor{couleurvedette}{f'(x)}\,dx=f(b)-f(a) +\end{equation} + +Typiquement les couleurs utilisées dans un document sont déclarée dans +une classe ou dans un style mais il arrive qu’on désire fonctionner au +coup par coup. C’est le cas d’usage des secondes forme du synopsis. + +Des couleurs de \textcolor[rgb]{0.33,0.14,0.47}{violet} et {\color[rgb]{0.72,0.60,0.37}doré} pour l'équipe + +Le format de spécification de couleur dépend du modèle de couleur +(see Color models). Par exemple, alors que rgb prend trois +nombbres, gray n’en prend qu’un. + +La sélection a été \textcolor[gray]{0.5}{grisée}. + +Des couleurs au sein d’autres couleurs ne se combinent pas. Ainsi + +\textcolor{green}{une sorte de \textcolor{blue}{bleu}} + +se termine par un mot en bleu, et non pas dans une combinaison de bleu +et de vert. + + + + + + +Faire des boîtes en couleur + +couleur +colorées, boîtes +boîtes colorées + +Synopsis : + +\colorbox{nom}{...} +\colorbox[nom modèle]{spécification couleur arrière-plan boîte}{...} + +ou + +\fcolorbox{couleur cadre}{couleur arrière-plan boîte}{...} +\fcolorbox[nom modèle]{spécification couleur cadre}{spécification arrière-plan boîte}{...} + +Fabrique une boite avec la couleur d’arrière-plan indiquée. La commande \fcolorbox +place un cadre autour de la boîte. Par exemple ceci : + +Nom~:~\colorbox{cyan}{\makebox[5cm][l]{\strut}} + +fabrique une boîte de couleur cyanqui fait cinqu centimètres de long et +dont la profondeur et la hauteur sont déterminées par le \strut +(de sorte que la profondeur est -.3\baselineskip et la hauteur +est \baselineskip). Ceci met un texte blanc sur un arrière plan +bleu : + +\colorbox{blue}{\textcolor{white}{Welcome to the machine.}} + +La commande \fcolorbox utilise les mêmes paramètres que +\fbox (see \fbox and \framebox), à savoir \fboxrule et +\fboxsep, pour régler l’épaisseur du filet et de la séparation +entre l’intérieur de la boîte et le filet l’entourant. Les valeurs par +défaut de &latex; sont 0.4pt et 3pt respectivement. + +L’exemple suivant change l’épaisseur de la bordure en 0,8 points. +Notez qu’il est entre accolades de sorte que le changement cesse d’être +en vigueur à la fin de la seconde ligne. + +{\setlength{\fboxrule}{0.8pt} +\fcolorbox{black}{red}{En aucun cas ne tournez cette poignée.}} + + + +Faire des pages en couleur + +couleur +colorée, page +page colorée +arrière-plan coloré + +Synopsis : + +\pagecolor{nom} +\pagecolor[modèle de couleur]{spécification de couleur} +\nopagecolor + +Les deux premières commandes règlent l’arrière-plan de la page, et de +toutes les pages suivantes, à la couleur indiquée. Pour une explication +de la spécification dans la seconde forme see Colored text. La +troisième fait revenir l’arrière-plan à la normale, c-à-d. un +arrière-plan transparent. (Si cela n’est pas pris en charge, alors +utilisez \pagecolor{white}, bien que cela produit un +arrière-plan blanc au lieu de l’arrière-plan transparent par défaut.) + + ... +\pagecolor{cyan} + ... +\nopagecolor + + + + + + +Graphiques + +graphiques +graphics, paquetage + +Vous pouvez utiliser des graphiques tel que des fichier PNG ou PDF dans +vos documents &latex;. Vous aurez besoin d’un paquetage supplémentaire +standard de &latex;. Cet exemple montre en bref comment : + +\include{graphicx} % dans le préambule + ... +\includegraphics[width=0.5\linewidth]{graphique.pdf} + +Pour utiliser les commandes décrite ici, le préambule de votre document +doit contenir soit \usepackage{graphicx}, soit +\usepackage{graphics}. (Le plus souvent, c’est graphicx +qui est préférable.) + +Les graphiques peuvent être de deux types, matriciels ou vectoriels. +&latex; peut utiliser les deux. Dans les graphiques matriciels le +fichier comprend pour chaque position dans un tableau une entrée +décrivant la couleur de celle-ci. Un exemple de ceci est une +photograpgie en format JPG. Dans une graphique vectoriel, le fichier +contient une liste d’instructions telles que ‘dessin un cercle avec +tel rayon et tel centre’. Un exemple de ceci est le dessin d’une ligne +produit par le programme Asymptote en format PDF. En général les +graphiques vectoriel sont plus utiles car on peut les redimensionner +sans pixélisation ou autres problèmes, et parce que la plupart du temps +ils ont une taille plus petites. + +Il y a des systèmes particulièrement bien adapté pour produire des +graphiques pour un document &latex;. Par exemple, qui vous permettent +d’utiliser les mêmes polices que dans votre document. &latex; comprend +un environnement picture (see picture) qui a des possibilités +de base. En plus de cela, il y a d’autres façons d’inclure des +commandes de production de graphiques dans le document. Deux systèmes +pour cela sont les paquetages PSTricks et TikZ. Il y a aussi des +systèmes externe à &latex; qui génèrent un graphique qu’on peut inclure +en utilisant les commandes de ce chapitre. Il y a aussi deux autres +systèmes qui utilisent un langage de programmation : Asymptote et +MetaPost. Encore un autre système qui utilise une interface graphique : +Xfig. Une description complète des ces systèmes est hors du champ +d’application de ce document ; reportez vous à leur documentation sur le +CTAN. + + + + +Options du paquetage <literal>graphics</literal> + +graphics, options du paquetage +options, paquetage graphics + +Synopsis (à placer dans le préambule du document) : + +\usepackage[liste d'option séparée par des virgules]{graphics} + +ou + +\usepackage[liste d'option séparée par des virgules]{graphicx} + +Le paquetage graphicx a un format pour les arguments optionnels +passés à \includegraphics qui est commode (c’est le format +clef/valeur), ainsi c’est le meilleur des deux choix pour les nouveaux +documents. Quand vous chargez les paquetages graphics ou +graphicx avec \usepackage il y a deux sortes d’options +disponibles. + +La première est que &latex; ne contient pas d’information concernant +les différents systèmes de sortie, mais au lieu de cela dépend de +l’informtion stockée dans un fichier pilote d’impression. +Normalment vous ne devriez pas spécifier l’option de pilote dans le +document, mais au lieu de cela vous reposer sur les valeurs par défaut +du système. Un avantage de procéder ainsi et que cela rend les documents +portables entre systèmes. + +Pour être complet voici une liste des pilotes. Ceux qui sont +actuellement pertinents sont : dvipdfmx, dvips, +dvisvgm, luatex, pdftex, xetex. Les deux +pilotes xdvi and oztex sont essentiellement des alias de +dvips (et xdvi est monochrome). Ceux qu’on ne devrait pas +utiliser pour de nouveaux systèmes sont : dvipdfmx, dvips, +dvisvgm, luatex, pdftex, xetex. Les deux +pilotes xdvi et oztex sont essentiellement des alias de +dvips (et xdvi est monochrome). Ceux qui ne devraient pas +être utilisés pour de nouveaux systèmes sont : dvipdf, +dvipdfm, dviwin, dvipsone, emtex, +pctexps, pctexwin, pctexhp, pctex32, +truetex, tcidvi, vtex (et dviwindo est un +alias de dvipsone). Ces pilotes sont stockés dans des fichiers +avec une extension .def, tels que pdftex.def. + +La seconde sorte d’options est décrite ci-après. + +demo +Au lieu d’un fichier d’image, &latex; met un rectangle de 150 pt +sur 100 pt (à moins qu’une autre taille soit spécifiée dans la +commande \includegraphics). + +draft +Aucun des fichier grahpique n’est affiché, mais au lieu de cela le nom +du fichier est imprimé au sein d’une boîte de la bonne taille. De sorte +à ce que la taille soit déterminée, le fichier doit être présent. + +final +(Option par défaut) L’emporte sur toute options draft précédente, +de sorte que le document afficher le contenu des fichiers graphiques. + +hiderotate +Ne montre pas le texte ayant subi une rotation. (Ceci permet d’utiliser +une visionneuse ne prenant pas en charge le texte ayant subi une +rotation). + + +hidescale +Ne montre pas le texte rétréci/dilaté. (Ceci permet d’utiliser une +visionneuse ne prenant pas en charge le texte ayant subi un +rétrécissment/une dilatation.) + + +hiresbb +Dans un fichier PS ou EPS la taille du graphique peut être spécifiée de +deux façons. Les lignes %%BoundingBox décrivent la taille du +graphique en utilisant des multiples entiers d’un point PostScript, +c-à-d. des multiples entiers d’ 1/72 de pouce. Une addition plus +récente au langage PostScript autorise les multiples décimaux, tel que +1.23, dans les lignes %%HiResBoundingBox. Cette option fait que +&latex; lit la taille à partir de %%HiResBoundingBox plutôt que +de %%BoundingBox. + + + + +Configuration du paquetage <literal>graphics</literal> + +graphics +graphics, paquetage +configuration du paquetage graphics +EPS, fichiers +JPEG, fichiers +JPG, fichiers +PDF, fichiers graphiques +PNG, fichiers + +Ces commandes configurent la façon dont &latex; recherche le graphique +dans le système le fichier. + +Le comportement du code de recherche dans le système de fichier dépend +nécessairement de la plateforme. Dans ce document nous couvrons +GNU/Linux, Macintosh, et Windows, étant donné que ces systèmes ont des +configurations typiques. Pour les autres situations consultez la +documentation dans grfguide.pdf, ou le source &latex;, ou la +documentationn de votre distribution &tex;. + + + + +<literal>\graphicspath</literal> + +\graphicspath + +Synopsis : + +\graphicspath{liste des répertoires entre les accolades} + +Déclare une liste de répertoires dans lesquels rechercher des fichiers +graphiques. Ceci permet d’écrire plus tard quelque chose du genre de +\includegraphics{lion.png} au lieu de donner son chemin. + +&latex; recherche toujours en premier les fichiers graphiques dans le +répertoire courant (et dans le répertoire de sortie, si spécifié ; +see output directory). La déclaration ci-dessous dit au système de +regarder ensuite dans le sous-répertoire img, et ensuite +../img. + +\usepackage{graphicx} % ou graphics; à mettre dans le préambule + ... +\graphicspath{ {img/} {../img/} } + +La déclaration \graphicspath est optionnelle. Si vous ne +l’incluez pas, alors le comportement par défaut de &latex; est de +rechercher dans tous les endroits où il recherche d’habitude un fichier +(il utilise la commande \input@path de &latex;). En +particulier, dans ce cas l’un l’un des endroit où il regarde est le +répertoire courant. + +Mettez chaque nom de répertoire entre accolades ; en particulier, +ci-dessus on a écrit ‘{img}’. Faites ainsi même si il n’y +a qu’un seul répertoire. Chaque nom de répertoire doit se terminer par +une oblique vers l’avant /. Ceci est vrai même sur Windows, où +la bonne pratique est d’utilise des obliques vers l’avant pour tous les +séparateur de répertoire puisque cela rend le document portable vers +d’autres plateformes. Si vous avez des espace dans votre nom de +répertoire alors utilisez des guillemets anglais, comme dans +{"mes docs/"}. Enfreindre l’une de ces règles aura pour effet +que &latex; rapportera une erreur Error: File `filename' not found. + +Pour faire simple, l’algorithme est que dans l’exemple qui suit, après +avoir regardé dans le répertoire courant, + +\graphicspath{ {img/} {../img/} } +... +\usepackage{lion.png} + +pour chacun des répertoires listés, &latex; le concatène avec le nom du +fichier et recherche le fichier ainsi nommé, eh cherchant +img/lion.png et puis ../img/lion.png. Cet algorithme +signifie que la commande \graphicspath ne recherche pas +récursivement dans les sous-répertoires : si vous faites +\graphicspath{{a/}} et que le graphique est dans +a/b/lion.png alors &latex; ne le trouvera pas. Cela signifie +aussi que vous pouvez utiliser des chemins absolus tels que +\graphicspath{{/home/jim/logos/}} ou +\graphicspath{{C:/Users/Albert/Pictures/}}. Toutefois, faire +cela rend votre document non portable. (Vous pourriez préserver la +portabilité en ajustant vos le paramètre TEXINPUTS du fichier de +configuration des réglages système &tex; ; voir la documentation de +votre système). + +Vous pouvez utiliser \graphicspath n’improte-où dans le +document. Vous pouvez l’utiliser plus d’une fois. Sa valeur peut être +affichée avec \makeatletter\typeout{\Ginput@path}\makeatother. + +Les répertoires sont à donner relativement au fichier de base. Pour +faire clair, supposez que vous travaillez sur un document basé sur +livre/livre.tex et qu’il contienne +\include{chapitres/chap1}. Si dans chap1.tex vous +mettez \graphicspath{{graphiques/}} alors &latex; ne +cherchera pas les graphiques dans livre/chapitres/graphiques, +mais dans livre/graphiques. + + + + +<literal>\DeclareGraphicsExtensions</literal> + +\DeclareGraphicsExtensions + +Synopsis : + +\DeclareGraphicsExtensions{liste séparée par des virgules d'extentions de fichier} + +Déclare les extensions de nom de fichier à essayer. Ceci vous permet de +spécifier l’ordre dans lequel les formats graphiques sont choisis quant +les fichiers graphiques sont inclus en donnant le nom de fichier sans +l’extension, comme dans \includegraphics{courbe_de_fonction}. + +Dans l’exemple qui suit, &latex; trouve les fichiers au format PNG +avant les fichiers PDF. + +\DeclareGraphicsExtensions{.png,PNG,.pdf,.PDF} + ... +\includegraphics{lion} % trouve lion.png avant lion.pdf + +Du fait que le nom lion ne contient pas de point, &latex; +utilise la liste d’extension. Pour chacun des répertoires dans la liste +de chemins graphiques (see \graphicspath), &latex; essaie les +extensions dans l’ordre donné. S’il ne trouve aucun fichier +correspondant après avoir essayé tous les répertoires et toutes les +extensions, alors il renvoie une erreur ‘! LaTeX Error: File +`lion' not found’. Notez que vous devez inclure le point au +début de chaque extension. + +Du fait que les noms de fichiers sous GNU/Linux et Macintosh sont +sensibles à la casse, la liste des extensions de fichier est sensible à +la casse sur ces plateformes. La plateforme Windows n’est pas sensible +à la casse. + +Vous n’êtes pas tenu d’inclure \DeclareGraphicsExtensions dans +votre document ; le pilote d’impression a une valeur par défaut +raisonnable. Par exemple, la version la plus récente de +pdftex.def a cette liste d’extensions. + +.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2 + +Vous pouvez utiliser cette commande n’importe où dans le document. Vous +pouvez l’utiliser plus d’une fois. On peut afficher la valeur courante +avec \makeatletter\typeout{\Gin@extensions}\makeatother. + + + + +<literal>\DeclareGraphicsRule</literal> + +\DeclareGraphicsRule + +Synopsis : + +\DeclareGraphicsRule{extension}{type}{extension taille-fic}{commande} + +Declare comment gérer les fichiers graphiques dont le nom se termine en +extension. + +L’exemple suivant déclare que tous le fichiers dont ele est de la forme +nomfichier-sans-point.mps doivent être traité comme une sortie de +MetaPost, ce qui signifie que le pilote d’impression utilisera son code +de gestion MetaPost pour traiter le fichier en entrée. + +\DeclareGraphicsRule{.mps}{mps}{.mps}{} + +La déclaration suivante + +\DeclareGraphicsRule{*}{mps}{*}{} + +dit à &latex; qu’il doit traiter comme une sortie MetaPost tout fichier +avec extension non couverte par une autre règle, ainsi il couvre +nomfichier.1, nomfichier.2, etc. + +Ici on décrit les quatre arguments. + +extension +L’extension de nom de fichier à laquelle la règle considérée +s’applique. L’extension commence au premier point dans le nom de +fichier, en incluant le point. Utiliser l’astérisque, *, pour +désigner la comportement par défaut pour toutes les extensions non +déclarées. + +type +Le type du fichier considéré. Ce type est une chaîne de caractères qui +doit être définie dans le pilote d’impression. Par exemple, les fichiers +avec les extensions .ps, .eps, ou .ps.gz peuvent +tous être classifiés sous le type eps. Tous les fichiers de même +type sont traités en entrée avec la même commande interne par le pilote +d’impression. Par exemple, les types de fichiers reconnus par +pdftex sont : jpg, jbig2, mps, pdf, +png, tif. + +extension taille-fic +L’extension du fichier à lire pour déterminer la taille du graphique, si +un tel fichier existe. Elle peut être la même que extension mais +aussi être différente. + +Considérons par exemple un graphique PostScript. Pour le rendre plus +petit, il peut être compressé en un fichier .ps.gz. Les fichiers +compressé ne sont pas lu simplement par &latex; aussi vous pouvez +mettre l’information de boîte englobante dans une fichier séparé. Si +extension taille-fic est vide, alors vous devez spécifier +l’information de taill dans les arguments de \includegraphics. + +Si le fichier pilote a un procédure pour lire les tailles de fichier +pour type alors elle est utilisée, sinon il utilise la procédure +pour lire les fichiers .eps. (Ainsi vous pourriez spécifier la +taille d’un fichier bitmap dans un fichier avec une ligne +%%BoundingBox de style PostScript style si aucun autre format +n’est disponible). + +commande +Une commande à appliquer au fichier. La plupart du temps on laisse cet +argument vide. Cette commande doit commencer avec un caractère accent +grave. Ainsi, +\DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c +#1} spécifie que tout fichier ayant une extension .eps.gz doit +être traité comme un fichier eps, avec l’information de boîte +englobante stockée dans le fichier ayant l’extension .eps.bb, et +que la commande gunzip -c sera exécuté sur votre plateforme pour +décompresser le fichier. + +Une telle commande est spécifique à votre plateforme. De plus, votre +système &tex; doit autoriser l’exécution de commandes externes ; par +mesure de sécurité les système moderne restreigne l’exécution de +commandes à moins que vous l’autorisiez explicitement. Se référer à la +documentation de votre distribution &tex;. + + + + + +Commandes du paquetage <literal>graphics</literal> + +graphics, commandes du paquetage +commandes, paquetage graphics + +Voici les commandes disponibles dans les paquetages graphics et +graphicx. + + + + +<literal>\includegraphics</literal> + +graphiques +graphics, paquetage +inclure des graphiques +importer des graphiques +EPS, fichiers +JPEG, fichiers +JPG, fichiers +PDF, fichiers graphiques +PNG, fichiers +\includegraphics + +Synopsis pour le paquetage graphics : + +\includegraphics{nomfichier} +\includegraphics[urx,ury]{nomfichier} +\includegraphics[llx,lly][urx,ury]{nomfichier} +\includegraphics*{nomfichier} +\includegraphics*[urx,ury]{nomfichier} +\includegraphics*[llx,lly][urx,ury]{nomfichier} + +Synopsis pour le paquetage graphicx : + +\includegraphics{nomfichier} +\includegraphics[liste-à-clefs-valeurs]{nomfichier} +\includegraphics*{nomfichier} +\includegraphics*[liste-à-clefs-valeurs]{nomfichier} + +Inclut un fichier graphique. La forme étoilée \includegraphics* +rogne le graphique à la taille spécifiée, alors que pour la forme +non-étoilée toute partie du graphiqe en dehors de la boîte de la taille +spécifiée se superpose à ce qui l’entoure. + +Dans cet exemple + +\usepackage{graphicx} % dans le préambule + ... +\begin{center} + \includegraphics{trace.pdf} +\end{center} + +on incorpore dans le document le graphique dans plot.pdf, centré +et à sa taille nominale. Vous pouvez aussi donner un chemin au fichier, +comme dans \includegraphics{graphiques/trace.pdf}. Pour +spécifier une liste de répertoire ou rechercher le fichier, +see \graphicspath. + +Si votre nom de fichier comprend des espaces, alors placer le entre +guillemets anglais. Par exemple comme dans +\includegraphics{"image complementaire.jpg"}. + +La commande \includegraphics{nomfichier} décide du type +de graphique en segmentant nomfichier sur le premier point +(‘.’). Vous pouvez utiliser nomfichier sans extension de nom +de fihcier, comme dans \includegraphics{turing} et &latex; +essaie une séquence d’extension telle que .png et .pdf +jusqu’à ce qu’il trouve un fichier avec cette extension +(see \DeclareGraphicsExtensions). + +Si votre fichier comprend des points avantr l’extension alors vous +pouvez les cacher avec des accolades, comme dans +\includegraphics{{plot.2018.03.12.a}.pdf}. Ou, si vous +utilisez le paquetage graphicx alors vous pouvez utiliser les +options type et ext ; voir plus bas. Ces problèmes de +noms de fichiers, et d’autres sont aussi traités par le paquetage +grffile. + +L’exemple ci-après place un graphique dans un environnement +figure de sorte que &latex; puisse le déplacer sur la page +suivante si le faire rentrer dans la page courante rend mal +(see figure). + +\begin{figure} + \centering + \includegraphics[width=3cm]{rayonxpoumon.jpg} + \caption{Ça saute aux yeux : vous ne devriez arrêter de fumer} \label{fig:rayon-x} +\end{figure} + +L’exemple suivant place un graphique non flottant, de sorte +à garantir qu’il apparaisse à ce point-ci du document même si cela +oblige &latex; à dilater le texte ou à recourir à des zones blanche sur +la page. Le graphique est centré est a une légende. + +\usepackage{caption} % dans le préambule + ... +\begin{center} + \includegraphics{sans/images.png} + \captionof{figure}{L'esprit de la nuit} \label{sans:images} % optionnel +\end{center} + +L’exemple suivant place une boîte avec un graphique le long d’une autre +boîte contenant du texte, les deux boîtes étant verticalement centrées : + +\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}} + ... +\begin{center} + \vcenteredhbox{\includegraphics[width=0.4\textwidth]{trace}} + \hspace{1em} + \vcenteredhbox{\begin{minipage}{0.4\textwidth} + \begin{displaymath} + f(x)=x\cdot \sin (1/x) + \end{displaymath} + \end{minipage}} +\end{center} + +Si vous utilisez le paquetage graphics alors les seules options +disponibles concernent la taille du graphique (mais voir +\rotatebox et \scalebox). Quand un argument optionnel est +présent alors c’est [urx,ury] et il donne les +coordonnées du coin en haut à droite de l’image, comme une paire de +dimensions &tex; (see Units of length). Si les unités sont omises, +alors par défaut l’unité considérée est le bp. Dans ce cas, le +coin en bas à gaéuche de l’image est supposée être à (0,0). Si deux +arguments optionnels sont présents alors le premier est +[llx,lly], et il spécifie les coordonnées du coin en +bas à gauche de l’image. Ainsi, +\includegraphics[1in,0.618in]{...} demande que le graphique +soit placé de sorte a avoir 1 inch de largeur et 0,618 inches de hauteur +et donc son origine est à (0,0). + +Le paquetage graphicx vous offre beaucoup plus d’options. +Spécifiez les sous la forme de paires clef-valeur, comme ci-après : + +\begin{center} + \includegraphics[width=3cm,angle=90]{lion} + \hspace{2em} + \includegraphics[angle=90,width=3cm]{lion} +\end{center} + +Les options sont lues de gauche à doite. Ainsi le premier graphique +ci-dessus est dilaté à une largeur de 3cm, et ensuite subit une +rotation de 90degrés, alors que le second subit la rotation en +premier et ensuite est dilaté à 3cm de largeur. Ainsi, à moins +que le graphique soit parfaitement carré, à la fin les deux n’ont pas +les mêmes largeurs et hauteurs. + +Il y a beaucoup d’options. Les principales sont listées en premier. + +boîte englobante +englobante, boîte +Notez qu’un graphique est placé par &latex; dans une boîte, qu’on +désigne traditionnellement comme sa boîte englobante (distincte de +la BoundingBox PostScript décrite plus bas). La zone sur laquelle le +graphique s’imprime peut aller au delà de cette boîte, ou s’inscrire +dans cette boîte, mais quand &latex; fabrique une page il assemble des +boîtes, et celle-ci est la boîte allouée pour le graphique. + +width +Le graphique est affiché de sorte que sa boîte englobante ait cette +largeur. Un exemple est \includegraphics[width=2.5cm]{trace}. +Vous pouvez utiliser les unités de longueur standardes de &tex; +(see Units of length) et également il est commode d’utiliser +\linewidth, ou, dans un document recto-verso, \columnwidth +(see Page layout parameters). Un exemple est qu’en utilisant le +paquetage calc vous pouvez rendre le graphique 1cm plus +étroit que la largeur du texte avec +\includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}. + +height + +Le graphique est affiché de sorte que sa boîte englobante est de cette +hauteur. Vous pouvez utiliser les unités de longueur standardes de +&tex; (see Units of length), et également il est commode d’utiliser +\pageheight et \textheight (see Page layout +parameters). Par exemple, la commande +\includegraphics[height=0.25\textheight]{godel} rend le +graphique d’une hauteur d’un quart de celle de la zone de texte. + +totalheight + +Le graphique est affiché de sorte que sa boîte englobante ait cette +hauteur plus profondeur. Ceci diffère de la hauteur si le graphique a +subi une rotation. Par exemple, s’il a subi une rotation de -90 degrès +alors il a une hauteur nulle mais une grande profondeur. + +keepaspectratio +Si réglé à true, ou juste spécifié comme ci-dessous + +\includegraphics[...,keepaspectratio,...]{...} + +et que vous donnez en option à la fois width et height (ou +totalheight), alors &latex; rendra le graphique aussi grand que +possible sans le déformer. C’est à dire que &latex; assure que le +graphique n’est ni plus large que width ni plus haut que +height (ou totalheight). + +scale +Facteur par lequel dilater/contracter le graphique. On peut rendre + graphique à deux fois sa taille nominale avec + \includegraphics[scale=2.0]{...}. Ce nombre peut prendre + n’importe quelle valeur ; un nombre entre 0 et 1 contracte le graphique + et un nombre négatif lui applique une réflexion. + +angle +Applique une rotation au graphique. L’angle est exprimé en degrès et +dans le sens anti-horaire. La rotation est effectuée autour de +l’origine donnée par l’option origin ; s’y référer. Pour une +descrition complète de la compositiion de matériel ayant subi une +rotation, see \rotatebox. + +origin +Le point du graphique autour duquel la rotation s’effectue. Les valeurs +possibles sont toute chaîne contenant un ou deux caractères parmi : +l pour gauche (left), r pour droite (right), b pour +bas, c pour centré, t pour haut (top), et B pour +ligne de base. Ainsi, saisir la commande +\includegraphics[angle=180,origin=c]{moon} a pour effet de +mettre la figure tête en bas en tournant autour du centre de l’image, +alors que la commande +\includegraphics[angle=180,origin=lB]{LeBateau} fait la +rotation autour du point gauche de la ligne de base. (Le caractère +c désigne le centre horizontal dans bc ou tc, mais +le centre vertical dans lc rc). Le réglage par défaut est +lB. + +Pour faire une rotation autour d’un point arbitraire, +see \rotatebox. + + +Voici maintenant des options moins usuelles. + +viewport +Désigne une sous-région du graphique à afficher. Prend quatre +arguments, séparés par des espaces et exprimés comme des dimensions +&tex;, comme dans \includegraphics[.., viewport=0in 0in 1in +0.618in]{...}. Quand l’unité est omise, les dimensions sont par +défaut en big points, bp. Elle sont prises relativement à +l’origine spécifiée par la boîte englobante. Voir aussi l’option +trim. + +trim +Désigne les parties du graphique à ne pas afficher. Prend quatre +arguments, séparés par des espaces, et exprimés comme des dimensions +&tex; dimensions, comme dans \includegraphics[.., trim= 0in 0.1in +0.2in 0.3in, ...]{...}. Ceci donne la quantité du graphique à ne pas +afficher, c-à-d. que &latex; rogne l’image de 0 pouce sur la gauche +left, 0.1 pouce sur la bas, 0.2 pouce sur la droite, et 0.3 pouce sur le +haut. Voir aussi l’option viewport. + +clip +Si réglé à true, ou juste spécifié comme ci-dessous + +\includegraphics[...,clip,...]{...} + +alors le graphique est rogné à sa boîte englobante. Ceci revient au +même que d’utiliser la forme étoilée de la commande, +\includegraphics*[...]{...}. + +page +Donne le numéro de page pour un fichier PDF multi-page. La valeur par +défaut est page=1. + +pagebox +Spécifie quelle boîte englobante utiliser pour les fichier PDF parmi les +suivantes mediabox, cropbox, bleedbox, +trimbox, ou artbox. Les fichier PDF n’ont pas la +BoundingBox que les fichiers PostScript ont, mais peuvent spécifier +jusqu’à quatre rectangle prédéfinis. La boîte MediaBox donne les +frontière du médium physique. La boîte CropBox est la région à laquelle +le contenu de la page devrait être épinglé quand il est affiché. La +boite BleedBox la région à laqeulle le contenu de la page devrait être +épinglé en production. La boîte TrimBox est correspond au dimensions +désirée de la page finie. La boîte ArtBox est l’étendu du contenu de la +page ayant du sens. Le pilote règle la taille de l’image en se basant +sur la CropBox si elle est présente, sinon il n’utilise pas les autres, +avec un ordre de préférence propre au pilote. La MediaBox est toujours +présente. + +interpolate +Active ou désactive l’interpolation des images matricielles par la +visionneuse. On peut régler l’option avec interpolate=true ou +juste comme ci-dessous : + +\includegraphics[...,interpolate,...]{...} + +quiet +N’écrit pas d’information dans le journal. On peut régler l’option avec +quiet=true ou juste en la spécifiant avec +\includegraphics[...,quiet,...]{...}, + +draft +Lorsqu’on règle l’option avec draft=true ou juste ainsi + +\includegraphics[...,draft,...]{...} + +alors le graphique n’apparaît pas dans le document, ce qui permet +éventuellement d’économiser l’imprimante couleur. À la place &latex; +place une boîte vide de la bonne taille avec le nom du fichier imprimé +dedans. + + +Les options suivantes traitent de la boîte englobante pour les fichiers +graphique de type PostScript Encapsulé, leur taille est spécifié avec +une ligne %%BoundingBox qui apparaît dans le fichier. Elle a +quatre valeurs donant la coordonnée x inférieure, la coordonnée +y inférieure, la coordonnée x supérieure, et la coordonnée +y supérieure. L’unité est le point PostScript, équivalent au big +point de &tex;, à savoir 1/72 de pouce. Par exemple, si un fichier +.eps a la ligne %%BoundingBox 10 20 40 80 alors sa taille +naturelle est 30/72 de pouche de large pour 60/72 de pouce de haut. + +bb +Spécifie la boîte englobante de la région affichée. L’argument est +constitué de quatre dimensions séparées par des espaces, comme dans +\includegraphics[.., bb= 0in 0in 1in 0.618in]{...}. +D’ordinaire \includegraphics lit les ces nombre BoundingBox dans +le fichier EPS automatiqument, de sorte que cette option n’est utile que +si la définition de la boîte englobante est absente du fihcier ou si +vous désirez la changer. + +bbllx, bblly, bburx, bbury +Règke la boîte englobante box. Ces quatre options là sont obsolète, +mais existent encore pour maintenir la rétrocompatibilité avec des +paquetages anciens. + +natwidth, natheight +Une alternative à bb. Régler + +\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...} + +revient au même que régler bb=0 0 1in 0.618in. + +hiresbb +Si réglé à true, ou juste spécifié comme dans + +\includegraphics[...,hiresbb,...]{...} + +alors &latex; recherche la ligne %%HiResBoundingBox plutôt que +la ligne %%BoundingBox. (La ligne BoundingBox n’utilise +que des nombres entiers naturels alors que la ligne +HiResBoundingBox utilise des décimaux ; les deux utilisent une +unité équivalente au big point de &tex;, 1/72 de pouce). Pour +l’emporter sur un réglage précédent à true, on peut la régler à +false. + + +Les options suivantes permettent à l’utilisateur de l’emporter sur la +méthode par laquelle &latex; choisit le type d’un graphique en fonction +de son extension de nom de fichier. Par exemple avec +\includegraphics[type=png,ext=.xxx,read=.xxx]{lion} le fichier +lion.xxx est lu comme s’il s’agissait de lion.png. Pour +plus ample information, see \DeclareGraphicsRule. + +type +Spécifie le type de graphique. + +ext +Spécifie l’extension du graphique. À n’utiliser qu’en conjonction avec +l’option type. + +read +Spécifie l’extension du fichier lu. À n’utiliser qu’en conjonction avec +l’option type. + +command +Spécifie une commande à appliquer à ce fichier. À n’utiliser qu’en +conjonction avec l’option type. See Command line options, +pour une discussion sur l’activation de la fonctionalité \write18 +pour exécuter des commandes externes. + + + + + +<literal>\rotatebox</literal> + +rotation +rotating graphics +rotating text +\rotatebox + +Synopsis for graphics package: + +\rotatebox{angle}{material} + +Synopses for graphicx package: + +\rotatebox{angle}{material} +\rotatebox[liste-à-clefs-valeurs]{angle}{material} + +Put material in a box and rotate it angle degrees counterclockwise. + +This example rotates the table column heads forty five degrees. + +\begin{tabular}{ll} + \rotatebox{45}{Character} &\rotatebox{45}{NATO phonetic} \\ + A &AL-FAH \\ + B &BRAH-VOH +\end{tabular} + +The material can be anything that goes in a box, including a graphic. + + \rotatebox[origin=c]{45}{\includegraphics[width=1in]{lion}} + +You can get the same effect using the graphicx package alone +(see \includegraphics). + +To place the rotated material, the first step is that &latex; sets +material in a box, with a reference point on the left baseline. +The second step is the rotation, by default about the reference point. +The third step is that &latex; computes a box to bound the rotated +material. Fourth, &latex; moves this box horizontally so that the left +edge of this new bounding box coincides with the left edge of the box +from the first step (they need not coincide vertically). This new +bounding box, in its new position, is what &latex; uses as the box when +typesetting this material. + +If you use the graphics package then the rotation is about the +reference point of the box. If you use graphicx then these are +the options that can go in the liste-à-clefs-valeurs. + +origin +The point of the material’s box about which the rotation happens. +Possible values are any string containing one or two of: l for +left, r for right, b for bottom, c for center, +t for top, and B for baseline. Thus, +\includegraphics[angle=180,origin=c]{moon} will turn the +picture upside down from the center, while +\includegraphics[angle=180,origin=lB]{LeBateau} will turn its +picture upside down about its left baseline. (The character c +gives the horizontal center in bc or tc but gives the +vertical center in lc or rc.) The default is lB. + +x, y +Specify an arbitrary point of rotation with +\rotatebox[x=&tex; dimension,y=&tex; +dimension]{...} (see Units of length). These give the offset +from the box’s reference point. + +units +This key allows you to change the default of degrees counterclockwise. +Setting units=-360 changes the direction to degrees clockwise and +setting units=6.283185 changes to radians counterclockwise. + + + + + +<literal>\scalebox</literal> + +graphics, scaling +graphics, resizing +scaling +resizing +text, scaling +text, resizing +\scalebox +\reflectbox + +Synopses: + +\scalebox{horizontal factor}{material} +\scalebox{horizontal factor}[vertical factor]{material} +\reflectbox{material} + +Scale the material. + +This example halves the size, both horizontally and vertically, of the +first text and doubles the size of the second. + +\scalebox{0.5}{DRINK ME} and \scalebox{2.0}{Eat Me} + +If you do not specify the optional vertical factor then it +defaults to the same value as the horizontal factor. + +You can use this command to resize a graphic, as with +\scalebox{0.5}{\includegraphics{lion}}. If you use the +graphicx package then you can accomplish the same thing with +optional arguments to \includegraphics +(see \includegraphics). + +The \reflectbox command abbreviates +\scalebox{-1}[1]{material}. Thus, Able was +I\reflectbox{Able was I} will show the phrase ‘Able was I’ +immediately followed by its mirror reflection. + + + + +<literal>\resizebox</literal> + +graphics, scaling +graphics, resizing +scaling +resizing +text, scaling +text, resizing +\resizebox + +Synopses: + +\resizebox{horizontal length}{vertical length}{material} +\resizebox*{horizontal length}{vertical length}{material} + +Given a size, such as 3cm, transform material to make it +that size. If either horizontal length or vertical length +is an exclamation point ! then the other argument is used +to determine a scale factor for both directions. + +This example makes the graphic be a half inch wide and scales it +vertically by the same factor to keep it from being distorted. + +\resizebox{0.5in}{!}{\includegraphics{lion}} + +The unstarred form \resizebox takes vertical length to be +the box’s height while the starred form \resizebox* takes it to +be height+depth. For instance, make the text have a height+depth of a +quarter inch with \resizebox*{!}{0.25in}{\parbox{1in}{This +box has both height and depth.}}. + +You can use \depth, \height, \totalheight, and +\width to refer to the original size of the box. Thus, make the +text two inches wide but keep the original height with +\resizebox{2in}{\height}{Two inches}. + + + + + + +Insertions spéciales + +&latex; fournit des commandes pour insérer les caractères qui ont une +signification spéciale mais ne correspondent à aucun caractère simple +que vous pouvez taper. + + + + +Caractères réservés +caractères réservés +réservés, caractères +caractères spéciaux +spéciaux, caractères + +&latex; réserve les caractères suivant à un usage spécial (par exemple, +le signe pourcent % sert aux commentaires) c’est pourquoi on les +appelle caractères réservés ou caractères spéciaux. Ils sont +chacun l’objet d’une discussion ailleurs dans ce manuel. + +# $ % & { } _ ~ ^ \ + +\# +\$ +\% +\& +\_ +\{ +\} +Si vous voulez qu’un caractère réservé soit imprimé comme lui-même, +dans la même police que le corps du texte, alors pour tous les +caractères hormis les trois derniers de cette liste il suffit de les +faire précéder d’une contr’oblique \. Ainsi \$1.23 +produit $1.23 en sortie. + +\~ +\^ +\textbackslash +Quant aux trois derniers caractères, pour faire un tilde dans la police +du corps du texte utilisez \~{} (sans les accolades cela +mettrait un accent tilde sur le caractère suivant). De même pour faire +un accent circonflexe dans la police du corps du texte utilisez +\^{}. Une contr’oblique dans la police du corps de texte se +fait avec \textbackslash{}. + +Pour produire les caractères réservés dans la police tapuscrite utilisez +\verb!! comme ci-dessous (la double contr’oblique \\ n’est +là que pour aller à la ligne en sortie) : + +\begin{center} + \# \$ \% \& \{ \} \_ \~{} \^{} \textbackslash \\ + \verb!# $ % & { } _ ~ ^ \! +\end{center} + +Dans cet exemple la double contr’oblique \\ n’est là que pour +sauter à la ligne. + + + + +Capitales et bas de casse + +Capitales +Bas de casse +Casse de caractères +Changer la casse de caractères + +Synopsis : + +\uppercase{texte} +\lowercase{texte} +\MakeUppercase{texte} +\MakeLowercase{texte} + +Change la casse des caractères. Les commandes primitives de &tex; +\uppercase et \lowercase ne fonctionnent que pour les +26 lettres sans diacritiques a-z et A-Z. Les commandes &latex; +\MakeUppercase et \MakeLowercase changent aussi les +caractères accessibles par des commandes telles que \ae ou +\aa. Ces commandes \MakeUppercase et +\MakeLowercase sont robustes, mais elles ont des arguments +mouvants (see \protect). + +Ces commandes ne changent pas la casse des lettres utilisées dans le nom +d’une commande au sein de texte. Mais par contre elles changent la +casse de tout autre lettre latine au sein de l’argument texte. +Ainsi, \MakeUppercase{Soit $y=f(x)$} produit ‘SOIT +Y=F(X)’. Un autre exemple est que le nom de tout environnement est +changé, de sorte que \MakeUppercase{\begin{tabular} +... \end{tabular}} produit une erreur puisque la première moitié est +changée en \begin{TABULAR}. + +&latex; utilise la même table pour changer la casse tout au long du +document. La table utilisée est conçue pour le codage T1 ; ceci +fonctionne bien avec les polices standardes de &tex; pour tous les +alphabets latins, mais cause des problèmes avec d’autres alphabets. + +Pour changer la casse du texte qui résulte d’une macro au sein de +texte il est nécessaire de faire un développement. Dans l’exemple +qui suit la macro \Nomecole produit ‘UNIVERSITÉ DE MATHÉMATIQUES’. + +\newcommand{\nomecole}{Universit\'e de math\'ematiques} +\newcommand{\Nomecole}{\expandafter\MakeUppercase\expandafter{\nomecole}} + +paquetage textcase +textcase, paquetage + +Le paquetage textcase comble certaines des lacunes des commandes +standardes \MakeUppercase et \MakeLowerCase de &latex;. + +paquetage mfirstuc +mfirstuc, paquetage + +Pour mettre en capitale seulement la première lettre d’un mot, on peut +utiliser le paquetage mfirstuc. + +paquetage expl3 +expl3, paquetage + +Wright, Joseph + +Gérer toutes les règles concernant la casse spécifiée par Unicode, par +ex. pour les scripts non latins, est une tâche bien plus conséquente que +ce qui avait été considéré dans les &tex; et &latex; d’origine. Cela +a été implémenté dans le paquetage expl3 à compter de +2020. L’article « Case changing: From &tex; primitives to the Unicode +algorithm », (Joseph Wright, TUGboat 41:1, +https://tug.org/TUGboat/tb41-1/tb127wright-case.pdf), donne un bon +aperçu du sujet, passé et présent. + + + +Symboles appelés par leur position dans une police + +\symbol +accéder à un caractère quelconque d’une police +symboles d’une police, par leur numéro +police, symboles par leur numéro + +Vous pouvez accéder à n’importe quel caractère de la police courante en +utilisant son numéro avec la commande \symbol. Par exemple, le +caractère espace visible utilisé dans la commande \verb* a le +code décimal 32, ainsi on peut le taper avec \symbol{32}. + +Vous pouvez également spécifier le numéro en octal (base 8) en utilisant +un préfixe ', ou en hexadécimal (base 16) avec un préfixe +", ainsi l’exemple précédent pourrait tout aussi bien être écrit +comme \symbol{'40} ou \symbol{"20}. + + + + +Symboles en texte + +symboles texte +textcomp, paquetage +&latex; fournit des commandes pour générer divers symboles qui ne sont +pas des lettres dans le cours sein du texte. Certaines d’entre elles, +en particulier les plus obscures, ne sont pas disponible en OT1 ; il se +peut que vous deviez charger le paquetage textcomp. + + +\copyright\copyright +\textcopyright\textcopyright +droit d’auteur, symbole +symbole droit d’auteur +Le symbole « droit d’auteur », ©. + +\dag\dag obèle, dans le texte Le symbole obèle (dans le texte). @@ -8724,7 +12086,7 @@ utilisés en mode mathématique. fermant, guillemet-apostrophe simple droite, guillemet anglais simple fermant, guillemet anglais simple -Guillemet-apostrophe simple de gauche (fermant) : ’. +Guillemet-apostrophe simple de droite (fermant) : ’. \S\S \itemx \textsection @@ -8928,12 +12290,12 @@ hauteur de capitale de la fonte, alors que la forme \textvisiblespace\textvisiblespace visible, symbole espace, dans le texte espace visible, symbole, dans le texte -Symbol espace visible. +Symbole espace visible. - + Accents accents @@ -8970,7 +12332,7 @@ disponible avec l’OT1. diacrtique accent aigu Produit un accent aigu, comme dans ó. Dans l’environnement tabbing, pousse la colonne courante à droite de la colonne -précédente (voir tabbing). +précédente (see tabbing). \. \. (dot-over accent) @@ -9011,7 +12373,7 @@ dans ō. grave accent Produit un accent grave suscrit à la lettre qui suit, comme dans ò. Au sein de l’environnement tabbing, déplace le texte qui -suit à la marge de droite (voir tabbing). +suit à la marge de droite (see tabbing). \~ \capitaltilde @@ -9134,9 +12496,9 @@ sorte elle traverse les descentes. Voir aussi \underline dan - + Lettres latines supplémentaires - + caractères speciaux speciaux, caractères caractères latins non diacrités @@ -9240,7 +12602,7 @@ autre codage de police, tel que T1. - + <literal>\rule</literal> \rule @@ -9262,7 +12624,7 @@ un rectangle. Les arguments sont : - + <literal>\today</literal> \today date d’aujourd’hui @@ -9270,7 +12632,7 @@ un rectangle. Les arguments sont : La commande \today produit la date d’aujourd’hui, par défaut dans le format ‘mois jj, aaaa’ ; par exemple, ‘July 4, 1976’. Elle utilise les compteurs prédéfinis \day, -\month, et \year (voir \day \month \year) pour faire +\month, et \year (see \day \month \year) pour faire cela. Elle n’est pas mise à jour durant l’execution de la compilation. Les extensions multilingues comme entre autres le paquetage babel @@ -9287,75 +12649,253 @@ suivant produit ‘4 juillet 1976’ : paquetage datetime datetime, paquetage + Le paquetage datetime, entre autres, produit un large choix d’autres formats de date. - + Partitionner le fichier d’entrée partitionner le fichier d’entrée 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 +&latex; vous permet de partitionner un document de grande taille en +plusieurs plus petits. Ceci peut simplifier son édition et permette à +plusieurs auteurs 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 racine, fichier fichier racine -fichier racine ; c’est le fichier dont vous passer le nom à la -ligne de commande quand vous exécutez &latex;. +fichier racine sur lequel la compilation &latex; +démarre. L’exemple ci-dessous illuste un tel fichier avec cinq fichiers +inclus. + +\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} + +Dans cet example on prend le matériel de pref.tex, +chap1.tex, chap2.tex, append.tex, et +bib.tex. Si vous compilez ce fichier, et ensuite mettez en +commentaire toutes les lignes au sein de \includeonly{...} +hormis chap1, et compilez de nouveau, alors &latex; traite +seulement le matériel du premier chapitre. Ainsi, la sortie apparaît +plus rapidement et est plus courte à imprimer. Cependant, l’avantage +de la commande \includeonly est 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. -Voir filecontents, pour un environnement qui permet de grouper un -fichier externe à créer avec le document principal. +See Larger book template pour un autre exemple de \includeonly. + + + - -<literal>\include</literal> -\include + + +<literal>\endinput</literal> + +\endinput Synopsis : -\include{fichier} +\endinput -Si aucune commande \includeonly n’est présente, la commande -\include exécute un \clearpage pour commencer une nouvelle -page (voir \clearpage), puis elle lit fichier, et ensuite fait -encore un \clearpage. +Quand vous écrivez \include{nomfichier}, alors au sein de +nomfichier.tex le matériel qui vient après \endinput n’est +pas inclus. Cette commande est optionnelle ; si nomfichier.tex +ne comprend pas de \endinput alors &latex; lit tout le fichier. -Précédé d’une commande \includeonly, les actions de -\include ne sont exécutées que si fichier est un élément des -fichiers listés en argument de l’\includeonly. Voir \includeonly. +Par exemple, supposons que le fichier racine d’un document a un +\input{chap1} que ce le contenu de chap1.tex est ce qui +suit : -\include emboîtés interdits -La commande \include ne doit apparaître ni dans le préambule, ni -au sein d’un fichier lu par une autre commande \include. +\chapter{One} Ce matériel apparaît dans le document. \endinput Ceci +n'apparaît pas. + +Ceci peut être utile pour placer de la documentation ou des commentaire +à la fin d’un fichier, ou pour éviter des caractères indésirable qui +pourraît s’ajouter si le fichier est transmis dans le corps d’un +courriel. C’est également utile pour déboguer : une stratégie pour +localiser des erreurs est de placer un \endinput à mi-chemin en +cours des fichiers inclus et de voir si l’erreur disparaît. Ensuite, +sachant quelle moitié contient l’erreur, en déplaçant le +\endinput à mi-chemin de cette zone circonscrit de plus près +l’endroit où elle se trouve. Ainsi on trouve rapidement la ligne +fautive. + +Après avoir lu \endinput, &latex; continue à lire jusqu’à la fin +de la ligne, ansi il est possible de faire suivre cette ligne par +quelque-chose qui sera tout de même lu. Ceci vous permet entre autre de +fermer un \if... par un \fi. - - -\<literal>includeonly</literal> + +<literal>\include</literal> & <literal>\includeonly</literal> +\include \includeonly Synopsis : -\includeonly{fichier1,fichier2,...} +\includeonly{ % dans le préambule du document + ... + nomfichier, + ... + } + ... +\include{nomfichier} % dans le corps du document + +Apporte du matériel d’un fichier externe nomfichier.tex +dans un document &latex;. + +La commande \include fait trois choses : elle exécute +\clearpage (see \clearpage & \cleardoublepage), puis elle +insère le matériel à partir du fichier nomfichier.tex dans +le document, ensuite fait encore un \clearpage. Cette commande ne +peut apparaître que dans le corps du document. + +La commande \includeonly contrôle quels fichiers seront lus par +&latex; lors des commandes \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, constitution.tex, on +inclut trois fichiers, preambule.tex, articles.tex, et +amendements.tex. + +\documentclass{book} +\includeonly{ + preambule, + articles, + amendements + } +\begin{document} +\include{preambule} +\include{articles} +\include{amendements} +\end{document} + +Le fichier preambule.tex ne contient aucun code spécial ; vous +avez juste extrait ce chapitre de consitution.tex pour le mettre +dans un fichier séparé pour rendre son édition plus commode. + +\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, ... + +Exécuter &latex; sur constitution.tex fait apparaître le +matériel issu de ces trois fichiers dans le document mais génère +également les fichiers auxiliaires preamble.aux, +articles.aux, et amendements.aux. Ceux-ci contiennent de +l’information telle que les numéros de page et les renvois (see Cross +references). Si maintenant vous mettez en commentaire les lignes de +\includeonly contenant preambule et amendements et +exécutez &latex; de nouveau alors le document résultant ne contiendra +que le matériel issu de articles.tex, mais pas celui de +preamblue.tex ni de amendements.tex. Néanmois, la +totalité de l’information auxiliaire issue des fichiers omis est +toujours là, y compris le numéro de la page où commence le chapitre. + +S’il n’y a pas de \includeonly dans le préambule du document, +alors &latex; inclut tous les fichiers demandés par des commandes +\include. + +La commande \include fabrique une nouvelle page. Pour éviter +cela, voir \input (ce qui, cependant, ne retient pas l’information +auxiliaire). + +See Larger book template pour un autre exemple utilisant +\include et \includeonly. Cet exemple utilise également +\input pour certain matériel qui ne débute pas nécessairement sur +une nouvelle page. + +Les noms de fichiers peuvent impliquer un chemin. + +\documentclass{book} +\includeonly{ + chapitres/chap1, + } +\begin{document} +\include{chapitres/chap1} +\end{document} + +Pour rendre votre document portable vis à vis des diverses distributions +et plateformes vous devriez éviter les espaces dans les noms de +fichier. Traditionnnelement on utilise des tirets de 6 ou de 8 à la +place. Néanmoins, pour le nom ‘amo amas amat’, ce qui suit +fonctionne sous &tex; Live sur GNU/Linux: + +\documentclass{book} +\includeonly{ + "amo\space amas\space amat" + } +\begin{document} +\include{"amo\space amas\space amat"} +\end{document} + +et ceci fonctionne sous MiK&tex; sur Windows: + +\documentclass{book} +\includeonly{ + {"amo amas amat"} + } +\begin{document} +\include{{"amo amas amat"}} +\end{document} -La commande \includeonly contrôle quels fichiers sont lisible par -toute commande \include venant ensuite. La liste des noms de -fichier est à éléments séparés par des virgules. Chaque élément -fichier1, fichier2, … doit exactement correspondre à -un nom de fichier spécifié en argument d’une commande \include -pour que la sélection soit effective. +\include imbriqués non autorisés +imbrication de \include non autorisée +Vous ne pouvez pas utiliser \include au sein d’un fichier qui +lui-même est inclus via \include, sans quoi vous obtenez l’erreur +‘LaTeX Error: \include cannot be nested’. La commande +\include ne peut pas apparaître dans le préambule ; sans quoi +vous obtenez l’erreur ‘LaTeX Error: Missing \begin{document}’. + +Si un fichier que vous incluez par \include n’existe pas, par +exemple si vous tapez la commande \include{athiesme} par erreur +à la place de \include{atheisme}, alors &latex; ne produit pas +une erreur mais un avertissement ‘No file athiesme.tex.’ (Il crée +également le fichier athiesme.aux). -Cette commande ne peut apparaître que dans le préambule. +Si vous faites un \include du fichier racine dans lui-même alors +vous obtenez tout d’abord ‘LaTeX Error: Can be used only in +preamble’. Les exécutions suivantes donnent ‘TeX capacity +exceeded, sorry [text input levels=15]’. Pour réparer cela, vous devez +enlever l’inclusion \include{racine} mais aussi détruire +le fichier racine.aux et exécuter de nouveau &latex;. + + + + - + \input \input @@ -9375,45 +12915,147 @@ n’est trouvé avec ce nom, alors on essaie le nomfichier - -Prologue et épilogue + +Parties pré/post-liminaires - -Tables des matières + +Table des matières etc. table des matière, création \tableofcontents .toc, fichier -On produit une table des matières avec la commande -\tableofcontents. Placez la commande à l’endroit même où vous -voulez que la table des matière apparaisse ; &latex; fera le reste pour -vous. Une seconde compilation est nécessaire pour qu’un fichier -.toc ait été produit à la précédente. - -La commande \tableofcontents produit un titre, mais il ne produit -pas automatiquement un début de nouvelle page. Si vous voulez une -nouvelle page après la table des matières, mettez une commande -\newpage après la commande \tableofcontents. - \listoffigures \listoftables -Les commandes analogues \listoffigures et \listoftables -produisent respectivement une liste des figures et une listes des -tableaux. Le fonctionnement est exactement le même que pour la table des matières. +.lof fichier +.lot fichier + +Synopsis, l’un parmi ceux qui suivent : -\nofiles -La commande \nofiles l’emporte sur ces commandes, et -empèche la génération de ces listes. +\tableofcontents +\listoffigures +\listoftables + +Produit une table des matières, ou une liste des figures, ou une liste +des tableaux. Placez la commande à l’endroit même où vous voulez que la +table ou liste apparaisse. Vous n’avez pas à la renseigner ; par +exemple, typiquement les entrées de la table des matières sont +automatiquement générées à partir des commandes de rubricage +\chapter, etc. + +L’exemple ci-dessous illustre la première commande, +\tableofcontents. &latex; produit une table des matières sur la +première page du livre. + +\documentclass{book} +% \setcounter{tocdepth}{1} +\begin{document} +\tableofcontents\newpage + ... +\chapter{...} + ... +\section{...} + ... +\subsection{...} + ... +\end{document} + +En décommentant la deuxième ligne on peut limiter la table à ne lister +que les rubriques issues de \chapter et \section, mais pas +celle issue de \subsection, parce que la commande \section +a pour niveau 1. See Sectioning pour les numéros de niveaux des +rubriques. Pour plus ample information sur tocdepth +see Sectioning/tocdepth. + +Un autre exemple de l’utilisation de \tableofcontents est dans +Larger book template. + +Si vous désirez un saut de page après la table des matières, insérez une commande +\newpage après la commande \tableofcontents, comme ci-dessus. + +Pour fabriquer la table des matières, &latex; stocke l’information dans +un fichier auxiliaire nommé fichier-racine.toc +(see Splitting the input). Par exemple, le fichier +&latex; test.tex ci-dessous : + +\documentclass{article} +\begin{document} +\tableofcontents\newpage +\section{Premièrement} +\subsection{Deuxièmement} + ... + +écrit la ligne suivante dans test.toc : + +\contentsline {section}{\numberline {1}Premièrement}{2} +\contentsline {subsection}{\numberline {1.1}Deuxièmement}{2} + +L’indication section ou subsection donne le type de +rubrique. Le crochet \numberline vous permet de changer la façon +dont l’information apparaît au sein de la table des matières. Son +unique argument, 1 ou 1.1, est le numéro de la rubrique +alors que le reste du deuxième argument de \contentsline, +Premièrement ou Deuxièmement, est le titre. Finalement, +le troisième argument, 2, est le numéro de la page à laquelle les +rubriques débutent. + +Une conséquence de cette stratégie de stockage de fichier auxiliaire est +que pour obtenir correctement la page de table des matières vous devez +exécuter &latex; deux fois, une fois pour stocker l’information et une +fois pour l’obtenir. + + +En particulier, la première fois que vous exécutez &latex; sur un +nouveau document, la page de table des matières est vide hormis le titre +‘Table des matières’. Il suffit de l’exécuter de nouveau. + + +Les commandes \listoffigures et \listoftables produisent +une liste des figures et une liste des tables. Elles fonctionnent de la +même façon que les commandes pour la table des martières ; notamment +elles fonctionnent avec l’information stockée dans des fichiers +.lof et .lot. + +Pour modifier le titre de la page de table des matières, inspirez vous +la la première ligne de l’exemple suivant : + +\renewcommand{\contentsname}{Table des matières} +\renewcommand{\listfigurename}{Tracé de courbes} +\renewcommand{\listtablename}{Tableaux} + +paquetage babel +babel, paquetage + +paquetage polyglossia +polyglossia, paquetage + +De même, les deux autres lignes s’occupent des deux autres. Des +paquetages d’internationalisation tels que babel ou +polyglossia modifient les titres en fonction de la langue de base +sélectionnée. + +paquetage tocloft +tocloft, paquetage + +paquetage tocbibbind +tocbibbind, paquetage + +Le CTAN a beaucoup de paquetages traitant de la table des matières et +des listes de figures et de tableaux. L’un d’eux bien commode pour +ajuster certains aspects du traitement par défaut, tels que +l’espacement, est tocloft. Et tocbibbind permet d’ajouter +automatiquement la bibliograpghie, les indexes, etc. à la table des +matières. - + <literal>\addcontentsline</literal> \addcontentsline{ext}{unit}{texte} -table of contents entry, manually adding +table des matières, ajouter manuellement un article + Synopsis : @@ -9454,7 +13096,7 @@ suivantes, selon la valeur de l’argument ext : - + <literal>\addtocontents</literal> \addtocontents{ext}{texte} @@ -9472,10 +13114,39 @@ figures), ou lot (liste des tableaux). texte Le texte à écrire. + + +<literal>\nofiles</literal> + +\nofiles + +Synopsis : + +\nofiles + +Empêche &latex; d’écrire quelque fichier auxiliaire que ce soit. Les +seules sorites seront les fichiers .log et .pdf (ou +.dvi). Cette commande ne peut être placée que dans le preambule. + +À cause de la commande \nofiles dans cet exemple aucun fichier +.toc n’est produit. + +\documentclass{book} +\nofiles +\begin{document} +\tableofcontents\newpage +\chapter{...} + ... + +&latex; n’efface pas les fichiers auxiliaires existants, de sorte que +si vous insérer la commande \nofiles après avoir compilé le +fichier et obtenu un fichier .toc alors la page de table des +matières contiendra l’ancienne information. + - + Glossaires glossaires @@ -9496,9 +13167,9 @@ est la valeur courante de \thepage. Le paquetage glossary disponible sur le CTAN fournit une prise en charge de glossaires plus élaborée. - + - + Index index @@ -9517,7 +13188,8 @@ préambule. \indexentry{texte}{numpage}, où numpage est la valeur courante de \thepage. -« Voir » et « Voir aussi », article d’index +Voir et Voir aussi, article d’index +article d’index, « Voir » et « Voir aussi » Pour générer un article d’index pour « toto » qui dit « Voir titi », utilisez une barre verticale : \index{toto|see{titi}}. Utilisez seealso au lieu de see pour fabriquer un article @@ -9525,6 +13197,11 @@ en « Voir aussi ». \seename \alsoname +paquetage babel +babel, paquetage +paquetage polyglossia +polyglossia, paquetage + Le texte « Voir » est défini par la macro \seename, et le texte « Voir aussi » par la macro \alsoname. Ils peuvent être redéfinis pour d’autres langages. @@ -9542,6 +13219,7 @@ pour composer l’index. \printindex paquetage makeidx makeidx, paquetage + L’index est d’ordinaire généré avec la commande \printindex. Celle-ci est définie dans le paquetage makeidx, ainsi vous devez mettre \usepackage{makeidx} dans le préambule. @@ -9553,12 +13231,14 @@ nouvelle lettre dans l’index imprimé ; sa valeur par défaut est paquetage showidx showidx, paquetage + Le paquetage showidx a pour effet que chaque article de l’index est affiché dans la marge de la page où l’article apparaît. Ceci peut aider à la préparation de l’index. paquetage multind multind, paquetage + Le paquetage multind prend en charge la pluralité des index. Voir aussi l’article de la FAQ &tex; FAQ à ce propos, http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind. @@ -9566,7 +13246,7 @@ Voir aussi l’article de la FAQ &tex; FAQ à ce propos, - + Des lettres lettres, écrire des écrire des lettres @@ -9662,7 +13342,7 @@ I ne suis pas intéressé à faire affaire avec vous. - + <literal>\address</literal> \address @@ -9681,14 +13361,14 @@ individuel. Cette commande est optionnelle : sans la déclaration \address la lettre est formatée avec un espace à blanc en haut de sorte à pouvoir -être imprimée sur du papier à en-tête pré-imprimé. (Voir Overview, +être imprimée sur du papier à en-tête pré-imprimé. (See Overview, pour les détails concernant votre implémentation locale). Avec la déclaration \address, elle est formatée comme une lettre personnelle. - + <literal>\cc</literal> \cc @@ -9710,7 +13390,7 @@ les avec une double contr’oblique \\, comme dans : - + <literal>\closing</literal> \closing @@ -9733,7 +13413,7 @@ optionnelle). Par exemple : - + <literal>\encl</literal> \encl @@ -9747,7 +13427,7 @@ optionnelle). Par exemple : - + <literal>\location</literal> \location @@ -9760,7 +13440,7 @@ seulement si le style de la page est firstpage. - + <literal>\makelabels</literal> \makelabels @@ -9812,7 +13492,7 @@ préambule : - + <literal>\name</literal> \name @@ -9823,7 +13503,7 @@ retour. - + <literal>\opening{<replaceable>texte</replaceable>}</literal> \opening lettres, commencer @@ -9841,7 +13521,7 @@ texte d’appel de votre lettre. Par exemple : - + <literal>\ps</literal> \ps postscriptum, dans une lettre @@ -9856,7 +13536,7 @@ texte d’appel de votre lettre. Par exemple : - + <literal>\signature{<replaceable>texte</replaceable>}</literal> \signature @@ -9915,7 +13595,7 @@ le préambule). - + <literal>\telephone</literal> \telephone @@ -9933,13 +13613,137 @@ il apparaît en bas à droite de la page. - + Entrée/sortie console entrée/sortie console + +<literal>\openin</literal> & <literal>\openout</literal> + +\openin +\openout +\closein +\closeout +file, opening +file, closing +open a file + +Synopsis : + +\openin numéro=nomfichier + +ou : + +\openout numéro=nomfichier + +Ouvre un fichier pour y lire, ou pour y écrire. Le numéro doit +être entre 0 et 15, comme dans \openin3 (dans Lua&latex; numéro +peut être entre 0 et 255). + +Ici &tex; ouvre le fichier le fichier presidents.tex en lecture. + +\newread\fichierpresidents +\openin\fichierpresidents=presidents +\typeout{fichierpresidents vaut \the\fichierpresidents} +\read\fichierpresidents to\presidentligne +\typeout{\presidentligne} + +La commande \newread alloue des numéros de flux d’entrée de 0 +à 15 (il y a aussi une commande \newwrite). La variable +\fichierpresidents est plus facile à mémoriser mais sous le capot +ce n’est rien de plus qu’un numéro ; le premier \typeout donne +queleque-chose du genre de ‘fichierpresidents vaut 1’. De plus, +\newread garde la trace de l’allocation de sorte que si vous en +utilisez trop alors vous obtiendrez une erreur du genre de ‘! No +room for a new \read’. Le second \typeout produit la première +ligne du fihcier, quelque-chose du genre de ‘1 Bonaparte, +Louis-Napoléon’. + +D’ordinaire &tex; n’essaie pas d’ouvrir le fichier jusqu’à la prochaine +éjection de page. Pour changer cela, utilisez +\immediate\openin numéro=nomfichier ou +\immediate\openout numéro=nomfichier. + +Fermez les fichiers avec \closein numéro et +\closeout numéro. + +La façon dont &latex; manipule les noms de fichiers varie selon les +distributions, et peut même varier d’une version à l’autre d’une même +distribution. Si le nom de fichier n’a pas d’extension alors &tex; y +ajoute un .tex. L’exemple suivant crée presidents.tex, y +écrit une ligne, et le ferme. + +\newwrite\fichierpresidents +\openout\fichierpresidents=presidents +\write\fichierpresidents{1 Bonaparte, Louis-Napoléon} +\closeout\fichierpresidents + +Mais les noms de fichier avec un point peuvent causer des problèmes : si +&tex; tombe sur un nomfichier comme presidents.dat il se +peut qu’il cherche d’abord presidents.dat.tex et ensuite +presidents.dat, ou bien le contraire. La documentation de votre +distribution devrait en dire plus, et si cela fonctionne pour vous tant +mieux, mais pour assurer une portabilité complète le mieux et d’utiliser +des noms de fichier ne contenant que les vingt-six lettres ASCII +(insensible à la casse case-sensitive) et les dix chiffres, ainsi que +les tiret de 8 ‘_’ et de 6 ‘-’, et en particulier sans point +ni espace. + +Pour \openin, si &tex; ne peut pas trouver le fichier alors il +ne produit pas une erreur. Il ne fait que considérer que ce flux n’est +pas ouvert (ce qu’on peut vérifier avec \ifeof ; on peut +également recourir à la commande \InputIfFileExists, see Class +and package commands). Si vous essayer d’utiliser le même numéro deux +fois, &latex; ne produit pas d’erreur. Si vous essayer d’utiliser un +mauvais numéro, alors vous obtiendrez un message d’erreur du genre de +‘! Bad number (16). <to be read again> = l.30 \openin16=test.jh’. + + + +<literal>\read</literal> + +\read +fichier, lecture d’un +lire un fichier +lecture d’un fichier + +Synopsis : + +\read numéro tomacro + +Fait que la commande macro contienne la ligne suivante d’entrée du +flux de texte numéro, comme dans \read5 to\data. + +L’exemple suivant ouvre le fichier mel.tex en lecture, me le +contenu de la première ligne dans la commande \courriel, et +ensuite ferme le fichier. + +\newread\fichierreception +\openin\fichierreception=mel +\read\fichierreception to\courriel +\typeout{Adresse mél : \courriel} +\closein\fichierreception + +Si numéro est hors de l’intervalle de 0 à 15 ou si aucun fichier +avec ce numéro n’est ouvert, ou si le fichier est à sa fin, alors +\read prend son entrée à partir du terminal. Notez, cependant, +que la méthode naturelle en &latex; de prendre en entrée à partir du +terminal est \typein (see \typein). + +Pour lire un fichier entier en une fois utilisez \input +(see \input) ou \include (see \include & \includeonly). + +paquetage datatool +datatool, paquetage + - +Une raison usuelle de vouloir lire d’un fichier de données est de faire +du publipostage. CTAN a plusieurs paquetage pour cela ; parmi lesquels +datatool. + + + <literal>\typein[<replaceable>cmd</replaceable>]{<replaceable>msg</replaceable>}</literal> \typein @@ -9958,7 +13762,7 @@ le texte en entrée qui a été tapé. - + <literal>\typeout{<replaceable>msg</replaceable>}</literal> \typeout @@ -9978,41 +13782,661 @@ commande s’appliquent à msg. Une commande \sp l’entourent. Un ^^J dans msg tape un saut à la ligne. + +<literal>\write</literal> + +\write + +Synopsis : + +\write numéro{chaîne} + +Écrit chaîne vers le fichier journal (.log), vers le +terminal, ou vers un fichier ouvert par \openout. Par exemple, +\write6 écrit vers le flux textuel numéro 6 + +Si le code suivant apparaît dans le fichier fichierbase.tex +alors cela ouvre le fichier fichierbase.jh, y écrit +‘Bonjour tout le monde !’ et un saut le ligne, et ferme ce fichier. + +\newwrite\monfichier +\immediate\openout\monfichier=\jobname.jh % \jobname est le nom de base fichier racine +... +\immediate\write\monfichier{Bonjour tout le monde !} + ... +\immediate\closeout\monfichier + +\newwrite +Le \newwrite alloue un numéro de flux, en lui donnant un nom +symbolique pour se faciliter la vie, de sorte que flux +\newwrite\monfichier\the\monfichier produit quelque-chose du genre de +‘flux 3’. Ensuite \openout associe le numéro de flux avec +le nom de fichier fourni. Et puis à la fin &tex; exécute +\write3 ce qui place la chaîne dans le fichier. + +journal, écrire vers le fichier +terminal, écrire vers le +-1, écrire dans le flux numéro +Typiquement numéro est compris entre 0 et 15, parce que typiquement +les auteurs &latex; suivent l’exemple précédent et le numéro est alloué +par le système. Si numéro est hors de l’intervalle de 0 à 15 ou +si il n’est pas associé à un fichier ouvert alors &latex; écrit +chaîne vers le fichier journal. Si numéro est positif alors +ne plus &latex; écrit chaîne vers le terminal. Ainsi, test +\write-1{Bonjour tout le monde !} place ‘Bonjour tout le +monde !’ suivi d’un saut de ligne dans le fichier journal (c’est cez que +la commande \wlog fait ; see \wlog). Et +\write100{Bonjour tout le monde !} met la même chose dans le +fichier jornal mais aussi met ‘Bonjour tout le monde !’ suivi d’un +saut de ligne dans la sortie terminal. (Mais 16, 17, et 18 sont des +valeurs spéciales de numéro ; voir ci-dessous.) + +Lua&tex;, 256 flux de sortie dans +Dans Lua&tex;, au lieu de 16 flux de sortie il y en a 256 +(see &tex; engines). + +\@auxout +\@mainaux +Utilisez \write\@auxout{chaîne} pour écrire vers le +fichier .aux courant qui est associé soit au fichier racine soit +au fichier inclus courant ; et utilisez +\write\@mainaux{chaîne} pour écrire le fichier +.aux principal. Ces noms symboliques sont définis par &latex;. + + +Par défaut &latex; n’écrit pas chaîne vers le fichier +immediatement. C’est ainsi parce que, par exemple, vous pourriez avoir +besoin de \write pour sauvegarder le numéro de page courant, mais +au moment où &tex; rencontre une commande \write tpyiquement il +ne connaît pas quel est le numéro de page, puisque il n’a pas encore +découpé la sortie en pages. Ainsi, vous utilisez \write dans +l’un des trois contextes suivants : + +\immediate\write\@auxout{chaîne} %1 +\write\@auxout{chaîne} %2 +\protected@write\@auxout{}{chaîne} %3 + +\write immédiat +\immediate\write +Avec le premier, &latex; écrit chaîne vers le fichier +immédiatement. Toutes les macros dans chaîne sont développées à +fond (exactement comme dans \edef de sorte que pour empêcher le +développement vous devez utiliser \noexpand, un toks, etc. +mais avec la différence que vous devez utiliser # au lieu de +##). + +\write retardé +élément extraordinaire +\shipout et développement +Avec le deuxième, chaîne est stocké dans la liste courante des +choses (comme un élémént « extraordinaire » de &tex;) et conservé +jusqu’à ce que la page soit éjectée et de la même manière les macros ne +sont pas développées jusqu’à l’éjection (\shipout). Au moment du +\shipout, chaîne est développée à fond. + +\protected@write +Le troisième, \protected@write, est sembable au deuxième sauf +que vous pouvez utiliser \protect pour éviter le +développement. Le premier argument qui est en plus vous permet d’insérer +locallement des définitions supplémentaires pour que plus de macros +soient protégées ou pour avoir d’autres définitions spéciales pendant +l’écriture. + + +Voici un exemple simple de développement avec \write dans lequel +chaîne contient une séquence de contrôle \triplex que l’on +a définie comme le texte ‘XYZ’ : + +\newwrite\fichierjh +\openout\fichierjh=test.jh +\newcommand{\triplex}{XYZ} +\write\fichierjh{test \triplex test} + +Ceci résulte en ce que le fichier test.jh contienne le texte +‘test XYZtest’ suivi d’un saut de ligne. + +\write, flux 16, 17, 18 +Les cas où numéro vaut 16, 17, ou 18 sont spéciaux. À cause du +comportement de \write quand numéro est hors de +l’intervalle de 0 à 15 qu’on a déjà décrit plus haut, dans Plain &tex; +\write16 et \write17 étaient parfois utilisés pour écrire +dans le fichier journal et le terminal ; toutefois, dans &latex;, la +façon naturelle de faire ceci est d’utiliser \typeout +(see \typeout). La commande \write18 est encore plus +spéciale ; les systèmes &tex; modernes l’utilisent pour passer des +commandes au système d’exploitation (see \write18). + +saut de ligne, dans \write +^^J, dans \write +D’ordinaire \write produit en sortie une unique ligne. On peut y +insérer un saut de ligne avec ^^J. Ainsi, l’exemple suivant +produit deux lignes dans le fichier journal : + +\wlog{Les lignes parallèles ont beaucoup en commun.^^JMais elles ne se +rencontrent jamais.} + +paquetage answers +answers, paquetage + +Un cas usuel dans lequel des auteurs tentent d’écrire dans leur propre +fichier est pour les réponses à des exerccies, ou dans quelque autre +situation où vous désirer écrire en sortie verbatim, sans développer les +macros. CTAN a plusieurs paquetages pour cela ; parmi lesquels +answers. + + + +<literal>\write</literal> et la sécurité + +securité et \write +\write et sécurité + +La possibilité d’écrire dans des fichier soulève des problèmes de +sécurtié. Si vous compilez un fichier &latex; téléchargé et qu’il +écrase votre fichier de mots de passe alors vous serez à juste titre +embêté. + +Ainsi par défaut les systèmes &tex; ne vous autorisent à ouvrir en +écriture que les fichiers qui sont dans le répertoire courant ou dans un +sousrépertoire. L’exemple suivant + +\newwrite\fichierjh +\openout\fichierjh=../test.jh + +produit une erreur du genre de : +Not writing to ../test.jh (openout_any = p). +! I can't write on file `../test.jh' + +répertoires parents, impossible d’écrire vers +Il est possible d’avoir une telle erreur lorsqu’on essaie d’utiliser une +commande telle que \include{../nomfichier} puisque &latex; va +essayer d’ouvrir ../filename.aux. La solution la plus simple est +de placer les fichiers inclus dans le même répertoire que le fichier +racine, ou dans des sous-répertoires. + + + +<literal>\message</literal> + +\message + +Synopsis : + +\message{chaîne} + +Écrit chaîne vers le fichier journal en .log et le +terminal. + +Typiquement, les auteurs &latex; utilisent \typeout +(see \typeout) qui permet d’utiliser \protect sur toute +commande fragile au sein de chaîne (see \protect). Mais la +commande \typeout insère un saut de ligne à la fin de +chaîne contrairement à \message, aussi cette dernière peut +être utile. + +Dans l’exemple ci-dessous dans le corps du document + +avant\message{Un Deux}\message{Trois}\message{Quatre^^JLes} +\message{pouces vont se battre.}Après + +dans certaines circonstances (voir ci-dessous) &latex; écrit ce qui suit +à la fois vers le terminal et le fichier journal. + +Un Deux Trois Quatre +Les pouces vont se battre. + +Un ^^J produit un saut de ligne. Aussi, dans le document +en sortie, on a entre ‘avant’ et ‘Après’ un seul espace (issu +de la fin de ligne suivant ‘Les}’). + +Alors que \message vous permet de mieux contrôler le formatage, +un truc à piger c’est que &latex; peut très bien bousiller ce formatage +là en insérant des sauts de ligne selon ce qu’il a déjà sorti. Comparez +ce corps de document, où le ‘Deux’ a été déplacé, à celui donné en +exemple plus haut. + +avant\message{Un}\message{Deux Trois}\message{Quatre^^JLes} +\message{pouces vont se battre.}Après + +La chose suivante peut se produire : lorsque &latex; produit les +messages en sortie vers le terminal, le message avec ‘Un’ désormais +plus court tient à la fin de la ligne de terminal, et du coup &latex; +saute de ligne juste après lui et avant le ‘Deux Trois’. Ce saut +de ligne apparaît également dans le fichier journal. Cette insertion de +saut de ligne peut déprendre de, par exemple, la longueur des noms +complet des fichiers inclus. C’est pourquoi il est difficile de produire +des lignes formatées précisément et d’une façon qui soit portable, et de +même de demander que votre message commence au début d’une ligne. + + + + +<literal>\wlog</literal> + +\wlog + +Synopsis : + +\wlog{chaîne} + +Écrit chaîne vers le fichier journal .log. + +\wlog{Pour tout n différent de 0, et tout x, (sin x)/n vaut six.} +\wlog{Ben oui, il suffit de simplifier par n.} + +D’ordinaire chaîne apparaît sur une seule ligne séparée. Utilisez +^^J pour insérer un saut de ligne. + +\wlog{C'est Helvetica qui téléphone à Times Roman :} +\wlog{Change de ligne !^^JJe t'entends très mal.} + + + + +<literal>\write18</literal> +\write18 +externes, commandes +commandes exécutées depuis &latex; +système, commandes exécutées depuis &latex; +interpréteur de commandes du système d’exploitation, accès à + + +Synopsis : + +\write18{commande_shell} + +É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. + +paquetage Asymptote +Asymptote, paquetage + +La séquence suivante (sur Unix) + +\usepackage{graphicx} % dans le préambule + ... +\newcommand{\numerofig}{1} +\immediate\write18{cd pix && asy figure\numerofig} +\includegraphics{pix\figure\numerofig.pdf} + +exécute Asymptote (le programme asy) sur le fichier +pix/figure1.asy, de sorte que le document peut par la suite lire +le graphique en résultant (see \includegraphics). Comme pour tout +\write, ici &latex; développe les macros contenues dans +commande_shell de sorte que \numerofig est remplacé par +‘1’. + +Un autre exemple est que vous pouvez exécuter automatiquement Bib&tex; +au début de chaque exécution de &latex; (see Using BibTeX) en +incluant \immediate\write18{bibtex8 \jobname} comme première +ligne du fichier. Notez que \jobname se développe par défaut en +le nom de base du fichier racine, ou bien l’argument de l’option +--jobname si celle-ci est passée sur la ligne de commande. + +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 +texosquery plus bas) : + +\immediate\write18{ls *.pdf > tmp.dat} +\input{tmp.dat} + +Le comportement standard de tout \write est d’attendre jusqu’à la +prochaine éjection de page avant de développer les macros ou d’écrire +dans le flux (see \write). Mais il se peut que vous désiriez que +cela soit immédiat. Pour cela, utilisez +\immediate\write18{commande_shell}. + +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 latex --enable-write18 nomfichier (see Command line +options). (L’option --shell-escape est un synonyme dans &tex; +Live.) + +restreint, accès shell +restreint, accès interpréteur de commande du système d’exploitation +Au lieu de l’accès complet, les distributions modernes 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 +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 (see Command line options). + +Certains paquetage ont besoin d’exécuter des commandes système +externes. Par exemple sagetex vous permet de faire faire des +calcul ou tracer des graphiques au logiciel de mathématiques Sage, +puis d’incorporer ces sorties dans votre document. Pour cela vous devez +exécuter &latex; avec la fonction \write18 pleinement débridée. + +/bin/sh, utilisé par \write18 +sh, utilisé par \write18 +cmd.exe, utilisé par \write18 +SHELL, environnement, variables de +SHELL, variables d’environnement +Le texte commande_shell est toujours passé à /bin/sh sur +les systèmes d’exploitation unixiens, et à l’interpréteur de commande DOS +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 SHELL. + +paquetage texosquery +texosquery, paquetage + +système, information +exploitation, information système de +locale, information, du système +répertoire, listage, du système +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 texosquery qui +fournit une interface commode et sûre pour cela, contrairement aux +exemples donnés plus haut utilisant \write18 à l’état brut : +https://ctan.org/pkg/texosquery. + + + - + Ligne de commande ligne de commande -La spécification du fichier d’entrée indique le fichier à être formaté ; -&tex; utilise .tex comme extension de fichier par défaut. Si -vous omettez complètment le fichier d’entrée, &tex; accèpte en entrée -les caractères saisis à partir de la console. Vous spécifiez les -options de commande en fournissant une chaîne en paramètre de la -commande ; par ex. +Synopsis (depuis la ligne de commande d’un terminal) : + +pdflatex options argument + +Exécute &latex; sur argument. À la place de pdflatex +vous pouvez aussi utiliser xelatex, ou lualatex, ou +latex. + +L’exemple suivant exécute &latex; sur le fichier these.tex +produisant en sortie these.pdf. + +pdflatex these + +.tex, extension par défaut +Notez que .tex est l’extension par défault des noms de fichier. + +pdf&tex; est une évolution du programme original &tex;, comme le sont +Xe&tex; et Lua&tex; (see &tex; engines). Ils sont complètement +rétrocompatibles. Mais le programme original avait son propre format de +sortie, DVI, alors que les plus récents peuvent produire directement un +PDF en sortie. Ceci leur permet de profiter des fonctions +supplémentaires des PDF tels que les hyperliens, la prise en charge de +formats modernes d’images tels que JPG et PNG, et les programmes de +visionnage que l’on trouve de partout. En bref, si vous exécutez +pdflatex ou xelatex ou lualatex alors par +défaut vous obtenez un PDF et avez accès à toutes ses fonctions +modernes. Si vous exécutez latex, ou dvilualatex, +alors vous obtenez un DVI. La description faite ici suppose +pdf&latex;. + +See Command line options, pour une sélection des options de ligne de +commande les plus utiles. Quant à argument, le cas habituel est +qu’il ne commence pas par une contr’oblique, dans ce cas le système le +prend pour un nom de fichier, et compile ce fichier. Si argument +commence avec une contr’oblique, alors le système l’interprète comme une +ligne d’entrée à &latex;, ce qui peut être utilisé pour obtenir +certains effets spéciaux (see Command line input). + +Si vous ne donnez aucun arguments ni options alors pdflatex +invite à saisir à partir du terminal. Vous pouvez vous échapper de cela +en entrant CTRL-D. + +Si &latex; trouve une erreur dans votre document alors par défaut il +s’arrête et vous interroge à ce propos. See Recovering from errors +pour un aperçu de quoi faire. + + + + +Options passées à la ligne de commande + +options passée à la ligne de commande + +On décrit ici les options de ligne de commande qui sont pertinentes pour +rédaction ordinaire de documents. Pour une liste complète, essayez +d’exécuter ‘latex --help’ depuis la ligne de commande. + +Les implementations permettent en général de spécifier les options de +ligne de commande avec un prefixe ‘-’ ou ‘--’. C’est le cas à +la fois pour &tex; Live (et Mac&tex;) et MiK&tex;. Ici on utilise +les deux conventions indistinctement. + +--version ligne de commande, option +-version +Affiche la version courante, comme ‘pdfTeX 3.14159265-2.6-1.40.16 +(TeX Live 2015/Debian)’ ainsi qu’une petite quantité d’information +supplémentaire, et se termine. + +--help ligne de commande, option +-help +Produit un message bref d’utilisation servant d’aide-mémoire et se +termine. + +--interaction ligne de commande, option +-interaction=mode +batchmode +scrollmode +errorstopmode +nonstopmode +z&tex; compile un document en l’un parmi quatre modes possibles +d’interaction : batchmode, nonstopmode, scrollmode, +errorstopmode. Dans le mode errorstopmode (le mode par +défaut), &tex; s’arrête à chaque erreur et demande une intervention de +l’utilisateur. Dans le mode batchmode il n’imprime rien sur le +terminal, on défile sur les erreurs comme si l’utilisateur appuyait +RETURN à chaque erreur, et les fichiers manquants entrainent la +terminaison de la tâche. Dans le mode nonstopmode, les messages de +diagnostic apparaissent sur le terminal mais comme dans le mode batch il +n’y as pas d’interaction avec l’utilisateur. Dans le mode +scrollmode, &tex; s’arrête en cas de fichiers manquants ou +d’entrée clavier, mais pour nulle autre raison. + +Par exemple, en démarrant &latex; avec cette ligne de commande : + +pdflatex -interaction=batchmode nomfichier + +on élimine la plupart des sorties terminal. + +jobname +nom de fichier de la tâche courante +--jobname ligne de commande, option +-jobname=chaîne +Règle la valeur du nom de tâche de &tex; à la chaîne de +caractères chaîne. Le fichier journal et le fichier de sortie +s’appeleront chaîne.log et chaîne.pdf. + +Quand vous exécutez pdflatex options +argument, si argument ne commence pas par une contr’oblique +alors &tex; considère que c’est le nom d’un fichier à lire en +entrée. Autrement il attend la première instruction \input et le +nom du fichier en entrée devient le nom de tâche +(\jobname). Celui-ci est utilisé pour nommer le fichier journal +et le fichier de sortie. L’option jobname l’emporte et spécifie +directement le nom. See Command line input, pour un examples +d’usage. + +répertoire de sortie pour tous les fichiers externes +sortie, pour tous les fichiers externes, répertoire de +--output-directory ligne de commande, option +-output-directory=répertoire +Écrit les fichiers dans le répertoire répertoire. Il doit déjà +exister. Ceci s’applique à tous les fichiers externes créés par &tex; +ou &latex;, tels que le fichier .log de l’exécution, les +fichiers .aux, .toc, etc., créés par &latex;, de même que +le fichier de sortie principal .pdf ou .dvi lui-même. + +Lorsqu’il est spécifié, le répertoire de sortie répertoire est +aussi vérifié en premier automatiquement pour tout fichier lu en entrée, +de sorte que les fichiers externes peuvent être relus en entrée, si +désiré. Le vrai répertoire courant (dans lequel &latex; été lancé) +demeure inchangé, et est également vérifié pour trouver les fichiers en +entrée. + +shell escape +\write18, activation +--enable-write18 ligne de commande, option +--disable-write18 ligne de commande, option +--shell-escape ligne de commande, option +--no-shell-escape ligne de commande, option +--enable-write18 +--disable-write18 +--shell-escape +--no-shell-escape +Activation et desactivation \write18{commande_shell} +(see \write18). Les deux premières options sont prises en charge à +la fois par &tex; Live et MiK&tex;, alors que les deux suivantes sont +des synonymes pris en charge par &tex; Live. + +Activer cette fonction a des implications lourdes de sécurité, puisque +cela permet à un fichier &latex; d’exécuter n’importe quelle commande. +Ainsi, par défaut, le \write18 non restreint n’est pas autorisé. +(Le réglage par défaut de &tex; Live, Mac&tex;, et MiK&tex; est +d’autoriser l’exécution d’un nombre limité de programmes en relation +avec &tex;, et qu’elles distribuent). + +Pa exemple, si vous invoquez &latex; avec l’option +no-shell-escape, et que dans votre document vous appelez +\write18{ls -l}, alors vous n’obtenez pas d’erreur mais votre +fichier journal dit ‘runsystem(ls -l)...disabled’. + +--halt-on-error ligne de commande, option +-halt-on-error +Arrête le traitement sur la première erreur. + +--file-line-error ligne de commande, option +--no-file-line-error ligne de commande, option +-file-line-error +-no-file-line-error +Active ou désactive le style +nomfichier:numéroligne:erreur des messages +d’erreur. Ces options ne sont disponibles qu’avec &tex; Live ou +Mac&tex;. + + + + +Spécifier du code LaTeX sur la ligne de commande + +code entré sur la ligne de commande +entré, code sur la ligne de commande + +Au sein de l’invocation de ligne de commande pdflatex +options argument vous pouvez spécifier du code &latex; +arbitraire en entrée en commençant argument par une +contr’oblique. Ceci permet de faire certains effet spéciaux. + +paquetage hyperref +hyperref, paquetage + + +Par exemple, ce fichier (qui utilise le paquetage hyperref pour +les hyperliens) peut produire deux types de sortie, l’un pour +l’impression papier et l’autre pour une consultation PDF. -latex '\nonstopmode\input foo.tex' +\ifdefined\paperversion % dans le préambule +\newcommand{\urlcolor}{black} +\else +\newcommand{\urlcolor}{blue} +\fi +\usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref} + ... +\href{https://www.ctan.org}{CTAN} % dans le corps + ... -Traitera foo.tex sans faire de pause après chaque erreur. +Lorsqu’on compile ce document book.tex avec la ligne de commande +pdflatex book le lien ‘CTAN’ sera en bleu. Mais si on le +compile avec pdflatex "\def\paperversion{}\input book.tex", +alors le lien sera en noir. (Notez l’utilise des guillemets anglais +pour empécher l’interpretation des symboles par l’interpréteur de ligne +de commande ; votre système fait peut-être cela différemment). + +De même, à partir d’un seul fichier principal.tex vous pouvez +compiler deux versions distinctes. + + +pdflatex -jobname=etudiants "\def\etudiants{}\input{principal}" +pdflatex -jobname=professeurs "\def\profs{}\input{principal}" + +L’option jobname est là parce que sinon les deux fichiers en +sortie s’appeleraient principal.pdf et le second écraseraient le +premier. + +Dans ce dernier exemple on charge le paquetage graphicx avec l’option +draft + + +pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}" + +de sorte que les fichiers graphiques ne sont lus que pour l’information +de dimension de boîte englobante, mais non incorporés dans le PDF. +(L’option jobname est la parce que sinon autrement le fichier de +sortie s’appelerait graphicx.pdf, comme \RequirePackage +fait lui-même un \input). + + + + +Quand quelque chose se passe mal + +Si &latex; trouve une erreur dans votre document alors il vous produit +un message d’erreur et vous invite à la saisie par un point +d’interrogation, ?. Par exemple, exécuter &latex; sur ce fichier + +\newcommand{\NP}{\ensuremath{\textbf{NP}}} +Le problème \PN{} est mis à prix à un million de dollars. + +a pour effet qu’il affiche ceci, et attende une saisie : + +! Undefined control sequence. +l.5 Le problème \PN + {} est mis à prix à un million de dollars. +? + +Le plus simple est de saisir x et RETURN et de corriger la +coquille. Alternativement vous pourriez saisir ? et RETURN +pour voir les autres options. -invite ‘* *’, invite +invite ‘* \stop -Si &latex; s’arrête au milieu du document et vous fait une invite en -‘*’, c’est qu’il attend que vous saisissiez quelque chose. Vous -pouvez taper \stop (et retour-chariot) et il terminera -prématurément le document. +Il y a deux autres scénarios. Le premier est que vous ayez omis le +\end{document} ou fait une faute de frappe dessus. Dans ce cas +&latex; produit en invite ‘*’. Vous pouvez revenir à la ligne de +commande en tapant \stop et RETURN. + +Le dernier scénario est que vous ayez fait une faute de frappe sur le +nom de fichier. Par exemple, au lieu de pdflatex test vous +auriez tapé pdflatex tste. -Voir &tex; engines, pour les autres commandes système invoquant &latex;. +! I can't find file `tste'. +<*> tste + +(Press Enter to retry, or Control-D to exit) +Please type another input file name: + +Le plus simple est de saisir CTRL D (en appuyant sur les touches +Control et d simultannément), et d’ensuite retaper la ligne de commande +correcte. + + Patrons de documents patron de document modèle de document -Bien que ce ne soit pas un matériel de référence, peut-être que ces -patrons de document vous seront utiles. Davantage de resources de -patrons sont listé à http://tug.org/interest.html#latextemplates. +Bien qu’ils soient illustratifs, ces patrons de document vous seront +put-être utiles. Davantage de ressources de patrons sont listées à +https://tug.org/interest.html#latextemplates. @@ -10021,6 +14445,9 @@ patrons sont listé à beamer patron et classe patron, beamer +paquetage beamer +beamer, paquetage + La classe beamer crée des présentations en diapositives. Elle a de très nombreuses possibilités, mais voici un patron de base : @@ -10030,7 +14457,7 @@ de très nombreuses possibilités, mais voici un patron de base : \title{Patron pour la classe Beamer} \author{Alex L'Auteur} -\date{31 juillet 2007} +\date{31 juillet 2020} \begin{document} @@ -10048,17 +14475,44 @@ de très nombreuses possibilités, mais voici un patron de base : \end{document} -Une ressource web pour cela : -http://robjhyndman.com/hyndsight/beamer/. +Le paquetage Beamer sur le CTAN : +https://ctan.org/pkg/beamer. + + + +Patron <literal>article</literal> + +patron (simple), article + +Un patron simple pour un article. +\documentclass{article} +\title{Patron de la classe article} +\author{Alex Author} + +\begin{document} +\maketitle + +\section{Première section} +Du texte. +\subsection{Première section, première sous-section} +Encore du texte. + +\section{Deuxième section} +Et du texte. + +\end{document} + - + Un patron <literal>book</literal> patron, book - +Voici un patron simple pour un livre. See Larger book template pour +un patron plus élaboré. + \documentclass{book} \title{Le Patron de la classe book} \author{Alex L'Auteur} @@ -10074,100 +14528,72 @@ Et du texte. \section{Un sujet secondaire} La fin. + \end{document} - -Un patron <literal>tugboat</literal> + +Un patron <literal>book</literal> plus élaboré -patron, TUGboat -classe ltugboat +patron book -TUGboat est la revue du groupe des utilisateur de &tex; (&tex; -Users Group), http://tug.org/TUGboat. +Voici un patron quelque peu élaboré pour un livre. See book template +pour un patron plus simple. -\documentclass{ltugboat} -\usepackage{graphicx} -\usepackage{ifpdf} -\ifpdf -\usepackage[breaklinks,hidelinks]{hyperref} -\else -\usepackage{url} -\fi - -\title{Exemple d'article \TUB} +Ce patron utilise un \frontmatter, \mainmatter, et +\backmatter pour contrôler la typographie des trois zones +principales d’un livre (see \frontmatter & \mainmatter & +\backmatter). Le livre a une bibliographie et un index. + +Il est également à noter qu’il utilise \include et +\includeonly (see Splitting the input). Lorsque vous +travaillez sur un chapitre vous pouvez ne pas compiler tous les autres +chapitres en mettant en commentaire les entrées correspondantes dans les +arguments de \includeonly. Ceci accélère la compilation sans +perdre aucune information telle que les renvois. (Le matériel qu’il +n’est pas nécessaire de mettre sur une nouvelle page est inclus avec +\input au lieu de \include ; mais ceci au dépens du +bénéfice de maintenir les valeurs de renvois). + +\documentclass[titlepage]{book} +\usepackage{makeidx}\makeindex -% répétez l'information pour chaque auteur. -\author{Prénom Nom} -\address{Voie\\ Ville, Code postal \\ Pays} -\netaddress{user (at) exemple dot org} -\personalURL{http://exemple.org/~user/} +\title{Book Class Template} +\author{Alex Author} - %%% Fin des métadonnées %%% +\includeonly{% + frontcover, + preface, + chap1, + ... + } \begin{document} +\frontmatter +\include{frontcover} + % maybe comment out while drafting: +\maketitle \input{dedication} \input{copyright} +\tableofcontents +\include{preface} -\maketitle - -\begin{abstract} -Ceci est un exemple d'article pour le \TUB{}. -Prière d'écrire un abrégé. -\end{abstract} - -\section{Introduction} - -Ceci est un exemple d'article pour le \TUB, à partir du lien -\url{http://tug.org/TUGboat/location.html}. - -Nous recommandons le paquetage graphicx pour les inclusionj d'iimage, et -le paquetage hyperref pour des adresses réticulaires (url) actives (dans -la sortie \acro{PDF}). De nos jour le \TUB\ est produit en utilisant -exclusivement des fichiers \acro{PDF}. - -La classe \texttt{ltugboat} fournit ces abréviations (et bien d'autres) : - -% verbatim blocks are often better in \small -\begin{verbatim}[\small] -\AllTeX \AMS \AmS \AmSLaTeX \AmSTeX \aw \AW -\BibTeX \CTAN \DTD \HTML -\ISBN \ISSN \LaTeXe -\mf \MFB -\plain \POBox \PS -\TUB \TUG \tug -\UNIX \XeT \WEB \WEAVE - -\, \bull \Dash \dash \hyph - -\acro{FRED} -> {\small[er] fred} % prière d'utiliser ! -\cs{fred} -> \fred -\meta{fred} -> <fred> -\nth{n} -> 1st, 2nd, ... -\sfrac{3/4} -> 3/4 -\booktitle{Book of Fred} -\end{verbatim} - -Pour faire référence à d'autre numéros du \TUB\, veuillez utiliser le -format \textsl{volno:issno}, par ex., ``\TUB\ 32:1'' pour notre numéro -\nth{100}. - -Ce fichier n'est qu'un patron. La documentation du style \TUB\ est dans -le document \texttt{ltubguid} se trouvant à -\url{http://ctan.org/pkg/tugboat}. (Pour les références au \CTAN\ nous -recommandons cette forme d'URL utilisant \texttt{/pkg/} quand cela fait -sens ; ou, si vous avez besoin de faire référence spécifiquement à une -localisation : \texttt{http://mirror.ctan.org/\textsl{chemin}}.) - -Écrivez par mél à \verb|tugboat@tug.org| en cas de problèmes ou -questions. - -\bibliographystyle{plain} % nous recommandons le style de bibliographie plain -\nocite{book-minimal} % pour forcer la bibliographie à ne pas être vide -\bibliography{xampl} % xampl.bib est compris dans BibTeX +\mainmatter +\include{chap1} +... +\appendix +\include{appena} +... -\makesignature +\backmatter +\bibliographystyle{apalike} +\addcontentsline{toc}{chapter}{Bibliography} +\bibliography +\addcontentsline{toc}{chapter}{Index} +\printindex +\include{backcover} \end{document} - + + diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.html b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.html index e1a77e5142a..9d66eb106ba 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.html +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.html @@ -1,30 +1,29 @@ - + -manuel de référence officieux de LaTeX2e (Août 2017) + +Manuel de référence officieux de LaTeX2e (Septembre 2020) - - + + - - + - +