Différences

Ci-dessous, les différences entre deux révisions de la page.

--- issue199:latex [2023/11/28 15:51] – darkjam
+++ issue199:latex [2023/11/30 10:35] (Version actuelle) – auntiee
@@ Ligne 5: / Ligne 5: @@
 \usepackage{inputenc, cooking, cooking-units, makeidx, hyperref}**
- Cela pourrait être la tâche la plus facile et la plus simple à faire dans Latex que nous avons rencontré.
+Cela pourrait être la tâche la plus facile et la plus simple à faire dans LaTeX que nous ayons rencontrée.
-Pour ajouter des liens hypertextes à un document, ajoutez le paquet hyperref au préambule du document. Selon la documentation, il doit s’agir du dernier paquet. Dans le livre de recettes que j’ai fait, cela signifie que les instructions d’utilisation ressembleront maintenant à ceci :
+Pour ajouter des liens hypertextes à un document, ajoutez le paquet hyperref au préambule du document. Selon la documentation, il doit s’agir du dernier paquet. Dans le livre de recettes que je fais, cela signifie que les instructions d’utilisation ressembleront maintenant à ceci :
 \usepackage{inputenc, cooking, cooking-units, makeidx, hyperref}
 **As you can see in Figure 1, there are now links in the Table of Contents to all of the chapter headings. This happens automatically with the hyperref package. The formatting you see is the default formatting with this package. I do not like the red boxes around each link, and I will change those using features of the hyperref package.
@@ Ligne 17: / Ligne 18: @@
 I did not build any links for the items in the Glossary. I could add those links into the relevant files. I note there is no way in the initial document to return to the Table of Contents after having read a recipe. I will also take a look at using the Table of Contents to make a Bookmarks column in the generated PDF.**
-Comme vous pouvez le voir à la figure 1, il y a maintenant des liens dans la table des matières vers tous les titres de chapitre. Cela se produit automatiquement avec le paquet hyperref. Le formatage que vous voyez est le formatage par défaut avec ce paquet. Je n’aime pas les cadres rouges autour de chaque lien, et je vais les changer en utilisant les fonctionnalités du paquet hyperref.
+Comme vous pouvez le voir à la figure 1 (ci-dessous à gauche), il y a maintenant des liens dans la table des matières vers tous les titres de chapitres. Cela se produit automatiquement avec le paquet hyperref. Le formatage que vous voyez est le formatage par défaut avec ce paquet. Je n’aime pas les cadres rouges autour de chaque lien, et je vais les changer en utilisant les fonctionnalités du paquet hyperref.
-En regardant la recette pour les petits pains cuits à la vapeur, vous pouvez voir une citation. Il y a aussi un lien vers l'entrée correspondant à cette citation dans la bibliographie. Ce type de lien a un cadre vert autour de lui, encore une fois ce n’est pas le formatage que j’aime, donc j’espère le changer.
+En regardant la recette pour les petits pains cuits à la vapeur, vous pouvez voir une citation. Il y a aussi un lien vers l'entrée correspondant à cette citation dans la bibliographie. Ce type de lien se trouve dans un cadre vert et, encore une fois, ce n’est pas le formatage que j’aime, donc j’espère le changer.
+Je n’ai pas créé de liens pour les éléments du Glossaire. Je pourrais ajouter ces liens dans les fichiers pertinents. Je constate qu’il n’y a aucun moyen dans le document initial de revenir à la Table des matières après avoir lu une recette. Je vais également jeter un coup d’œil à l’utilisation de la Table des matières pour créer une colonne Bookmarks (Signets) dans le PDF généré.
-Je n’ai pas créé de liens pour les éléments du glossaire. Je pourrais ajouter ces liens dans les fichiers pertinents. Je constate qu’il n’y a aucun moyen dans le document initial de revenir à la table des matières après avoir lu une recette. Je vais également jeter un coup d’œil à l’utilisation de la table des matières pour créer une colonne Signets dans le PDF généré.
 **Formatting links
@@ Ligne 32: / Ligne 34: @@
 \hypersetup{pdfborder=0 0 0, colorlinks=true}
 **
 Mise en forme des liens
-Afin d’apprendre à formater les liens générés automatiquement en utilisant hyperref, j’ai lu la documentation pour le paquet hyperref. Je sais que la lecture du manuel est contre-intuitive pour de nombreuses personnes impliquées //**dans l'IT**//. Les choses devraient être explicites. Je suis d’accord : la plupart des logiciels devraient être explicites, mais la plupart des logiciels ne le sont pas. C’est pourquoi les développeurs de logiciels rédigent des manuels. Si vous avez l’intention d’utiliser un paquet inconnu dans votre travail avec Latex, je vous encourage à lire toute documentation fournie avec le paquet et à lire les pages pertinentes dans The Latex Companion de Mittelbach et Fischer. (La troisième édition a été publiée plus tôt cette année, ISBN 978-0-465894-0.)
+Afin d’apprendre à formater les liens générés automatiquement en utilisant hyperref, j’ai lu la documentation pour le paquet hyperref. Je sais que la lecture du manuel est contre-intuitive pour de nombreuses personnes impliquées dans l'informatique. Les choses devraient être explicites. Je suis d’accord : la plupart des logiciels devraient être explicites, mais la plupart des logiciels ne le sont pas. C’est pourquoi les développeurs de logiciels rédigent des manuels. Si vous avez l’intention d’utiliser un paquet inconnu dans votre travail avec LaTeX, je vous encourage à lire toute documentation fournie avec le paquet et à lire les pages pertinentes dans The LaTeX Companion de Mittelbach et Fischer. (La troisième édition a été publiée plus tôt cette année, ISBN 978-0-465894-0. [Ndt : Il n'existe pas en français.])
-La documentation fournie avec le paquet hyperref n’est pas adaptée aux débutants. En particulier, elle pourrait utiliser plus d’exemples. Peut-être qu’un document séparé contenant des exemples serait mieux que plus de texte. Un grand nombre d’options possibles sont disponibles. Dans le cas de ce livre de cuisine, je voulais qu’il y ait des liens, mais je voulais éliminer les cadres. J’ai utilisé l’instruction hypersetup avec deux options.
+La documentation fournie avec le paquet hyperref n’est pas adaptée aux débutants. En particulier, elle pourrait utiliser plus d’exemples. Peut-être qu’un document séparé contenant des exemples serait mieux que plus de texte. Un grand nombre d’options possibles sont disponibles. Dans le cas de ce livre de recettes, je voulais qu’il y ait des liens, mais je voulais éliminer les cadres. J’ai utilisé l’instruction hypersetup avec deux options.
 \hypersetup{pdfborder=0 0 0, colorlinks=true}
 **The default for pdfborder is 0 0 1. Setting the last digit to 0 turns off the boxes. Having any positive value as the last digit makes the boxes visible. I used colorlinks=-true in order to have a visible indication some text was different from the main text. The default is colorlinks=false, no color for any of the hyperlinks. As you can see from the image, all of the text in the Table of Contents is now red, with no boxes or lines. If you view the PDF, the mouse cursor will change shape to indicate clickable links. The “back links” from recipes to the Table of Contents are also red. Links to the Bibliography are indicated by green text.**
-La valeur par défaut pour pdfborder est 0 0 1. Le réglage du dernier chiffre à 0 désactive les cases. Avoir une valeur positive comme dernier chiffre rend les cases visibles. J’ai utilisé colorlinks=-true afin d’avoir une indication visible que certains textes étaient différents du texte principal. La valeur par défaut est colorlinks=false, aucune couleur pour les hyperliens. Comme vous pouvez le voir sur l’image, tout le texte de la table des matières est maintenant rouge, sans encadrés ni lignes. Si vous affichez le PDF, le curseur de la souris change de forme pour indiquer les liens cliquables. Les « liens de retour » des recettes à la table des matières sont également rouges. Les liens vers la bibliographie sont indiqués par du texte vert.
+La valeur par défaut pour pdfborder est 0 0 1. Le réglage du dernier chiffre à 0 désactive les cadres. Avoir une valeur positive comme dernier chiffre rend les cadres visibles. J’ai utilisé colorlinks=-true afin d’avoir une indication visible du fait que certaines parties du texte soient différents du texte principal. La valeur par défaut est colorlinks=false, aucune couleur pour les hyperliens. //**d52fr : A supprimer, pas d'image**Comme vous pouvez le voir sur l’image,**// Tout le texte de la table des matières est maintenant rouge, sans encadrés ni lignes. Si vous affichez le PDF, le curseur de la souris change de forme pour indiquer les liens cliquables. Les « liens de retour » des recettes vers la Table des matières sont également rouges. Les liens vers la bibliographie sont indiqués par du texte vert.
 **Links to Glossary
@@ Ligne 51: / Ligne 56: @@
 The simplest approach would be to put “see Glossary” in parentheses after the name of the ingredient. That might get tedious for the reader and would certainly get tiresome to input all those extra bits of text. Another solution would be to make a footnote in each recipe that contained an ingredient listed in the Glossary. The footnote would be “see Glossary”. Again that would be tiresome to type (or copy and paste) in all the relevant recipes but not so obtrusive for the reader. Neither of these methods takes advantage of the electronic links that are available with Latex in an on-screen PDF.**
-Liens vers le glossaire
+Liens vers le Glossaire
-La mise en place de liens entre le texte des recettes et le glossaire n’est pas difficile. Je pourrais utiliser le même processus décrit dans les liens de retour à la table des matières. Toutefois, les liens de retour doivent tous pointer vers le même endroit, à moins que vous ne vouliez faire beaucoup de « liens de retour » dans le glossaire. Par exemple, il y a une entrée dans le glossaire pour l’huile de sésame. Plusieurs recettes utilisent de l’huile de sésame. (Consultez l’index pour voir combien de pages contiennent cet ingrédient.) Vous pouvez créer des liens séparés vers chaque recette en utilisant de l’huile de sésame. Ensuite, le lecteur devrait choisir lequel pour revenir à la recette qu’il lit ou utilise. Si tous les liens de retour pointent vers la table des matières, le lecteur devra se souvenir de la recette qu’il utilise, puis cliquer du glossaire à la table des matières, puis sur la recette qu’il souhaite utiliser. Bien que cela soit un peu gênant pour l’utilisateur, cela simplifie le codage, réduit considérablement le temps nécessaire au codage et ne génère qu’un seul lien de retour pour chaque entrée du glossaire, pas un lien de retour pour chaque recette où un ingrédient spécifique se produit.
+La mise en place de liens entre le texte des recettes et le Glossaire n’est pas difficile. Je pourrais utiliser le même processus décrit dans les liens de retour vers la Table des matières. Toutefois, les liens de retour doivent tous pointer vers le même endroit, à moins que vous ne vouliez faire beaucoup de « liens de retour » dans le Glossaire. Par exemple, il y a une entrée dans le Glossaire pour l’huile de sésame. Plusieurs recettes utilisent de l’huile de sésame. (Consultez l’index pour voir combien de pages contiennent cet ingrédient.) Vous pouvez créer des liens séparés vers chaque recette utilisant de l’huile de sésame. Ensuite, le lecteur devrait choisir lequel pour revenir à la recette qu’il lit ou utilise. Si tous les liens de retour pointent vers la Table des matières, le lecteur devra se souvenir de la recette qu’il utilise, puis cliquer du Glossaire vers la Table des matières, puis sur la recette qu’il souhaite utiliser. Bien que cela soit un peu gênant pour l’utilisateur, cela simplifie le codage, réduit considérablement le temps nécessaire au codage et ne génère qu’un seul lien de retour pour chaque entrée du Glossaire, pas un lien de retour pour chaque recette où un ingrédient spécifique apparaît.
+L’approche la plus simple serait de mettre « voir le Glossaire » entre parenthèses après le nom de l’ingrédient. Cela pourrait devenir fastidieux pour le lecteur et serait certainement fatigant d’entrer tous ces morceaux supplémentaires de texte. Une autre solution serait de faire une note de bas de page dans chaque recette qui contient un ingrédient énuméré dans le Glossaire. La note de bas de page serait « voir Glossaire ». Encore une fois, il serait fastidieux de taper cela (ou de le copier-coller) dans toutes les recettes pertinentes, mais pas si gênant pour le lecteur. Aucune de ces deux méthodes ne tire parti des liens électroniques disponibles avec LaTeX dans un PDF à l’écran.
-L’approche la plus simple serait de mettre « voir le glossaire » entre parenthèses après le nom de l’ingrédient. Cela pourrait devenir fastidieux pour le lecteur et serait certainement fatigant d’entrer tous ces bits supplémentaires de texte. Une autre solution serait de faire une note de bas de page dans chaque recette qui contient un ingrédient énuméré dans le glossaire. La note de bas de page serait « voir glossaire ». Encore une fois, il serait fastidieux de taper (ou copier-coller) dans toutes les recettes pertinentes, mais pas si gênant pour le lecteur. Aucune de ces méthodes ne tire parti des liens électroniques disponibles avec Latex dans un PDF à l’écran.
 **Ideally, every item in the Glossary would be matched to a pop-up item. If the user of the book hovers over an unknown term a box would pop up giving the information in the glossary. If I add the pdfcomment package to the document, this kind of popup or comment or annotation can be made available in the PDF version of the document. I hope it is obvious why popups are not available in printed documents. I hope it is also obvious why popups for the glossary are not necessary in a printed copy of this cookbook.
@@ Ligne 67: / Ligne 73: @@
 \label{toc}**
-Idéalement, chaque élément du glossaire correspondrait à un élément contextuel. Si l’utilisateur du livre passe au-dessus d’un terme inconnu, une boîte apparaîtra donnant les informations dans le glossaire. Si j’ajoute le paquet pdfcomment au document, ce type de popup ou de commentaire ou d’annotation peut être disponible dans la version PDF du document. J’espère qu’il est évident que les fenêtres contextuelles ne sont pas disponibles dans les documents imprimés. J’espère qu’il est également évident pourquoi les popups pour le glossaire ne sont pas nécessaires dans une copie imprimée de ce livre de cuisine.
+Idéalement, chaque élément du Glossaire correspondrait à un élément contextuel. Si l’utilisateur du livre passe au-dessus d’un terme inconnu, une boîte apparaîtra donnant les informations du Glossaire. Si j’ajoute le paquet pdfcomment au document, ce type de popup ou de commentaire ou d’annotation peut être disponible dans la version PDF du document. J’espère qu’il est évident que les fenêtres contextuelles ne sont pas disponibles dans les documents imprimés. J’espère qu’il est également évident pourquoi les popups pour le Glossaire ne sont pas nécessaires dans une copie imprimée de ce livre de cuisine.
 Une solution électronique simple pour la navigation des chapitres serait un système de signets, très courant dans les fichiers PDF (et HTML) – voir ci-dessous pour les signets PDF.
-Retour aux liens vers la table des matières
+Liens de retour vers la Table des matières
-Pour passer d’un endroit dans un document à un autre, le lien cliquable doit être codé et la cible du lien doit également être codée. Une façon de le faire est d’utiliser l’étiquette et les instructions pageref. La cible, la table des matières, doit inclure une étiquette appropriée.
+Pour passer d’un endroit dans un document à un autre, le lien cliquable doit être codé et la cible du lien doit également être codée. Une façon de le faire est d’utiliser l’étiquette et les instructions pageref. La cible, la Table des matières, doit inclure une étiquette appropriée.
 \label{toc}
 **Once the hyperref package is being used, the pageref information automatically becomes a clickable link in the PDF document.
@@ Ligne 100: / Ligne 107: @@
 \pageref{toc}
-Les noms d’étiquettes doivent être uniques dans un document (ou un ensemble de documents qui est ce que nous avons construit). J’ai choisi « toc » parce qu’il est facile de s’en souvenir et qu’il identifie évidemment la table des matières. Toutefois, toute combinaison alphanumérique est acceptable. La phrase que j’ai utilisée est la suivante:
+Les noms d’étiquettes doivent être uniques dans un document (ou un ensemble de documents qui est ce que nous avons construit). J’ai choisi « toc » (pour Table of Contents)parce qu’il est facile de s’en souvenir et qu’il identifie évidemment la Table des matières. Toutefois, toute combinaison alphanumérique est acceptable. La phrase que j’ai utilisée est la suivante:
-Retour à la table des matières \pageref{toc}
+Retour vers la table des matières \pageref{toc} //AE : ceci n'est pas un titre//
 Je pense que c’est assez clair pour que n’importe qui puisse comprendre.
-Table des matières des signets
+De la Table des matières vers les signets //AE : C'est cela le titre//
-C’est la partie la plus facile. Il n’y a rien à faire. Utilisez une visionneuse de document PDF ordinaire pour ouvrir le document PDF généré. Les signets ne sont pas visibles dans la vue du document PDF dans Texstudio. Cependant, une visionneuse PDF régulière vous montrera la table des matières comme signets PDF standard. Si vous ne les voyez pas, parcourez les menus de la visionneuse PDF et activez les signets.
+C’est la partie la plus facile. Il n’y a rien à faire. Utilisez une visionneuse de document PDF ordinaire pour ouvrir le document PDF généré. Les signets ne sont pas visibles dans la vue du document PDF dans TeXstudio. Cependant, une visionneuse PDF régulière vous montrera la Table des matières comme des signets PDF standard. Si vous ne les voyez pas, parcourez les menus de la visionneuse PDF et activez les signets.
-Prochaine fois
+La prochaine fois
-Dans le prochain numéro, j’expérimenterai des modifications de la page de titre. Elle doit être plus professionnelle que le texte standard. Après cela, je serai prêt à finir de modifier ce petit livre de cuisine et passer à un autre projet en utilisant Latex.
+Dans le prochain numéro, j’expérimenterai des modifications de la page de titre. Elle doit être plus professionnelle que le texte standard. Après cela, je serai prêt à finir mes modifications de ce petit livre de cuisine et passer à un autre projet qui utilise LaTeX.