# Markdown et Gitbook   *Raphaël Grolimund* 6 septembre 2019 --- ## Objectifs :dart: ---- 1. comprendre comment utiliser et prendre en main Markdown 2. comprendre comment travailler à plusieurs sur un document (avec Git) 3. publier un document sur GitBook --- ## Programme :clock930: :clock12: :clock1: :clock4: ---- | horaire | activité | méthode | | ------: | :------- | :------ | | 9h30-10h00 | présentation et introduction | *présentation* | | 10h00-11h30 | syntaxe de Mardown | *pratique* | | 11h30-12h00 | Git | *démo* | ---- | horaire | activité | méthode | | ------: | :------- | :------ | | 13h00-13h30 | GitBook: comment ça marche | *discussion et démo* | | 13h30-15h30 | syntaxe de Mardown | *pratique* | | 15h30-16h00 | Bilan et conclusion | *présentation* | --- ## Markdown  ---- ### paragraphe - [ ] créez un document et insérez-y 2-3 paragraphes de texte. - [ ] sauvegardez-le, car vous allez vous en servir tout au long des exercices pratiques. ---- ### titres - [ ] ajoutez des titres et sous-titres à votre document ---- ### citations - [ ] ajoutez au moins une citation dans votre document ---- ### listes à puce - [ ] ajoutez une liste dans votre document - [ ] numérotez des années sous forme de liste ---- ### code - [ ] insérez du code (ou assimilé) dans votre document. - [ ] insérez un `` ` `` dans un morceau de code ---- ### ligne horizontale - [ ] ajoutez une séparation dans votre document ---- ### liens - [ ] ajoutez au moins un lien dans votre document ---- ### accentuation - [ ] mettez une partie d'un texte en gras - [ ] mettez une partie d'un texte en italique - [ ] mettez une partie d'un texte en gras et en italique ---- ### images - [ ] insérez quelques images dans votre document ---- ### backslash - [ ] s'il est pertinent de le faire, ajoutez quelques caractères d'échappement dans votre document ---- ### tableaux - [ ] insérez un tableau dans votre document - [ ] définissez une colonne alignée à gauche - [ ] définissez une colonne alignée à droite - [ ] définissez une colonne alignée au centre ---- ### tâches - [ ] ajoutez une liste à puce dans votre document - [ ] cochez une activité qui serait terminée ---- ### retour à la ligne - [ ] quand c'est pertinent, remplacer les lignes vides par 3 espaces dans votre document ---- ### d'autres idées ? - [ ] essayez de faire tout ce dont vous pensez avoir besoin plus tard --- ## Git  ---- ``` git init git add git commit git pull git push ``` ----  ----  --- ## GitBook Comment ça marche ? ---- Schéma :art: ---- Mise en pratique :wrench: :nut_and_bolt: ---- ## Bonus support de formation VS support de présentation --- ## Bibliographie https://www.zotero.org/groups/2364506/markdown/items ---- BONJOUR, Jean-Daniel, 2013. Création et conversion de documents avec Pandoc. In : *Flash Informatique*. 16 juillet 2013. n° 4, p. 3‑8. [http://archiveweb.epfl.ch/flashinformatique.epfl.ch/spip.php%3Farticle2658.html](http://archiveweb.epfl.ch/flashinformatique.epfl.ch/spip.php%3Farticle2658.html) (**CC BY-SA 3.0**) `pandoc` ---- BORBOEN, Nicolas, 2013. Markdown. In : *Flash Informatique*. 2013. n° 1, p. 5‑8. [https://archiveweb.epfl.ch/flashinformatique.epfl.ch/IMG/pdf/1-13-page5.pdf](https://archiveweb.epfl.ch/flashinformatique.epfl.ch/IMG/pdf/1-13-page5.pdf) (**CC BY-SA 3.0**) `markdown` ---- CHACON, Scott et STRAUB, Ben, 2014. *Pro Git* [en ligne]. 2nd ed. Berkeley, CA : Imprint: Apress. ISBN 978-1-4842-0076-6. Disponible à l’adresse : [https://git-scm.com/book/en/v2](https://git-scm.com/book/en/v2). (**CC BY-NC-SA 3.0**) `git` ---- GRUBER, John, 2013. Markdown Syntax Documentation. In : *Daring Fireball* [en ligne]. 30 avril 2013. [Consulté le 3 mai 2013]. Disponible à l’adresse : [http://daringfireball.net/projects/markdown/syntax](http://daringfireball.net/projects/markdown/syntax). `markdown` ---- GRUBER, John, 2014. Markdown. In : *Daring Fireball* [en ligne]. 17 décembre 2014. [Consulté le 3 mai 2013]. Disponible à l’adresse : [http://daringfireball.net/projects/markdown](http://daringfireball.net/projects/markdown). `markdown` ---- WIKIPEDIA CONTRIBUTORS, 2019. *Git* [en ligne]. S.l. : s.n. [Consulté le 3 septembre 2019]. Disponible à l’adresse : [https://en.wikipedia.org/w/index.php?title=Git&oldid=913657425](https://en.wikipedia.org/w/index.php?title=Git&oldid=913657425). `git` --- ## Contact Raphaël Grolimund | | | | :--| :-- | | E-mail | grolimur@nous4.ch | | Twitter| @grolimur | | Mastodon | @grolimur@mamot.fr | --- ## Crédits Réutilisez cette présentation si elle peut vous être utile !  Grolimund, Raphaël, 2019. *Markdown et GitBook*. https://cest.la/MDGB (**CC BY 4.0**) ---- Cette présentation accompagne le support de cours Markdown et GitBook: https://legacy.gitbook.com/book/grolimur/markdown-to-gitbook ---- 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.