[latexrefman-commits] [SCM] latexrefman updated: r784 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Sun Apr 5 15:12:56 CEST 2020
Author: vincentb1
Date: 2020-04-05 16:12:55 +0300 (Sun, 05 Apr 2020)
New Revision: 784
Modified:
trunk/latex2e-fr.texi
Log:
Take latest version of node \includegraphics (still needing translation).
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-04-04 21:39:57 UTC (rev 783)
+++ trunk/latex2e-fr.texi 2020-04-05 13:12:55 UTC (rev 784)
@@ -2500,7 +2500,7 @@
numéro de niveau. Par exempe, if @code{tocdepth} vaut 1 alors la table
des matière contiendra les rubriques issues de @code{\section}, mais pas
cells de @code{\subsection}. La valeur par défaut de @LaTeX{} pour
- at code{secnumdepth} vaut 3 dans la classe @file{article} et 2 dans les
+ at code{tocdepth} vaut 3 dans la classe @file{article} et 2 dans les
classe @file{book} et @file{report}.
@end ftable
@@ -11716,13 +11716,14 @@
\end@{center@}
@end example
+ at noindent
will incorporate into the document the graphic in @file{plot.pdf},
centered and at its nominal size. You can also give a path to the file,
as with @code{\includegraphics@{graphics/plot.pdf@}}. To specify a list
of locations to search for the file, @pxref{\graphicspath}.
-If your filename includes spaces then put it in double quotes, as with
- at code{\includegraphics@{"sister picture.jpg"@}}.
+If your filename includes spaces then put it in double quotes. An example
+is @code{\includegraphics@{"sister picture.jpg"@}}.
The @code{\includegraphics@{@var{filename}@}} command decides on the
type of graphic by splitting @var{filename} on the first dot. You can
@@ -11760,7 +11761,7 @@
...
\begin@{center@}
\includegraphics@{pix/nix.png@}
- \captionof@{figure@}@{The spirit of the night@} \label@{pix:nix@} % if you want a caption
+ \captionof@{figure@}@{The spirit of the night@} \label@{pix:nix@} % optional
\end@{center@}
@end example
@@ -11768,18 +11769,16 @@
text, with the two vertically centered.
@example
-\newcommand*@{\vcenteredhbox@}[1]@{\begingroup
- \setbox0=\hbox@{#1@}\parbox@{\wd0@}@{\box0@}\endgroup@}
+\newcommand*@{\vcenteredhbox@}[1]@{\begin@{tabular@}@{@@@{@}c@@@{@}@}#1\end@{tabular@}@}
...
\begin@{center@}
-\vcenteredhbox@{
- \includegraphics[width=0.4\textwidth]@{plot@}@}
-\hspace@{1em@}
-\vcenteredhbox@{\begin@{minipage@}@{0.4\textwidth@}
- \begin@{displaymath@}
- f(x)=(1/x)\cdot \sin (1/x)
- \end@{displaymath@}
- \end@{minipage@}@}
+ \vcenteredhbox@{\includegraphics[width=0.4\textwidth]@{plot@}@}
+ \hspace@{1em@}
+ \vcenteredhbox@{\begin@{minipage@}@{0.4\textwidth@}
+ \begin@{displaymath@}
+ f(x)=x\cdot \sin (1/x)
+ \end@{displaymath@}
+ \end@{minipage@}@}
\end@{center@}
@end example
@@ -11797,10 +11796,7 @@
tall and so its origin is at (0,0).
The @file{graphicx} package gives you many more options. Specify them
-in a key-value form, as here. The options are read left-to-right. So
-the first graphic below is made one inch wide and then rotated, while
-the second is rotated and then made one inch wide. Thus, unless the
-graphic is perfectly square, the two will be different sizes.
+in a key-value form, as here.
@example
\begin@{center@}
@@ -11810,6 +11806,12 @@
\end@{center@}
@end example
+ at noindent
+The options are read left-to-right. So the first graphic above is made
+one inch wide and then rotated, while the second is rotated and then
+made one inch wide. Thus, unless the graphic is perfectly square, the
+two will end with different widths and heights.
+
There are many options. The primary ones are listed first.
Note that a graphic is placed by @LaTeX{} into a box, which is
@@ -11820,6 +11822,7 @@
graphic.
@table @code
+ at anchor{includegraphics width}
@item width
The graphic will be shown so its bounding box is this width. An example
is @code{\includegraphics[width=1in]@{plot@}}. You can use the standard
@@ -11831,37 +11834,44 @@
@code{\includegraphics[width=\linewidth-1.0cm]@{hefferon.jpg@}}.
@item height
+ at anchor{includegraphics height}
The graphic will be shown so its bounding box is this height. You can
use the standard @TeX{} dimensions (@pxref{Units of length}), and also
convenient are @code{\pageheight} and @code{\textheight} (@pxref{Page
-layout parameters}). For instance,
+layout parameters}). For instance, the command
@code{\includegraphics[height=0.25\textheight]@{godel@}} will make the
-graphic be a quarter of the height of the text area.
+graphic a quarter of the height of the text area.
@item totalheight
+ at anchor{includegraphics totalheght}
The graphic will be shown so its bounding box has this height plus
depth. This differs from the height if the graphic was rotated. For
instance, if it has been rotated by -90 then it will have zero height
but a large depth.
@item keepaspectratio
-If set to @code{true}, or just specified as with
- at code{\includegraphics[...,keepaspectratio,...]@{...@}}, then if you
-give as options both @code{width} and @code{height} (or
- at code{totalheight}) then @LaTeX{} will make the graphic is as large as
+ at anchor{includegraphics keepaspectratio}
+If set to @code{true}, or just specified as here
+
+ at example
+ at code{\includegraphics[...,keepaspectratio,...]@{...@}}
+ at end example
+
+ at noindent
+and you give as options both @code{width} and @code{height} (or
+ at code{totalheight}), then @LaTeX{} will make the graphic is as large as
possible without distortion. That is, @LaTeX{} will ensure that neither
is the graphic wider than @code{width} nor taller than @code{height} (or
@code{totalheight}).
@item scale
-Factor by which to scale the graphic. Specifying
- at code{\includegraphics[scale=2.0]@{...@}} makes the graphic twice its
-nominal size. This number may be any value; a number between 1
-and at tie{}0 will shrink the graphic and a negative number will reflect
-it.
+Factor by which to scale the graphic. To make a graphic twice its
+nominal size, enter @code{\includegraphics[scale=2.0]@{...@}}. This
+number may be any value; a number between 1 and at tie{}0 will shrink the
+graphic and a negative number will reflect it.
@item angle
-Rotate the picture. The angle is taken in degrees and counterclockwise.
+Rotate the graphic. The angle is taken in degrees and counterclockwise.
The graphic is rotated about its @code{origin}; see that option. For a
complete description of how rotated material is typeset,
@pxref{\rotatebox}.
@@ -11870,9 +11880,9 @@
The point of the graphic about which the rotation happens. Possible
values are any string containing one or two of: @code{l} for left,
@code{r} for right, @code{b} for bottom, @code{c} for center, @code{t}
-for top, and @code{B} for baseline. Thus,
+for top, and @code{B} for baseline. Thus, entering the command
@code{\includegraphics[angle=180,origin=c]@{moon@}} will turn the
-picture upside down from the center, while
+picture upside down about that picture's center, while the command
@code{\includegraphics[angle=180,origin=lB]@{LeBateau@}} will turn its
picture upside down about its left baseline. (The character @code{c}
gives the horizontal center in @code{bc} or @code{tc}, but gives the
@@ -11885,13 +11895,16 @@
These are lesser-used options.
@table @code
+ at anchor{includegraphics viewport}
@item viewport
Pick out a subregion of the graphic to show. Takes four arguments,
separated by spaces and given in @TeX{} dimensions, as with
@code{\includegraphics[.., viewport=0in 0in 1in 0.618in]@{...@}}. The
-dimensions default to big points. They are taken relative to the origin
-specified by the bounding box. See also the @code{trim} option.
+dimensions default to big points, at tie{}@code{bp}. They are taken
+relative to the origin specified by the bounding box. See also the
+ at code{trim} option.
+ at anchor{includegraphics trim}
@item trim
Gives parts of the graphic to not show. Takes four arguments, separated
by spaces, that are given in @TeX{} dimensions, as with
@@ -11901,17 +11914,25 @@
the bottom, 0.2 at tie{}inches on the right, and 0.3 at tie{}inches on the
top. See also the @code{viewport} option.
+ at anchor{includegraphics clip}
@item clip
-If set to @code{true}, or just specified as with
- at code{\includegraphics[...,clip,...]@{...@}}, then the graphic is
-cropped to the bounding box. You can get this effect by instead using
-the starred form of the command, as
+If set to @code{true}, or just specified as here
+
+ at example
+\includegraphics[...,clip,...]@{...@}
+ at end example
+
+ at noindent
+then the graphic is cropped to the bounding box. This is the same as
+using the starred form of the command,
@code{\includegraphics*[...]@{...@}}.
+ at anchor{includegraphics page}
@item page
-Give the page number of a multi-page PDF file. The default
+Give the page number of a multi-page PDF file. The default is
@code{page=1}.
+ at anchor{includegraphics pagebox}
@item pagebox
Specifies which bounding box to use for PDF files from among
@code{mediabox}, @code{cropbox}, @code{bleedbox}, @code{trimbox}, or
@@ -11926,23 +11947,34 @@
present, otherwise it will not use one of the others, with a
driver-defined order of preference. MediaBox is always present.
+ at anchor{includegraphics interpolate}
@item interpolate
Enable or disable interpolation of raster images by the viewer. Can be
-set with @code{interpolate=true} or just specified as with
- at code{\includegraphics[...,interpolate,...]@{...@}}.
+set with @code{interpolate=true} or just specified as here.
+ at example
+\includegraphics[...,interpolate,...]@{...@}
+ at end example
+
+ at anchor{includegraphics quiet}
@item quiet
Do not write information to the log. You can set it with
@code{quiet=true} or just specified it with
@code{\includegraphics[...,quite,...]@{...@}},
+ at anchor{includegraphics draft}
@item draft
-If you set it with @code{draft=true} or just specified it with
- at code{\includegraphics[...,draft,...]@{...@}}, then the graphic will not
-appear in the document, possibly saving color printer ink. Instead,
- at LaTeX{} will put an empty box of the correct size with the filename
-printed in it.
+If you set it with @code{draft=true} or just specify it with
+ at example
+\includegraphics[...,draft,...]@{...@}
+ at end example
+
+ at noindent
+then the graphic will not appear in the document, possibly saving color
+printer ink. Instead, @LaTeX{} will put an empty box of the correct
+size with the filename printed in it.
+
@end table
These options address the bounding box for Encapsulated PostScript
@@ -11956,6 +11988,7 @@
60/72 at tie{}inch tall.
@table @code
+ at anchor{includegraphics bb}
@item bb
Specify the bounding box of the displayed region. The argument is four
dimensions separated by spaces, as with @code{\includegraphics[.., bb=
@@ -11964,24 +11997,41 @@
only useful if the bounding box is missing from that file or if you want
to change it.
+ at anchor{includegraphics bbllx}
+ at anchor{includegraphics bblly}
+ at anchor{includegraphics bburx}
+ at anchor{includegraphics bbury}
@item bbllx, bblly, bburx, bbury
-Set the bounding box. (These four are obsolete, but are retained for
-compatibility with old packages.)
+Set the bounding box. These four are obsolete, but are retained for
+compatibility with old packages.
+ at anchor{includegraphics natwidth}
+ at anchor{includegraphics natheight}
@item natwidth, natheight
An alternative for @code{bb}. Setting
- at code{\includegraphics[...,natwidth=1in,natheight=0.618in,...]@{...@}}
+
+ at example
+\includegraphics[...,natwidth=1in,natheight=0.618in,...]@{...@}
+ at end example
+
+ at noindent
is the same as setting @code{bb=0 0 1in 0.618in}.
+ at anchor{includegraphics hiresbb}
@item hiresbb
If set to @code{true}, or just specified as with
- at code{\includegraphics[...,hiresbb,...]@{...@}}, then @LaTeX{} will look
-for @code{%%HiResBoundingBox} lines instead of @code{%%BoundingBox}
-lines. (The @code{BoundingBox} lines use only natural numbers while the
- at code{HiResBoundingBox} lines use decimals; both use units equivalent to
- at TeX{}'s big points, 1/72 at tie{}inch.) To override a prior setting of
- at code{true}, you can set it to @code{false}.
+ at example
+\includegraphics[...,hiresbb,...]@{...@}
+ at end example
+
+ at noindent
+then @LaTeX{} will look for @code{%%HiResBoundingBox} lines instead of
+ at code{%%BoundingBox} lines. (The @code{BoundingBox} lines use only
+natural numbers while the @code{HiResBoundingBox} lines use decimals;
+both use units equivalent to @TeX{}'s big points, 1/72 at tie{}inch.) To
+override a prior setting of @code{true}, you can set it to @code{false}.
+
@end table
These following options allow a user to override @LaTeX{}'s method of
@@ -11991,21 +12041,26 @@
@file{lion.png}. For more on these, @pxref{\DeclareGraphicsRule}.
@table @code
+ at anchor{includegraphics type}
@item type
Specify the graphics type.
+ at anchor{includegraphics ext}
@item ext
Specify the graphics extension.
Only use this in conjunction with the option @code{type}.
+ at anchor{includegraphics read}
@item read
Specify the file extension of the read file.
Only use this in conjunction with the option @code{type}.
+ at anchor{includegraphics command}
@item command
-Specify a command to be applied to this file.
-Only use this in conjunction with the option @code{type}.
- at c write18 and restricted execution.
+Specify a command to be applied to this file. Only use this in
+conjunction with the option @code{type}. @xref{Command line options},
+for a discussion of enabling the @code{\write18} functionality to run
+external commands.
@end table
More information about the latexrefman-commits
mailing list.