issue198:latex
Différences
Ci-dessous, les différences entre deux révisions de la page.
| Prochaine révision | Révision précédente | ||
| issue198:latex [2023/10/28 16:00] – créée auntiee | issue198:latex [2023/11/02 15:19] (Version actuelle) – andre_domenech | ||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | This time we are going to expand the “back matter”of the book even more. I started working with the sample cookbook in Full Circle Magazine #194, and continued in #195 and #197. (Sorry about missing #196, there were other important things I had to deal with.) If you have been following along, you should now have a small book with a number of recipes, a very short glossary, and an index. There are section dividers and a table of contents. This time, I am going to add sources to the recipes and build a bibliography. | + | **This time we are going to expand the “back matter”of the book even more. I started working with the sample cookbook in Full Circle Magazine #194, and continued in #195 and #197. (Sorry about missing #196, there were other important things I had to deal with.) If you have been following along, you should now have a small book with a number of recipes, a very short glossary, and an index. There are section dividers and a table of contents. This time, I am going to add sources to the recipes and build a bibliography. |
| - | A bibliography is a necessary part of any academic paper, whether it is published in a peer-reviewed journal or an assignment submitted to a teacher. The basic rule for references is simple. If the words or ideas included in your paper were written by someone else you have to use a reference, you have to give credit where credit is due. Not to do so means you claim their words are your words. You are lying, misrepresenting the truth. Portions of your paper, article, book, have been copied from someone else. Officially this is called plagiarism, also known as cheating. | + | A bibliography is a necessary part of any academic paper, whether it is published in a peer-reviewed journal or an assignment submitted to a teacher. The basic rule for references is simple. If the words or ideas included in your paper were written by someone else you have to use a reference, you have to give credit where credit is due. Not to do so means you claim their words are your words. You are lying, misrepresenting the truth. Portions of your paper, article, book, have been copied from someone else. Officially this is called plagiarism, also known as cheating.** |
| - | The recipes I included in the sample cookbook I collected from email and various web sites. Most of them I have had for more than ten years. However, they are not my work. I do not know the sources for any of them. I do not claim they are my work. In this issue, I will provide the recipes with fictional | + | Cette fois-ci, nous allons élargir encore plus la « partie arrière » du livre. J’ai commencé à travailler avec l’exemple du livre de cuisine dans le Full Circle Magazine n° 194, et j’ai continué dans les n° 195 et 197. (Désolé d’avoir manqué le n° 196, il y avait d’autres choses importantes auxquelles j’ai dû faire face.) Si vous avez suivi, vous devriez maintenant avoir un petit livre avec un certain nombre de recettes, un glossaire très court et un index. Il y a des séparateurs de sections et une table des matières. Cette fois-ci, je vais ajouter des sources |
| - | If you have had to write something that included at least one other person’s words, you should know there are different ways to indicate the source of other persons’ words. The oldest way was to use numbered footnotes at the bottom of the page where the quoted material appeared, and then a complete listing of all sources in a bibliography (list of references) at the end. More recently, endnotes have become acceptable in many publications. They are similar to footnotes in that they are numbered in the text but the list of notes appears either at the end of the chapter (less common), or at the end of the book. Sometimes, the numbering was sequential from beginning to end. Usually in a book, the numbering restarted at 1 at the beginning of each chapter and the list of endnotes was divided by chapter. For many years, the standard in scientific papers has been inline references (or citations) plus a bibliography at the end of the book. | + | Une bibliographie est une partie nécessaire de tout article académique, qu’il soit publié dans une revue évaluée par des pairs ou un devoir soumis à un enseignant. La règle de base pour les références est simple. Si les mots ou les idées inclus dans votre article ont été écrits par quelqu’un d’autre, vous devez utiliser une référence ; vous devez donner le crédit là où le crédit est dû. Ne pas le faire signifie que vous prétendez que leurs paroles sont les vôtres. Vous mentez, vous déformez la vérité. Des parties de votre journal, de votre article, de votre livre, ont été copiées de quelqu’un d’autre. Officiellement, |
| - | There are “style sheets” for various types of citations and reference lists: APA, Chicago, MLA, etc. Every publication and every publisher will have a style for references. The style chosen might be their own custom style. More likely, they will use one of the well-known standards either as is or with a few modifications that make it more suitable for its intended audience. | ||
| - | There are more than 1.5 pages of references in the index to The Latex Companion dealing with bibliography. There are another two pages for references for “cite” and “citations”, | + | **The recipes I included in the sample cookbook I collected from email and various web sites. Most of them I have had for more than ten years. However, they are not my work. I do not know the sources |
| - | There are two major programs used by Latex to build bibliographies: | + | If you have had to write something that included at least one other person’s words, you should know there are different ways to indicate the source of other persons’ words. The oldest way was to use numbered footnotes at the bottom of the page where the quoted material appeared, |
| - | The first step in building a bibliography is to have sources to include in it. One way is available in TexStudio but not in Gummi (the two Latex GUIs I have on my system): a Bibliography menu. When selected, it shows a long list of different types of sources. Pick the one that is most relevant to your source, and fill in the blanks. What you are building is a one-table, multiple-field database. Before you select the Bibliography menu, you must open a new file in TexStudio (or open an existing bibliography database file). The file must be saved using “bib” as the file type. For ease of use, name it the same as the principle file and save it to the same directory as the principle file. (The name and location can be different than suggested, but you should have a good reason to do so.) | + | Les recettes que j’ai incluses dans le livre de recettes, je les ai recueillies par courriel et sur divers sites Web. La plupart d’entre elles existent depuis plus de dix ans. Cependant, ce n'est pas moi qui les ai faites. Je ne connais les sources d’aucune d’entre elles. Je ne prétends pas qu’elles sont mon travail. Dans ce numéro, je fournirai aux recettes des sources fictives de toutes sortes. |
| - | Once the file has been opened | + | Si vous avez dû écrire quelque chose qui comprenait les paroles d’au moins une autre personne, vous devez savoir qu’il existe différentes façons d’indiquer la source des paroles d’autres personnes. La méthode la plus ancienne consistait à utiliser des notes de bas de page numérotées au bas de la page où les documents cités apparaissaient, |
| - | Each record in the bib file will start with an ampersand @, followed by the name of the type of source, then a curly brace. Immediately after the curly brace you should supply a unique value (name) for the source. You can name a source anything you wish. I suggest you use something you will remember since it is this identifier that is used in the cite instruction in the body of your article or book or whatever. I normally use the author’s last name, unless I have two or more sources from the same author, and then I might include a year or part of the title of the source. (A little more about this when we get to the cite instruction.) | ||
| - | Another way to add records to the bib file is to copy them from an online source. Many books and journal articles | + | **There are “style sheets” for various types of citations and reference lists: APA, Chicago, MLA, etc. Every publication |
| - | Once you have at least one source recorded in a bib file, you need two more steps to make the bibliography appear | + | There are more than 1.5 pages of references |
| - | Step 1: Cite the item in the appropriate place in your document. | + | Il y a des « feuilles de style » pour divers types de citations et de listes de références : |
| + | |||
| + | Il y a plus de 1,5 pages de références dans l’index de The LaTeX Companion traitant de bibliographie. Il y a deux autres pages de références pour « citer » et « citations », | ||
| + | |||
| + | |||
| + | **There are two major programs used by Latex to build bibliographies: | ||
| + | |||
| + | The first step in building a bibliography is to have sources to include in it. One way is available in TexStudio but not in Gummi (the two Latex GUIs I have on my system): a Bibliography menu. When selected, it shows a long list of different types of sources. Pick the one that is most relevant to your source, and fill in the blanks. What you are building is a one-table, multiple-field database. Before you select the Bibliography menu, you must open a new file in TexStudio (or open an existing bibliography database file). The file must be saved using “bib” as the file type. For ease of use, name it the same as the principle file and save it to the same directory as the principle file. (The name and location can be different than suggested, but you should have a good reason to do so.)** | ||
| + | |||
| + | Il y a deux programmes importants utilisés par LaTeX pour construire des bibliographies : | ||
| + | |||
| + | La première étape dans la construction d’une bibliographie est d’avoir des sources à y inclure. Un moyen est disponible dans TeXstudio, mais pas dans Gummi (les deux interfaces graphiques pour LaTeX que j’ai sur mon système) : | ||
| + | |||
| + | |||
| + | **Once the file has been opened (and possibly saved), select the type of reference from the Bibliography menu in TexStudio and then fill in the information. Optional information is indicated with OPT at the beginning of the field name, required information is not. If you do not complete the required information, | ||
| + | |||
| + | Each record in the bib file will start with an ampersand @, followed by the name of the type of source, then a curly brace. Immediately after the curly brace you should supply a unique value (name) for the source. You can name a source anything you wish. I suggest you use something you will remember since it is this identifier that is used in the cite instruction in the body of your article or book or whatever. I normally use the author’s last name, unless I have two or more sources from the same author, and then I might include a year or part of the title of the source. (A little more about this when we get to the cite instruction.)** | ||
| + | |||
| + | Une fois le fichier ouvert (et éventuellement enregistré), | ||
| + | |||
| + | Chaque enregistrement dans le fichier bib commencera par un arobase @, suivi du nom du type de source, puis d’une accolade. Immédiatement après l’accolade, | ||
| + | |||
| + | |||
| + | **Another way to add records to the bib file is to copy them from an online source. Many books and journal articles have included bibliographic information in various formats on websites. Google Scholar is one place to find such information. Even if you own the source, sometimes it is easier to copy and paste the required information from a website to your bib file than to type it all yourself. Often the bibliographic information online is more complete than what you might type. I looked up a book I own on books.google.ca, | ||
| + | |||
| + | Once you have at least one source recorded in a bib file, you need two more steps to make the bibliography appear in the PDF of your document, well three steps if you count compilation, | ||
| + | |||
| + | Une autre façon d’ajouter des enregistrements au fichier bib est de les copier à partir d’une source en ligne. De nombreux livres et articles de revues ont inclus des informations bibliographiques sous divers formats sur des sites Web. Google Scholar est un endroit pour trouver de telles informations. Même si vous possédez la source, il est parfois plus facile de copier et de coller les informations requises d’un site Web dans votre fichier bib que de tout taper vous-même. Souvent, l’information bibliographique en ligne est plus complète que ce que vous pourriez taper. J’ai consulté un livre que je possède sur books.google.ca et j’ai trouvé des renseignements bibliographiques en trois formats : BibTeX, EndNote, RefMan. | ||
| + | |||
| + | Une fois que vous avez au moins une source enregistrée dans un fichier bib, vous avez besoin de deux étapes supplémentaires pour faire apparaître la bibliographie dans le PDF de votre document, en fait, trois étapes si vous comptez la compilation, | ||
| + | |||
| + | |||
| + | **Step 1: Cite the item in the appropriate place in your document. | ||
| Step 2: Add instructions to the document so the bibliography appears where you want it. | Step 2: Add instructions to the document so the bibliography appears where you want it. | ||
| Ligne 32: | Ligne 62: | ||
| \bibliography{fcm198index} | \bibliography{fcm198index} | ||
| + | **Étape 1 : Citez l’élément à l’endroit approprié dans votre document. | ||
| + | Étape 2 : Ajoutez des instructions au document afin que la bibliographie apparaisse à l’endroit où vous le souhaitez. | ||
| + | |||
| + | À la fin du document principal du livre de cuisine, j’ai inséré les deux instructions nécessaires pour que la bibliographie apparaisse après le glossaire et avant l’index. | ||
| + | |||
| + | |||
| + | \bibliographystyle{alpha} | ||
| + | |||
| + | \bibliography{fcm198index} | ||
| + | |||
| + | |||
| + | **These two instructions are both required. However, the options inside the curly braces will change. Remember I said the bib file is best named the same as the main document file. See the {fcm198index} instruction. That points to the fcm198index.bib file saved in the same directory as the main document. If you decide to save it with a different name, myrefs.bib for example, that name would appear as \bibliography{myrefs}. If you also saved it in a different directory, the path to that directory must be included inside the curly braces. | ||
| + | |||
| + | The bibliographystyle{alpha} is also required. It tells Latex how to set up the citations in the body of the document and how to set up the bibliography. {alpha} is the default style, which I do not like very much. I am used to using either APA or MLA, or some form of scientific-style citation. There are several built-in bibliography styles, and many other packages can be obtained from ctan.org. I did not want to load this issue with a lot of screenshots. If you are interested, I suggest you take a look at any of the following styles: plain, acm, apalike, ieeetr. To find out what bibliography styles are installed on your computer, do a search for files of type bst. My standard Latex installation has at least two hundred *.bst files.** | ||
| + | |||
| + | Ces deux instructions sont nécessaires. Cependant, les options à l’intérieur des accolades changeront. Rappelez-vous que j’ai dit qu'il est mieux de nommer le fichier bib comme le fichier principal du document. Voir l’instruction {fcm198index}. Cela pointe vers le fichier fcm198index.bib enregistré dans le même répertoire que le document principal. Si vous décidez de l’enregistrer avec un nom différent, myrefs.bib par exemple, ce nom apparaîtra comme \bibliographie{myrefs}. Si vous l’avez également enregistré dans un répertoire différent, le chemin d’accès à ce répertoire doit être inclus dans les accolades. | ||
| + | |||
| + | La bibliographystyle{alpha} est également requise. Elle indique à LaTeX comment configurer les citations dans le corps du document et comment configurer la bibliographie. {alpha} est le style par défaut, que je n’aime pas beaucoup. Je suis habitué à utiliser APA ou MLA, ou une certaine forme de citation de style scientifique. Il existe plusieurs styles de bibliographie intégrés et de nombreux autres paquets peuvent être obtenus auprès de ctan.org. Je ne voulais pas charger ce numéro avec beaucoup de captures d’écran. Si vous êtes intéressé, | ||
| + | |||
| + | **In order to have a bibliography, | ||
| + | |||
| + | As an example, the Chinese Sesame Buns recipe has a reference to Fuchsia Dunlop’s book. In the tex file, the reference is \cite{Dun19}. This citation points to item Dun19 in the bibliography. (This recipe has nothing to do with Fuchsia Dunlop, I use it only as an example.) See image previous page, bottom right.** | ||
| + | Afin d’avoir une bibliographie, | ||
| - | These two instructions are both required. However, the options inside the curly braces will change. Remember I said the bib file is best named the same as the main document file. See the {fcm198index} instruction. That points to the fcm198index.bib file saved in the same directory as the main document. If you decide to save it with a different name, myrefs.bib for example, that name would appear as \bibliography{myrefs}. If you also saved it in a different directory, the path to that directory must be included inside the curly braces. | + | À titre d’exemple, |
| - | The bibliographystyle{alpha} is also required. It tells Latex how to set up the citations in the body of the document and how to set up the bibliography. {alpha} is the default style, which I do not like very much. I am used to using either APA or MLA, or some form of scientific-style citation. There are several built-in bibliography styles, and many other packages can be obtained from ctan.org. I did not want to load this issue with a lot of screenshots. If you are interested, I suggest you take a look at any of the following styles: plain, acm, apalike, ieeetr. To find out what bibliography styles are installed on your computer, do a search for files of type bst. My standard Latex installation has at least two hundred *.bst files. | ||
| - | In order to have a bibliography, | + | **The last step in generating |
| - | As an example, the Chinese Sesame Buns recipe has a reference | + | Next time, I will show how to make the chapter titles clickable “live links”. Readers will not need to scroll through pages or use PDF Find in order to navigate through your thesis or cookbook or whatever.** |
| - | The last step in generating a PDF file from the Latex code is to compile the document. | + | La dernière étape pour générer un fichier |
| - | Next time, I will show how to make the chapter titles clickable “live links”. Readers will not need to scroll through | + | La prochaine fois, je montrerai comment faire en sorte que les titres des chapitres soient cliquables par des « liens directs ». Les lecteurs n’auront pas besoin de faire défiler les pages ou d’utiliser |
issue198/latex.1698501636.txt.gz · Dernière modification : 2023/10/28 16:00 de auntiee