~/tilder/, fr/, Documentation/, Référence/, Le miroir en texte

text-mirror - chaque page en texte, pour les terminaux

Chaque page que construit tilder sort deux fois : en HTML pour les navigateurs, et en texte pour les terminaux, à partir de la même source, si bien que les deux ne peuvent pas diverger. Le texte fait 75 colonnes de large et se ramène à l'ASCII. Il est lui aussi écrit deux fois : brut dans txt/, et coloré par des séquences d'échappement ANSI dans ansi/. Un terminal qui demande une page au site reçoit la version en couleur.

Le texte de chaque page est rangé sous txt/ et ansi/, à l'adresse de la page, avec .txt. La page d'un dossier porte le nom du dossier.

Servi par le Caddyfile d'exemple, curl example.org/about renvoie ansi/about.txt, avec un 200 et sans redirection ; ?plain renvoie txt/about.txt à la place, pour l'enregistrer ou le passer à un autre programme ; et l'hôte en texte brut sert txt/ à tous les clients, aux mêmes chemins (déploiement). Les fichiers se lisent aussi depuis le disque :

less -R public/ansi/about.txt
curl example.org/about
curl "example.org/about?plain" > about.txt

robots.txt tient les moteurs de recherche à l'écart de /txt/ et de /ansi/, et txt/robots.txt de tout l'hôte en texte brut : le texte double les pages (SEO).

Le texte suit les sections de la page, à la manière d'une page de manuel (en raccourci ici : les vrais filets font 75 colonnes de large) :

MYSITE(1)                 My Site Manual                 MYSITE(1)

LANGUAGES: en fr

NAME
     about - who we are

     A paragraph, wrapped at 75 columns, indented five spaces.

SEE ALSO
     ...

previous: Getting started                         next: Deployment

MYSITE                    2026-01-01                     MYSITE(1)

• Le filet d'en-tête : le man: de la page des deux côtés, site.manual au milieu.
• Sur un site en plusieurs langues, une ligne LANGUAGES: les énumère.
• Chaque section ## : son titre en capitales à la première colonne, son corps en retrait de cinq espaces.
• Avant le pied de page, la ligne des voisins d'une collection séquentielle, avec labels.prev et labels.next (navigation).
• Le filet de pied de page : footer.left, site.updated, footer.right (configuration).

Ce qui n'y figure pas : tout ce qui précède le premier ##, une section marquée {html}, et un bloc de commentaire. Une section marquée {text} n'apparaît qu'ici, pas sur la page (sections). Les espaces en fin de ligne disparaissent, et jamais plus d'une ligne vide n'en suit une autre.

Chaque ligne tient en 75 colonnes : un terminal de 80 colonnes, le format par défaut depuis le VT100, avec de la place pour une barre de défilement, la marge de less ou d'un diff, ou le > d'un courriel cité. Les paragraphes sont coupés sur les espaces, chaque ligne remplie autant qu'elle le peut. Un mot n'est jamais coupé, une URL ou une commande non plus : un mot plus long que la ligne est donc la seule chose qui puisse dépasser le bord.

txt/ est en ASCII : la source garde ses accents et sa typographie, le miroir les ramène à l'ASCII, où qu'ils se trouvent - l'en-tête de manuel, la date de mise à jour, le lien d'un membre et le chemin d'une image sont ramenés aussi. D'abord, ces caractères sont remplacés :

Ensuite, chaque lettre perd ses accents et autres signes : un e accent aigu devient e, un c cédille devient c. Dans la prose, les suites d'espaces n'en font plus qu'une ; dans le code, l'espacement est gardé à l'identique. Ce qui reste hors ASCII - un emoji, une autre écriture, un symbole absent du tableau - est retiré : txt/ n'est qu'ASCII, quoi que tienne la source.

En ligne : un lien garde son libellé, et un lien externe y ajoute son adresse entre parenthèses, archive (https://example.org/) ; une adresse interne est omise, puisqu'un terminal la visite avec curl plutôt que de la recopier. Le gras et l'italique deviennent du texte simple ; le texte barré garde ses marques ~~, puisque les retirer changerait le sens. Le dialecte complet, bloc par bloc, est dans la référence Markdown.

Un bloc de code est encadré de deux filets qui disent quel bout est lequel : celui du haut s'ouvre sur ., porte le langage et se ferme sur . ; celui du bas s'ouvre et se ferme sur '. Le code est en retrait à l'intérieur, sans rien d'ajouté sur ses propres lignes : il se copie proprement depuis un terminal. En raccourci :

.-- sh ------------------------------.
  curl example.org/about
'------------------------------------'

Le code garde son espacement à l'identique ; une tabulation avance jusqu'au taquet suivant, toutes les quatre colonnes. Une ligne qui dépasse la 75e colonne est coupée et continue sur la ligne suivante, en retrait de deux espaces, la coupure marquée d'un \ : un shell la lit comme une continuation.

ansi/ est le même texte avec des séquences d'échappement ANSI : huit couleurs, ou un accent en 256 couleurs choisi par le site (text.accent), jamais de fond, pour se lire aussi bien sur un terminal clair que sombre. La couleur suit le balisage, sans jamais être devinée d'après les mots : la construction marque le code en ligne, les puces des listes, les lignes des blocs de code et, dans un bloc de code coloré, chaque composant, là où elle les rend, et colore exactement ceux-là, d'une ligne à l'autre.

La couleur d'accent est text.accent : "cyan" par défaut, ou l'un des huit noms de couleur, ou un index de 256 couleurs de 16 à 255, tel que 208 pour l'orange, réglé dans site.toml (un site.<lang>.toml peut régler le sien) (configuration). La ponctuation qui referme une phrase autour d'une URL ou d'une ligne de commande - un .,;:!? final, une apostrophe restée seule, une parenthèse jamais ouverte - reste sans couleur : dans une phrase comme (voir https://example.org/a_(b)), seule l'adresse est colorée, pas le ). qui la termine.

Une ligne de commande est une ligne de bloc de code qui commence par l'un des mots de text.commands, seul ou après une invite, $ ou # suivi d'une espace ; par défaut, seulement curl. Un site ajoute les siens :

[text]
commands = ["curl", "docker", "python3"]

Les encadrés sont reconnus au libellé de leur filet du haut : les couleurs suivent donc labels.info, labels.warning et labels.error dans chaque langue. Retirez les séquences d'échappement d'un fichier de ansi/, et il reste son jumeau de txt/, octet pour octet. txt/ ne contient aucune séquence d'échappement : il survit à curl > fichier.

Un bloc de code dans un langage que highlight.py connaît est aussi coloré dans ansi/, chaque composant dans la couleur de son genre, selon les mêmes règles que la page HTML : ansi/ ne dit jamais le contraire de ce que montre un navigateur. Seule la couleur change, jamais un caractère ajouté : les espaces autour d'un composant restent sans couleur, et une fois ses séquences d'échappement retirées, le bloc est celui de txt/. Une ligne coupée à la 75e colonne garde ses couleurs sur la ligne suivante.

Le mot de commande est le premier mot d'une commande : au début d'une ligne (après une invite $ en console), après |, ||, &&, ;, &, (, $(, après un préfixe comme sudo ou env, et après l'affectation d'une variable.

Les langages colorés sont sh, python, js, c, go, rust, sql, json, jsonc, yaml, kyaml, ini, conf, dockerfile, html, css et make, chacun selon ses propres règles, plus console, diff et markdown, colorés ligne par ligne ; la liste complète des noms et de leurs alias est dans les blocs de code. Un bloc sans langage, en text, ou dans un langage que tilder ne connaît pas n'est pas coloré : seules ses lignes de commande (text.commands) prennent la couleur d'accent, et txt/ reste brut dans tous les cas.

text: no dans l'en-tête d'une page n'écrit aucun texte pour elle, ni dans txt/ ni dans ansi/. La page 404 du site de départ le fait : un terminal reçoit à la place un court message du serveur (écrire des pages, déploiement).

---
title: 404
description: Page not found.
text: no
robots: noindex
---

• déploiement
• la référence Markdown
• la configuration