Télécharger les sites web qui utilisent AsciiDoc

À propos de AsciiDoc

Rien, dans un langage de balisage, ne devrait être visible sur un site en production, tout court. Tout l’intérêt d’AsciiDoc tient à ce qu’une source en texte brut devient du HTML, du PDF ou de l’EPUB quelque part dans une chaîne de production, et ce qui parvient au lecteur, c’est la sortie. La détection ramasse plutôt le résidu de ce circuit : des métadonnées de générateur, des noms de classe caractéristiques, la feuille de style par défaut qu’une chaîne d’outils d’origine émet quand personne ne l’a remplacée. Disponible depuis 2002 et diffusé sous licence Open Source, le format n’a jamais eu de fournisseur pour compter les installations, si bien qu’une population inférée est la seule population qui existe.

Il en résulte un groupe de sites précis et légèrement étrange. En octobre 2026, nous trouvons ce résidu sur 18 sites, ce qui représente des manuels, des livres, des références d’API et de la documentation de projet publiés directement depuis une chaîne d’outils plutôt qu’au travers d’un système de contenu dans lequel quelqu’un se connecte. Le chiffre ne dit rien du nombre de personnes qui écrivent dans ce format. Il décrit combien de sorties publiées ont gardé les empreintes de la chaîne d’outils au lieu d’être rhabillées en quelque chose de méconnaissable.

C’est dans les données de version que ce circuit devient visible. Nous enregistrons 8 versions distinctes sur l’ensemble de la population, et 9.0.0 revient assez largement pour suggérer qu’il s’agit de documents figés au moment où ils ont été générés, et non de sites reconstruits à intervalles réguliers. Une sortie publiée ne se met pas à jour toute seule. Un site de documentation continue de servir le même HTML jusqu’à ce que quelqu’un le régénère, si bien que l’étalement des versions se lit ici comme une chronologie de dates de compilation plutôt que comme une courbe de mise à niveau.

Pour quiconque cartographie l’outillage des développeurs, l’implication vaut plus que le décompte. Un site qui porte cette empreinte appartient à un projet doté d’une documentation écrite, d’une étape de compilation et, le plus souvent, d’un public technique, ce qui constitue un indicateur indirect correct pour un certain type d’organisation d’ingénierie et un indicateur médiocre pour tout le reste.

La sous-estimation est sévère et doit être dite clairement. Tout éditeur qui applique un thème personnalisé, retire les balises de générateur ou fait passer la sortie par un générateur de site statique disparaît du décompte, si bien que l’usage réel du format dépasse ce que la détection peut voir dans une proportion que personne ne peut mesurer. Ce qu’une liste téléchargeable offre, c’est le sous-ensemble identifiable, complet, dans un seul fichier, domaines compris. Une requête domaine par domaine peut confirmer une intuition sur un hôte de documentation. Seule la liste complète permet de demander quelles organisations publient de cette manière, comment cet ensemble recoupe le reste de leur stack, et où une chaîne d’outils a discrètement cessé d’être maintenue.