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.
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 aux recettes et construire une bibliographie.
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, cela s’appelle du plagiat, aussi appelé tricherie.
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 sources of various kinds. 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.
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.
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, puis une liste complète de toutes les sources dans une bibliographie (liste de références) à la fin. Plus récemment, les notes de fin de document sont devenues acceptables dans de nombreuses publications. Elles sont similaires aux notes de bas de page en ce qu’elles sont numérotées dans le texte, mais la liste des notes apparaît soit à la fin du chapitre (moins commun), soit à la fin du livre. Parfois, la numérotation était séquentielle du début à la fin. Habituellement, dans un livre, la numérotation recommençait à 1 au début de chaque chapitre et la liste des notes de fin était divisée par chapitre. Pendant de nombreuses années, la norme dans les articles scientifiques a été des références (ou des citations) au fil des pages plus une bibliographie à la fin du livre.
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”, and half a page of references for database management for bibliographies. Volume 2, chapter 15, deals with bibliographies, and chapter 16 deals with citations, over two hundred pages of text. You should conclude from all these numbers that this is a very valuable and complex feature in Latex.
Il y a des « feuilles de style » pour divers types de citations et de listes de références : APA, Chicago, MLA, etc. Chaque publication et chaque éditeur aura un style pour les références. Le style choisi pourrait être leur propre style personnalisé. Plus probablement, ils utiliseront l’une des normes bien connues soit en l’état, soit avec quelques modifications qui la rendent plus adaptée à son public cible.
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 », et une demi-page de références pour la gestion de la base de données pour les bibliographies. Le volume 2, chapitre 15, traite des bibliographies, et le chapitre 16 traite des citations, plus de deux cents pages de texte. Vous devez conclure de tous ces chiffres que c’est une caractéristique très précieuse et complexe dans LaTeX.
There are two major programs used by Latex to build bibliographies: Bibtex and biber. I am going to use the tools and commands used in Bibtex. I would prefer to use biber, because it supports Unicode. However, that would mean rebuilding my bibliographic database. 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 : BibTeX et biber. Je vais utiliser les outils et les commandes utilisés dans BibTeX. Je préférerais utiliser biber, car il supporte Unicode. Cependant, cela impliquerait de reconstruire ma base de données bibliographiques.
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) : un menu bibliographique. Lorsqu’il est sélectionné, il affiche une longue liste de différents types de sources. Choisissez celle qui est la plus pertinente pour votre source et remplissez les blancs. Vous construisez une base de données à une table et à plusieurs champs. Avant de sélectionner le menu Bibliographie, vous devez ouvrir un nouveau fichier dans TeXstudio (ou ouvrir un fichier de base de données bibliographiques existant). Le fichier doit être enregistré en utilisant « bib » comme type de fichier. Pour faciliter l’utilisation, nommez-le la même chose que le fichier principal et enregistrez-le dans le même répertoire que le fichier principal. (Le nom et l’emplacement peuvent être différents de ceux suggérés, mais vous devrez avoir une bonne raison de le faire.)
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, you will get a compilation error. Optional fields that do not have user information can be left as-is or deleted. 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é), sélectionnez le type de référence dans le menu Bibliographie de TeXstudio, puis renseignez les informations. Les informations facultatives sont indiquées avec OPT au début du nom du champ, les informations requises ne le sont pas. Si vous ne remplissez pas les informations requises, vous obtiendrez une erreur de compilation. Les champs facultatifs qui n’ont pas d’informations utilisateur peuvent être laissés tels quels ou supprimés.
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, vous devez fournir une valeur unique (nom) pour la source. Vous pouvez nommer une source comme vous le souhaitez. Je vous suggère d’utiliser quelque chose dont vous vous souviendrez puisque c’est cet identifiant qui est utilisé dans l’instruction de citation dans le corps de votre article ou livre ou quoi que ce soit. J’utilise normalement le nom de famille de l’auteur, à moins que j’aie deux sources ou plus du même auteur ; dans ce cas, je pourrais inclure une année ou une partie du titre de la source. (Nous en parlerons un peu plus lorsque nous arriverons à l’instruction de citation.)
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, and found bibliographic information in three formats: BibTex, EndNote, RefMan. 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, which is always the last step before the PDF appears. These two steps can be completed in any order.
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, qui est toujours la dernière étape avant que le PDF apparaisse. Ces deux étapes peuvent être complétées dans n’importe quel ordre.
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. At the end of the master document of the cookbook, I inserted the two necessary instructions to get the bibliography to appear after the glossary and before the index. \bibliographystyle{alpha} \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é, je vous suggère de jeter un œil à l’un des styles suivants : plaine, acm, apalike, ieeetr. Pour savoir quels styles de bibliographie sont installés sur votre ordinateur, faites une recherche sur les fichiers de type bst. Mon installation standard de LaTeX comporte au moins deux cents fichiers *.bst.
In order to have a bibliography, the document (in our case at least one of the documents) must contain a citation, a place in the text which refers to the source. The instruction for a citation is \cite. If you use TexStudio and have compiled the PDF when you type the instruction \cite, TexStudio will show you a list of entries from the bib file so you can pick one instead of trying to remember which identifier is appropriate at this point in your document. 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, le document (dans notre cas, au moins un des documents) doit contenir une citation, une place dans le texte qui se réfère à la source. L’instruction pour une citation est \cite. Si vous utilisez TeXstudio et que vous avez compilé le PDF, lorsque vous tapez la citation d’instruction \cite, TeXstudio vous montrera une liste d’entrées du fichier bib afin que vous puissiez en choisir une au lieu d’essayer de vous souvenir quel identifiant est approprié à ce stade de votre document.
À titre d’exemple, la recette chinoise des brioches au sésame fait référence au livre de Fuchsia Dunlop. Dans le fichier tex, la référence est \cite{Dun19}. Cette citation pointe vers l’article Dun19 dans la bibliographie. (Cette recette n’a rien à voir avec Fuchsia Dunlop, je ne l’utilise qu’à titre d’exemple.) Voir image page précédente, en bas à droite.
The last step in generating a PDF file from the Latex code is to compile the document. As with the index, a document with a bibliography has to be compiled at least three times. The first time and the third time are standard, the second time compiles the information for the citations and the bibliography. Again, TexStudio is very helpful with a Bibliography (F8) item in the Tools menu. Since compiling a standard document takes very little time, doing this three-step process does not slow down document production very much. If you have made changes to citations or sources, you must do the three-step recompile to update the final PDF. (Of course, if you have changed the indexing items as well, you must also recompile for the index, making this a four-step process in TexStudio.) 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.
La dernière étape pour générer un fichier PDF à partir du code LaTeX est de compiler le document. Comme pour l’index, un document avec une bibliographie doit être compilé au moins trois fois. La première et la troisième fois sont standard, la deuxième fois compile les informations pour les citations et la bibliographie. Encore une fois, TeXstudio est très utile, avec un élément Bibliographie (F8) dans le menu Outils. Étant donné que la compilation d’un document standard prend très peu de temps, ce processus en trois étapes ne ralentit pas beaucoup la production de documents. Si vous avez apporté des modifications aux citations ou aux sources, vous devez effectuer la recompilation en trois étapes pour mettre à jour le fichier PDF final. (Bien sûr, si vous avez également modifié les éléments d’indexation, vous devez également recompiler pour l’index, ce qui en fait un processus en quatre étapes dans TeXstudio.)
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 PDF Find pour naviguer dans votre thèse, livre de cuisine ou autre.