Scaricare i siti web che utilizzano AsciiDoc

Informazioni su AsciiDoc

Su un sito web attivo, di un linguaggio di markup non dovrebbe vedersi assolutamente nulla. Tutto il senso di AsciiDoc è che un sorgente in testo semplice diventa HTML, PDF o EPUB da qualche parte in una pipeline di build, e ciò che arriva al lettore è il risultato. Il rilevamento coglie invece i residui di quella pipeline: metadati del generatore, nomi di classe caratteristici, il foglio di stile predefinito che una toolchain standard produce quando nessuno lo ha sostituito. Disponibile dal 2002 con licenza Open Source, il formato non ha mai avuto un fornitore che ne contasse le installazioni, quindi una popolazione dedotta è l’unica popolazione che esista.

Il risultato è un gruppo di siti specifico e un po’ singolare. A ottobre 2026 troviamo questi residui su 56 siti, che corrispondono a manuali, libri, riferimenti API e documentazione di progetti pubblicati direttamente da una toolchain invece che attraverso un sistema di contenuti a cui qualcuno accede con le proprie credenziali. Il numero non dice nulla su quante persone scrivano in questo formato. Il numero descrive quanti risultati pubblicati hanno conservato le impronte della toolchain invece di essere rivestiti di uno stile che li rende irriconoscibili.

I dati di versione rendono visibile quella pipeline. Nella popolazione registriamo 14 versioni distinte, e la versione 8.6.9 ricorre abbastanza spesso da far pensare a documenti congelati nel momento in cui sono stati generati più che a siti ricostruiti a intervalli regolari. Un risultato pubblicato non si aggiorna da solo. Un sito di documentazione continua a servire lo stesso HTML finché qualcuno non lo rigenera, quindi qui la dispersione delle versioni si legge come una cronologia delle date di build più che come una curva di aggiornamento.

Per chi mappa gli strumenti per sviluppatori, l’implicazione vale più del conteggio. Un sito che porta questa impronta appartiene a un progetto con documentazione scritta, una fase di build e di solito un pubblico tecnico, il che ne fa un indicatore discreto di un certo tipo di organizzazione tecnica e un indicatore scadente di qualsiasi altra cosa.

La sottostima è grave e va detta chiaramente. Chi pubblica applicando un tema personalizzato, rimuovendo i tag del generatore o facendo passare il risultato attraverso un generatore di siti statici sparisce dal conteggio, quindi l’uso reale del formato supera ciò che il rilevamento riesce a vedere di un fattore che nessuno può misurare. Un elenco scaricabile offre il sottoinsieme identificabile, completo, in un unico file, con i domini associati. Una ricerca per dominio può confermare un’intuizione su un singolo host di documentazione. Solo l’elenco completo permette di chiedersi quali organizzazioni pubblichino in questo modo, come quell’insieme si sovrapponga al resto del loro stack e dove una toolchain abbia smesso, senza clamore, di ricevere manutenzione.