strats-smpr/README.md

strats-smpr

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/. L'un correspond au document d'introduction, l'autre à la présentation.

Génération

Requis

• pandoc (installation).
• pagedjs-cli (installation).
• GNU make.

Commandes

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

make pdf

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

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.