--- tags: démonstration slideOptions: overview: true transition: fade theme: white center: false text-align: left font-size: 30px --- <style> .reveal p { text-align: left; } </style> # Démo HackMD > [name=Agnès Greliche] [time=9 Mars 2022] [TOC] ---- ## A. Généralités ### 1. C'est quoi ? C’est un éditeur *Markdown* *C’est super ces informaticiens, quand ils répondent aux questions… On comprend rien aux réponses !* :grinning_face_with_one_large_and_one_small_eye: C’est une façon de rédiger du texte enrichissable (mise en page, titres, caractères gras, italique, etc…) à partir d’un simple ‘texte’, avec un ‘Notepad’. On parle d’un fichier texte ‘plat’, comprenant des marqueurs simples pour indiquer à l’interpréteur d’affichage, d'afficher le texte “enrichi” (et je peux inclure des images). ---- ### 2. Pourquoi l'utiliser ? * c'est un outil collaboratif à mise à jour instantannée * c'est un éditeur simple : peu de mises en forme * c'est un outil partagé accessible en ligne dès lors que l'on dispose du lien * Les modifications sont immédiatement visibles par l'ensemble des contributeurs * On dispose des différentes versions : accès par *... Menu -> Versions* en haut à gauche de l'écran ---- ### 3. Les limites :warning: ce n'est pas le logiciel préconnisé par l'INSEE : on peut l'utiliser mais il vaut mieux se tourner vers des espaces collaboratifs sous symphonie dans la mesure du possible ---- ## B. Premiers pas sur HackMD ### 1. Se connecter :key: - on peut créer son compte avec son adresse INSEE - quand on est connecté, on retrouve tous les documents que l'on a créés mais également tous ceux auxquels on a participé (pour lesquels on a fait une modification, ajout d'un espace...) ---- ### 2. Présentation de l'ergonomie de l'outil :mag: #### a. La page d'accueil On trouve dans la partie principale la liste des documents auxquels on a accès qui peuvent être triés gràce à des tags ---- #### b. La création d'un document et partager un document Pour créer un nouveau document, il faut cliquer sur l'icône '+' (create ou new note). Pour le partager afin de travailler en mode collaboratif, il suffit de copier le lien et de le transmettre aux collaborateurs. ---- #### c. La modification ou la visualisation d'un document On rentre dans un document, en cliquant sur sa vignette. En haut, à côté de "HackMD", on trouve 3 icônes qui permettent d'afficher l'édition ou la visualisation ou les 2 fenêtres côte à côte. ---- #### d. Organiser le stockage des documents On peut ajout un ou plusieurs tags pour classer les documents. Ces tags sont indiqués tout en haut du document entre 3 tirets (3 avant et 3 après). Ex : ``` --- tags: démonstration --- ``` Pour écrire des infos de gestion "> [name=Agnès Greliche] [time=24 Janvier 2022]" ---- ### 3. Premières astuces de mise en forme en Markdown :abcd: - Pour afficher le sommaire "[TOC]" - Pour faire des titres "#"(niveau 1) "##"(niveau 2)... - On peut faire des listes numérotées "1. " "2. "... - On peut créer des liste avec "- " ou "* " - et des sous listes en décalant "- " avec le TAB - et ça marche sur plusieurs niveaux - On peut mettre : - en **gras** (2 ** avant et après sans espace), - en *italique* (1 * avant et après sans espace), - ~~barré~~ (2 ~~ avant et après sans espace) ---- ### 4. Insertion d'un lien hypertexte :link: On peut cliquer sur l'icone :link: en haut de la fenêtre de l'éditeur ou écrire entre crochets le taxte qui apparaît puis entre parenthèses le lien hypertexte (attention : pas d'espace entre les 2 parties) - ex : [site internet Insee](https://www.insee.fr/fr/accueil) ---- ### 5. Ajout d'émoji :heavy_check_mark: On encadre le nom de l'émoji en anglais avec ":" La plupart des émoji fonctionnent :thumbsup: :green_heart: mais quelques uns sont encore absents :disappointed: :ghost: En tapant ":" une liste d'emojii est automatiquement proposée On peut consulter le site suivant [pour trouver un émoji](https://gist.github.com/rxaviers/7360908) pour trouver un emoji dont on ne sait pas le nom. ---- ### 6. Insertion d'un tableau :1234: Un exemple pour illustrer les différentes possilités : |Région de gestion| numéro de la FA| ssech| le| ec| bs| kp| numenq|Suivi| |:---| ----: | :----: |---|---|---|---| ----- |---| |24| 000022 |35 |0 |0 |2 |48 |2422 |:heavy_check_mark:| |31| 000015 |**36** |0 |0 |1 |20 |2168 |:x:| |93| 000096 |35 |0 |0 |2 |32 |0401 | :heavy_check_mark:| |93| 000096 |35 |0 |0 |1 |32 |0401 | :heavy_check_mark:| |93| 000497 |**36** |0 |0 |1 |32 |0008 | :x:| Check list de la création d'un tableau : - [ ] les colonnes sont séparées par un pipe "|" (Alt Gr + 6) - [ ] la première ligne contient les intitulés des colonnes - [ ] la deuxième ligne contient l'alignement de chaque colonne - [ ] les lignes du tableau s'incrémentent automatiquement en allant à la ligne - [ ] Pour que le tableau fonctionne, on doit avoir le même nombre de "|" à chaque ligne - [ ] on peut avoir des cases à vide "| |"