Nel mentre che, in questo nuovo round dell’estate attuale (“mese di agosto – inizio”), praticamente tutte le persone sulla faccia della Terra di stato socioeconomico comparabile al mio si divertono, io rimango inevitabilmente in questo mio stato di sofferenza semi-indefinito… ma non sono da sola. Infatti, a farmi compagnia, sulla base della mia sempreverde necessità di sviluppare ancora nuovi progetti magici (top secret!!!) così come migliorare quelli esistenti, c’è da un lato il fottuto CSS… e dall’altro i generatori di siti per documentazione basati su JavaScript, che mi trovo a dover usare ma mi lasciano semplicemente esterrefatta. 😾
Il punto bello di questi affari è che sono molto più comodi dei generatori di siti statici più classici, per creare documentazione di roba frontend, incluso il testare tutto strada facendo… usando rendering sia client-side che server-side, la robetta che si scrive cambia in automatico nel browser, senza ricaricare la pagina, così come anche gli stili e la struttura effettiva della pagina: è goduria. Purtroppo, il brutto è che, chissà perché, sono (quasi) tutti fottutamente rotti!!! E non generatori mezzi sconosciuti e abbandonati (perché ovviamente quelli non escono proprio, cercando tra consigli o classifiche), o applicando temi di terze parti vecchi e marci (quelli danno problemi pure sui generatori della Madonna)… ma la roba più popolare. Ma non c’è nemmeno molto da dire a riguardo, perché il modo in cui è tutto fuori posto è semplicemente così anticlimatico… 💔
Per esempio, per una roba adesso (…cioè l’altra sera, abbiate pazienza) volevo tentare VuePress, perché sembrava abbastanza rapido modificare il layout a partire dal tema di base… e si, di per sé funziona, ma ho dovuto buttare via tutto appena ho visto che qualsiasi HTML indentato io inserissi in pagine di documentazione Markdown veniva renderizzato come blocchi di codice formattato. Lo specificare blocchi di codice con la sola indentazione, anziché con i caratteri di contenimento (```), è una funzione di Markdown, però non dovrebbe attivarsi per dell’HTML innestato prima in un contenitore HTML che non è indentato… e, dovrei poter disattivare la funzione completamente… Purtroppo, non solo nessuna IA ha saputo suggerirmi una via che funzionasse per farlo, ma la documentazione di VuePress passa dall’incompleto al rotto: le spiegazioni su queste cose più specifiche sono parziali e poco comprensibili, e la documentazione in sé è per qualche motivo copiata su più siti, alcuni più o meno aggiornati, da cui si hanno link a pagine interne non più esistenti… WTF??? ☠️
A seguire, come seconda idea, avrei provato VitePress — che è praticamente un mezzo clone di VuePress, usa le stesse tecnologie — ma quello invece attualmente è proprio rotto e basta: qualunque configurazione io scegliessi, con lo script di creazione rapida, il sito risultante dava errore 404 ad ogni cazzo di pagina, sia con la home che i miei file Markdown… vai a capire che minchia hanno rotto in upstream! E poi ne ho trovato un altro apparentemente simpatico, RsPress — che, come suggerisce il nome, è basato in parte su Rust, anche se non ho ben capito in che misura — che però da errore ad installarsi su Termux, perché vuole usare npm per tirarsi appresso dipendenze native (EW!), ma per la stringa della piattaforma (android-qualcosa-aarch64) non trova niente… (E menomale che per questo caso ero fuori casa, quindi da telefono e non da PC come per i due prima; sarebbe stato un problema se avessi scoperto che su Android non gira solo dopo averlo visto funzionare su desktop!) 🦧
Quindi, alla fine dei conti, tra tutti questi generatorini, quello su cui finisco sempre per ripiegare è Docusaurus… che, grazie al cielo, funziona e basta. Non perché è scritto in React, ma perché è mantenuto da Meta, anziché da dei completi scappati di casa (e menomale che i prodotti open-source li fanno curati, a differenza di quelle lote fumanti di Facebook, Instagram e WhatsApp!). Tenderei a pensare sia meno personalizzabile, perché sembrano esserci pochi temi di terze parti in giro… eppure, pur col solo meccanismo interno dello swizzle, senza duplicare l’intero tema (che è sempre una cosa grossa in più da mantenere personalmente), ho fatto in un attimo quello che mi serviva — e poi ancora altre cose uscite strada facendo. Quindi boh, dai, bene così, che almeno una (1) cosa che funziona c’è a questo mondo… (oltre ad alcune librerie JavaScript per creare questi siti, che però di per sé non sono programmi già pronti, e io tempo da perdere non ne ho.) 🦖🦕🐊🐉!!!
Every Mario Game on Nintendo Switch in 2025