Above is the code Erik used in Part 3 of this series, using LaTeX to produce documents: The following are required to make a complete document with an image: \documentclass[letterpaper]{book} \usepackage{graphicx} These two packages are also useful: \usepackage{subcaption} % Builds customized captions for images, tables, etc. \usepackage{lipsum} %To add lipsum dummy text All three of these packages should be available in any standard installation of LaTeX. The begin{document} code has to be closed in order to compile without error. Putting all the pieces together yields the code shown top right. Some of this code should be self-explanatory. Other parts need some words to make their effects clear. The obvious ones are explained first.
Ci-dessus se trouve le code qu'Erik a utilisé dans la troisième partie de cette série, utilisant LaTeX pour produire des documents.
Les éléments suivants sont nécessaires pour créer un document complet avec une image :
\documentclass[letterpaper]{book}
\usepackage{graphicx}
Ces deux paquets sont également utiles :
\usepackage{subcaption} % Crée des légendes personnalisées pour les images, les tableaux, etc.
\usepackage{lipsum} % Ajoute du texte factice lipsum
Ces trois paquets devraient être disponibles dans toute installation standard de LaTeX. Le code begin{document} doit être fermé afin de compiler sans erreur. En assemblant tous les éléments, on obtient le code illustré en haut à droite.
Une partie de ce code devrait être explicite. D'autres parties nécessitent quelques mots pour rendre clairs leurs effets. Les parties les plus évidentes sont expliquées en premier.
Image files are imported size-as or to fit the text-width or line-width of the selected location. Height and width arguments in the includegraphics instruction should be obvious. LaTeX is not limited to metric measures. Text-width and line-width are usually the same value, the width between left and right margins. If there is more than one column of text, then line-width will equal the column width. Images used inside a column will not by default exceed the column margins. The centering instruction should also be obvious. Any element inside the figure environment will be centred between the left and right margins. The caption instruction gives text to the caption. Notice the caption is automatically given the name “Fig.”, and the next number in the sequence of figures. Fig is short for figure, the number (visible in the pdf output) will change if other figures come before this one. There is a label instruction in the code which is not required. Labels are very useful for providing cross references. They can be used to generate hot links in the pdf file, very useful for both author and reader. The instruction includegraphics[height=3cm,width=3cm]{atom} contains the name of the required graphic: atom.png. No file extension (file type) is required, LaTeX will import and show image files of types EPS, JPEG, PDF or PNG. If there are two or more files with the same name but different file types, the first file alphabetically is loaded in the document. The writer can indicate the correct file type in the includegraphics instruction: \includegraphics{sample-image.pdf}
Les fichiers d'image sont importés en taille standard ou pour s'adapter à la largeur du texte ou de la ligne de l'emplacement sélectionné. Les arguments de hauteur et de largeur dans l'instruction includegraphics devraient être évidents. LaTeX n'est pas limité aux mesures métriques. La largeur de texte et la largeur de ligne ont généralement la même valeur, à savoir la largeur entre les marges gauche et droite. S'il y a plus d'une colonne de texte, la largeur de ligne sera égale à la largeur de la colonne. Les images utilisées à l'intérieur d'une colonne ne dépasseront pas par défaut les marges de la colonne.
L'instruction de centrage doit également être évidente. Tout élément situé dans l'environnement de la figure sera centré entre les marges gauche et droite. L'instruction de légende donne du texte à la légende. Notez que la légende reçoit automatiquement le nom « Fig. », et le numéro suivant dans la séquence des figures. Fig est l'abréviation de figure, le numéro (visible dans la sortie pdf) changera si d'autres figures viennent avant celle-ci.
Le code contient une instruction d'étiquetage qui n'est pas obligatoire. Les étiquettes sont très utiles pour fournir des références croisées. Elles peuvent être utilisées pour générer des liens directs dans le fichier pdf, très utiles à la fois pour l'auteur et le lecteur.
L'instruction includegraphics[height=3cm,width=3cm]{atom} contient le nom du graphique requis : atom.png. Aucune extension de fichier (type de fichier) n'est requise, LaTeX importera et affichera des fichiers d'images de type EPS, JPEG, PDF ou PNG. S'il y a deux ou plusieurs fichiers portant le même nom mais de types différents, le premier fichier par ordre alphabétique est chargé dans le document. Le rédacteur peut indiquer le type de fichier correct dans l'instruction includegraphics :
\includegraphics{sample-image.pdf}
LaTeX also assumes image files are stored in the same folder / directory as the tex document. It is possible to store graphics files in another directory. The location of the graphics file must be indicated in the includegraphics instruction. Either absolute or relative paths may be used. For example: \includegraphics{./sample-image.png} Image files may also be scaled, reduced or enlarged by a specific metric: \includegraphics[scale=.5]{sample-image.png} % scales both width and height by 0.5 Images can be rotated: \includegraphics[angle=10]{sample-image.png} % rotates the image by 10 degrees counterclockwise Location on the page is obviously important to the page design. The image environment floats images to the best location. If there is not room for the image on the selected page then it is moved to the next page, generating a new page if necessary. This action can be controlled through options in the beginfigure instruction. In it, you will see [h] which indicates the graphic image should be inserted “here”, at the location where the instruction is typed. Options are h=here, t=top of this page, b=bottom of this page, p=a separate page dedicated to floated elements, a different page in other words. If “t” or “b” are used, and the image is larger than the available space on the current page, the image will be moved to either the top or bottom of the next page. Repositioning the begin{figure} code using “h” as its first argument will move the image of the model of an atom within the document. (See images below left and below right.)
LaTeX suppose également que les fichiers graphiques sont stockés dans le même dossier/répertoire que le document tex. Il est possible de stocker les fichiers graphiques dans un autre répertoire. L'emplacement du fichier graphique doit être indiqué dans l'instruction includegraphics. Des chemins absolus ou relatifs peuvent être utilisés. Par exemple :
\includegraphics{./sample-image.png}
Les fichiers image peuvent également être mis à l'échelle, réduits ou agrandis selon une métrique spécifique :
\includegraphics[scale=.5]{sample-image.png} % met la largeur et la hauteur à l'échelle 1/2
Les images peuvent être pivotées :
\includegraphics[angle=10]{sample-image.png} % fait pivoter l'image de 10 degrés dans le sens inverse des aiguilles d'une montre.
L'emplacement sur la page est évidemment important pour la conception de la page. L'environnement d'image fait flotter les images au meilleur endroit. S'il n'y a pas de place pour l'image sur la page sélectionnée, elle est déplacée vers la page suivante, en générant une nouvelle page si nécessaire. Cette action peut être contrôlée par des options dans l'instruction beginfigure. Dans celle-ci, vous verrez [h] qui indique que l'image graphique doit être insérée « ici » (here), à l'endroit où l'instruction est saisie. Les options sont h=ici, t=haut de cette page, b=bas de cette page, p=une page séparée dédiée aux éléments flottants, une page différente en d'autres termes. Si « t » ou « b » sont utilisés, et que l'image est plus grande que l'espace disponible sur la page actuelle, l'image sera déplacée en haut ou en bas de la page suivante. En repositionnant le code begin{figure} en utilisant « h » comme premier argument, l'image du modèle d'un atome sera déplacée dans le document. (Voir les images ci-dessous à gauche et ci-dessous à droite).
I leave it to you to experiment with the position of text in relation to the position of the code for the image. Note: using lipsum to generate imitation text does not allow for inserting the image between paragraphs. One way to control the position of an image is to resize it so it fits where you want it. Setting both height and width options to fixed values can distort images because it can change the aspect-ratio. Images can look squashed or stretched if both height and width are fixed values. (See image bottom left in which both height and width are fixed.) If only one of height and width is fixed, LaTeX will alter the other dimension automatically to maintain the aspect-ratio of the image. A similar way to resize an image is to use the [scale] instruction which alters both height and width by the same multiplier. This keeps the aspect ratio the same as the original. If [scale=1] the image is displayed in its original size, if [scale>1} then image is enlarged, and if [scale<1] then image is reduced. (See image bottom right in which [scale=1.3]. I hope this article has given you a few ideas about working with images in Tex / LaTeX. Next time, I will discuss setting up columns, a necessary skill for many online and printed publications.
Je vous laisse le soin d'expérimenter la position du texte par rapport à la position du code de l'image. Remarque : l'utilisation de lipsum pour générer du texte d'imitation ne permet pas d'insérer l'image entre les paragraphes.
Une façon de contrôler la position d'une image est de la redimensionner pour qu'elle s'adapte à l'endroit où vous la voulez. Le fait de régler les options de hauteur et de largeur sur des valeurs fixes peut déformer les images car cela peut modifier le rapport d'aspect. Les images peuvent sembler écrasées ou étirées si la hauteur et la largeur sont toutes deux des valeurs fixes. (Voir l'image en bas à gauche dans laquelle la hauteur et la largeur sont toutes deux fixes.) Si une seule des deux options est fixe, LaTeX modifiera automatiquement l'autre dimension pour maintenir le rapport hauteur/largeur de l'image.
Une manière similaire de redimensionner une image est d'utiliser l'instruction [scale] qui modifie la hauteur et la largeur par le même multiplicateur. Le rapport d'aspect reste ainsi le même que celui de l'original. Si [scale=1] l'image est affichée dans sa taille d'origine, si [scale>1} l'image est agrandie, et si [scale<1] l'image est réduite. (Voir l'image en bas à droite dans laquelle [scale=1.3].
J'espère que cet article vous a donné quelques idées pour travailler avec des images dans Tex/LaTeX. La prochaine fois, j'aborderai la mise en place de colonnes, une compétence nécessaire pour de nombreuses publications en ligne et imprimées.