# Comment écrire correctement du texte brut?
2023-10-24T12:21:23Z

Le texte brut, ou plaintext, plus j'y pense, plus je l'apprécie : 

* C'est ce qui semble le plus pérenne. Même moi, je pourrais écrire un lecteur de fichier texte.
* 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:

	gemini://geminiprotocol.net/docs/gemtext-specification.gmi
	https://geminiprotocol.net/docs/gemtext-specification.gmi

## 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
...
```

On peut tout à fait aussi préférer souligner les titre avec des "===" ou des "---" voire des "...", mais cela limite à avoir 3 niveaux seulement : 

```
niveau 1
========

niveau 2
--------

niveau 3
........
```

Enfin, 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 restreint à 6 niveaux maximum (qui voudrait de + ???). Déjà, 3, c'est bien!

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:

```
#include <stdio.h>

int 
main(int argc, char *argv[])
{
	return 0;
}
```

## 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, 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). Je préfère cette dernière solution, car c'est parfois pénible de sélectionner le lien avec "=>" devant.
Un lien doit être décrit : la description sera sur la ligne/paragraphe précédent(e).

Voici un exemple de lien:
	https://ceciestunexemple.pwet

## 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?

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 grand nombre de caractères utft8.

## Liens

Pour finir, voici 2 textes qui vont encouragent l'utilisation du texte brut avec des exemples : 

Un blog tout en txt:
	https://www.curiositry.com/blog.txt

WRITING FOR THE INTERNET ACROSS A HUMAN LIFETIME:
	https://web.archive.org/web/20211025182333/https://len.falken.ink/misc/writing-for-the-internet-across-a-human-lifetime.txt

---
Une réaction?

Envoyez votre commentaire par mail (anonyme):
	mailto:bla@bla.si3t.ch?subject=plaintext

Voici quelques instructions pour utiliser la liste de diffusion et recevoir les réponses à vos messages:
	https://si3t.ch/log/_commentaires_.txt