# Tutoriel livre web HackMD

## Création de compte

Créez-vous un compte sur [HackMD](https://hackmd.io/). Vous pouvez utiliser votre adresse étudiante si vous ne souhaitez pas communiquer une autre adresse email.

## Les bases de HackMD

HackMD est un outil d'écriture et d'édition collaborative en ligne qui utilise plusieurs technologies pour vous permettre de composer des documents structurés et connectés au reste du web. On y crée des *notes* dans lesquelles on peut écrire nativement en Markdown et en HTML, ajouter du CSS via l'élément HTML `style`, et inclure du contenu externe (vidéos, présentations, PDF) via quelques connecteurs [pré-définis](https://hackmd.io/features?both#Externals).

## Étapes pour créer un livre web

HackMD permet d'assembler plusieurs notes en un **livre web**. Il existe [un tutoriel](https://hackmd.io/s/how-to-create-book) avec captures d'écran animées qui est simple et rapide à suivre. Voici un résumé en français :

1. Créez une nouvelle note. Elle va constituer la colonne vertébrale du livre et ne s'affiche pas à la lecture.
2. Dans cette note, écrivez le titre du livre sous la forme d'un titre de niveau un : `# Titre`.
3. En-dessous du titre, créez la liste du contenu :
- Saisissez un tiret `-` suivi d'un espace pour créer un item.
- À la suite de l'espace, saisissez une paire de crochets droits `[]` (le crochet fermant est saisi automatiquement) pour créer un lien.
- Entre les crochets, écrivez le titre de la partie (ex : "Présentation", "Partie 1", "Bibliographie", etc.). Un menu déroulant apparaît dessous : cliquez sur le bouton `+ create note` (créer une nouvelle note) si vous n'avez pas encore créé une note dans HackMD pour cette partie, ou bien cliquez sur le nom de la note si vous l'aviez déjà créée. Cette première note de la liste constitue la première page qui s'affichera à la lecture.
4. Répétez l'étape précédente pour chaque partie du livre.
5. Toujours dans cette même note, cliquez sur le bouton de partage ("Sharing") en haut à droite. Mettez le fichier en mode livre ("Book Mode"). Donnez l'autorisation de lecture ("Read") à tout le monde ("Everyone") et l'autorisation d'écriture ("Write") à vous uniquement ("Owners"). Cliquez sur "Publish".
6. Le livre est créé, vous pouvez maintenant modifier chaque partie. Rédigez hors-ligne dans le confort de votre éditeur de texte préféré ou bien directement sur HackMD, au choix. N'oubliez pas de régler l'autorisation d'écriture sur "Owners" pour chaque note.

Consultez [le modèle Infonum](https://hackmd.io/@aperret/livrewebinfonum/) pour structurer votre livre.

## Partager le livre web