Installation et utilisation de zmarkdown
zmarkdown est l’outil permetant de transformer le markdown (en) (avec quelques additions spécifiques à ZdS) en HTML ou LaTeX. Celui-ci est utilisé via un serveur HTTP (via pm2), qu’il est nécessaire de démarer (voir plus loin) et que ZdS interroge ensuite pour effectuer le rendu du markdown.
Installation
Note
L’utilisation de zmarkdown requiere d’avoir installé node et npm, qui est déjà utilisé par le front-end. L’installation de ces outils peut être faite via nvm.
L’installation se fait simplement à l’aide de
make zmd-install
ou, sous Windows (non testé):
cd zmarkdown
npm -g install pm2
npm install zmarkdown --production
cd ..
Utilisation
Afin de pouvoir profiter de zmarkdown, vous devez lancer le serveur à l’aide de make zmd-start
(ou, sous Windows, cd zmd/node_modules/zmarkdown && npm run server
[non-testé]).
Vous pouvez vérifier qu’il est bien lancé à l’aide de zmd-check
(qui ne fonctionne pas sous Windows).
On arrête le serveur en utilisant make zmd-stop
, ou bien pm2 kill
.