You may ask, “Why another Latex tutorial when there are so many Youtube videos?” And my answer would be, after watching countless outdated videos that were badly planned and badly executed and gave me no answers, THIS tutorial was born. I am no expert, this is what I wish the tutorials actually taught me. When it comes to typesetting, LaTeX is the undisputed champ. It outweighs its opponents in the sheer number of options alone. At first, LaTeX is a bit confusing and difficult to use. Not to scare you, but I suggest looking here: http://tug.ctan.org/info/symbols/comprehensive/symbols-a4.pdf
Vous vous demandez peut-être : « Pourquoi un autre tutoriel sur le LaTeX alors qu'il y a tant de vidéos sur Youtube ? »
Et ma réponse serait la suivante : après avoir regardé d'innombrables vidéos dépassées, mal planifiées et mal exécutées, qui ne m'ont apporté aucune réponse, CE tutoriel est né. Je ne suis pas un expert, c'est tout simplement ce que je souhaiterais que les tutoriels m'ont réellement appris.
En matière de composition, LaTeX est le champion incontesté. Il l'emporte sur ses adversaires par le seul nombre d'options qu'il offre. Au début, LaTeX est un peu déroutant et difficile à utiliser. Je ne veux pas vous effrayer, mais je vous suggère de regarder ici : http://tug.ctan.org/info/symbols/comprehensive/symbols-a4.pdf.
Last issue, we explored more basic concepts, one of them was tagging with labels. We can dive into the nuances of fonts and columns if there is interest, but for now, we soldier on. If you recall, we spoke about tagging your images with fig:2 or whatever, but instead of a figure, we tagged a section. The reason was that I wanted to further explore the issue of images and common mistakes in a totally separate tutorial. Place your cursor on a new line and this time go to the “wizards” menu item and choose: insert graphic. Follow the prompts to get your ‘code’ filled in for you. Compile (F6)… What went wrong? Should a wizard not just work? You are welcome to google/duckduckgo the error. I’ll wait… Now you would understand the reason for this tutorial first hand. I will also cover – let you do/make – more common mistakes newbies make.
Dans le dernier numéro, nous avons exploré des concepts de base, notamment l'étiquetage avec des étiquettes. Nous pourrons nous plonger dans les nuances des polices et des colonnes si vous le souhaitez, mais pour l'instant, nous continuons. Si vous vous en souvenez, nous avons parlé de l'étiquetage de vos images avec fig:2 ou autre, mais au lieu d'une figure, nous avons étiqueté une section. La raison en est que je voulais approfondir la question des images et des erreurs courantes dans un tutoriel totalement distinct.
Placez votre curseur sur une nouvelle ligne et, cette fois, allez dans l'élément de menu « Assistants » et choisissez : insérer graphique. Suivez les instructions pour que votre « code » soit rempli pour vous. Compilez (F6)… Que s'est-il passé ? Un assistant ne devrait-il pas simplement fonctionner ? Vous pouvez chercher l'erreur sur Google/duckduckgo. Je vais attendre… Maintenant, vous saisissez vraiment la raison de ce tutoriel. Je vais également couvrir - vous laisser faire/faire - les erreurs les plus courantes que les débutants font.
Explanation: Latex is very “geeky”. It is like a programming language. You cannot use graphics (or other add-ons, we will get to those) without telling Latex that you will be using graphics. It has to be in the pre-processor space too, not anywhere else – that is where all the backslash stuff, written in red, is, before your “/begin{document}” is located at the top. Adding this line, after the documentclass: \usepackage[demo]{graphicx} will clear the error, but not solve the problem. The wizard will automatically use the picture’s name as a label, so you can save yourself a lot of time by changing the names of your pictures beforehand. However, I have no picture of snoopy displayed (I used a picture of snoopy). Instead I have a black block. This is the “demo”.
Explication :
Le LaTeX est très « geek ». C'est comme un langage de programmation. Vous ne pouvez pas utiliser d'images (ou d'autres ajouts, nous y viendrons) sans indiquer à LaTeX que vous allez utiliser des graphiques. Cela doit également se trouver dans l'espace du pré-processeur, pas ailleurs - c'est là que se trouvent tous les backslashs, écrits en rouge, avant votre « /begin{document} » situé en haut. L'ajout de la ligne \usepackage[demo]{graphicx}, après documentclass:, fera disparaître l'erreur, mais ne résoudra pas le problème.
L'assistant utilise automatiquement le nom de l'image comme étiquette, ce qui vous permet de gagner beaucoup de temps en changeant le nom de vos images au préalable. Cependant, je n'ai pas d'image de Snoopy affichée (j'ai utilisé une image de Snoopy). À la place, j'ai un bloc noir. C'est « demo ».
Go back, remove the “[demo]” from that line, and use the wizard again. When you compile your document, you will be greeted by a new error. TL;DR – you need to specify a path to a directory that has your images. The full path in the \includegraphics{} statement does not work. *(Even when they say so.) This also has to be added in the pre-processor space at the top. Here again, I was met with frustration, as the “beginners guide to Latex” does not even mention it in chapter Five (Inserting images). This just goes to show you that there are so many things you need to keep track of, that even the experts miss things. Even definitive sources, see here: https://www.latex-tutorial.com/tutorials/figures/. Copy that code and see if it will work (spoiler: It won’t). TIP: When using images in your Latex documents, I suggest you make a separate folder for them.
Revenez en arrière, supprimez le « [demo] » de cette ligne et utilisez à nouveau l'assistant. Lorsque vous compilerez votre document, vous serez accueilli par une nouvelle erreur. En résumé, vous devez indiquer le chemin d'accès à un répertoire contenant vos images. Le chemin complet dans l'instruction \includegraphics{} ne fonctionne pas. *(Même s'ils le disent.) Cela doit également être ajouté dans l'espace « pré-processeur » en haut. Là encore, j'ai été frustré, car le « Guide LaTeX pour débutants » ne le mentionne même pas dans le chapitre cinq (insertion d'images). Cela montre bien qu'il y a tellement de choses dont vous devez tenir compte que même les experts passent à côté de certaines choses. Même les sources définitives, voir ici : https://www.latex-tutorial.com/tutorials/figures/. Copiez ce code et voyez s'il fonctionne (avertissement : il ne fonctionne pas).
ASTUCE : Lorsque vous utilisez des images dans vos documents LaTeX, je vous suggère de créer un dossier séparé pour celles-ci.
Check the type of image you are adding as currently it can be only a .png, a .jpg, or a .pdf file. Deep breath, we will get there. Sometimes one needs to make mistakes to understand your subject better. Now you can understand my frustration at other tutorials that just do not work. Open your file browser and navigate to the picture you would like to insert. Click and drag it into TeXstudio. You will now see this: \begin{figure} \includegraphics{Figures/me} \caption{} \label{fig:me} \end{figure} This is why I recommend making a “Figures” folder in your current working folder and dumping your pictures there. This used to trip me up when I was trying to get to grips with LaTeX. Now that you have made the mistake with me, hopefully this will stick.
Vérifiez le type d'image que vous ajoutez. Actuellement, il ne peut s'agir que d'un fichier .png, .jpg ou .pdf.
Respirez profondément, nous allons y arriver. Parfois, il faut faire des erreurs pour mieux comprendre son sujet. Vous pouvez maintenant comprendre ma frustration face à d'autres tutoriels qui ne fonctionnent tout simplement pas. Ouvrez votre navigateur de fichiers et naviguez jusqu'à l'image que vous souhaitez insérer. Cliquez et faites-la glisser dans TeXstudio. Vous verrez alors ceci :
\begin{figure}
\includegraphics{Figures/me}
\caption{}
\label{figure:me}
\end{figure}
C'est pourquoi je recommande de créer un dossier « Figures » dans votre dossier de travail actuel et d'y déposer vos images. C'est ce que je faisais souvent lorsque j'essayais de dompter LaTeX. Maintenant que vous avez fait l'erreur avec moi, j'espère que vous vous en souviendrez.
Now, when you click on run, you should see “Process exited normally”, and the preview should contain your picture. In my case I just included a selfie, but you can add any image that pleases you. (Does the image make my feet look big?). Depending on the size of your image, if you do not supply any options, the image will be all over the place, even off the page. Now again, as we learned with the \documentclass example, the options go before the curly braces in square brackets. It is always a good idea to use a larger image than needed as it will show in the end product’s quality. We can restrain our image thus: Inside your square brackets, type “w” and the word “width=” should appear with two of the most common options. Choose “linewidth” and hit F5.
Maintenant, lorsque vous cliquez sur exécuter, vous devriez voir « Process exited normally » (Traitement terminé normalement), et l'aperçu devrait contenir votre image. Dans mon cas, j'ai juste inclus un selfie, mais vous pouvez ajouter n'importe quelle image qui vous plaît. (Est-ce que mes pieds sont gros ?).
En fonction de la taille de votre image, si vous ne fournissez aucune option, l'image prendra toute la place, voire débordera. Une fois encore, comme nous l'avons appris avec l'exemple \documentclass, les options doivent être placées entre crochets avant les accolades.
C'est toujours une bonne idée d'utiliser une image plus grande que nécessaire, car cela se ressentira sur la qualité du produit final. Nous pouvons restreindre notre image ainsi : à l'intérieur de vos crochets, tapez « w » et le mot « width= » devrait apparaître avec deux des options les plus courantes. Choisissez « linewidth » et appuyez sur F5.
What happened to your image? We have no lines in our document yet, so our line width is 0. This is another common mistake you need to watch out for. Hover your mouse cursor over the word “linewidth” and read the tool tip carefully. So how would we wrangle our image to a more manageable size? We simply specify the height and width in centimetres. Add the following to the square brackets and press F5 again: height= 3cm,width=3cm Looking better already! Another popular option is angle. This can be a positive or negative integer. Since you are reading FCM, I have no doubt you know how angles work, so I will leave that to you to play with.
Qu'est-il arrivé à votre image ? Nous n'avons pas encore de lignes dans notre document, notre largeur de ligne est donc de 0. C'est une autre erreur courante à laquelle vous devez faire attention. Passez le curseur de votre souris sur le mot « linewidth » (largeur de ligne) et lisez attentivement l'info-bulle.
Comment faire pour ramener notre image à une taille plus gérable ? Il suffit de spécifier la hauteur et la largeur en centimètres. Ajoutez ce qui suit entre les crochets et appuyez de nouveau sur F5 :
height=3cm,width=3cm
C'est déjà mieux ! Une autre option appréciée est l'angle. Il peut s'agir d'un nombre entier positif ou négatif. Puisque vous lisez le FCM, je ne doute pas que vous sachiez comment fonctionnent les angles, je vous laisse donc jouer avec.
My image is currently at the top, what if I want it at the bottom? Right next to \begin{figure} simply add a [b] thus: \begin{figure}[b] \includegraphics[height= 3cm,width=3cm]{Figures/me} \caption{It's a ME!} \label{fig:me} \end{figure} This will put your image at the bottom of the page (NOT at the end of your text). If you want it at the end of the text, you need to use an [h]. If you want the image on its own page, you need to specify the [p] option. You may have noticed that I added a caption and a label. By default, if you drag the image in, it will use the name of the file in here, be sure to change it to something useful.
Mon image est actuellement en haut, que faire si je la veux en bas ? Juste à côté de \begin{figure} ajoutez simplement un [b] ainsi :
\begin{figure}[b]
\includegraphics[height= 3cm,width=3cm]{Figures/me}
\caption{C'est un MOI!}
\label{fig:me}
\end{figure}
Cela placera votre image en bas de la page (PAS à la fin de votre texte). Si vous voulez qu'elle soit à la fin du texte, vous devez utiliser un [h]. Si vous voulez que l'image soit placée sur sa propre page, vous devez spécifier l'option [p].
Vous avez peut-être remarqué que j'ai ajouté une légende et une étiquette. Par défaut, si vous faites insérer l'image, elle utilisera le nom du fichier qui s'y trouve ; assurez-vous de le changer en quelque chose d'utile.
Add a section and copy the following code to reference your image (as you type /ref{ TeXstudio should fill in the image reference for you). \section A As you can see in the figure \ref{fig:me} that I have gained weight. Press F5 again to see your handy work. It is now easy to refer to any image by its label in this way. I hope you learned something not only by copying my code, but also by making mistakes. Join us in the next issue for more LaTeX, where we will tackle more n00b stumbling blocks. If you have any comments or queries, email us: misc@fullcirclemagazine.org
Ajoutez une section et copiez le code suivant pour référencer votre image (lorsque vous tapez /ref{, TeXstudio devrait remplir la référence de l'image pour vous).
\section A
Comme vous pouvez le voir dans la figure \ref{fig:me}, j'ai pris du poids.
Appuyez à nouveau sur F5 pour voir votre travail artistique.
Il est maintenant facile de faire référence à n'importe quelle image par son étiquette de cette manière.
J'espère que vous avez appris quelque chose non seulement en copiant mon code, mais aussi en faisant des erreurs.
Rejoignez-nous dans le prochain numéro pour plus de LaTeX, où nous nous attaquerons à d'autres écueils pour les débutants.
Si vous avez des commentaires ou des questions, envoyez-nous un courriel à l'adresse suivante : misc@fullcirclemagazine.org.