Ecrire un tuto

Les pages de tuto sont des fichiers markdown (.md) stockés dans un dépôt Github.

Le dépôt est ici.

Les tutos sont dans ce répertoire.

Ils sont structurés suivant l’organisation suivante:

• code: pour tout ce qui concerne la programmation, le développement;
• logiciels: installation et utilisation des logiciels;
• machines: utilisation, paramétrage, maintenance des machines utilisées au fablab;
• os: installation, paramétrage et utilisation des systèmes d’exploitation.

Les fichiers markdown

Une très bonne ressource en anglais à propos des fichiers Markdown.

Ce sont des fichiers texte avec un peu de formatage possible pour créer des pages web très simples mais supportant les éléments essentiels pour créer une page sur la toile:

• La struturation du documents (plan)
• Les hyperliens
• Les images
• Les listes
• Les tables

La syntaxe est basée sur l’emploi de caractères spéciaux qui, placés en début de ligne, indiquent la nature de la ligne. Ainsi le # (dièse ou hashtag en anglais) permet de définir des sections du documents, les - (tiret ou “tiret du 6” comme on l’entend parfois avec des utilisateurs du PC - les tirets ne sont pas gérés par la touche 6 du clavier sur un mac -) pour créer une liste d’élements.

Une ligne vide permet de séparer le texte en paragraphes.

Voir toute la syntaxe Markdown pour devenir un pro de l’écriture Markdown.