summaryrefslogtreecommitdiff
path: root/info/formation-latex-ul/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'info/formation-latex-ul/README.md')
-rw-r--r--info/formation-latex-ul/README.md140
1 files changed, 107 insertions, 33 deletions
diff --git a/info/formation-latex-ul/README.md b/info/formation-latex-ul/README.md
index dffb9d5d04..b24b9fd3bd 100644
--- a/info/formation-latex-ul/README.md
+++ b/info/formation-latex-ul/README.md
@@ -1,8 +1,9 @@
-# formation-latex-ul
+# Rédaction avec LaTeX
-Package **formation-latex-ul** contains the supporting documentation,
-slides, exercise files and templates for an introductory LaTeX course
-(in French) prepared for Université Laval, Québec, Canada.
+The package **formation-latex-ul** provides an introduction to LaTeX
+manual (in French) and the support material (slides and exercise
+files) for a course. The material was prepared for Université Laval,
+Québec, Canada.
## License
@@ -10,15 +11,54 @@ Creative Commons Attribution-ShareAlike 4.0 International.
## Version
-2020.10
+2023.11
## Author
Vincent Goulet <vincent.goulet@act.ulaval.ca>
-> The rest of this file is in French for the target audience.
+## Web page of the project
-# formation-latex-ul
+https://vigou3.gitlab.io/formation-latex-ul
+
+## Source code repository
+
+https://gitlab.com/vigou3/formation-latex-ul
+
+## Contents
+
+- `doc/formation-latex-ul.pdf`: reference manual;
+- `doc/formation-latex-ul-diapos.pdf`: slides for a short course based
+ on the reference manual;
+- `doc/exercice-*.tex`: source files for the exercises;
+- other files in `doc/`: support files for the exercises;
+- `source/*`: complete sources for the reference manual and the
+ slides;
+- `CONTRIBUTING.md`: instructions to contribute to the project;
+- `LICENSE`: CC BY-SA 4.0 license;
+- `NEWS`: version history;
+- `README.md`: this file.
+
+## Compilation of the documents
+
+The directory `source/` contains the complete sources to compile the
+reference manual and the slides using XeLaTeX on an up-to-date TeX
+distribution. Note, however, that the reference manual requires the
+non-free [Lucida fonts](https://tug.org/store/lucida/) from TUG.
+
+## Version history
+
+The version history of the project appears in `NEWS` (in French).
+
+## Comments or suggestions
+
+The Gitlab [project repository](https://gitlab.com/vigou3/formation-latex-ul)
+is the best place to report bugs or to propose improvements to the
+project.
+
+======================================================================
+
+# Rédaction avec LaTeX
Le paquetage **formation-latex-ul** propose une formation à
l'utilisation de LaTeX développée à l'origine pour la Bibliothèque de
@@ -27,22 +67,19 @@ l'[Université Laval](https://www.ulaval.ca).
La formation est formée des éléments suivants:
1. *Rédaction avec LaTeX*, un document de référence de près de
- 200 pages; voir le fichier `doc/formation-latex-ul.pdf`;
+ 200 pages;
2. des diapositives pour une formation en classe couvrant grosso modo
- les quatre premiers chapitres du document de référence; voir le
- fichier `doc/formation-latex-ul-diapos.pdf`;
+ les quatre premiers chapitres du document de référence;
3. les fichiers nécessaires pour compléter certains exercices, ainsi
- qu'un gabarit pour composer les solutions des autres exercices; voir
- le dossier `doc/`.
+ qu'un gabarit pour composer les solutions des autres exercices.
Les quatre premiers chapitres du document de référence couverts par
-les diapositives traitent des concepts de base pour un nouvel
-utilisateur de LaTeX: processus d'édition, compilation, visualisation;
-séparation du contenu et de l'apparence du texte; mise en forme du
-texte; séparation du document en parties; rudiments du mode
-mathématique.
+les diapositives traitent des concepts de base de LaTeX: processus
+d'édition, compilation, visualisation; séparation du contenu et de
+l'apparence du texte; mise en forme du texte; séparation du document
+en parties; rudiments du mode mathématique.
Les six autres chapitres du document de référence visent à rendre
l'utilisateur de LaTeX débutant ou intermédiaire autonome dans la
@@ -50,22 +87,59 @@ rédaction de documents relativement complexes comportant des tableaux,
des figures, des équations mathématiques élaborées, une bibliographie,
etc.
+## Licence
+
+Attribution-Partage dans les mêmes conditions 4.0 International de
+Creative Commons
+
+## Version
+
+2023.11
+
+## Auteur
+
+Vincent Goulet <vincent.goulet@act.ulaval.ca>
+
+## Page web du projet
+
+https://vigou3.gitlab.io/formation-latex-ul
+
+## Dépôt du code source
+
+https://gitlab.com/vigou3/formation-latex-ul
+
+## Contenu du paquetage
+
+- `doc/formation-latex-ul.pdf`: ouvrage de référence;
+- `doc/formation-latex-ul-diapos.pdf`: diapositives de la formation;
+- `doc/exercice-*.tex`: fichiers pour les exercices;
+- autres fichiers dans `doc/`: fichiers additionnels pour les
+ exercices;
+- `source/*`: code source de l'ouvrage de référence et des
+ diapositives;
+- `CONTRIBUTING.md`: instructions pour contribuer au projet;
+- `LICENSE`: license CC BY-SA 4.0;
+- `NEWS`: historique des versions;
+- `README.md`: le présent fichier.
+
## Composition des documents
Le dossier `source/` contient tous les fichiers nécessaires pour
-composer le document principal et les diapositives avec XeLaTeX. La
-compilation du document requiert les polices de caractères suivantes:
-
-- [Lucida Bright OT, Lucida Math OT et Lucida Mono DK](https://tug.org/store/lucida/).
- Ces polices de très grande qualité sont payantes. La Bibliothèque de
- l'Université Laval détient une licence d'utilisation de cette
- police. Les étudiants et le personnel de l'Université peuvent s'en
- procurer une copie gratuitement en écrivant à
- [mailto:lucida@bibl.ulaval.ca].
-- [Fira Sans](https://www.fontsquirrel.com/fonts/fira-sans) (les
- versions OpenType de Mozilla) en graisses *Book*, *Semi Bold*, *Book
- Italic* et *Semi Bold Italic*.
-- [Font Awesome](https://fontawesome.com/). Cette police fournit une
- multitude d'icônes et de symboles. Depuis octobre 2020, le document
- utilise la version 5.x de la police. Celle-ci est normalement
- installée avec TeX Live.
+composer le document principal et les diapositives avec XeLaTeX à
+partir d'une distribution TeX récente et à jour. Toutefois, la
+compilation de l'ouvrage de référence requiert les polices de
+caractères payantes [Lucida](https://tug.org/store/lucida/) du TeX
+User Group. La Bibliothèque de l'Université Laval détient une licence
+d'utilisation de cette police. Les étudiants et le personnel de
+l'Université peuvent s'en procurer une copie gratuitement en écrivant
+à [mailto:lucida@bibl.ulaval.ca].
+
+## Historique des versions
+
+L'historique des versions se trouve dans `NEWS`.
+
+## Commentaires et suggestions
+
+Le [dépôt du projet](https://gitlab.com/vigou3/formation-latex-ul)
+dans GitLab demeure le meilleur endroit pour rapporter des bogues ou
+pour proposer des améliorations au projet.