La maggior parte degli strumenti di documentazione esporta HTML statico. MkDocs, Sphinx, Docusaurus, Hugo, un riferimento API generato: il risultato è una cartella autonoma, progettata per funzionare senza connessione. È esattamente ciò che serve in aereo, nel seminterrato di un datacenter o da un cliente il cui wifi rifiuta il tuo portatile.
Resta da aprirla sul tablet che hai portato.
Il riflesso è esportare la documentazione in PDF. Funziona, e per un documento breve è spesso la scelta giusta. Ma una documentazione tecnica perde molto nella conversione.
Eppure l'esportazione HTML esiste già, e contiene tutto questo.
Pagira apre la cartella di esportazione come farebbe un browser: la barra laterale, i link tra le pagine, l'evidenziazione del codice. Consulti la documentazione, non una fotografia della documentazione.
Una documentazione generata pesa spesso diverse centinaia di megabyte, immagini e font compresi. Messa su iCloud Drive, si scarica mentre leggi, senza attesa prima che compaia la prima pagina.
Prima di una trasferta, scarica una copia offline permanente. Il download è riprendibile, quindi un'interruzione non ricomincia da capo, e un banner chiarisce cosa resta consultabile senza rete. Vedi streaming da iCloud Drive o copia offline.
C'è l'offline subito e l'offline preparato. Se sai già quali sezioni consulterai, salvale nella lista di lettura prima di partire. Ogni elemento è conservato come istantanea completa e non come segnalibro, quindi resta leggibile anche se la cartella d'origine si sposta. Vedi la lista di lettura.
Una documentazione aziendale mescola quasi sempre pagine HTML e PDF: una specifica, uno schema di architettura, un allegato contrattuale. Entrambi si aprono nella stessa app, e un link da una pagina a un PDF si apre sul posto.
Lo streaming da iCloud evita di dover scaricare tutto in una volta. Per l'offline completo, il limite è lo spazio disponibile sul dispositivo.
Non viene inviato nulla. Tutto è reso in locale, che è proprio l'argomento contro un servizio online di visualizzazione documenti.
Sì, una sola app copre entrambi, e gli elementi recenti permettono di riprendere un documento iniziato sull'altro dispositivo.
Dal menu di condivisione, con Apri con Pagira, da File o da qualsiasi app. Vedi aprire da qualsiasi punto.