Tex was developed in the mid 1970s by Donald Knuth and published in 1978. “TeX was designed with two main goals in mind: to allow anybody to produce high-quality books with minimal effort, and to provide a system that would give exactly the same results on all computers, at any point in time” (Wikipedia: Tex). That meant the document and the typesetting instructions had to be written using only the standard 128 characters available in ASCII. Remember the first IBM-PC was not available until 1981. It came with 16KB of RAM, which was expandable to 256KB. For storage, the original IBM PC could house either one or two 320KB floppy disk drives. There were no PCs in 1978, so the first installations of Tex ran on PDP-10 machines, a mainframe computer popular in commercial settings and universities. Remember Tex was designed for typesetting, and remember that, until IBM made CGA graphics cards available in 1981, computer monitors displayed only ASCII characters: text, numbers and a few special characters. Printers were also restricted in the same way until the development of Postscript (mid 1980s) and PDF (1992).
Tex a été développé par Donald Knuth au milieu des années 1970 et publié en 1978. « TeX a été conçu avec deux objectifs principaux en tête : permettre à n'importe qui de produire des livres de haute qualité avec un minimum d'effort, et fournir un système qui donnerait exactement les mêmes résultats sur tous les ordinateurs, à tout moment » (Wikipedia : Tex). Cela signifiait que le document et les instructions de composition devaient être écrits en utilisant uniquement les 128 caractères standard disponibles en ASCII. Rappelez-vous que le premier IBM-PC n'a été disponible qu'en 1981. Il était équipé de 16 Ko de mémoire vive, qui pouvait être étendue à 256 Ko. Pour le stockage, l'IBM-PC original pouvait accueillir un ou deux lecteurs de disquettes de 320 Ko. Comme il n'y avait pas de PC en 1978, les premières installations de Tex fonctionnaient sur des machines PDP-10, un ordinateur central populaire dans les entreprises et les universités.
N'oubliez pas que Tex a été conçu pour la composition et que, jusqu'à ce qu'IBM mette à disposition des cartes graphiques CGA en 1981, les écrans d'ordinateur n'affichaient que des caractères ASCII : texte, chiffres et quelques caractères spéciaux. Les imprimantes étaient également limitées de la même manière jusqu'au développement de Postscript (au milieu des années 1980) et de PDF (1992).
This brief history lesson is to point out the need for packages when using Tex. With very limited RAM available and the necessity for using only ASCII, Knuth had to develop a typesetting system that would be efficient and run consistently on mainframes from as many different manufacturers as possible. These limits (processing power and printing power) necessitated the use of packages, small independent sets of instructions that could be loaded only when required. The hardware limitations made Tex and LaTex modular. Because this early design decision was forced upon Knuth by the hardware specifications available at the time, Tex is now remarkably flexible and relatively easy to expand. Need a new capability? Write a new package. For example, the American Mathematical Society has written several packages that are very useful when mathematical formulas are included in printed documents.. This set of packages can be identified by “ams” at the beginning of the package name.
Cette brève leçon d'histoire a pour but de souligner le besoin de paquets lors de l'utilisation de Tex. Avec une mémoire vive disponible très limitée et la nécessité d'utiliser uniquement l'ASCII, Knuth a dû développer un système de composition qui serait efficace et fonctionnerait sans problème sur des ordinateurs centraux provenant du plus grand nombre possible de fabricants différents. Ces limites (puissance de traitement et puissance d'impression) ont nécessité l'utilisation de paquets, de petits ensembles indépendants d'instructions qui ne pouvaient être chargés que lorsque cela était nécessaire. Les limitations matérielles ont rendu Tex et LaTex modulaires.
Parce que cette décision de conception précoce a été imposée à Knuth par les spécifications matérielles disponibles à l'époque, Tex est aujourd'hui remarquablement flexible et relativement facile à étendre. Vous avez besoin d'une nouvelle fonctionnalité ? Écrivez un nouveau paquet. Par exemple, l'American Mathematical Society a écrit plusieurs paquets qui sont très utiles lorsque des formules mathématiques sont incluses dans des documents imprimés. Cet ensemble de paquets peut être identifié par « ams » au début du nom du paquet.
Latex was developed more-or-less in parallel to Tex. Latex is designed to be a user-friendly layer on top of Tex. It is a set of macros for the markup functions of Tex, and leaves the layout functions to Tex. It was developed in the 1980s, the current version was released in 1994 and revised in 2020. Latex consists of a basic set of packages that all users of Latex can assume will be availabe, and minimal documentation. The Latex archive (https://www.ctan.org/pkg/latex) contains more details. CTAN is an enormous storehouse of packages (sets of Tex macros) which can be downloaded and added to your Latex / Tex files, and then made available for use with your documents. What kind of document are you trying to write? Are you doing research in the physical sciences? There are 93 packages which include the word physics in their description at CTAN. There are 58 which use chemistry, but only 14 for astronomy. What about the life sciences? Packages using biology in their description are 23 in number, but only 1 for biochemistry. There are 750(!) for math, 62 labeled for geometry. You might want to narrow your search for an appropriate package, for example the term “integration” has 21 packages, probably some of these are in the total of 750 for mathematics. Turning to non-scientific packages, there is 1 which says it supports the work of pastors and priests, 28 for business, 1 for accounting, 2 for banking - including one that is specific for documents from the Czech National Bank.
LaTeX a été développé plus ou moins parallèlement à Tex. LaTeX est conçu pour être une couche conviviale au-dessus de Tex. C'est un ensemble de macros pour les fonctions de balisage de Tex, et il laisse les fonctions de mise en page à Tex. Il a été développé dans les années 1980 et la version actuelle a été publiée en 1994 et révisée en 2020. LaTeX consiste en un ensemble de paquets de base que tous les utilisateurs de LaTeX peuvent supposer être disponibles et une documentation minimale. L'archive LaTeX (https://www.ctan.org/pkg/latex) contient plus de détails. CTAN est un énorme entrepôt de paquets (ensembles de macros Tex) qui peuvent être téléchargés et ajoutés à vos fichiers LaTeX/Tex, puis mis à disposition pour être utilisés dans vos documents.
Quel type de document essayez-vous d'écrire ? Faites-vous des recherches dans le domaine des sciences physiques ? Il y a 93 paquets qui incluent le mot physique dans leur description au CTAN. Il y en a 58 qui utilisent la chimie, mais seulement 14 pour l'astronomie. Qu'en est-il des sciences de la vie ? Les paquets utilisant la biologie dans leur description sont au nombre de 23, mais seulement 1 pour la biochimie. Il y en a 750 (!) pour les mathématiques, 62 étiquetés pour la géométrie. Vous pourriez vouloir restreindre votre recherche pour trouver un paquet approprié, par exemple le terme « intégration » a 21 paquets, probablement certains d'entre eux sont dans le total de 750 pour les mathématiques. En ce qui concerne les paquets non scientifiques, il y en a un qui dit soutenir le travail des pasteurs et des prêtres, 28 pour les affaires, 1 pour la comptabilité, 2 pour la banque - dont un qui est spécifique aux documents de la Banque nationale tchèque.
If your document requires citations, there are packages for several different citation styles so the references in your document can conform to whatever style your school or publication requires. There are 5 packages for the MLA style, 17 for the Chicago style, and 53 for the APA style. Some of these packages will be obsolete as citation styles change from time to time. (Perhaps we should develop a package for FCM? <tongue firmly planted in cheek>). If you find a package you would like to use at CTAN, what then? First, of course, you need to download it and unpack it. Then follow the installation instructions if there are any. Some packages have no installation instructions. Apparently the user is supposed to know how to install them. How the user, particularly inexperienced users, are to obtain this knowledge is not clear. Installing new Tex / LaTex packages can be a frustrating experience as you will learn in the rest of this article.
Si votre document nécessite des citations, il existe des paquets pour plusieurs styles de citation différents afin que les références de votre document soient conformes au style exigé par votre école ou votre publication. Il existe 5 paquets pour le style MLA, 17 pour le style Chicago et 53 pour le style APA. Certains de ces paquets seront obsolètes, car les styles de citation changent de temps en temps. (Peut-être devrions-nous développer un paquet pour le FCM ? <je plaisante, bien entendu>).
Si vous trouvez un paquetage que vous aimeriez utiliser au CTAN, que faire ? D'abord, bien sûr, vous devez le télécharger et le décompresser. Ensuite, suivez les instructions d'installation s'il y en a. Certains paquets n'ont pas d'instructions d'installation. Apparemment, l'utilisateur est censé savoir comment les installer. La manière dont l'utilisateur, en particulier les utilisateurs inexpérimentés, doit acquérir cette connaissance n'est pas claire. L'installation de nouveaux paquets Tex/LaTeX peut être une expérience frustrante, comme vous l'apprendrez dans la suite de cet article.
Some packages have good, clear, concise installation instructions. For example the installation instructions for the apa7 package say: 1. Create directory “config” next to the file apa7.ins 2. Run latex apa7.ins 3. Move/copy apa7.cls to the directory of your latex install or the directory containing your latex project. As we will find out, these instructions are appropriate for installing apa7. They are not all you need to know in order to install and use APA citation styles in your documents. I selected APA because it is a very common citation style used at colleges, universities and in professional journals. I selected apa7 because it is tied to the most recent revision of the APA style standard. Whether you use APA (or any citation style), I hope you will learn from what I did. When you want to expand what you can do with LaTex by installing new packages, keep my experience in mind.
Certains paquets ont de bonnes instructions d'installation, claires et concises. Par exemple, les instructions d'installation du paquet apa7 disent : 1. Créez le répertoire « config » à côté du fichier apa7.ins 2. Exécutez latex apa7.ins 3. Déplacez/copiez apa7.cls dans le répertoire de votre installation LaTeX ou dans le répertoire contenant votre projet LaTeX.
Comme nous allons le découvrir, ces instructions sont appropriées pour installer apa7. Elles ne sont pas tout ce que vous devez savoir pour installer et utiliser les styles de citation APA dans vos documents. J'ai choisi APA parce que c'est un style de citation très communément utilisé dans les collèges, les universités et les revues professionnelles. J'ai choisi apa7 parce qu'il est lié à la révision la plus récente de la norme de style APA. Que vous utilisiez APA (ou tout autre style de citation), j'espère que vous apprendrez de ce que j'ai fait. Lorsque vous voudrez étendre ce que vous pouvez faire avec LaTeX en installant de nouveaux paquets, gardez mon expérience à l'esprit.
Having downloaded the apa7.zip package and then unzipping it there are these files: apa7.dtx, apa7.ins, apa7.pdf, README.txt. The README file has the installation instructions shown above. APA7.PDF contains documentation for this version of the APA style sheet – nothing to help with installation of the package. So I will follow the instructions. 1. In the apa7 folder in my default download folder, I made a folder called “config”. 2. I opened a terminal window and ran latex apa7.ins. This generated twelve txt files in the config folder: twelve files starting with apa7 and then a word denoting language: apa7american.txt, apa7british.txt, etc. It also added two files to the main apa7 folder: apa7.cls and apa7.log. 3. Then I am supposed to copy apa7.cls to the directory of my latex install or my project. I chose the project folder. 4. Once I had apa7.cls in the project file, I started a new Tex project (apa7test.tex) and added the apa7 package to the preamble. Then I compiled apa7test.tex using TexStudio. 5. Compiling apa7test.tex with apa7.cls in the same folder generated an error. The apa7.sty file could not be found. I moved the apa7.cls file to the installation folder (using sudo) and compiled it again. a. I did a search for *.cls files and discovered in my distribution *.cls files are stored in /usr/share/texlive/texmf-dist/tex/latex. Each cls file is stored in a separate folder. I have to make a folder apa7 in /usr/share/texlive/texmf-dist/tex/latex (/usr/share/texlive/texmf-dist/tex/latex/apa7) and then moved apa7.cls into that folder (using sudo). 6. Same error: cannot find apa7.sty.
Après avoir téléchargé le paquet apa7.zip et l'avoir décompressé, vous trouverez les fichiers suivants : apa7.dtx, apa7.ins, apa7.pdf, README.txt. Le fichier README contient les instructions d'installation indiquées ci-dessus. APA7.PDF contient la documentation pour cette version de la feuille de style APA - rien pour aider à l'installation du paquet. Je vais donc suivre les instructions. 1. Dans le dossier apa7 de mon dossier de téléchargements par défaut, j'ai créé un dossier appelé « config ». 2. J'ai ouvert une fenêtre de terminal et exécuté latex apa7.ins. Cela a généré douze fichiers txt dans le dossier config : douze fichiers commençant par apa7 et ensuite un mot désignant la langue : apa7american.txt, apa7british.txt, etc. Deux fichiers ont également été ajoutés dans le dossier principal apa7 : apa7.cls et apa7.log. 3. Ensuite, je suis censé copier apa7.cls dans le répertoire de mon installation latex ou de mon projet. J'ai choisi le dossier du projet. 4. Une fois que j'ai eu apa7.cls dans le dossier du projet, j'ai démarré un nouveau projet Tex (apa7test.tex) et ajouté le paquet apa7 au préambule. Puis j'ai compilé apa7test.tex en utilisant TexStudio. 5. La compilation de apa7test.tex avec apa7.cls dans le même dossier a généré une erreur. Le fichier apa7.sty n'a pas pu être trouvé. J'ai déplacé le fichier apa7.cls dans le dossier d'installation (en utilisant sudo) et je l'ai compilé à nouveau.
a. J'ai fait une recherche sur les fichiers *.cls et j'ai découvert que, dans ma distribution, les fichiers *.cls sont stockés dans /usr/share/texlive/texmf-dist/tex/latex. Chaque fichier cls est stocké dans un dossier séparé. Je dois créer un dossier apa7 dans /usr/share/texlive/texmf-dist/tex/latex (/usr/share/texlive/texmf-dist/tex/latex/apa7) et ensuite déplacer apa7.cls dans ce dossier (en utilisant sudo).
6. Même erreur : impossible de trouver apa7.sty.
What I learned is not obvious and not mentioned in the apa7 documentation. APA7 is simply an update to the original APA style sheet which is available by installing apacite. It is not a complete package, the original apacite package needs to be installed first. This oversight in the documentation is common with Tex packages; this kind of oversight is very frustrating for inexperienced users. After I downloaded and unzipped apacite, I then gave the command text apacite.ins. (This instruction is often used as a precursor to installing Tex / LaTex packages.) There are now 24 files in the apacite folder instead of the 4 I started with. These files need homes; they have to be moved to appropriate folders in the tex hierarchy of folders. Each user will have to find where the files with a particular extension are stored in their distribution. Most or all will be in the same part of the directory tree. Search for the extension to find the location. Then move the appropriate file into the location. Then repeat. In my download/apacite folder, there are eight extensions which need to be relocated. Where they will go depends upon your distribution.
Ce que j'ai appris n'est pas évident et n'est pas mentionné dans la documentation d'apa7. APA7 est simplement une mise à jour de la feuille de style APA originale qui est disponible en installant apacite. Ce n'est pas un paquet complet, le paquet original apacite doit être installé en premier. Cet oubli dans la documentation est courant avec les paquets Tex ; ce genre d'oubli est très frustrant pour les utilisateurs inexpérimentés.
Après avoir téléchargé et décompressé apacite, j'ai ensuite donné la commande text apacite.ins. (Cette instruction est souvent utilisée comme précurseur de l'installation des paquets Tex/LaTeX). Il y a maintenant 24 fichiers dans le dossier apacite au lieu des 4 avec lesquels j'ai commencé. Ces fichiers ont besoin d'une lieu d'accueil ; ils doivent être déplacés vers les dossiers appropriés dans la hiérarchie tex des dossiers.
Chaque utilisateur devra trouver où sont stockés les fichiers avec une extension particulière dans sa distribution. La plupart, voire tous, se trouveront dans la même partie de l'arborescence des répertoires. Recherchez l'extension pour trouver l'emplacement. Ensuite, déplacez le fichier approprié dans cet emplacement. Puis répétez l'opération. Dans mon dossier download/apacite, il y a huit extensions qui doivent être déplacées. Leur emplacement dépend de votre distribution.
I know this article has not had much “hands-on” material for you to follow. Next month, I will return to my usual hands-on, step-by-step stuff with an expansion of Erik’s work about images in documents. Some of you have probably watched some or many of the instructional videos about LaTex available online. Many of them are specific about what packages need to be included in order to do particular tasks. Erik used three packages in the articles he wrote: graphicx, subcaption and lipsum. Packages can be used to extend LaTex, to give it capabilities the standard install does not have, to update its features, to do specific tasks. When I look at images next time, I will need to use the graphicx package. As always if you have comments, or questions, or have a specific topic you want me to deal with, please send an email. I will respond to the best of my ability.
Je sais que cet article ne contenait pas beaucoup de matériel « pratique » que vous pouviez suivre. Le mois prochain, je reviendrai à mon habituel travail pratique, étape par étape, en développant le travail d'Erik sur les images dans les documents. Certains d'entre vous ont probablement regardé une ou plusieurs des vidéos de formation sur LaTeX disponibles en ligne. Nombre d'entre elles indiquent précisément quels paquets doivent être inclus pour effectuer certaines tâches. Erik a utilisé trois paquets dans les articles qu'il a écrits : graphicx, subcaption et lipsum. Les paquets peuvent être utilisés pour étendre LaTeX, pour lui donner des capacités que l'installation standard ne possède pas, pour mettre à jour ses fonctionnalités et pour effectuer des tâches spécifiques. La prochaine fois que je regarderai des images, j'aurai besoin d'utiliser le paquet graphicx.
Comme toujours, si vous avez des commentaires, des questions ou un sujet spécifique que vous souhaitez que je traite, envoyez-moi un courriel. Je vous répondrai du mieux que je peux.