Markdown dans la programmation

Meetup #39 programmez, effectué par Christophe Villeneuve sur Markdown dans la programmation

Transcript

1. Markdown dans la programmation Christophe Villeneuve @hellosct1 @hellosct1@mamot.fr Meetup #39
2. Atos open source - afup – lemug.fr – mariadb – drupal – mozilla - firefox – lemugfr - sumo – webextensions – VR – AR – XR - Cause commune 93.1 FM - TechSpeaker - Lizard - eyrolles – editions eni – programmez – linux pratique – webriver – elephpant - CommonVoice – Sécurité - Cybersécurité Christophe Villeneuve • Consultant Open Source • Dresseur animaux
3. @hellosct1 – Meetup #39 - 2024 Aujourd’hui • Le markdown • Première page • Version Dynamique
4. @hellosct1 – Meetup #39 - 2024 • Le markdown • Première page • Version Dynamique
5. @hellosct1 – Meetup #39 - 2024 Qu’est ce que le Markdown • Créé par John Gruber en 2004 • Langage de balisage léger – Possibilité d’ajouter des éléments de formatage aux documents • L'utilisation de Markdown – n’est pas la même que • l'utilisation d'un éditeur WYSIWYG • Appeler « texte en clair » • Exemple de sites webs : Github, Reddit
6. @hellosct1 – Meetup #39 - 2024 Formatage Markdown • Formatage/syntaxe du Markdown – Ajout au texte quels mots et phrases devraient être différents. • Exemple
7. @hellosct1 – Meetup #39 - 2024 Utiliser Markdown ? • Markdown peut être utilisé pour tout. • Création des sites web • des documents • des notes • des livres • des présentations • des messages électroniques • documentation technique • Markdown est portable • Compatible – toutes plateformes / OS • • Exemples – Fichiers à Plat – Des livres – Thèses universitaires – Documents...
8. @hellosct1 – Meetup #39 - 2024 Fonctionnement du Markdown • Processus en quatre parties – Créer un fichier Markdown • Avec un éditeur de texte ou d'une application dédiée – Ouvrez le fichier Markdown dans une application Markdown. – Utilisez un IDE Markdown • Option possible de conversion Markdown en un document HTML. – Visualisez le fichier HTML dans un navigateur web • Possible d’avoir d’autres formats
9. @hellosct1 – Meetup #39 - 2024 • Le markdown • Première page • Version Dynamique
10. @hellosct1 – Meetup #39 - 2024 Documentation # Meetup 39 ## Exemple 1. Exemple d'implémentation 1. Afficher un logo  1. Construction d'un tableau : | Titre | Description | | --- | :--- | | *Programmez !* | Le magazine des **dév**eloppeurs | | Lieu du meetup | The Coding Machaine | | Date | 06 février 2024 | 1. Un message dans une note >[!NOTE] > > A découvrir
11. @hellosct1 – Meetup #39 - 2024 Custom Markdown • Gras • Italique • Listes à puces • Listes numérotées • Listes imbriquées • Titres • Blocs de citation • Code incorporé • Blocs de code • Images • Liens • Images servant de liens • Liens vers les tickets • Ligne de séparation horizontale • Saut de ligne • Trait de soulignement
12. @hellosct1 – Meetup #39 - 2024 Compilation pour MD → PDF • sudo apt install pandoc • Ajout les langues du monde – sudo apt install texlive-lang-all • ​ Ajout les langues européennes – sudo apt install texlive-lang-european • Ajout la langue Française – sudo apt install texlive-lang-french
13. @hellosct1 – Meetup #39 - 2024 Ligne de commandes • Extension Beamer – Exemple pour convertir MD vers PDF $ pandoc -st beamer \ -V theme:Custom \ -V lang:fr-FR \ "main.md" \ -o "main.pdf" \ --slide-level=2 \ --dpi=300
14. @hellosct1 – Meetup #39 - 2024 • Le markdown • Première page • Version Dynamique
15. @hellosct1 – Meetup #39 - 2024 WebSite • Ajout de LaTeX •
16. @hellosct1 – Meetup #39 - 2024 Et la suite... PROCHAINEMENT
17. @hellosct1 – Meetup #39 - 2024 Plus loin • Bien démarrer : – Dillinger https://dillinger.io/ • Apprendre Markdown : https://www.markdowntutorial.com • Générer de la documentation – Read The Docs https://readthedocs.org/ • Générer des sites statique : – Mkdocs https://www.markdownguide.org/tools/mkdocs/ – Docusaurus https://www.markdownguide.org/tools/docusaurus/ • Site statique pour Docs techniques : – VuePress https://vuepress.vuejs.org/ • Générer documentations techniques – Jekyll : https://www.markdownguide.org/tools/jekyll/ •
18. @hellosct1 – Meetup #39 - 2024 Ressources supplémentaires • Fichiers sources des démos – https://github.com/hellosct1/markdown-in-programmation • Podcast de la présentation – https://www.youtube.com/watch?v=kL7oLOc-4bE
19. Christophe Villeneuve @hellosct1 @hellosct1@mamot.fr Merci