Nom
le site - tilder, documenté par tilder
tilder a un site : celui-ci. On y trouve la documentation, les raisons d'être de l'outil, une vitrine et ces notes de version, en anglais et en français. tilder le construit avec le thème de documentation du dépôt du site, si bien que chaque page est aussi son propre exemple.
Construit par tilder
Chaque page est un fichier Markdown, rendu deux fois : une page HTML pour les navigateurs, et un miroir texte de 75 colonnes pour les terminaux. Un client en ligne de commande reçoit le miroir plutôt que le HTML :
curl tilder.thosted.frLes pages ne chargent rien depuis un autre site, et se lisent en entier sans JavaScript.
tilder 1.2.0
Le site documente tilder 1.2.0 et il est construit avec. L'image est ghcr.io/thosted/tilder:1.2.0.
Collections imbriquées. Une collection peut lire son dossier à toute profondeur, avec recursive = true : content/docs/guide/install.md est un élément de docs, servi à /docs/guide/install. Chaque dossier forme une section, dont la page est son index.md ou un guide.md à côté du dossier ; la barre latérale devient un arbre, et l'ordre, les listes et les liens précédent et suivant le parcourent en profondeur. Une collection datée, comme un blog, reste à plat.
Vérification des thèmes. build.py --check confronte le thème du site au tilder qui le construit, puis s'arrête sans rien construire : chaque classe qu'écrit le générateur doit avoir une règle dans style.css, sauf si le thème la nomme dans [check] unstyled, et les paires de couleurs que le thème déclare dans [check] contrast doivent atteindre leur contraste minimal, en clair comme en sombre. Les deux listes vivent dans le theme.toml du thème. La commande affiche une ligne error: par problème et une ligne de bilan par vérification, et sort avec le code 1 quand une vérification échoue.
Un site qui ne règle rien de nouveau se construit exactement comme avec la 1.1.
Ce qu'avait apporté la 1.1.0
La navigation dans les collections. Un type marqué SEQUENTIAL donne à ses éléments une place dans un ordre : un thème dessine la barre latérale et les liens précédent et suivant avec {{ collection_nav }}, {{ prev }} et {{ next }}, les éléments peuvent se regrouper sous un group, et le miroir texte reçoit une ligne qui nomme la page précédente et la suivante. Des fichiers par langue. Un type marqué LOCALIZED_OUTPUTS écrit ses propres fichiers, un index de recherche par exemple, une fois par langue, sous le préfixe de cette langue. Les langues elles-mêmes étaient arrivées avec la 1.0.0.
Deux changements plus modestes : le theme.<lang>.toml d'un thème pour une langue que le site ne déclare pas est ignoré, et l'image Docker embarque la documentation de référence dans /tilder/docs/.