Esportazione PDF

Esporta il sito della documentazione come un unico PDF dalla dashboard. Jamdesk genera in un solo file tutte le pagine pubblicate. Quando il file è pronto, ti invia via email un link per il download. Il PDF resta disponibile per essere scaricato di nuovo fino alla successiva build della documentazione.

L'esportazione in PDF è utile per:

• Condividere la documentazione con revisori che non hanno accesso alla dashboard
• La lettura offline su aerei, in strutture riservate o presso i siti dei clienti
• Snapshot per conformità e audit a un commit specifico
• Pacchetti di consegna ai clienti

Chi può usarlo

L'esportazione in PDF è inclusa in ogni piano a pagamento senza costi aggiuntivi. Non c'è alcun add-on da acquistare. Ogni progetto può generare fino a 3 PDF al giorno. Il contatore si azzera a mezzanotte UTC.

Generare un PDF

Progetti multilingue

Accanto al pulsante Genera PDF compare un menu a tendina delle lingue quando docs.json contiene più di una lingua.

{
  "navigation": {
    "languages": [
      { "language": "en", "default": true },
      { "language": "es" },
      { "language": "fr" }
    ]
  }
}

Ogni esportazione copre una sola lingua. Esporta ciascuna lingua in sequenza per inviare tutte e tre a un revisore: en, poi es, poi fr.

Caching e rigenerazione

La pagina Impostazioni ricorda solo l'esportazione completata più recente per progetto. Rigenera verifica se l'ultima esportazione corrisponde alla build attuale e alla lingua richiesta:

• Stessa build e stessa lingua → Jamdesk restituisce immediatamente il PDF dalla cache. Un avviso indica che non ci sono modifiche dall'ultima esportazione.
• Nuova build o lingua diversa → viene avviato un nuovo rendering. Fare clic su Ricostruisci conta come nuova build, anche se il commit non è cambiato.

La cache contiene una sola esportazione. Esportare una seconda lingua o una nuova build la sostituisce. Il PDF precedente non viene eliminato, ma non è più mostrato nella pagina Impostazioni.

Per ottenere un PDF aggiornato dopo aver modificato la documentazione:

Rigenera può essere cliccato spesso senza problemi. Non esegue nuovamente il rendering né reinvia email senza una nuova build.

Limitazione della frequenza

Ogni progetto ha due limiti:

• 3 esportazioni completate al giorno: il contatore si azzera a mezzanotte UTC. La dashboard mostra quante ne hai già usate.
• 5 minuti tra un'esportazione e l'altra: le richieste effettuate entro questo intervallo restituiscono Riprova tra qualche minuto.

Le risposte dalla cache (stessa build e stessa lingua dell'esportazione precedente) non vengono conteggiate in questi limiti.

Jamdesk considera obsoleto un PDF che è ancora in generazione dopo venti minuti. Fai clic di nuovo su Genera PDF per rimetterlo in coda.

Cosa viene esportato

Il PDF include tutte le pagine elencate nella navigazione di docs.json per la lingua scelta, nell'ordine di dichiarazione. I link esterni nella navigazione vengono ignorati. Le pagine orfane (file presenti nel repository ma non collegati alla navigazione) non vengono incluse.

Jamdesk esegue il rendering di ogni pagina dallo stesso URL che visita un lettore (https://<slug>.jamdesk.app/<path>). Tutto ciò che appare nel browser appare anche nel PDF.

Siti protetti da password

L'esportazione in PDF non funziona su un sito protetto da password. Disattiva la protezione con password per eseguire l'esportazione. Riattivala successivamente.

Consegna via email

La persona che ha fatto clic su Genera PDF riceve un'email quando il PDF è pronto. L'email contiene un link alla sezione Impostazioni → Esportazioni PDF e riporta il numero di pagine, la data e l'ora e la lingua (per i progetti multilingua). La dashboard passa in tempo reale allo stato pronto. Per scaricare il file non è necessaria l'email.

Solo chi ha richiesto l'esportazione riceve l'email. Gli altri collaboratori vedono il nuovo PDF la volta successiva in cui aprono la pagina Impostazioni.

Durata del link di download

I link di download inviati via email sono validi per 72 ore dal momento in cui il PDF è completato. La dashboard crea un nuovo URL ogni volta che apri la pagina Impostazioni. I download dalla dashboard non scadono. Se un link dell'email restituisce 403, fai clic su Scarica PDF nella dashboard.

Risoluzione dei problemi

Cosa fare dopo?