Export PDF

Exportez votre site de documentation en un seul PDF depuis le dashboard. Jamdesk compile chaque page publiée en un seul fichier, vous envoie un lien de téléchargement par e-mail lorsqu'il est prêt, et conserve le PDF disponible pour un nouveau téléchargement jusqu'au prochain build.

L'export PDF est utile pour :

• Partager la documentation avec des relecteurs n'ayant pas accès au dashboard
• La lecture hors ligne dans un avion, dans des installations sécurisées ou chez des clients
• Les instantanés de conformité et d'audit à un commit précis
• Les paquets de remise client

Qui peut l'utiliser

L'export PDF est disponible sur chaque plan payant. Aucun module complémentaire, aucun frais supplémentaire. Chaque projet peut générer jusqu'à 3 PDF par jour, le compteur se réinitialisant à minuit UTC.

Générer un PDF

Projets multilingues

Si votre docs.json comporte plusieurs langues configurées, un menu déroulant de sélection de langue apparaît à côté du bouton Générer un PDF.

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

Chaque export couvre une seule langue. Pour envoyer les trois à un relecteur, choisissez en, exportez, puis es, exportez, puis fr.

Mise en cache et Regenerer

La page Paramètres ne conserve que le dernier export terminé par projet. Lorsque vous cliquez sur Régénérer, Jamdesk vérifie si le dernier export correspond à la fois au build actuel et à la langue demandée :

• Même build et même langue → le PDF en cache est renvoyé immédiatement. Vous verrez un avis expliquant que rien n'a changé depuis votre dernier export.
• Nouveau build ou langue différente → un nouveau rendu est lancé. Cliquer sur Reconstruire compte comme un nouveau build, même si le commit est inchangé.

Le cache n'étant qu'un seul emplacement, exporter une deuxième langue ou un nouveau build remplace ce qui s'y trouvait. Le PDF précédent n'est pas supprimé, mais il n'est plus celui affiché sur la page Paramètres.

Pour obtenir un PDF actualisé après avoir mis à jour votre documentation :

Régénérer peut être cliqué librement sans risque. Si aucun nouveau build n'a été terminé, aucun nouveau rendu ni e-mail ne sera déclenché.

Limitation du débit

Chaque projet a deux limites :

• 3 exports terminés par jour. Le compteur se réinitialise à minuit UTC. Le dashboard affiche combien vous en avez utilisés.
• 5 minutes entre les exports. Les requêtes dans cette fenêtre renvoient Try again in a few minutes.

Les accès au cache (même build et même langue que l'export précédent) contournent ces deux limites, de sorte que les téléchargements répétés d'un PDF inchangé ne se heurtent jamais à la limite.

Un PDF dont la génération dure plus de vingt minutes est considéré comme périmé. Vous pouvez cliquer à nouveau sur Générer un PDF pour le remettre en file d'attente.

Ce qui est exporté

Le PDF inclut chaque page répertoriée dans la navigation de votre docs.json pour la langue choisie, dans l'ordre de déclaration. Les liens externes dans la navigation sont ignorés. Les pages orphelines (fichiers de votre dépôt non reliés à la navigation) ne sont pas incluses.

Chaque page est affichée via la même URL qu'un lecteur visiterait (https://<slug>.jamdesk.app/<path>), de sorte que tout ce qui s'affiche dans le navigateur apparaît dans le PDF.

Sites protégés par mot de passe

Si votre site est protégé par mot de passe, aucun PDF ne sera généré. Désactivez la protection par mot de passe pour lancer l'export, puis réactivez-la ensuite.

Livraison par e-mail

Lorsque le PDF est prêt, la personne ayant cliqué sur Générer un PDF reçoit un e-mail avec un lien vers la section Paramètres → Exports PDF, ainsi que le nombre de pages, l'horodatage et la langue (pour les projets multilingues). Le dashboard lui-même bascule aussi en temps réel vers l'état prêt ; vous n'avez pas besoin de l'e-mail pour télécharger.

Seul le demandeur reçoit l'e-mail. Les autres collaborateurs voient le nouveau PDF la prochaine fois qu'ils ouvrent la page Paramètres.

Duree de vie du lien de telechargement

Les liens de téléchargement par e-mail sont valides 72 heures à compter de la fin de génération du PDF. Le dashboard génère une nouvelle URL à chaque ouverture de la page Paramètres, de sorte que les téléchargements depuis le dashboard n'expirent pas. Si un lien e-mail renvoie une erreur 403, rendez-vous sur le dashboard et cliquez sur Télécharger le PDF.

Dépannage

Et ensuite ?