From e83962cbd7d9fc58700853d94f8ea87884911d76 Mon Sep 17 00:00:00 2001 From: iGor milhit Date: Tue, 20 May 2025 14:39:39 +0200 Subject: [PATCH] =?UTF-8?q?polycopi=C3=A9:=20met=20=C3=A0=20jour=20pour=20?= =?UTF-8?q?le=20printemps=202025?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Récupère le logo pour LaTeX supprimé par erreur. - Mets à jour l'export des références pour l'exercice. - Ignore le dossier des fichiers générés et les différents fichiers *.bib. - Simplifie la structure, notamment afin d'améliorer les commandes pour le rendu. - Adapte la documentation du README en conséquence. Co-Authored-by: iGor milhit --- .gitignore | 2 + README.md | 18 +- exercice/references-exercice.ris | 4 +- sources/{polycopié => }/heg-iso-690.csl | 0 sources/{polycopié => }/interface.css | 0 sources/{polycopié => }/paged.polyfill.js | 0 sources/{polycopié => }/polycopié.md | 22 +- .../polycopié/static/bibliotheque-logo.svg | 210 ------------------ sources/polycopié/static/by-sa.svg | 199 ----------------- sources/presentation/presentation.md | 38 ---- sources/{polycopié => }/references.json | 0 sources/{polycopié => }/reload-in-place.js | 0 .../better-bibtex-a-jour.png | Bin .../{medias => static}/bibliotheque-logo.svg | 0 sources/{medias => static}/by-sa.png | Bin sources/{medias => static}/by-sa.svg | 0 .../compil-rapide-assistant.png | Bin .../compil-rapide-liste.png | Bin sources/{medias => static}/install-add-on.png | Bin sources/static/latex-logo.svg | 8 + sources/{medias => static}/menu-outils.png | Bin sources/{medias => static}/texmaker-biber.png | Bin sources/{medias => static}/zotero-logo.png | Bin sources/{medias => static}/zotero-logo.svg | 0 sources/{polycopié => }/style.css | 5 +- sources/{polycopié => }/template.html | 13 +- 26 files changed, 44 insertions(+), 475 deletions(-) rename sources/{polycopié => }/heg-iso-690.csl (100%) rename sources/{polycopié => }/interface.css (100%) rename sources/{polycopié => }/paged.polyfill.js (100%) rename sources/{polycopié => }/polycopié.md (95%) delete mode 100644 sources/polycopié/static/bibliotheque-logo.svg delete mode 100644 sources/polycopié/static/by-sa.svg delete mode 100644 sources/presentation/presentation.md rename sources/{polycopié => }/references.json (100%) rename sources/{polycopié => }/reload-in-place.js (100%) rename sources/{medias => static}/better-bibtex-a-jour.png (100%) rename sources/{medias => static}/bibliotheque-logo.svg (100%) rename sources/{medias => static}/by-sa.png (100%) rename sources/{medias => static}/by-sa.svg (100%) rename sources/{medias => static}/compil-rapide-assistant.png (100%) rename sources/{medias => static}/compil-rapide-liste.png (100%) rename sources/{medias => static}/install-add-on.png (100%) create mode 100644 sources/static/latex-logo.svg rename sources/{medias => static}/menu-outils.png (100%) rename sources/{medias => static}/texmaker-biber.png (100%) rename sources/{medias => static}/zotero-logo.png (100%) rename sources/{medias => static}/zotero-logo.svg (100%) rename sources/{polycopié => }/style.css (98%) rename sources/{polycopié => }/template.html (83%) diff --git a/.gitignore b/.gitignore index 50ebc3e..913ee2e 100644 --- a/.gitignore +++ b/.gitignore @@ -2,6 +2,8 @@ polycopié.html test.html watched-files.txt +public/ +*.bib # Created by https://www.toptal.com/developers/gitignore/api/latex # Edit at https://www.toptal.com/developers/gitignore?templates=latex diff --git a/README.md b/README.md index 6be838e..46023dc 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ tags: [README, documentation, latex, rdv-info] Ce répertoire contient les sources pour le *Rendez-vous de l'info* sur les citations et les références bibliographiques avec LaTeX. Il contient : -- La source en markdown pour le support de cours (`sources/polycopié/`). +- La source en markdown pour le support de cours (`sources/`). - Des exemples de fichiers `.tex` (`exercice/exercice.tex`). - Un export de collection Zotero au format biblatex (`exercice/references-exercices.bib`). @@ -40,7 +40,7 @@ Pour pouvoir utiliser ce projet, il est nécessaire : Avec cet outil, il est possible de définir les styles des éléments dans le PDF au moyen de règles CSS (voir [paged.js][6]). Dans le dossier -`sources/polycopié/` se trouvent un `template.html` utilisé par `pandoc` pour +`sources/` se trouvent un `template.html` utilisé par `pandoc` pour produire un fichier HTML avec les classes et les identifiants désirés. Le fichier `style.css` contient pour sa part la mise en forme permettant d'obtenir un fichier suivant en bonne partie la charte de l'UNIGE. @@ -55,8 +55,8 @@ npm install -g puppeteer pagedjs pagedjs-cli Puis, on peut produire directement un PDF : ```bash -cd sources/polycopié/ -pandoc --standalone --embed-resource --citeproc \ +cd sources/ +pandoc --V noscript=true --embed-resource --citeproc \ --to=pdf --pdf-engine=pagedjs-cli \ --toc --toc-depth=2 --css=style.css \ @@ -66,8 +66,10 @@ pandoc --standalone --embed-resource --citeproc \ Pour obtenir un fichier HTML, qui peut être ensuite imprimé au format PDF : ```bash -cd sources/polycopié/ -pandoc --citeproc --to=html \ +cd sources/ +pandoc --standalone \ + --citeproc --to=html \ + --toc --toc-depth=2 --template=template.html --css=style.css \ --output=polycopié.html polycopié.md ``` @@ -89,7 +91,7 @@ utiliser la commande suivante : ```bash pandoc --citeproc --to=pdf --pdf-engine=tectonic \ --output=public/polycopié.pdf \ - source/polycopié/polycopié.md + source/polycopié.md ``` - `--citeproc` traite les citations et génère la bibliographie. @@ -124,4 +126,4 @@ pandoc -t pdf --pdf-engine=tectonic -o déroulé.pdf déroulé.md [4]: https://www.latex-project.org/get/ [5]: https://tectonic-typesetting.github.io/en-US/install.html [6]: https://pagedjs.org/ -[7]: ./déroulé.md +[7]: ./déroulé diff --git a/exercice/references-exercice.ris b/exercice/references-exercice.ris index 84d9318..0ecc3ed 100644 --- a/exercice/references-exercice.ris +++ b/exercice/references-exercice.ris @@ -1,11 +1,11 @@ TY - ELEC -TI - BibTeX, natbib, biblatex: Managing citations in LaTeX: BibTeX and natbib. +TI - BibTeX, natbib, biblatex: Managing citations in LaTeX AU - Bohemier, Kayleigh T2 - Yale University Library Research Guides AB - A short guide linking to documentation, resources for bibliographic citation styles, and other useful tools to use when citing sources using .bib files and associated packages. LA - eng ST - Yale university library research guides -UR - https://guides.library.yale.edu/bibtex/bibtex-natbib +UR - https://guides.library.yale.edu/bibtex Y2 - 2022/05/17/ KW - cmu KW - non lu diff --git a/sources/polycopié/heg-iso-690.csl b/sources/heg-iso-690.csl similarity index 100% rename from sources/polycopié/heg-iso-690.csl rename to sources/heg-iso-690.csl diff --git a/sources/polycopié/interface.css b/sources/interface.css similarity index 100% rename from sources/polycopié/interface.css rename to sources/interface.css diff --git a/sources/polycopié/paged.polyfill.js b/sources/paged.polyfill.js similarity index 100% rename from sources/polycopié/paged.polyfill.js rename to sources/paged.polyfill.js diff --git a/sources/polycopié/polycopié.md b/sources/polycopié.md similarity index 95% rename from sources/polycopié/polycopié.md rename to sources/polycopié.md index c51b3c3..fd3bdc1 100644 --- a/sources/polycopié/polycopié.md +++ b/sources/polycopié.md @@ -1,11 +1,11 @@ --- title: "Citer ses références et créer une bibliographie avec LaTeX et Zotero" -date: Automne 2024 +date: Printemps 2025 creation_date: 2023-03-24T08:25:47+0100 id: 20230324082557 logo: - - ../medias/latex-logo.svg - - ../medias/zotero-logo.png + - ./static/latex-logo.svg + - ./static/zotero-logo.png lang: fr bibliography: references.json csl: heg-iso-690.csl @@ -79,7 +79,7 @@ d'un fichier dont l'extension est `.bib`, ce qui correspond : Ce fichier `.bib` se place le plus souvent dans le même dossier que le document `.tex` de travail, mais il est possible de l'enregistrer n'importe où et de -préciser son chemin dans le fichier `tex`. +préciser son chemin dans le fichier `.tex`. @@ -92,7 +92,7 @@ préciser son chemin dans le fichier `tex`. BibTex est le logiciel historique pour la gestion des références et des bibliographies dans un document `.tex`. Il est aussi le plus souvent mentionné dans les exigences des éditeurs scientifiques. Pourtant, ce logiciel n'est plus -développé depuis de plusieurs décennies et n'offre pas facilement les +développé depuis plusieurs décennies et n'offre pas facilement les fonctionnalités auxquelles nous pouvons nous attendre actuellement. Aussi Biber (et BibLaTeX) est fortement conseillé et c'est pourquoi il n'est @@ -189,7 +189,7 @@ L'extension *Better BibTeX for Zotero* résout deux problèmes des fichiers 1. Elle permet de **modifier une clé de citation (citekey) manuellement ou de créer un format de citekey par défaut.** -![Fenêtre de dialogue de Better BibTex](../medias/better-bibtex-a-jour.png) +![Fenêtre de dialogue de Better BibTex](./static/better-bibtex-a-jour.png) Pour installer l'extension (au format `.xpi`) *Better BibTeX* : @@ -200,9 +200,9 @@ Pour installer l'extension (au format `.xpi`) *Better BibTeX* : from file* (Figure 3). - Sélectionner le fichier téléchargé. -![Menu « outils » de Zotero](../medias/menu-outils.png) +![Menu « outils » de Zotero](./static/menu-outils.png) -![Installer un fichier `.xpi`](../medias/install-add-on.png) +![Installer un fichier `.xpi`](./static/install-add-on.png) ### Autres fonctionnalités de Better BibTeX @@ -239,7 +239,7 @@ Il faut donc lui préciser lequel on utilise : 1. Dans l'onglet *Commandes*, chercher l'entrée *Bib(la)tex* et entrer `biber %` (Figure 4). -![Configuer Biber pour BibLaTeX dans Texmaker](../medias/texmaker-biber.png) +![Configuer Biber pour BibLaTeX dans Texmaker](./static/texmaker-biber.png) Lorsque l'on compile avec des références bibliographiques, il est nécessaire de le faire quatre fois : @@ -262,12 +262,12 @@ Dans le cas de l'exercice présenté, une bonne solution est d'utiliser XeLaTeX. Pour cela, il faut choisir l'option *Utilisateur* et utiliser l'assistant (figure 5). -![Assistant de configuration de compil rapide](../medias/compil-rapide-assistant.png) +![Assistant de configuration de compil rapide](./static/compil-rapide-assistant.png) Puis, dans l'assistant, sélectionner les commandes à ajouter, une à une, dans l'ordre (figure 6). -![Ajout des commandes dans l'assistant](../medias/compil-rapide-liste.png) +![Ajout des commandes dans l'assistant](./static/compil-rapide-liste.png) Les services web comme Overleaf ou les outils comme `tectonic`[^5] prennent eux-mêmes en charge ce genre de complexité. diff --git a/sources/polycopié/static/bibliotheque-logo.svg b/sources/polycopié/static/bibliotheque-logo.svg deleted file mode 100644 index b33b2b1..0000000 --- a/sources/polycopié/static/bibliotheque-logo.svg +++ /dev/null @@ -1,210 +0,0 @@ - - - - diff --git a/sources/polycopié/static/by-sa.svg b/sources/polycopié/static/by-sa.svg deleted file mode 100644 index f850297..0000000 --- a/sources/polycopié/static/by-sa.svg +++ /dev/null @@ -1,199 +0,0 @@ - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/sources/presentation/presentation.md b/sources/presentation/presentation.md deleted file mode 100644 index 7551149..0000000 --- a/sources/presentation/presentation.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Citer ses références et créer une bibliographie avec LaTeX -author: iGor milhit -date: 2023-03-30 -creation_date: 2023-03-21T09:07:01+01:00 -id: 20230321090701 -tags: [rdv-info, latex, biblatex, zotero, bibliographie] ---- - -## Objectifs de la formation - -- Exporter ses références de Zotero au format `.bib`. -- Configurer le style de citation et de bibliographie. -- Insérer des citations. -- Créer une bibliographie. - -## Exemple de préambule - -```latex -\documentclass[11pt,a4paper]{article} -\usepackage{lmodern} -\usepackage[french]{babel} -\usepackage[utf8]{inputenc} -\usepackage[T1]{fontenc} -\usepackage{hyperref} -\usepackage[citestyle=numeric, - style=vancouver, - backend=biber]{biblatex} -\addbibresource{references.bib} -``` - -# Examples - -## Exemple de bloc - -### Titre {.alert} - -Texte dans un bloc. diff --git a/sources/polycopié/references.json b/sources/references.json similarity index 100% rename from sources/polycopié/references.json rename to sources/references.json diff --git a/sources/polycopié/reload-in-place.js b/sources/reload-in-place.js similarity index 100% rename from sources/polycopié/reload-in-place.js rename to sources/reload-in-place.js diff --git a/sources/medias/better-bibtex-a-jour.png b/sources/static/better-bibtex-a-jour.png similarity index 100% rename from sources/medias/better-bibtex-a-jour.png rename to sources/static/better-bibtex-a-jour.png diff --git a/sources/medias/bibliotheque-logo.svg b/sources/static/bibliotheque-logo.svg similarity index 100% rename from sources/medias/bibliotheque-logo.svg rename to sources/static/bibliotheque-logo.svg diff --git a/sources/medias/by-sa.png b/sources/static/by-sa.png similarity index 100% rename from sources/medias/by-sa.png rename to sources/static/by-sa.png diff --git a/sources/medias/by-sa.svg b/sources/static/by-sa.svg similarity index 100% rename from sources/medias/by-sa.svg rename to sources/static/by-sa.svg diff --git a/sources/medias/compil-rapide-assistant.png b/sources/static/compil-rapide-assistant.png similarity index 100% rename from sources/medias/compil-rapide-assistant.png rename to sources/static/compil-rapide-assistant.png diff --git a/sources/medias/compil-rapide-liste.png b/sources/static/compil-rapide-liste.png similarity index 100% rename from sources/medias/compil-rapide-liste.png rename to sources/static/compil-rapide-liste.png diff --git a/sources/medias/install-add-on.png b/sources/static/install-add-on.png similarity index 100% rename from sources/medias/install-add-on.png rename to sources/static/install-add-on.png diff --git a/sources/static/latex-logo.svg b/sources/static/latex-logo.svg new file mode 100644 index 0000000..d02e869 --- /dev/null +++ b/sources/static/latex-logo.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/sources/medias/menu-outils.png b/sources/static/menu-outils.png similarity index 100% rename from sources/medias/menu-outils.png rename to sources/static/menu-outils.png diff --git a/sources/medias/texmaker-biber.png b/sources/static/texmaker-biber.png similarity index 100% rename from sources/medias/texmaker-biber.png rename to sources/static/texmaker-biber.png diff --git a/sources/medias/zotero-logo.png b/sources/static/zotero-logo.png similarity index 100% rename from sources/medias/zotero-logo.png rename to sources/static/zotero-logo.png diff --git a/sources/medias/zotero-logo.svg b/sources/static/zotero-logo.svg similarity index 100% rename from sources/medias/zotero-logo.svg rename to sources/static/zotero-logo.svg diff --git a/sources/polycopié/style.css b/sources/style.css similarity index 98% rename from sources/polycopié/style.css rename to sources/style.css index a91e696..b672f15 100644 --- a/sources/polycopié/style.css +++ b/sources/style.css @@ -80,9 +80,8 @@ .logo { display: inline-flex; - justify-content: space-between; - align-items: center; - width: 60%; + justify-content: center; + /* width: 60%; */ margin: 2em auto 1em auto; } .logo img { diff --git a/sources/polycopié/template.html b/sources/template.html similarity index 83% rename from sources/polycopié/template.html rename to sources/template.html index 6bad0b9..46946b6 100644 --- a/sources/polycopié/template.html +++ b/sources/template.html @@ -26,16 +26,21 @@ $endif$ $for(css)$ $endfor$ - - - + +$if(noscript)$ +$else$ + + + +$endif$ $for(header-includes)$ $header-includes$ $endfor$ $if(math)$ $math$ $endif$ - $for(include-before)$