---
# System prepended metadata

title: Démo HackMD
tags: [démonstration]

---

---
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 "|  |"




