wip: restructure le projet
- Regroupe les fichiers sources dans un dossier. - Regroupe les images dans un dossier spécifique dans le répertoire des fichiers statiques. - Regroupe tous les autres fichiers statiques dans le bon dossier. - Adapte les sources, le template et le règles de styles en fonction. - Réécrit le Makefile pour le simplifier, le documenter et augmenter ses possibilités. - TODO: documente les modifications. - TODO: mets à jour les fichiers du template BUNIGE. Co-Authored-by: iGor milhit <igor@milhit.ch>
68
Makefile
|
|
@ -1,40 +1,46 @@
|
|||
input_files := \
|
||||
0-frontmatter.md \
|
||||
2-licence.md \
|
||||
3-definitions.md \
|
||||
4-syntaxe.md \
|
||||
5-editeurs.md \
|
||||
6-advanced.md \
|
||||
7-bibliographie.md \
|
||||
100-references.md \
|
||||
SOURCE_FOLDER := sources
|
||||
|
||||
pandoc := \
|
||||
pandoc -s --citeproc \
|
||||
--css=style.css --template=template.html \
|
||||
# Liste les fichiers sources.
|
||||
MD_UNSORTED := $(wildcard $(SOURCE_FOLDER)/*.md)
|
||||
# Ordonne les fichiers sources sur la base du début numérique du nom des
|
||||
# fichiers.
|
||||
MD_SORTED := $(shell printf '%s\n' $(MD_UNSORTED) | sort -t- -k1,1n)
|
||||
|
||||
# Construit le fichier HTML.
|
||||
.PHONY: html
|
||||
html: $(MD_SORTED)
|
||||
pandoc \
|
||||
--to=html --standalone \
|
||||
--template=static/template.html --css=static/style.css \
|
||||
-V static='./static' \
|
||||
--citeproc \
|
||||
--toc --toc-depth=2 \
|
||||
--out=document.html $(MD_SORTED)
|
||||
|
||||
pandoc_html := \
|
||||
$(pandoc) \
|
||||
--to=html --output=document.html \
|
||||
$(input_files)
|
||||
# Construit le fichier PDF.
|
||||
.PHONY: pdf
|
||||
pdf: $(MD_SORTED)
|
||||
pandoc \
|
||||
--to=pdf --pdf-engine=pagedjs-cli --embed-resources=true \
|
||||
--template=static/template.html --css=static/style.css \
|
||||
-V noscript=true -V static='./static' \
|
||||
--citeproc \
|
||||
--toc --toc-depth=2 \
|
||||
--out=document.pdf $(MD_SORTED)
|
||||
|
||||
pandoc_pdf := \
|
||||
$(pandoc) \
|
||||
-V noscript=true \
|
||||
--embed-resources=true --to=pdf \
|
||||
--pdf-engine=pagedjs-cli \
|
||||
--output=document.pdf \
|
||||
$(input_files)
|
||||
|
||||
html: $(input_files)
|
||||
$(pandoc_html)
|
||||
|
||||
watch_html: $(input_files)
|
||||
# Reconstruit le fichier HTML à la modification des autres fichiers.
|
||||
.PHONY: watch
|
||||
watch:
|
||||
watchexec -r -w . -i document.html \
|
||||
" $(pandoc_html)"
|
||||
-- make html
|
||||
|
||||
pdf: $(input_files)
|
||||
$(pandoc_pdf)
|
||||
# Supprime les fichiers construits lorsqu'ils ne sont plus nécessaire.
|
||||
.PHONY: clean
|
||||
clean:
|
||||
rm *.html
|
||||
rm *.pdf
|
||||
|
||||
# Lance un serveur web pour servir le HTML.
|
||||
.PHONY: serve
|
||||
serve:
|
||||
watchexec -r -w . "python -m http.server"
|
||||
|
|
|
|||
103
exemple.md
|
|
@ -1,103 +0,0 @@
|
|||
# Exemple de note
|
||||
|
||||
Pour écrire un paragraphe, il faut séparer deux blocs de texte par une ligne
|
||||
vide. Un simple retour à la ligne
|
||||
ne change rien.
|
||||
|
||||
Ici commence le paragraphe suivant. Dans celui-ci, on peut insérer *un texte en
|
||||
italique*, soit en entourant la partie en *italique* par des astérisques (`*`),
|
||||
soit au moyen _d'underscore_ (`_`).
|
||||
|
||||
Pour le gras, **on utilise un double astérisque**, ou __un double underscore__.
|
||||
|
||||
## Les titres
|
||||
|
||||
Comme en HTML, il y a 6 niveaux de titres disponibles. Pour indiquer qu'il
|
||||
s'agit d'un titre, il faut commencer la ligne par un `#`, et on multiplie les
|
||||
`#` pour indiquer les niveaux de titre de 1 (`#`) à 6 (`######`). Ce fichier
|
||||
d'exemple contient un titre de niveau 1 et des titres de niveau 2 et 3.
|
||||
|
||||
## Les listes
|
||||
|
||||
Pour générer une liste, on commence chaque ligne de la liste avec un tiret :
|
||||
|
||||
- Une liste
|
||||
- Simple et
|
||||
- Non ordonnée.
|
||||
|
||||
Pour une liste ordonnée, on commence chaque ligne par un chiffre suivit d'un
|
||||
point :
|
||||
|
||||
1. Une liste
|
||||
3. Simple mais
|
||||
9. Ordonnée.
|
||||
|
||||
L'ordre de la numérotation n'importe pas. Pour ne pas s'ennuyer à réordonner
|
||||
une liste qui peut évoluer, il y a une solution simple :
|
||||
|
||||
1. Pomme.
|
||||
1. Poire.
|
||||
1. Cerise.
|
||||
|
||||
Des listes imbriquées plus complexes peuvent être réalisées en ajoutant des
|
||||
espaces devant les lignes des sections inférieures :
|
||||
|
||||
1. Une liste
|
||||
1. Ordonnée et
|
||||
- Plus
|
||||
- Complexe
|
||||
1. Voilà.
|
||||
|
||||
## Les liens
|
||||
|
||||
### La méthode simple
|
||||
|
||||
Il y a plusieurs méthodes pour insérer un lien. La plus simple est de mettre le
|
||||
texte du lien entre crochets, suivi de la cible entre parenthèses :
|
||||
[site de l'UNIGE](https://unige.ch).
|
||||
|
||||
On peut vouloir ajouter un titre à ce lien, qui s'affiche lorsque le curseur
|
||||
survol le lien : [site de l'UNIGE](https://unige.ch "site officiel d'UNIGE").
|
||||
|
||||
### Avec les références
|
||||
|
||||
Une autre méthode existe qui a les avantages suivants :
|
||||
|
||||
- Une même référence (cible du lien) peut être réutilisée plusieurs fois dans
|
||||
le même texte.
|
||||
- La lisibilité du texte est améliorée.
|
||||
|
||||
Le texte du lien est toujours entre crochet, mais à la place de la cible entre
|
||||
parenthèse, on ajoute une référence entre crochet. Cette référence, qui peut
|
||||
être un chiffre, une lettre ou un texte, correspond à la cible, définie
|
||||
n'importe où dans le fichier.
|
||||
|
||||
Ce qui donne le lien suivant : [site de l'UNIGE][1].
|
||||
|
||||
## Images
|
||||
|
||||
Pour l'insertion d'une image, on reprend la même syntaxe que pour le lien, en
|
||||
ajoutant un point d'exclamation au début de la ligne :
|
||||
|
||||

|
||||
|
||||
Le lien pour l'image peut être une URL ou un chemin vers un fichier local. Et
|
||||
la syntaxe avec la référence est possible aussi :
|
||||
|
||||
![Légende de l'image][2]
|
||||
|
||||
## Les tableaux
|
||||
|
||||
Pour les tableaux, il est fortement conseillé d'utiliser un [générateur][3].
|
||||
|
||||
| No | Fruits | Quantité | Qualité |
|
||||
|----|-----------:|----------|:-------:|
|
||||
| 1 | Pommes | Un peu | 🙁 |
|
||||
| 2 | Poires | Plus | 😊 |
|
||||
| 3 | Framboises | Beaucoup | 😋 |
|
||||
|
||||
<!-- références -->
|
||||
|
||||
[1]: https://unige.ch "site officiel de l'UNIGE"
|
||||
[2]: ./static/logo-md.svg "logo de Markdown"
|
||||
[3]: https://www.tablesgenerator.com/markdown_tables
|
||||
692
heg-iso-690.csl
|
|
@ -1,692 +0,0 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="never">
|
||||
<info>
|
||||
<title>Haute école de gestion de Genève (ISO 690)</title>
|
||||
<title-short>HEG Genève (ISO 690)</title-short>
|
||||
<id>http://www.zotero.org/styles/haute-ecole-de-gestion-de-geneve-iso-690</id>
|
||||
<link href="http://www.zotero.org/styles/haute-ecole-de-gestion-de-geneve-iso-690" rel="self"/>
|
||||
<link href="http://www.zotero.org/styles/iso690-author-date-en" rel="template"/>
|
||||
<link href="https://www.hesge.ch/heg/campus/infotheque/citations-et-references-bibliographiques" rel="documentation"/>
|
||||
<author>
|
||||
<name>Raphael Grolimund</name>
|
||||
<email>grolimur@protonmail.ch</email>
|
||||
</author>
|
||||
<contributor>
|
||||
<name>Melissa Paez</name>
|
||||
<email>paez.melissa@gmail.com</email>
|
||||
</contributor>
|
||||
<category citation-format="author-date"/>
|
||||
<category field="generic-base"/>
|
||||
<updated>2023-10-24T10:00:00+00:00</updated>
|
||||
<rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
|
||||
</info>
|
||||
<locale xml:lang="fr-FR">
|
||||
<terms>
|
||||
<term name="no date">[sans date]</term>
|
||||
<term name="online">en ligne</term>
|
||||
<term name="retrieved">disponible</term>
|
||||
<term name="issue" form="short">
|
||||
<single>no</single>
|
||||
<multiple>nos</multiple>
|
||||
</term>
|
||||
<term name="page" form="short">
|
||||
<single>p.</single>
|
||||
<multiple>pp.</multiple>
|
||||
</term>
|
||||
<term name="number-of-pages" form="short">
|
||||
<single>p.</single>
|
||||
<multiple>pp.</multiple>
|
||||
</term>
|
||||
<!-- the 2 following terms, never used in any citation style published on https://zotero.org/styles, are hijacked to distinguish the diffrents dates (submitted, issued) of a patent -->
|
||||
<term name="special-issue">déposé le</term>
|
||||
<term name="special-section">publié le</term>
|
||||
</terms>
|
||||
</locale>
|
||||
<locale xml:lang="fr-CA">
|
||||
<terms>
|
||||
<term name="no date">[sans date]</term>
|
||||
<term name="online">en ligne</term>
|
||||
<term name="retrieved">disponible</term>
|
||||
<term name="issue" form="short">
|
||||
<single>no</single>
|
||||
<multiple>nos</multiple>
|
||||
</term>
|
||||
<term name="page" form="short">
|
||||
<single>p.</single>
|
||||
<multiple>pp.</multiple>
|
||||
</term>
|
||||
<term name="number-of-pages" form="short">
|
||||
<single>p.</single>
|
||||
<multiple>pp.</multiple>
|
||||
</term>
|
||||
<!-- the 2 following terms, never used in any citation style published on https://zotero.org/styles, are hijacked to distinguish the diffrents dates (submitted, issued) of a patent -->
|
||||
<term name="special-issue">déposé le</term>
|
||||
<term name="special-section">publié le</term>
|
||||
</terms>
|
||||
</locale>
|
||||
<locale xml:lang="en-US">
|
||||
<terms>
|
||||
<term name="issue">no.</term>
|
||||
<!-- the 2 following terms, never used in any citation style published on https://zotero.org/styles, are hijacked to distinguish the diffrents dates (submitted, issued) of a patent -->
|
||||
<term name="special-issue">submitted on</term>
|
||||
<term name="special-section">published on</term>
|
||||
</terms>
|
||||
</locale>
|
||||
<locale xml:lang="en-UK">
|
||||
<terms>
|
||||
<term name="issue">no.</term>
|
||||
<!-- the 2 following terms, never used in any citation style published on https://zotero.org/styles, are hijacked to distinguish the diffrents dates (submitted, issued) of a patent -->
|
||||
<term name="special-issue">submitted on</term>
|
||||
<term name="special-section">published on</term>
|
||||
</terms>
|
||||
</locale>
|
||||
<macro name="editor">
|
||||
<names variable="editor">
|
||||
<name and="text" name-as-sort-order="all" sort-separator=", " delimiter=", " delimiter-precedes-last="never">
|
||||
<name-part name="family" text-case="uppercase"/>
|
||||
</name>
|
||||
<label prefix=" (" form="short" suffix=".)"/>
|
||||
</names>
|
||||
</macro>
|
||||
<macro name="translator">
|
||||
<names variable="translator">
|
||||
<name and="text" name-as-sort-order="all" sort-separator=", " delimiter=", " delimiter-precedes-last="never">
|
||||
<name-part name="family" text-case="uppercase"/>
|
||||
</name>
|
||||
<label prefix=" (" form="short" suffix=".)"/>
|
||||
</names>
|
||||
</macro>
|
||||
<macro name="responsability">
|
||||
<names variable="author director">
|
||||
<name and="text" name-as-sort-order="all" sort-separator=", " delimiter=", " delimiter-precedes-last="never">
|
||||
<name-part name="family" text-case="uppercase"/>
|
||||
</name>
|
||||
<substitute>
|
||||
<text macro="editor"/>
|
||||
<text macro="translator"/>
|
||||
<text macro="title"/>
|
||||
</substitute>
|
||||
</names>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="year-date" prefix=", "/>
|
||||
</if>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="author-citation">
|
||||
<names variable="author director">
|
||||
<name form="short"/>
|
||||
<substitute>
|
||||
<names variable="editor"/>
|
||||
<names variable="translator"/>
|
||||
<text variable="title" font-style="italic"/>
|
||||
</substitute>
|
||||
</names>
|
||||
</macro>
|
||||
<macro name="container-author">
|
||||
<names variable="container-author">
|
||||
<name and="text" name-as-sort-order="all" sort-separator=", " delimiter=", " delimiter-precedes-last="never">
|
||||
<name-part name="family" text-case="uppercase"/>
|
||||
</name>
|
||||
</names>
|
||||
</macro>
|
||||
<macro name="container-responsability">
|
||||
<choose>
|
||||
<if variable="container-author">
|
||||
<text macro="container-author"/>
|
||||
</if>
|
||||
<else-if variable="editor">
|
||||
<text macro="editor"/>
|
||||
</else-if>
|
||||
<else>
|
||||
<text macro="translator"/>
|
||||
</else>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="year-date">
|
||||
<choose>
|
||||
<if is-uncertain-date="issued">
|
||||
<group prefix="[" suffix="]">
|
||||
<choose>
|
||||
<if variable="issued">
|
||||
<date variable="issued">
|
||||
<date-part name="year" form="long" suffix="?"/>
|
||||
</date>
|
||||
</if>
|
||||
<else>
|
||||
<text term="no date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</group>
|
||||
</if>
|
||||
<else>
|
||||
<choose>
|
||||
<if variable="issued">
|
||||
<date variable="issued">
|
||||
<date-part name="year" form="long"/>
|
||||
</date>
|
||||
</if>
|
||||
</choose>
|
||||
</else>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="title">
|
||||
<choose>
|
||||
<if type="book thesis map motion_picture song manuscript speech" match="any">
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text variable="title" font-style="italic"/>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="title" font-style="italic" suffix=", "/>
|
||||
<text macro="year-date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</if>
|
||||
<else-if type="software">
|
||||
<text variable="title" font-style="italic"/>
|
||||
<text term="software" prefix=" [" suffix="]"/>
|
||||
</else-if>
|
||||
<else-if type="paper-conference chapter article-journal article-magazine article-newspaper entry entry-dictionary entry-encyclopedia post-weblog post webpage broadcast" match="any">
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text variable="title" suffix=". "/>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="title" suffix=", "/>
|
||||
<text macro="year-date"/>
|
||||
</else>
|
||||
</choose>
|
||||
<choose>
|
||||
<if type="chapter paper-conference" match="any">
|
||||
<text term="in" text-case="capitalize-first" suffix=" : "/>
|
||||
</if>
|
||||
</choose>
|
||||
<choose>
|
||||
<if variable="container-author editor translator" match="any">
|
||||
<text macro="container-responsability"/>
|
||||
<choose>
|
||||
<if variable="container-title event" match="any">
|
||||
<text value=", "/>
|
||||
</if>
|
||||
</choose>
|
||||
</if>
|
||||
</choose>
|
||||
<choose>
|
||||
<if variable="container-title">
|
||||
<text variable="container-title" font-style="italic"/>
|
||||
<choose>
|
||||
<if type="chapter paper-conference" match="any">
|
||||
<group delimiter=" " prefix=", ">
|
||||
<label variable="page" form="short"/>
|
||||
<text variable="page"/>
|
||||
</group>
|
||||
</if>
|
||||
</choose>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="event" font-style="italic"/>
|
||||
</else>
|
||||
</choose>
|
||||
</else-if>
|
||||
<else-if type="report">
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text variable="title" font-style="italic"/>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="number" suffix=" : "/>
|
||||
<text variable="title" font-style="italic" suffix=", "/>
|
||||
<text macro="year-date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</else-if>
|
||||
<else-if type="patent">
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text variable="title" font-style="italic"/>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="title" suffix=", "/>
|
||||
<text macro="year-date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</else-if>
|
||||
<else>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text variable="title" font-style="italic"/>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="title" font-style="italic" suffix=", "/>
|
||||
<text macro="year-date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</else>
|
||||
</choose>
|
||||
<choose>
|
||||
<if variable="DOI version" match="none">
|
||||
<choose>
|
||||
<if variable="URL">
|
||||
<text term="online" prefix=" [" suffix="]"/>
|
||||
</if>
|
||||
<else>
|
||||
<choose>
|
||||
<if type="broadcast motion_picture song book chapter article-journal article-magazine article-newspaper patent" match="none">
|
||||
<text value=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
</else>
|
||||
</choose>
|
||||
</if>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="number">
|
||||
<text variable="authority" suffix=" "/>
|
||||
<text variable="number"/>
|
||||
</macro>
|
||||
<macro name="medium">
|
||||
<text variable="medium" prefix=" [" suffix="]"/>
|
||||
</macro>
|
||||
<macro name="legislation-number">
|
||||
<group delimiter=" ">
|
||||
<text variable="container-title"/>
|
||||
<text variable="volume"/>
|
||||
</group>
|
||||
</macro>
|
||||
<macro name="genre">
|
||||
<choose>
|
||||
<if type="map">
|
||||
<choose>
|
||||
<if variable="genre">
|
||||
<text variable="genre" prefix="[" suffix="]"/>
|
||||
</if>
|
||||
<else>
|
||||
<text value="map" prefix="[" suffix="]"/>
|
||||
</else>
|
||||
</choose>
|
||||
</if>
|
||||
<else>
|
||||
<text variable="genre" suffix=" "/>
|
||||
<text variable="number"/>
|
||||
</else>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="date">
|
||||
<choose>
|
||||
<if type="patent">
|
||||
<text term="patent" text-case="capitalize-first" suffix=" "/>
|
||||
<text term="special-issue" suffix=" "/>
|
||||
<date variable="submitted">
|
||||
<date-part name="day" suffix=" "/>
|
||||
<date-part name="month" suffix=" "/>
|
||||
<date-part name="year"/>
|
||||
</date>
|
||||
<text term="and" prefix=" " suffix=" "/>
|
||||
<text term="special-section" suffix=" "/>
|
||||
<date variable="issued">
|
||||
<date-part name="day" suffix=" "/>
|
||||
<date-part name="month" suffix=" "/>
|
||||
<date-part name="year"/>
|
||||
</date>
|
||||
</if>
|
||||
</choose>
|
||||
<choose>
|
||||
<if is-uncertain-date="issued">
|
||||
<group prefix="[" suffix="]">
|
||||
<choose>
|
||||
<if variable="issued">
|
||||
<date variable="issued">
|
||||
<date-part name="year" form="long" suffix="?"/>
|
||||
</date>
|
||||
</if>
|
||||
<else>
|
||||
<text term="no date"/>
|
||||
</else>
|
||||
</choose>
|
||||
</group>
|
||||
</if>
|
||||
<else>
|
||||
<choose>
|
||||
<if variable="issued">
|
||||
<date variable="issued">
|
||||
<date-part name="day" suffix=" "/>
|
||||
<date-part name="month" suffix=" "/>
|
||||
<date-part name="year"/>
|
||||
</date>
|
||||
</if>
|
||||
</choose>
|
||||
</else>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="edition">
|
||||
<text variable="edition" form="long"/>
|
||||
</macro>
|
||||
<macro name="publisher-group">
|
||||
<choose>
|
||||
<if type="speech" match="any">
|
||||
<group delimiter=", ">
|
||||
<text variable="event"/>
|
||||
<text variable="publisher-place"/>
|
||||
</group>
|
||||
</if>
|
||||
<else>
|
||||
<group delimiter=" : ">
|
||||
<text variable="publisher-place"/>
|
||||
<text variable="publisher"/>
|
||||
</group>
|
||||
</else>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="issue">
|
||||
<group delimiter=", ">
|
||||
<text variable="volume" prefix="Vol. "/>
|
||||
<choose>
|
||||
<if variable="volume">
|
||||
<group delimiter=" ">
|
||||
<text term="issue" form="short"/>
|
||||
<text variable="issue"/>
|
||||
</group>
|
||||
<group delimiter=" ">
|
||||
<label variable="page" form="short"/>
|
||||
<text variable="page"/>
|
||||
</group>
|
||||
</if>
|
||||
<else-if variable="issue">
|
||||
<group delimiter=" ">
|
||||
<text term="issue" form="short" text-case="capitalize-first"/>
|
||||
<text variable="issue"/>
|
||||
</group>
|
||||
<group delimiter=" ">
|
||||
<label variable="page" form="short"/>
|
||||
<text variable="page"/>
|
||||
</group>
|
||||
</else-if>
|
||||
<else>
|
||||
<group delimiter=" ">
|
||||
<label variable="page" form="short"/>
|
||||
<text variable="page"/>
|
||||
</group>
|
||||
</else>
|
||||
</choose>
|
||||
</group>
|
||||
</macro>
|
||||
<macro name="accessed">
|
||||
<choose>
|
||||
<if variable="DOI" match="none">
|
||||
<choose>
|
||||
<if variable="URL">
|
||||
<group prefix=" [" suffix="]">
|
||||
<text term="accessed"/>
|
||||
<date variable="accessed">
|
||||
<date-part name="day" prefix=" "/>
|
||||
<date-part name="month" prefix=" "/>
|
||||
<date-part name="year" prefix=" "/>
|
||||
</date>
|
||||
</group>
|
||||
</if>
|
||||
</choose>
|
||||
</if>
|
||||
</choose>
|
||||
</macro>
|
||||
<macro name="collection">
|
||||
<group delimiter=", ">
|
||||
<text variable="collection-title"/>
|
||||
<text variable="collection-number"/>
|
||||
</group>
|
||||
</macro>
|
||||
<macro name="page">
|
||||
<text variable="number-of-pages" suffix=" p"/>
|
||||
</macro>
|
||||
<macro name="isbn">
|
||||
<text variable="ISBN" prefix="ISBN "/>
|
||||
</macro>
|
||||
<macro name="doi">
|
||||
<text variable="DOI" prefix="DOI "/>
|
||||
</macro>
|
||||
<macro name="url">
|
||||
<choose>
|
||||
<if variable="DOI" match="none">
|
||||
<choose>
|
||||
<if variable="URL">
|
||||
<group>
|
||||
<text term="retrieved" suffix=" " text-case="capitalize-first"/>
|
||||
<text term="from" suffix=" : "/>
|
||||
<text variable="URL"/>
|
||||
</group>
|
||||
</if>
|
||||
</choose>
|
||||
</if>
|
||||
</choose>
|
||||
</macro>
|
||||
<citation et-al-min="4" et-al-use-first="1" disambiguate-add-year-suffix="true" disambiguate-add-names="true" disambiguate-add-givenname="true" collapse="year" year-suffix-delimiter=", " after-collapse-delimiter="; ">
|
||||
<layout prefix="(" suffix=")" delimiter="; ">
|
||||
<group delimiter=", ">
|
||||
<group delimiter=" ">
|
||||
<text macro="author-citation"/>
|
||||
<text macro="year-date"/>
|
||||
</group>
|
||||
<group>
|
||||
<label variable="locator" suffix=". " form="short" strip-periods="true"/>
|
||||
<text variable="locator"/>
|
||||
</group>
|
||||
</group>
|
||||
</layout>
|
||||
</citation>
|
||||
<bibliography et-al-min="4" et-al-use-first="1">
|
||||
<sort>
|
||||
<key macro="responsability"/>
|
||||
<key macro="year-date"/>
|
||||
</sort>
|
||||
<layout>
|
||||
<choose>
|
||||
<if type="book map" match="any">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="isbn" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</if>
|
||||
<else-if type="article-journal article-magazine" match="any">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="issue" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="article-newspaper">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=", "/>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="page" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="chapter entry entry-dictionary entry-encyclopedia" match="any">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="isbn" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="speech">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="page" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="paper-conference">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="page" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="isbn" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="thesis">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="post-weblog post webpage" match="any">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="broadcast motion_picture song" match="any">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="medium" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=", "/>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="isbn" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="report">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="manuscript">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="patent">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="url" suffix=". "/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
<text macro="number" suffix=". "/>
|
||||
</else-if>
|
||||
<else-if type="software">
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text variable="version" prefix="Version " suffix=". "/>
|
||||
<text macro="date" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else-if>
|
||||
<else>
|
||||
<text macro="responsability" suffix=". "/>
|
||||
<choose>
|
||||
<if variable="author editor translator director" match="any">
|
||||
<text macro="title" suffix=". "/>
|
||||
</if>
|
||||
</choose>
|
||||
<text macro="medium" suffix=". "/>
|
||||
<text macro="genre" suffix=". "/>
|
||||
<text variable="authority" suffix=". "/>
|
||||
<text macro="edition" suffix=". "/>
|
||||
<text macro="publisher-group" suffix=". "/>
|
||||
<text macro="number" suffix=". "/>
|
||||
<text macro="legislation-number" suffix=". "/>
|
||||
<text macro="collection" suffix=". "/>
|
||||
<text macro="page" suffix=". "/>
|
||||
<text macro="isbn" suffix=". "/>
|
||||
<text macro="doi" suffix=". "/>
|
||||
<text macro="url"/>
|
||||
<text macro="accessed" suffix=". "/>
|
||||
</else>
|
||||
</choose>
|
||||
<text variable="note"/>
|
||||
</layout>
|
||||
</bibliography>
|
||||
</style>
|
||||
|
|
@ -2,15 +2,15 @@
|
|||
title: Introduction à la prise de note avec markdown
|
||||
author:
|
||||
- Igor Milhit^[Uni CMU]
|
||||
date: Printemps 2025
|
||||
date: Automne 2025
|
||||
creation_date: 2023-04-19T11:35:14+02:00
|
||||
id: 20230419113601
|
||||
tags: [note, markdown]
|
||||
tags: ["note", "markdown"]
|
||||
logo:
|
||||
- static/logo-md.svg
|
||||
- static/images/logo-md.svg
|
||||
lang: fr
|
||||
bibliography: references.json
|
||||
citation-style: heg-iso-690.csl
|
||||
bibliography: ./static/references.json
|
||||
citation-style: ./static/heg-iso-690.csl
|
||||
nocite: '@*'
|
||||
link-citations: true
|
||||
toc-title: Table des matières
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<!-- références -->
|
||||
|
||||
[1]: ./static/by-sa.svg
|
||||
[1]: ./static/images/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/rdv-info-markdown
|
||||
[4]: https://www.arthurperret.fr/cours/format-texte.html
|
||||
|
|
@ -9,12 +9,12 @@
|
|||
[7]: https://fr.wikipedia.org/wiki/Git "Article Wikipedia en français"
|
||||
[8]: #dedies
|
||||
[9]: #generalistes
|
||||
[10]: ./static/ghostwriter.png
|
||||
[11]: ./static/zettlr.png
|
||||
[12]: ./static/hackmd.png
|
||||
[13]: ./static/vscode.png
|
||||
[14]: ./static/lien-entre-fichiers.png
|
||||
[15]: ./static/recherche-vscode.png
|
||||
[10]: ./static/images/ghostwriter.png
|
||||
[11]: ./static/images/zettlr.png
|
||||
[12]: ./static/images/hackmd.png
|
||||
[13]: ./static/images/vscode.png
|
||||
[14]: ./static/images/lien-entre-fichiers.png
|
||||
[15]: ./static/images/recherche-vscode.png
|
||||
[16]: https://pandoc.org/MANUAL.html#citations
|
||||
[17]: https://zotero.org
|
||||
[18]: https://joplinapp.org/
|
||||
|
|
@ -1,10 +1,12 @@
|
|||
## Définition, avantages et inconvénients[^0] {#first-section}
|
||||
|
||||
:::{.exercise}
|
||||
::: {.warning}
|
||||
|
||||
Le plus important est de trouver des méthodes et des outils
|
||||
adaptés à *vos besoins*. Cette section liste des arguments pour l'usage de
|
||||
fichiers au format texte et de la syntaxe markdown, mais aucune méthode ou
|
||||
outil n'est *la* solution miracle pertinente dans *tous* les contextes.
|
||||
|
||||
:::
|
||||
|
||||
### Définition
|
||||
|
|
@ -60,8 +60,8 @@ est destiné à un usage académique, que ce soit pour construire une base de
|
|||
connaissance à partir de notes ou pour rédiger un travail de mémoire ou un
|
||||
article scientifique. Il intègre Zotero pour la gestion des références.
|
||||
|
||||
En ligne, on peut mentionner à nouveau le service [HackMD][2] ou le logiciel
|
||||
[HedgeDoc][1] qui permet non seulement d'éditer des fichiers markdown avec une
|
||||
En ligne, on peut mentionner à nouveau le service [HackMD][6] ou le logiciel
|
||||
[HedgeDoc][5] qui permet non seulement d'éditer des fichiers markdown avec une
|
||||
prévisualisation, mais également de le faire à plusieurs, de disposer d'un
|
||||
suivi des modifications et de commenter.
|
||||
|
||||
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
Before Width: | Height: | Size: 313 KiB After Width: | Height: | Size: 313 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 325 KiB After Width: | Height: | Size: 325 KiB |
|
Before Width: | Height: | Size: 76 KiB After Width: | Height: | Size: 76 KiB |
|
Before Width: | Height: | Size: 300 B After Width: | Height: | Size: 300 B |
|
Before Width: | Height: | Size: 213 KiB After Width: | Height: | Size: 213 KiB |
|
Before Width: | Height: | Size: 55 KiB After Width: | Height: | Size: 55 KiB |
|
Before Width: | Height: | Size: 74 KiB After Width: | Height: | Size: 74 KiB |
|
Before Width: | Height: | Size: 195 KiB After Width: | Height: | Size: 195 KiB |
|
Before Width: | Height: | Size: 154 KiB After Width: | Height: | Size: 154 KiB |
|
|
@ -28,7 +28,7 @@
|
|||
* bibliothèque de l'UNIGE. */
|
||||
@top-right {
|
||||
content: "";
|
||||
background-image: url("static/bibliotheque-logo.svg");
|
||||
background-image: url("images/bibliotheque-logo.svg");
|
||||
background-position: right;
|
||||
background-repeat: no-repeat;
|
||||
background-size: 25%;
|
||||
|
|
@ -85,7 +85,7 @@
|
|||
margin: 2em auto 1em auto;
|
||||
}
|
||||
.logo img {
|
||||
max-width: 50%;
|
||||
max-width: 25%;
|
||||
padding: .5em;
|
||||
}
|
||||
|
||||
|
|
@ -196,6 +196,7 @@
|
|||
figure img {
|
||||
max-width: 85%;
|
||||
margin: 0 auto;
|
||||
max-height: 35vh;
|
||||
}
|
||||
figcaption {
|
||||
text-align: center;
|
||||
|
|
@ -207,13 +208,28 @@
|
|||
content: "Figure " counter(figureNumber) " : ";
|
||||
}
|
||||
|
||||
.exercise {
|
||||
.exercise,
|
||||
.warning {
|
||||
background-color: #f2f1f1;
|
||||
width: 90%;
|
||||
margin: 0 auto;
|
||||
border: 2px solid #d80669;
|
||||
border-radius: .5em;
|
||||
padding: 0 .5em;
|
||||
padding: .5em;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.exercice > p,
|
||||
.warning > p {
|
||||
margin: 0;
|
||||
padding-left: .5em;
|
||||
}
|
||||
|
||||
.exercice::before,
|
||||
.warning::before {
|
||||
content: "⚠️";
|
||||
font-size: larger;
|
||||
}
|
||||
|
||||
blockquote {
|
||||
|
|
@ -31,9 +31,9 @@ $endfor$
|
|||
when they are unnecessary. -->
|
||||
$if(noscript)$
|
||||
$else$
|
||||
<link href="/interface.css" rel="stylesheet" type="text/css" />
|
||||
<script src="/paged.polyfill.js"></script>
|
||||
<script src="/reload-in-place.js"></script>
|
||||
<link href="$static$/interface.css" rel="stylesheet" type="text/css" />
|
||||
<script src="$static$/paged.polyfill.js"></script>
|
||||
<script src="$static$/reload-in-place.js"></script>
|
||||
$endif$
|
||||
$for(header-includes)$
|
||||
$header-includes$
|
||||