Markdown et GitBook
Ce document est le support de la formation donnée à l'association ICI, le 6 septembre 2019 à Paris, sur la rédaction de documents pédagogiques en Markdown et leur publication avec GitBook.
Objectifs du cours
La formation permet aux participants :
- comprendre comment utiliser et prendre en main Markdown
- comprendre comment travailler à plusieurs sur un document (avec Git)
- publier un document sur GitBook
Auteur
Raphaël Grolimund grolimur@nou4.ch
Version 0.1.1
La dernière version de ce document est disponible sur https://legacy.gitbook.com/book/grolimur/markdown-to-gitbook.
Vous pouvez lire le document en ligne ou le télécharger aux formats PDF, ePub ou Mobi.
L'historique complet des versions est disponible à la fin du document.
Licence CC BY
Ce document est mis à disposition selon les termes de la Licence Creative Commons Paternité 4.0 International.
Les fichiers source sont disponibles sur https://framagit.org/grolimur/markdown-et-gitbook.
Informations complémentaires
Tous les liens ont été consultés avant la mise en ligne du document et étaient accessibles.
La date de consultation correspond à la date de publication de la présente version.
Cette formation suit la philosophie du dogfooding (ou Eat your own dog food) qui consiste à utiliser les outils qu'on crée, ou dans le cas présent, qu'on enseigne. Ce document a été rédigé en Markdown et publié sur GitBook.
Crédits
Les logos utilisés dans ce document ont été publiés sous les licences suivantes par leur auteur :
CC0 logo - Markdown (https://commons.wikimedia.org/wiki/File:Markdown-mark.svg)
CC BY 3.0 Jason Long - Git-logo (https://commons.wikimedia.org/wiki/File:Git-logo.svg)
CC BY 4.0 Font Awesome - Font Awesome 5 brands github (https://commons.wikimedia.org/wiki/File:Font_Awesome_5_brands_github.svg)
CC BY 4.0 Darby - GitLab Logo (https://commons.wikimedia.org/wiki/File:GitLab_Logo.svg)
Seul le logo de GitBook provient directement de la plateforme.