| # Écrire correctement du texte pour toute une vie
## À propos du texte brut
C'est ce qui semble le plus pérenne.
Dans 10 ou 20 ans, ça sera toujours lisible contrairement aux autres formats.
C'est léger. Très léger. Un fichier contenant seulement "Coucou" au format txt pèse 7B tandis qu'il pèse 4,9KB au format docx.
On lui donne la forme qu'on veut. VRAIMENT. On n'est finalement pas contraint par toutes les formes typographiques.
Certains verront ça comme un inconvénient, mais il n'y a pas de choix de polices interminables. En réalité, c'est le lecteur qui va choisir sa police favorite, est c'est aussi bien pour la lisibilité.
C'est finalement très accessible, un lecteur d'écran peut s'en sortir sans trop de problème.
Les contraintes imposées par ce format minimaliste impose davantage de réflexion et finalement favorise la création d'un texte plus structuré et peut-être plus lisible.
Voici les "règles" que je me donne pour écrire correctement du texte brut. Comme vous le constaterez très vite, c'est très largement inspiré du gemtext:
|
|
## Les titres
Je préfère des titres en forme de lignes précédées d'un ou plusieurs "#". C'est pratique à écrire, même si c'est moins joli que les propositions qui suivront.
```
# niveau 1
## niveau 2
### niveau 3
#### niveau 4
...
```
Sinon, comme pour dokuwiki, on peut choisir d'encadrer les titres par des symboles "=" ou "#". Plus il y a de symboles, plus le titre est important:
```
====== niveau 1 ======
===== niveau 2 =====
==== niveau 3 ====
...
```
Ce dernier format est chouette aussi, il est plus esthétique que le premier, mais contraint davantage la lecture.
Quoi que l'on choisisse, il faut rester cohérent dans un même document.
### Les morceaux de code
Rien de très original, on met le code entre "``` ou entre rien du tout tant qu'on l'annonce avant. Évitez blocs de code indentés, ça se copie très mal.
Exemple :
```
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
Happy helping ☃ here: You tried to output a spurious TAB character. This will break gopher. Please review your scripts. Have a nice day!
```
En de rares occasions, on peut vouloir insérer du code dans la ligne de texte. Pour cela, le plus propre reste de le citer "$ comme ceci". C'est à éviter pour faciliter la lecture.
### Les listes
Une liste, c'est une série de lignes commençant par "*" :
```
* item 1
* item 2
* item 3
```
Une liste numérotée, c'est pareil, on ne change pas de symbole. Il suffit d'ajouter le numéro :
```
* 1 : premier item
* 2 : 2 item
* 3 : et un troisième
```
### Les liens
Un lien doit être simple à copier/coller : il sera seul sur sa ligne.
Un lien doit être facilement identifiable. On peut si on le souhaite le précéder de "=>" comme en gemtext, ou bien d'un alinéa (tabulation).
Un lien doit être décrit : la description sera sur la ligne/paragraphe précédent(e): cela facilite la copie, et assure une forme d'honnêteté dans le sens où on ne cache pas un lien éventuellement malveillant derrière un joli label.
```
Voici un exemple de lien: |
| ```
## Mises en évidence.
Pour mettre des mots ou du texte en évidence, je pense qu'encadrer du texte avec ** ou __ voire // rend la lecture plus difficile.
À la place, on peut simplement utiliser des MAJUSCULES.
Ça évite le mélange gras/souligné/italique insupportable et fatiguant. Qu'est-ce qui est important entre les 3 ?
Pour distinguer les niveaux d'importance, c'est à l'auteur de mettre son texte en forme, de créer des paragraphes dédiés, de réfléchir.
### Citations
```
> Pourquoi pas? -- auteurice
```
Hors contexte, ça na guère de sens. Il faut préciser l'auteurice par exemple.
### Liberté
Chacun est libre de mettre son texte en forme comme il le souhaite. Ajouter de l'ascii art. Écrire des paragraphes longs, des lignes courtes... Marquer de longues pauses:
Certains clients mails mettent en forme les citations, et aussi les séparations:
```
---
```
C'est comme chacun le souhaite.
On peut d'autant plus innover avec l'immense nombre de caractères utft8 disponibles.
--- |