# [strats-smpr][1]

Supports pour un cours donné aux internes du SMPR, en vue de la mise à jour de
stratégies et d'articles scientifiques, sur la méthodologie de la recherche de
littérature et l'utilisation de Zotero.

Il s'agit :

- Un document pour une introduction rapide (quickstart).
- Des slides pour la présentation elle-même.

## Édition

Pour éditer les sources, il faut modifier les fichiers Markdown du [dossier
`sources/`][2]. L'un correspond au document d'introduction, l'autre à la
présentation.

## Génération

### Requis

- `pandoc` ([installation][3]).
- `pagedjs-cli` ([installation][4]).
- GNU make.

### Commandes

Pour générer la version PDF du document :

```
make pdf
```

Pour générer les slides au format HTML :

```bash
make slides
```

## Développement

Une fois les requis de la génération de PDF installés, les commandes suivantes
facilitent le développement :

- `make html` génère un fichier HTML. Une fois servi par un serveur web, il
  permet de se rendre compte du résultat final et d'adapter les règles de
  style.
- `make serve` lance un serveur à l'aide de python (qui doit être disponible).
- `make watch <filename>` génère la version HTML du fichier, et relance la
  génération à chaque changement des fichiers utiles.

<!-- références -->

[1]: /
[2]: ./sources/
[3]: https://pandoc.org/installing.html
[4]: https://gitlab.coko.foundation/pagedjs/pagedjs-cli#installation