diff --git a/.gitignore b/.gitignore index b4c43ee..e85d7fc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,7 @@ *.pdf policopié.html test.html +watched-files.txt # Created by https://www.toptal.com/developers/gitignore/api/latex # Edit at https://www.toptal.com/developers/gitignore?templates=latex diff --git a/sources/medias/better-bibtex-a-jour.png b/sources/medias/better-bibtex-a-jour.png index ef97b83..4a118d3 100644 Binary files a/sources/medias/better-bibtex-a-jour.png and b/sources/medias/better-bibtex-a-jour.png differ diff --git a/sources/medias/install-add-on.png b/sources/medias/install-add-on.png index dcb7d07..2bad8a9 100644 Binary files a/sources/medias/install-add-on.png and b/sources/medias/install-add-on.png differ diff --git a/sources/medias/menu-outils.png b/sources/medias/menu-outils.png index 87c214a..3cac20b 100644 Binary files a/sources/medias/menu-outils.png and b/sources/medias/menu-outils.png differ diff --git a/sources/medias/texmaker-biber.png b/sources/medias/texmaker-biber.png index 549780c..3acbcb8 100644 Binary files a/sources/medias/texmaker-biber.png and b/sources/medias/texmaker-biber.png differ diff --git a/sources/polycopié/polycopié.css b/sources/polycopié/polycopié.css deleted file mode 100644 index 45288fe..0000000 --- a/sources/polycopié/polycopié.css +++ /dev/null @@ -1,154 +0,0 @@ -@media print { - body { - font-family: TheSans, "Open Sans", Arial, Helvetica, sans-serif; - /* Définit les deux variable de compteur nécessaires */ - counter-reset: figureNumber toc; - } - /* Définit que string(date) contient la date indiquée dans le frontmatter - * de la source markdown */ - .date { - string-set: date content(text) - } - @page { - size: A4; - margin-top: 25mm; - margin-bottom: 25mm; - bleed: 6mm; - @bottom-center { - content: counter(page) - } - } - @page:left { - margin-left: 25mm; - margin-right: 15mm; - } - @page:right { - margin-left: 15mm; - margin-right: 25mm; - } - @page:first { - @top-right { - content: ""; - background-image: url("../medias/bibliotheque-logo.svg"); - background-position: right; - background-repeat: no-repeat; - background-size: 25%; - } - @bottom-center { - content: none; - } - @bottom-right { - content: string(date); - } - } - /* Attention, il faut adapter au nombre effectif de pages ! * - * Cette règle n'affiche pas de numré de page à la dernière page */ - @page:nth(11) { - @bottom-center { - content: none; - } - } - h2 { - color: #d80669; - text-decoration: underline; - } - /* Ajouter ou supprimer les ID de titre pour un saut de page */ - #principes-généraux, - #bibliographie, - .footnotes { - break-before: page; - } - #title-block-header { - text-align: center; - margin-bottom: 6em; - } - .authors { - display: flex; - justify-content: space-evenly; - } - .author { - margin: 0; - } - pre { - font-family:'Courier New', Courier, monospace; - font-size: 90%; - background-color: #f2f1f1; - border: 2px solid #d80669; - border-radius: .5em; - margin: 1em; - padding: .5em 1em; - break-inside: avoid; - } - code { - font-family:'Courier New', Courier, monospace; - font-size: 90%; - background-color: #f2f1f1; - padding: 2px; - border-radius: 5px; - } - .footnotes::before { - content: "Notes"; - color: #d80669; - font-size: 120%; - font-weight: bold; - } - .footnote-ref { - text-decoration: none; - } - figure { - display: flex; - flex-direction: column; - border: 2px solid #d80669; - border-radius: .5em; - padding: .5em; - break-inside: avoid; - } - figure img { - max-width: 85%; - margin: 0 auto; - } - figcaption { - text-align: center; - font-size: 90%; - counter-increment: figureNumber; - padding-top: .5em; - } - figcaption::before { - content: "Figure " counter(figureNumber) " : "; - } - blockquote { - font-style: italic; - } - blockquote em { - font-style: normal; - } - div.csl-entry { - padding: .5em; - } - .logo { - display: inline-flex; - width: 60%; - margin: 0 auto; - } - .logo img { - max-width: 50%; - padding: .5em; - } - /* Les 3 règles suivantes mettent en forme la table des matières :* - * Suppression des liste à puce et numérotation des chapitres. */ - #TOC ul { - list-style-type: none; - padding-left: 0; - } - #TOC li { - counter-increment: toc; - } - #TOC li::before { - content: counter(toc) ". "; - } - #TOC a::after { - content: target-counter(attr(href url), page); - position: absolute; - right: 0; - } -} diff --git a/sources/polycopié/polycopié.html b/sources/polycopié/polycopié.html new file mode 100644 index 0000000..f28d693 --- /dev/null +++ b/sources/polycopié/polycopié.html @@ -0,0 +1,651 @@ + + + + + + + Citer ses références et créer une bibliographie avec LaTeX et Zotero + + + + + + + +
+

Citer ses références et créer une bibliographie avec +LaTeX et Zotero

+

Automne 2024

+ +
+ +

Objectifs

+

Au terme de cet atelier, vous serez en mesure de :

+ +
+


+CC BY-SA 4.0Sources

+
+ +

Principes généraux

+
+

« Dans LaTeX il faut distinguer le langage de balisage, le système de +composition et la distribution. » (Fauchié 2020)

+
+

Pour générer des documents avec LaTeX, il faut :

+ +

Pour disposer d’un tel système de composition, le plus souvent on +installe un environnement ou une distribution LaTeX, par +exemple TeX Live pour Linux, MacTex pour Mac OS ou MiKTeX pour Windows1. Il est aussi possible d’installer +des distributions plus minimales, comme tectonic ou +TinyTeX2.

+

Afin de faciliter la collaboration ou pour s’éviter une installation +parfois laborieuse, des services en ligne sont préférés, comme https://www.overleaf.com/.

+

Enfin, un éditeur est nécessaire pour travailler sur les sources (le +ou les fichiers .tex). N’importe quel éditeur de texte +suffit, mais des aides comme la coloration syntaxique, la complétion des +commandes ou la gestion de la compilation autrement que dans une console +sont très utiles. Parmi une liste plutôt riche, les éditeurs suivants +peuvent être mentionnés :

+ +

Afin de pouvoir insérer des citations et créer des bibliographies +avec LaTeX, un fichier contenant les références bibliographiques est +nécessaire. Il s’agit 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 le placer n’importe où et de préciser le chemin où il se +trouve.

+ +

BibTeX VS BibLaTeX

+

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 fonctionnalités auxquelles nous pouvons +nous attendre actuellement.

+

Aussi Biber (et BibLaTeX) est fortement conseillé et c’est pourquoi +il n’est question que de cette option dans ce document. Il est plus +récent et évolue encore constamment. En ne chargeant que le paquet +biblatex, il est possible de définir le type d’appel de +citation (notes en bas de page, numéro, auteur-date, etc.) et différents +style de bibliographies.

+

Débuter avec BibLaTeX n’empêche pas de passer à BibTeX ensuite, si +nécessaire.

+

Structure d’une +référence dans un fichier .bib

+

Une référence dans un fichier .bib au format BibLaTeX +ressemble à cela :

+
@book{sauvayreMethodesEntretienSciences2013,
+  location = {Paris},
+  title = {Les méthodes de l'entretien en sciences sociales},
+  isbn = {978-2-10-057970-9},
+  series = {Psycho sup. Psychologie sociale},
+  pagetotal = {138},
+  publisher = {Dunod},
+  author = {Sauvayre, Romy},
+  date = {2013},
+  keywords = {Enquêtes sociologiques, Entretiens, Sociologie},
+}
+

La première ligne définit le type de document, sous la forme +@type (@book, @article, +@phdthesis, etc.). Puis, après l’ouverture d’accolade, suit +la clé de citation (Citekey), c’est-à-dire l’identifiant unique +de la référence qui sera indiquée dans le document .tex, +afin d’insérer une référence.
+Les lignes suivantes correspondent aux champs de la référence, sous la +forme champ = {valeur}, séparés par une virgule.

+

La documentation BibLaTeX détaille l’ensemble des types et des champs +(Lehman, Kime, Wemheuer 2023, p. 7). Une +cheatsheet les liste également (voir Rees +2017).

+

Il est possible de créer et de mettre à jour un fichier +.bib à la main, à l’aide d’un éditeur de texte. Un grand +nombre de bases de données, de sites de revues ou de catalogues de +bibliothèques permettent de télécharger une ou plusieurs références dans +un fichier .bib, mais le plus souvent dans la structure +BibTeX et non pas BibLaTeX.

+

Mais il est recommandé de déléguer la gestion du fichier +.bib à un logiciel de gestion de références +bibliographiques, comme JabRef3 ou Zotero4. +L’intérêt de ces logiciels est d’éviter les erreurs et d’automatiser en +partie l’ajout de références dans sa base de données.

+ +

Créer un fichier +.bib via Zotero

+

Avec Zotero, il est possible de générer un fichier +.bib :

+ +

Il suffit de :

+ +

Ce procédé très simple a néanmoins un inconvénient : le fichier créé +est statique. Il ne sera pas mis à jour automatiquement si la collection +est complétée, ou si les références sont corrigées dans Zotero. Il +faudra générer à nouveau et écraser le fichier .bib pour +qu’il soit à jour.

+

L’extension Better +BibTeX for Zotero

+

L’extension Better BibTeX for Zotero résout deux problèmes +des fichiers .bib générés par Zotero :

+
    +
  1. Elle permet d’exporter un fichier .bib +dynamique, c’est-à-dire que le contenu de celui-ci sera mis à jour +automatiquement lorsque la collection correspondante dans Zotero sera +modifiée. Pour cela, il faut choisir le format d’exportation +Better BibTeX ou Better BibLaTeX et sélectionner +l’option Garder à jour. (Figure 1)
    +
  2. +
  3. Elle permet de modifier une clé de citation (citekey) +manuellement ou de créer un format de citekey par défaut.
  4. +
+
+ + +
+

Pour installer l’extension (au format .xpi) Better +BibTeX :

+ +
+Menu « outils » de Zotero + +
+
+ + +
+

Autres fonctionnalités +de Better BibTeX

+

Better BibTeX propose des fonctionnalités plus +avancées :

+ +

Ces fonctionnalités ne seront pas décrites en détail dans ce +document. Les informations supplémentaires à ce sujet sont disponibles +sur le site https://retorque.re/zotero-better-BibTeX/.

+

Configurer la compilation

+

Pour générer le fichier PDF à partir des sources .tex et +.bib, il est nécessaire de configurer le système de +composition que l’on va utiliser. Il peut être appelé en ligne de +commande dans une console ou, à l’inverse, pris en charge presque +entièrement par une plateforme comme Overleaf. Et entre les deux, des +éditeurs de texte dédiés à LaTeX offrent un certain nombre d’options de +compilation ou de composition.

+

L’exemple donné ci-dessous est adapté à l’exercice et à l’utilisation +de l’éditeur Texmaker, mais le principe est similaire dans les +différents environnement.

+

Dans Texmaker, la fonction pour lancer BibTeX ou Biber est la même. +Il faut donc lui préciser lequel on utilise :

+
    +
  1. Menu Options.
  2. +
  3. Configurer Texmaker.
  4. +
  5. Dans l’onglet Commandes, chercher l’entrée +Bib(la)tex et entrer biber %. (Figure 4)
    +
  6. +
+
+ + +
+

Lorsque l’on compile avec des références bibliographiques, il est +nécessaire de le faire quatre fois :

+
    +
  1. XeLaTeX.
  2. +
  3. Biber.
  4. +
  5. XeLaTeX.
  6. +
  7. XeLaTeX.
  8. +
  9. Afficher le PDF.
  10. +
+

Heureusement Texmaker permet de configure une Compilation +rapide qui lance automatiquement ces quatre itérations :

+
    +
  1. Menu Options.
  2. +
  3. Configurer Texmaker.
  4. +
  5. Onglet Compil rapide.
  6. +
  7. Choisir la suite de commande à lancer.
  8. +
+

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.

+
+ + +
+

Puis, dans l’assistant, sélectionner les commandes à ajouter, une à +une, dans l’ordre.

+
+ + +
+

Les services web comme Overleaf ou les outils comme +tectonic6 prennent eux-mêmes en charge ce +genre de complexité.

+

Utilisation de BibLaTeX

+

Préambule : options de style et lien avec les +références

+

Voici un exemple de préambule avec le paquet biblatex et +quelques options :

+
\documentclass[11pt,a4paper,french]{article}
+\usepackage{lmodern}
+\usepackage[french]{babel}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage{hyperref}
+\usepackage[style=vancouver,
+            backend=biber]{biblatex}
+\addbibresource{references-exercice.bib}
+
+\author{Dimitri Donzé, Vincent Hubert, Igor Milhit}
+\title{Notre pseudo-article}
+

Le paquet est chargé sous la forme +\usepackage[options]{biblatex}. Pour les options, il faut +se référer à la documentation ou à la cheatsheet citées plus +haut. L’exemple montre les options que vous allez le plus souvent +utiliser :

+ +

Pour plus de finesse, existent les options citestyle +pour définit le style de citation et bibstyle pour le style +bibliographique. Le plus souvent l’option style suffit.

+

La commande \addbibresource{<nom-du-fichier>.bib} +permet de définir le fichier contenant les références bibliographiques. +Le plus simple, est de le placer dans le même répertoire que le fichier +.tex.

+

Insérer des citations

+

Pour insérer des citations, il existe un ensemble de commandes +possibles (voir la cheatsheet), pour les différents cas. La +syntaxe est la suivante :

+
\cite[<pre>][<post>]{<key>}
+ +

Voici les appels de citation les plus utiles :

+ +

Ces commandes possèdent des versions pour appeler plusieurs +références simultanément : +\autocites{<key1>}{<key2>}.

+

Créer une bibliographie

+

La commande \printbibliography insère la bibliographie. +Elle se place généralement à la fin du document, mais ce n’est pas +obligatoire.

+

Elle peut prendre un certain nombre d’options :

+
\printbibliography[title=Bibliographie]
+

Cet exemple définit le titre de la bibliographie. Par défaut, le +titre est Références en français.

+

À l’aide de la cheatsheet ou de la documentation il est +possible de comprendre comment réaliser une bibliographie pour une +section du document, ou une bibliographie ne contenant que les +références liées à un mot clé particulier.

+

Enrichir BibLaTeX

+

Dans la bibliographie est indiqué une ressource en ligne qui liste +des paquets pouvant être installés afin d’enrichir BibLaTeX (CTAN: Topic +BibLaTeX [sans date]). Dans ces paquets, on trouve par +exemple des styles bibliographiques. Or, pour les installer, il faut +savoir dans quel répertoire il faut ajouter les fichiers, si nécessaire. +Pour cela, une commande peut être tapée dans une console (par exemple +Powershell pour Windows, iterm pour Mac OS ou votre terminal +Linux) :

+
kpsewhich --var-value TEXMFLOCAL
+/usr/local/share/texmf:/usr/share/texmf
+

La deuxième ligne est le chemin correspondant à l’installation de +LaTeX où les répertoires et fichiers peuvent être ajoutés.

+

Sous Windows la commande ne prend qu’un tiret pour le paramètre :

+
kpsewhich -var-value TEXMFLOCAL
+

Bibliographie

+
+
+Bibliography in LaTeX with Bibtex/Biblatex, 2021. +LaTeX-Tutorial.com. [en ligne]. 19 juillet 2021. +[Consulté le 23 mars 2023]. Disponible à l'adresse: https://latex-tutorial.com/tutorials/bibtex/ +
+
+CTAN: Topic BibLaTeX, [sans date]. CTAN: Comprehensive TeX Archive +Network. [en ligne]. [Consulté le 29 mars 2023]. Disponible à +l'adresse: https://ctan.org/topic/biblatex +
+
+FAUCHIÉ, Antoine, 2020. Fabriques de publication : LaTeX. +quaternum.net. [en ligne]. 29 avril 2020. +[Consulté le 23 mars 2023]. Disponible à l'adresse: https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/ +
+
+GROLIMUND, Raphaël, 2019. Zotero et LaTeX. Le blog Zotero +francophone. [en ligne]. 24 septembre 2019. +[Consulté le 29 mars 2023]. Disponible à l'adresse: https://zotero.hypotheses.org/762 +
+
+LEHMAN, Philipp, KIME, Philip et WEMHEUER, Moritz, 2023. The +biblatex package: programmable bibliographies and citations. +[en ligne]. 5 mars 2023. Disponible à l'adresse: https://ctan.org/pkg/biblatexVersion +3.19 +
+
+Overleaf documentation, [sans date]. [en ligne]. +[Consulté le 29 mars 2023]. Disponible à l'adresse: https://www.overleaf.com/learn +
+
+PATASHNIK, Oren, 1988. Bibtexing. [en ligne]. 8 février 1988. +[Consulté le 28 mars 2023]. Disponible à l'adresse: https://ctan.org/pkg/bibtexVersion +0.99b +
+
+POULAIN, Nicolas mathématicien, 2020. LaTeX pour les +enseignants. Paris: Ellipses. Références sciences. +ISBN 978-2-340-03671-0. +
+
+REES, Clea F., 2017. BibLaTeX/Biber « cheat +sheet ». [en ligne]. 24 juin 2017. +[Consulté le 23 mars 2023]. Disponible à l'adresse: https://ctan.org/pkg/biblatex-cheatsheet +
+
+ROUQUETTE, Maïeul, 2017. (Xe)LaTeX appliqué aux sciences humaines : +le seul livre sur LaTeX sans une seule équation ! Tampere: +Atramenta. ISBN 978-952-273-073-2. +
+
+TAILLET, Richard, 2022. Bien débuter en LaTeX. Louvain-la-Neue: +De Boeck Supérieur. Informatique. ISBN 978-2-8073-3989-7. +
+
+
+
+
    +
  1. Voir le site https://www.latex-project.org/get/.↩︎

  2. +
  3. Voir le site https://tectonic-typesetting.github.io ou le site https://yihui.org/tinytex/.↩︎

  4. +
  5. Logiciel multiplatforme et libre, BibTeX et Biber natif. +https://www.jabref.org/↩︎

  6. +
  7. Logiciel multiplatforme et libre. https://www.zotero.org/↩︎

  8. +
  9. Il est également possible d’exporter une bibliothèque au +format BibTeX depuis d’autres logiciels bibliographiques, notamment +EndNote. Pour cela, dans ce dernier, il faut aller dans les options de +styles Tools / Output Styles / Open Style Manager et cocher le +style BibTeX Export. Une fois cela fait, il faut cliquer sur +File Export, sélectionner le style BibTeX Export et +sauvegarder le fichier au format .bib.↩︎

  10. +
  11. Voir https://tectonic-typesetting.github.io. L’intérêt de +tectonic est qu’il s’occupe de télécharger à la volée des +logiciels nécessaires en fonction de ce qui est indiqué dans le +préambule, ce qui évite d’installer une distribution de LaTeX +volumineuse. À l’exception de Biber qui doit être installé sur le +système.↩︎

  12. +
+
+ + diff --git a/sources/polycopié/polycopié.md b/sources/polycopié/polycopié.md index db35664..4bb9ccd 100644 --- a/sources/polycopié/polycopié.md +++ b/sources/polycopié/polycopié.md @@ -1,13 +1,13 @@ --- title: "Citer ses références et créer une bibliographie avec LaTeX et Zotero" -date: 2024-02-29 -creation_date: 2023-03-24T08:25:47+01:00 +date: Automne 2024 +creation_date: 2023-03-24T08:25:47+0100 id: 20230324082557 logo: - ../medias/latex-logo.svg - ../medias/zotero-logo.svg lang: fr -bibliography: references-support.bib +bibliography: references.json csl: heg-iso-690.csl nocite: '@*' link-citations: true @@ -20,47 +20,50 @@ Au terme de cet atelier, vous serez en mesure de : - Comprendre ce qu'est un fichier `.bib`. - Connaître la structure d'une référence. - Créer ou de générer un fichier `.bib`. -- Charger les paquets nécessaires dans leur fichier `.tex` et utiliser les - outils de composition pour générer le document final. -- Utiliser les commandes LaTeX pour : - - Définir leur le style de citation et de bibliographie. +- Charger les paquets nécessaires dans le préambule pour configurer BibLaTeX. +- Utiliser les commandes BibLaTeX pour : + - Définir le style de citation et de bibliographie. - Insérer une citation et un appel de citation. - - Créer une bibliographie. + - Insérer une bibliographie. +- Compiler le document final. -  +:::{#licence} +![Logo de la licence CC BY-SA 4.0][1] \ +[CC BY-SA 4.0][2] --- [Sources][3] +::: -![Logo de la licence CC BY-SA 4.0](../medias/by-sa.png) \ -Ce document est sous licence [*CC BY-SA 4.0*][cc-by-sa]. \ -Les sources sont sur . + -[cc-by-sa]: https://creativecommons.org/licenses/by-sa/4.0/deed.fr "Texte de la licence en français" +[1]: ./static/by-sa.svg +[2]: https://creativecommons.org/licenses/by-sa/4.0/deed.fr "Texte de la licence en français" +[3]: https://git.milhit.ch/igor/biblatex-zotero "Projet git du document" -\newpage - -## Principes généraux +## Principes généraux {#first-section} > « Dans LaTeX il faut distinguer le langage de balisage, le système de -> composition et la *distribution*. » @fauchieFabriquesPublicationLaTeX2020 +> composition et la *distribution*. » [@fauchieFabriquesPublicationLaTeX2020] Pour générer des documents avec LaTeX, il faut : -- Rédiger un document dans un fichier `.tex` à l'aide du langage de balisage, +- Rédiger un document dans un fichier `.tex` à l'aide du *langage de balisage*, afin de le structurer. -- Compiler ce fichier avec un système (ou moteur) de composition, par exemple +- Compiler ce fichier avec un *système (ou moteur) de composition*, par exemple LaTeX, PdfLaTeX ou XeLaTeX. Pour disposer d'un tel système de composition, le plus souvent on installe un -environnement ou une distribution LaTeX, par exemple TeX Live pour Linux, -MacTex pour Mac OS ou MiKTeX pour Windows.[^0] De plus en plus souvent, -toutefois, afin de faciliter le travail en collaboration ou pour s'éviter une -installation parfois laborieuse, des services en ligne sont préférés, comme +*environnement ou une distribution* LaTeX, par exemple TeX Live pour Linux, +MacTex pour Mac OS ou MiKTeX pour Windows[^0]. Il est aussi possible +d'installer des distributions plus minimales, comme `tectonic` ou TinyTeX[^6]. + +Afin de faciliter la collaboration ou pour s'éviter une installation parfois +laborieuse, des services en ligne sont préférés, comme . -Enfin, un éditeur de texte est nécessaire pour travailler sur les sources (le -ou les fichiers `.tex`). N'importe quel éditeur suffit, mais des aides comme la -coloration syntaxique, la complétion des commandes ou la gestion de la +Enfin, un éditeur est nécessaire pour travailler sur les sources (le ou les +fichiers `.tex`). N'importe quel éditeur de texte suffit, mais des aides comme +la coloration syntaxique, la complétion des commandes ou la gestion de la compilation autrement que dans une console sont très utiles. Parmi une liste -impressionnante, les éditeurs suivants peuvent être mentionnés : +plutôt riche, les éditeurs suivants peuvent être mentionnés : - Texmaker, libre, multiplatforme, . - TeXworks, libre, multiplatforme, . @@ -74,17 +77,22 @@ d'un fichier dont l'extension est `.bib`, ce qui correspond : - soit à la structure BibTeX, - soit à la structure Biber pour BibLaTeX. -Ce fichier `.bib` se place le plus souvent dans le même dossier -que le document `.tex` de travail. +Ce fichier `.bib` se place le plus souvent dans le même dossier que le document +`.tex` de travail, mais il est possible de le placer n'importe où et de +préciser le chemin où il se trouve. + + [^0]: Voir le site . +[^6]: Voir le site ou + le site . ### BibTeX VS BibLaTeX BibTex est le logiciel historique pour la gestion des références et des -bibliographies dans un document `.tex`. Il est aussi le plus répandu dans les -exigences des éditeurs scientifiques. Pourtant, ce logiciel n'est plus -développé depuis de nombreuses décennies et n'offre pas facilement les +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 fonctionnalités auxquelles nous pouvons nous attendre actuellement. Aussi Biber (et BibLaTeX) est fortement conseillé et c'est pourquoi il n'est @@ -135,6 +143,8 @@ de gestion de références bibliographiques, comme JabRef[^1] ou Zotero[^2]. L'intérêt de ces logiciels est d'éviter les erreurs et d'automatiser en partie l'ajout de références dans sa base de données. + + [^1]: Logiciel multiplatforme et libre, BibTeX et Biber natif. [^2]: Logiciel multiplatforme et libre. @@ -233,14 +243,14 @@ donc lui préciser lequel on utilise : Lorsque l'on compile avec des références bibliographiques, il est nécessaire de le faire quatre fois : -1. LaTeX. +1. XeLaTeX. 1. Biber. -1. LaTeX. -1. LaTeX. +1. XeLaTeX. +1. XeLaTeX. 1. Afficher le PDF. Heureusement Texmaker permet de configure une *Compilation rapide* qui lance -tout seul ces quatre itération : +automatiquement ces quatre itérations : 1. Menu Options. 1. Configurer Texmaker. @@ -255,14 +265,15 @@ Pour cela, il faut choisir l'option *Utilisateur* et utiliser l'assistant. Puis, dans l'assistant, sélectionner les commandes à ajouter, une à une, dans l'ordre. -![Ajout des commandes](../medias/compil-rapide-liste.png) +![Ajout des commandes dans l'assistant](../medias/compil-rapide-liste.png) -Les outils comme Overleaf ou `tectonic`[^5] prennent eux-mêmes en charge ce -genre de complexité. +Les services web comme Overleaf ou les outils comme `tectonic`[^5] prennent +eux-mêmes en charge ce genre de complexité. -[^5]: Voir . L'intérêt de cet outil est -qu'il s'occupe de télécharger à la volée des logiciels nécessaires en fonction -de ce qui est indiqué dans le préambule. À l'exception de Biber qui doit être +[^5]: Voir . L'intérêt de `tectonic` +est qu'il s'occupe de télécharger à la volée des logiciels nécessaires en +fonction de ce qui est indiqué dans le préambule, ce qui évite d'installer une +distribution de LaTeX volumineuse. À l'exception de Biber qui doit être installé sur le système. ## Utilisation de BibLaTeX diff --git a/sources/polycopié/references-support.bib b/sources/polycopié/references-support.bib deleted file mode 100644 index 95075f6..0000000 --- a/sources/polycopié/references-support.bib +++ /dev/null @@ -1,150 +0,0 @@ -@online{BibliographyLaTeXBibtex2021, - title = {Bibliography in {{LaTeX}} with {{Bibtex}}/{{Biblatex}}}, - date = {2021-07-19}, - url = {https://latex-tutorial.com/tutorials/bibtex/}, - urldate = {2023-03-23}, - abstract = {Learn how to create a bibliography with Bibtex and Biblatex in a few simple steps. Create references / citations and autogenerate footnotes. Creating a .bib file Using BibTeX Autogenerate footnotes}, - langid = {english}, - organization = {{LaTeX-Tutorial.com}}, - keywords = {BibLaTeX,bibliographie,BibTeX,citation,LaTeX,non lu,publication numérique,Publication scientifique,référence,tutoriel}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\DSVLP28T\\bibtex.html} -} - -@online{CTANTopicBibLaTeX, - title = {{{CTAN}}: {{Topic BibLaTeX}}}, - url = {https://ctan.org/topic/biblatex}, - urldate = {2023-03-29}, - organization = {{CTAN: Comprehensive TeX Archive Network}}, - keywords = {non lu}, - note = {Liste de paquets pour BibLaTeX.}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\PXFRRUVX\\biblatex.html} -} - -@online{fauchieFabriquesPublicationLaTeX2020, - title = {Fabriques de publication : LaTeX}, - shorttitle = {Fabriques de publication}, - author = {Fauchié, Antoine}, - date = {2020-04-29}, - url = {https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/}, - urldate = {2023-03-23}, - langid = {french}, - organization = {{quaternum.net}}, - keywords = {LaTeX,non lu,publication numérique,Publication scientifique}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\JWPGF6XM\\fabriques-de-publication-latex.html} -} - -@online{grolimundZoteroLaTeX2019, - type = {Billet}, - title = {Zotero et LaTeX}, - author = {Grolimund, Raphaël}, - date = {2019-09-24}, - url = {https://zotero.hypotheses.org/762}, - urldate = {2023-03-29}, - abstract = {La rédaction du blog Zotero francophone est très heureuse d’accueillir un billet invité de Raphaël Grolimund sur un sujet qui nous tient à cœur et pour lequel nous apprécions particulièrement son expertise, l’interaction entre...}, - langid = {french}, - organization = {{Le blog Zotero francophone}}, - keywords = {non lu}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\QLMY2JC7\\762.html} -} - -@online{LaTeXBibliographiesBiblatex2022, - title = {{{LaTeX}}/{{Bibliographies}} with Biblatex and Biber}, - date = {2022-10-18}, - url = {https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber}, - urldate = {2023-03-29}, - abstract = {Learn how to create a bibliography using modern biblatex and biber - A short tutorial.}, - langid = {english}, - organization = {{Wikibooks, open books for an open world}}, - keywords = {non lu}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\DYNEELWA\\Bibliographies_with_biblatex_and_biber.html} -} - -@misc{lehmanBiblatexPackageProgrammable2023, - title = {The Biblatex Package: Programmable Bibliographies and Citations}, - author = {Lehman, Philipp and Kime, Philip and Wemheuer, Moritz}, - date = {2023-03-05}, - url = {https://ctan.org/pkg/biblatex}, - langid = {english}, - annotation = {Version 3.19}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\HAQD6ZK6\\Lehman et al. - The biblatex Package.pdf} -} - -@online{OverleafDocumentation, - title = {Overleaf Documentation}, - url = {https://www.overleaf.com/learn}, - urldate = {2023-03-29}, - abstract = {An online LaTeX editor that’s easy to use. No installation, real-time collaboration, version control, hundreds of LaTeX templates, and more.}, - langid = {english}, - keywords = {non lu}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\XRCVQHKC\\learn.html} -} - -@misc{patashnikBibtexing1988, - title = {Bibtexing}, - author = {Patashnik, Oren}, - date = {1988-02-08}, - url = {https://ctan.org/pkg/bibtex}, - urldate = {2023-03-28}, - langid = {english}, - keywords = {non lu}, - annotation = {Version 0.99b}, - note = {Documentation officielle de BibTex}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\SXI58BAA\\btxdoc.pdf} -} - -@book{poulainLaTeXPourEnseignants2020, - title = {LaTeX pour les enseignants}, - author = {family=Poulain, given=Nicolas, prefix=mathématicien, useprefix=false}, - date = {2020}, - series = {Références sciences}, - publisher = {{Ellipses}}, - location = {{Paris}}, - abstract = {La 4e de couverture indique : "Ce livre a été conçu pour répondre aux questions fréquentes des débutants ainsi que pour servir d'aide aux utilisateurs plus expérimentés. L'accent est mis sur des exemples pratiques qui sont pour la plupart issus de situations concrètes dans l'enseignement. Le code de chacun d'eux (plus de 400) est téléchargeable, et les exemples les plus complets sont modifiables et compilables en ligne avec LaTeX, PdfLaTeX ou XeLaTeX. Les deux premiers chapitres décrivent en détail comment bénéficier d'un environnement de travail et comment compiler ses premiers documents. Toutes les personnalisations sont possibles et les outils pour les mettre en oeuvre sont décrits, objectif par objectif, dans un chapitre consacré à la mise en page. L'organisation particulière d'un document de grande taille comme un livre ou une thèse fait l'objet d'un traitement à part entière, tout comme la question des présentations à projeter avec Beamer. La part consacrée aux mathématiques est évidemment importante. L'écriture de formules ou la création de tableaux de variations sont présentées en détail, ainsi qu'avec PSTricks et TikZ, le tracé de figures géométriques, de courbes ou de graphes. Les sciences physiques, la chimie et l'informatique sont aussi abordées via l'étude de packages officiels qui étendent les possibilités de LaTeX et simplifient l'écriture pour les besoins particuliers dans ces domaines."}, - isbn = {978-2-340-03671-0}, - langid = {fre}, - pagetotal = {226}, - keywords = {à lire,enseignement,LaTeX,non lu,publication numérique} -} - -@misc{reesBibLaTeXBiberCheat2017, - title = {{{BibLaTeX}}/{{Biber}} ‘Cheat Sheet’}, - author = {Rees, Clea F.}, - date = {2017-06-24}, - url = {https://ctan.org/pkg/biblatex-cheatsheet}, - urldate = {2023-03-23}, - langid = {english}, - keywords = {BibLaTeX,bibliographie,cheat sheet,citation,LaTeX,non lu,référence}, - file = {C\:\\Users\\milhit\\Zotero\\storage\\QMZI3AFF\\Rees_2017_BibLaTeX-Biber ‘cheat sheet’.pdf} -} - -@book{rouquetteXeLaTeXApplique2017, - title = {(Xe)LaTeX appliqué aux sciences humaines\,: le seul livre sur LaTeX sans une seule équation\,!}, - shorttitle = {(Xe)LaTeX appliqué aux sciences humaines}, - author = {Rouquette, Maïeul}, - date = {2017}, - publisher = {{Atramenta}}, - location = {{Tampere}}, - abstract = {Pendant longtemps LaTeX n'a été utilisé que dans le domaine des sciences dites «exactes». Pourtant depuis peu les sciences humaines peuvent utiliser efficacement ce formidable outil de composition de textes. Malheureusement, la plupart des introductions à LaTeX abordent peu les outils utiles aux humanités. Ce livre est donc le premier manuel francophone d'introduction à l'usage de LaTeX en sciences humaines. Obtenir une typographie de haute qualité, gérer une bibliographie prolifique, proposer des éditions critiques de textes et des traductions en parallèle : telles sont les nombreuses raisons qui devraient pousser ces spécialistes de l'écriture que sont les étudiants et chercheurs en humanités à se tourner vers LaTeX. Telles sont les causes qui ont poussé à la rédaction de ce livre, qui accompagnera --- nous l'espérons --- les humanistes depuis la découverte de LaTeX, dans sa variante XeLaTeX, jusqu'à la personnalisation de l'apparence des textes, en passant par la gestion d'une bibliographie nombreuse sans oublier les éditions critiques de textes et toutes ces petites choses qui font les difficultés et le charme de l'écriture en sciences humaines… D'autres motifs pousseront le lecteur à l'améliorer un jour, car en se partageant le savoir ne se divise pas : il se multiplie. On trouvera les sources sur https://github.com/maieul/latexhumain/tags (version sep\_2012).}, - editora = {Chabannes, Brendan}, - editoratype = {collaborator}, - isbn = {978-952-273-073-2}, - langid = {fre}, - pagetotal = {268}, - keywords = {LaTeX,non lu,publication numérique,Publication scientifique,Sciences humaines}, - note = {Billet de blog de l'auteur présentant le livre : -\par -http://geekographie.maieul.net/Xe-LaTeX-applique-aux-sciences} -} - -@book{tailletBienDebuterLaTeX2022, - title = {Bien débuter en LaTeX}, - author = {Taillet, Richard}, - date = {2022}, - series = {Informatique}, - publisher = {{De Boeck Supérieur}}, - location = {{Louvain-la-Neue}}, - abstract = {Ce livre vous permet de bien débuter en LaTeX, malgré l'aspect complexe de ce logiciel, avec une présentation très progressive et méthodique. LaTeX est un traitement de texte universellement utilisé dans l’édition scientifique, que ce soit par des étudiants, des enseignants ou bien des ingénieurs. Il peut sembler plus difficile à aborder que d’autres traitements de texte, mêlant des balises et une très légère dose de programmation. Ce livre propose une présentation progressive de LaTeX : les notions fondamentales (mise en forme du texte, numérotation automatique, équations mathématiques, figures, tables, références bibliographiques, index, commandes personnalisées, etc) sont abordées de façon actuelle, en tenant compte des évolutions récentes de LaTeX ; de nombreux exemples simples viennent illustrer le texte ; de nombreux exercices permettent de s'entrainer. - éditeur}, - isbn = {978-2-8073-3989-7}, - langid = {fre}, - keywords = {à lire,Édition scientifique,LaTeX,non lu,publication numérique,Publication scientifique} -} diff --git a/sources/polycopié/references.json b/sources/polycopié/references.json new file mode 100644 index 0000000..8d44e1f --- /dev/null +++ b/sources/polycopié/references.json @@ -0,0 +1,13 @@ +[ + {"id":"BibliographyLaTeXBibtex2021","abstract":"Learn how to create a bibliography with Bibtex and Biblatex in a few simple steps. Create references / citations and autogenerate footnotes. Creating a .bib file Using BibTeX Autogenerate footnotes","accessed":{"date-parts":[["2023",3,23]]},"citation-key":"BibliographyLaTeXBibtex2021","container-title":"LaTeX-Tutorial.com","issued":{"date-parts":[["2021",7,19]]},"language":"eng","title":"Bibliography in LaTeX with Bibtex/Biblatex","type":"post-weblog","URL":"https://latex-tutorial.com/tutorials/bibtex/"}, + {"id":"CTANTopicBibLaTeX","accessed":{"date-parts":[["2023",3,29]]},"citation-key":"CTANTopicBibLaTeX","container-title":"CTAN: Comprehensive TeX Archive Network","title":"CTAN: Topic BibLaTeX","type":"webpage","URL":"https://ctan.org/topic/biblatex"}, + {"id":"fauchieFabriquesPublicationLaTeX2020","accessed":{"date-parts":[["2023",3,23]]},"author":[{"family":"Fauchié","given":"Antoine"}],"citation-key":"fauchieFabriquesPublicationLaTeX2020","container-title":"quaternum.net","issued":{"date-parts":[["2020",4,29]]},"language":"French","title":"Fabriques de publication : LaTeX","title-short":"Fabriques de publication","type":"post-weblog","URL":"https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/"}, + {"id":"grolimundZoteroLaTeX2019","abstract":"La rédaction du blog Zotero francophone est très heureuse d’accueillir un billet invité de Raphaël Grolimund sur un sujet qui nous tient à cœur et pour lequel nous apprécions particulièrement son expertise, l’interaction entre...","accessed":{"date-parts":[["2023",3,29]]},"author":[{"family":"Grolimund","given":"Raphaël"}],"citation-key":"grolimundZoteroLaTeX2019","container-title":"Le blog Zotero francophone","genre":"Billet","issued":{"date-parts":[["2019",9,24]]},"language":"fr","title":"Zotero et LaTeX","type":"post-weblog","URL":"https://zotero.hypotheses.org/762"}, + {"id":"lehmanBiblatexPackageProgrammable2023","author":[{"family":"Lehman","given":"Philipp"},{"family":"Kime","given":"Philip"},{"family":"Wemheuer","given":"Moritz"}],"citation-key":"lehmanBiblatexPackageProgrammable2023","issued":{"date-parts":[["2023",3,5]]},"language":"eng","note":"Version 3.19","source":"Zotero","title":"The biblatex package: programmable bibliographies and citations","type":"document","URL":"https://ctan.org/pkg/biblatex"}, + {"id":"OverleafDocumentation","abstract":"An online LaTeX editor that’s easy to use. No installation, real-time collaboration, version control, hundreds of LaTeX templates, and more.","accessed":{"date-parts":[["2023",3,29]]},"citation-key":"OverleafDocumentation","language":"en","title":"Overleaf documentation","type":"webpage","URL":"https://www.overleaf.com/learn"}, + {"id":"patashnikBibtexing1988","accessed":{"date-parts":[["2023",3,28]]},"author":[{"family":"Patashnik","given":"Oren"}],"citation-key":"patashnikBibtexing1988","issued":{"date-parts":[["1988",2,8]]},"language":"eng","note":"Version 0.99b","title":"Bibtexing","type":"document","URL":"https://ctan.org/pkg/bibtex"}, + {"id":"poulainLaTeXPourEnseignants2020","abstract":"La 4e de couverture indique : \"Ce livre a été conçu pour répondre aux questions fréquentes des débutants ainsi que pour servir d'aide aux utilisateurs plus expérimentés. L'accent est mis sur des exemples pratiques qui sont pour la plupart issus de situations concrètes dans l'enseignement. Le code de chacun d'eux (plus de 400) est téléchargeable, et les exemples les plus complets sont modifiables et compilables en ligne avec LaTeX, PdfLaTeX ou XeLaTeX. Les deux premiers chapitres décrivent en détail comment bénéficier d'un environnement de travail et comment compiler ses premiers documents. Toutes les personnalisations sont possibles et les outils pour les mettre en oeuvre sont décrits, objectif par objectif, dans un chapitre consacré à la mise en page. L'organisation particulière d'un document de grande taille comme un livre ou une thèse fait l'objet d'un traitement à part entière, tout comme la question des présentations à projeter avec Beamer. La part consacrée aux mathématiques est évidemment importante. L'écriture de formules ou la création de tableaux de variations sont présentées en détail, ainsi qu'avec PSTricks et TikZ, le tracé de figures géométriques, de courbes ou de graphes. Les sciences physiques, la chimie et l'informatique sont aussi abordées via l'étude de packages officiels qui étendent les possibilités de LaTeX et simplifient l'écriture pour les besoins particuliers dans ces domaines.\"","author":[{"family":"Poulain","given":"Nicolas","dropping-particle":"mathématicien"}],"citation-key":"poulainLaTeXPourEnseignants2020","collection-title":"Références sciences","event-place":"Paris","ISBN":"978-2-340-03671-0","issued":{"date-parts":[["2020"]]},"language":"fre","number-of-pages":"226","publisher":"Ellipses","publisher-place":"Paris","title":"LaTeX pour les enseignants","type":"book"}, + {"id":"reesBibLaTeXBiberCheat2017","accessed":{"date-parts":[["2023",3,23]]},"author":[{"family":"Rees","given":"Clea F."}],"citation-key":"reesBibLaTeXBiberCheat2017","issued":{"date-parts":[["2017",6,24]]},"language":"eng","title":"BibLaTeX/Biber ‘cheat sheet’","type":"document","URL":"https://ctan.org/pkg/biblatex-cheatsheet"}, + {"id":"rouquetteXeLaTeXApplique2017","abstract":"Pendant longtemps LaTeX n'a été utilisé que dans le domaine des sciences dites «exactes».\n\nPourtant depuis peu les sciences humaines peuvent utiliser efficacement ce formidable outil de composition de textes.\n\nMalheureusement, la plupart des introductions à LaTeX abordent peu les outils utiles aux humanités. Ce livre est donc le premier manuel francophone d'introduction à l'usage de LaTeX en sciences humaines.\n\nObtenir une typographie de haute qualité, gérer une bibliographie prolifique, proposer des éditions critiques de textes et des traductions en parallèle : telles sont les nombreuses raisons qui devraient pousser ces spécialistes de l'écriture que sont les étudiants et chercheurs en humanités à se tourner vers LaTeX.\n\nTelles sont les causes qui ont poussé à la rédaction de ce livre, qui accompagnera --- nous l'espérons --- les humanistes depuis la découverte de LaTeX, dans sa variante XeLaTeX, jusqu'à la personnalisation de l'apparence des textes, en passant par la gestion d'une bibliographie nombreuse sans oublier les éditions critiques de textes et toutes ces petites choses qui font les difficultés et le charme de l'écriture en sciences humaines…\n\nD'autres motifs pousseront le lecteur à l'améliorer un jour, car en se partageant le savoir ne se divise pas : il se multiplie.\n\nOn trouvera les sources sur https://github.com/maieul/latexhumain/tags (version sep_2012).","author":[{"family":"Rouquette","given":"Maïeul"}],"citation-key":"rouquetteXeLaTeXApplique2017","contributor":[{"family":"Chabannes","given":"Brendan"}],"event-place":"Tampere","ISBN":"978-952-273-073-2","issued":{"date-parts":[["2017"]]},"language":"fre","number-of-pages":"268","publisher":"Atramenta","publisher-place":"Tampere","title":"(Xe)LaTeX appliqué aux sciences humaines : le seul livre sur LaTeX sans une seule équation !","title-short":"(Xe)LaTeX appliqué aux sciences humaines","type":"book"}, + {"id":"tailletBienDebuterLaTeX2022","abstract":"Ce livre vous permet de bien débuter en LaTeX, malgré l'aspect complexe de ce logiciel, avec une présentation très progressive et méthodique. LaTeX est un traitement de texte universellement utilisé dans l’édition scientifique, que ce soit par des étudiants, des enseignants ou bien des ingénieurs. Il peut sembler plus difficile à aborder que d’autres traitements de texte, mêlant des balises et une très légère dose de programmation. Ce livre propose une présentation progressive de LaTeX : les notions fondamentales (mise en forme du texte, numérotation automatique, équations mathématiques, figures, tables, références bibliographiques, index, commandes personnalisées, etc) sont abordées de façon actuelle, en tenant compte des évolutions récentes de LaTeX ; de nombreux exemples simples viennent illustrer le texte ; de nombreux exercices permettent de s'entrainer. - éditeur","author":[{"family":"Taillet","given":"Richard"}],"citation-key":"tailletBienDebuterLaTeX2022","collection-title":"Informatique","event-place":"Louvain-la-Neue","ISBN":"978-2-8073-3989-7","issued":{"date-parts":[["2022"]]},"language":"fre","publisher":"De Boeck Supérieur","publisher-place":"Louvain-la-Neue","source":"unige.swisscovery.slsp.ch","title":"Bien débuter en LaTeX","type":"book"} +] diff --git a/sources/polycopié/static/bibliotheque-logo.svg b/sources/polycopié/static/bibliotheque-logo.svg new file mode 100644 index 0000000..b33b2b1 --- /dev/null +++ b/sources/polycopié/static/bibliotheque-logo.svg @@ -0,0 +1,210 @@ + + + + diff --git a/sources/polycopié/static/by-sa.svg b/sources/polycopié/static/by-sa.svg new file mode 100644 index 0000000..f850297 --- /dev/null +++ b/sources/polycopié/static/by-sa.svg @@ -0,0 +1,199 @@ + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/sources/polycopié/style.css b/sources/polycopié/style.css new file mode 100644 index 0000000..3ccdce1 --- /dev/null +++ b/sources/polycopié/style.css @@ -0,0 +1,239 @@ +@media print { + + /* ************************** + * Définition des pages * + * ************************ */ + + @page { + size: A4; + margin: 25mm; + bleed: 6mm; + /* Numérotation de page au centre en bas + * de la page. Le compteur est définit + * dans le selecteur body. */ + @bottom-center { + content: counter(page); + } + } + @page:left { + margin-left: 25mm; + margin-right: 15mm; + } + @page:right { + margin-left: 15mm; + margin-right: 25mm; + } + @page:first { + /* Insertion en haut à droite du logo de la + * bibliothèque de l'UNIGE. */ + @top-right { + content: ""; + background-image: url("static/bibliotheque-logo.svg"); + background-position: right; + background-repeat: no-repeat; + background-size: 25%; + } + /* Place le bloc de la licence en bas à gauche + * de la première page. Voir le sélecteur + * #licence plus bas. */ + @bottom-left{ + content: element(licenceBlock); + font-size: small; + } + @bottom-center { + content: none; + } + /* Insert la date en bas à droite de la + * première page. Voir le sélecteur .date */ + @bottom-right { + content: string(date); + font-size: small; + } + } + + /* ************************** + * Définitions globales * + * ************************ */ + + body { + font-family: "Noto Sans", "Open Sans", + Arial, Helvetica, sans-serif; + /* Définit les trois variables de compteur nécessaires */ + counter-reset: figureNumber toc tableNumber; + } + /* Définit que string(date) contient la date indiquée dans le frontmatter + * de la source markdown */ + .date { + string-set: date content(text); + display: none; /* Pour ne pas afficher la date sous le titre. */ + } + /* Définit que running(licenceBlock) contient le block licence. + * Le bloc licence est décrit dans le fichier markdown source, au-dessous + * de la section des objectifs. Le CSS permet de le placer correctement */ + #licence { + position: running(licenceBlock); + } + + /* ***************** + * Page de titre * + * *************** */ + + .logo { + display: inline-flex; + justify-content: center; + width: 60%; + margin: 2em auto 1em auto; + } + .logo img { + max-width: 50%; + padding: .5em; + } + + #title-block-header { + /* Concerne le bloc titre sur la page de titre */ + text-align: center; + margin: 4em 0; + } + + .authors { + display: flex; + justify-content: center; + } + .author { + margin: 0; + padding: 0 1em; + } + + /* Les 4 règles suivantes mettent en forme la table des matières :* + * Suppression des liste à puce, numérotation des chapitres et affichage du + * numéro de page. */ + #TOC ul { + list-style: none; + counter-reset: toc; + padding-left: 1.5em; + } + #TOC li { + counter-increment: toc; + } + #TOC li::before { + content: counter(toc) ". "; + } + #TOC a::after { + content: target-counter(attr(href url), page); + position: absolute; + right: 0; + } + + /* *************************** + * Structure du document * + * ************************* */ + + /* Ajouter ou supprimer les ID de titre pour un saut de page. + * Les IDs #first-section et #bibliography peuvent être ajoutés + * dans la source markdown. */ + #first-section, + #bibliography, + .footnotes { + break-before: page; + } + + /* ************* + * Contenu * + * *********** */ + + h2 { + color: #d80669; + text-decoration: underline; + } + + pre { + background-color: #f2f1f1; + border: 2px solid #d80669; + border-radius: .5em; + padding: .5em 1em; + /* Évite que les blocs de code ne soient séparés sur 2 pages */ + break-inside: avoid; + } + pre > code { + border-radius: none; + padding: none; + } + code { + font-family: 'Lilex Nerd Font', 'Courier New', Courier, monospace; + font-size: 90%; + line-height: 1.4; + background-color: #f2f1f1; + padding: 2px; + border-radius: 5px; + } + + .footnotes::before { + content: "Notes"; + color: #d80669; + font-size: 120%; + font-weight: bold; + } + .footnote-ref { + text-decoration: none; + padding-left: 2px; + } + .footnote-back { + font-size: small; + text-decoration: none; + padding-left: .5em; + } + + figure { + display: flex; + flex-direction: column; + border: 2px solid #d80669; + border-radius: .5em; + padding: .5em; + /* Évite que les figures ne soient séparés sur 2 pages */ + break-inside: avoid; + } + figure img { + max-width: 85%; + margin: 0 auto; + } + figcaption { + text-align: center; + font-size: 90%; + counter-increment: figureNumber; + padding-top: .5em; + } + figcaption::before { + content: "Figure " counter(figureNumber) " : "; + } + + blockquote { + font-style: italic; + } + blockquote em { + font-style: normal; + } + + div.csl-entry { + padding: .5em; + } + + table { + width: 90%; + margin: 1em auto; + border-collapse: collapse; + } + + th, td { + padding: 5px; + border: 1px solid; + } + table > caption { + counter-increment: tableNumber; + caption-side: bottom; + font-size: small; + padding-top: .5em; + } + table > caption:before { + content: "Table " counter(tableNumber) " : "; + } +} diff --git a/sources/polycopié/template.html b/sources/polycopié/template.html index 77febbf..c89a254 100644 --- a/sources/polycopié/template.html +++ b/sources/polycopié/template.html @@ -1,9 +1,12 @@ - + - + $for(author-meta)$ $endfor$ @@ -69,7 +72,9 @@ $endif$ $endif$ $if(toc)$ $endif$