summaryrefslogtreecommitdiff
path: root/README.md
blob: feeb99c6e0b8a999187a6fdef34fb66b5d782045 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# Carnet de doctorant - Roch delannay

Ce site a été construit avec [GNU Make 4.3](https://www.gnu.org/software/make/) et [Pandoc 3.1.1](https://pandoc.org/).

## Organisation des fichiers

```
pandoc-ssg/
├── docs
│   ├── css
│   │   └── styles.css
│   ├── pages
│   │   ├── colophon.html
│   │   ├── cours.html
│   │   ├── glossaire.html
│   │   └── publications.html
│   ├── posts
│   │   ├── 2023-11-03-creation-du-site.html
│   │   └── etc.
│   └── index.html
├── src
│   ├── bibliography
│   │   └── references.bib
│   ├── pages
│   │   ├── colophon.md
│   │   ├── cours.md
│   │   ├── glossaire.md
│   │   └── publications.md
│   ├── posts
│   │   ├── 2023-11-03-creation-du-site.md
│   │   └── etc.
│   ├── index.md
│   └── metadata.yml
├── static
│   ├── css
│   │   └── styles.css
├── templates
│   ├── csl
│   │   └── apa.csl
│   ├── partials
│   │   ├── footer.html
│   │   ├── head.html
│   │   ├── header.html
│   │   └── nav.html
│   ├── index.html
│   └── post.html
├── Makefile
├── metadata.yaml
└── README.md

```

## Production du site

Pour construire le site, utiliser les commandes suivantes :

```
make html
```
Cette commande permet de produire les fichiers `HTML` du site dans le dossier `docs/`.

```
make serve
```
`make serve` permet de jouer le site en local (_localhost_).

```
make clean
```
Cette dernière commande supprime tous les documents qui se trouvent dans le dossier `docs/`

## Remerciements

Merci à [Louis-Olivier Brassard](https://www.lobrassard.net/), pour toutes les explications sur le fonctionnement de Make et pour les bouts de code que je t'ai emprunté.
Merci également à [Arthur Perret](https://www.arthurperret.fr/) pour ton idée de combiner Make et Pandoc.

## Licence

Sauf mention contraire, les contenus publiés sur ce site sont réutilisables suivant les termes de la licence Creative Commons Attribution 4.0 International (CC BY), cf. [résumé](https://creativecommons.org/licenses/by/4.0/deed.fr) et [texte intégral](https://creativecommons.org/licenses/by/4.0/legalcode.fr).