Export PDF

Exportez votre site de documentation sous forme d'un seul PDF depuis le dashboard. Jamdesk génère chaque page publiée dans 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'à votre prochain build de documentation.

L'export PDF est utile pour :

• Partager la documentation avec des réviseurs qui n'ont pas accès au dashboard
• La lecture hors ligne dans les avions, les installations sécurisées ou chez les clients
• Les instantanés de conformité et d'audit à un commit spécifique
• Les packages de transfert client

Qui peut l'utiliser

L'export PDF est disponible sur tous les plans payants. Aucun module complémentaire, aucun frais supplémentaire. Les projets en essai gratuit voient le bouton mais ne peuvent pas lancer un export avant de passer à un plan supérieur.

Générer un PDF

Projets multilingues

Si votre docs.json comporte plusieurs langues configurées, un menu déroulant de paramètres régionaux apparaît à côté du bouton Générer le PDF.

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

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

Mise en cache et Régénération

La page Paramètres mémorise uniquement l'export complété le plus récent par projet. Lorsque vous cliquez sur Régénérer, Jamdesk vérifie si le dernier export correspond à la fois au build actuel et aux paramètres régionaux demandés :

• Même build et mêmes paramètres régionaux → le PDF en cache est renvoyé immédiatement. Un message vous indique que rien n'a changé depuis votre dernier export.
• Nouveau build ou paramètres régionaux différents → un nouveau rendu est lancé. Cliquer sur Rebuild compte comme un nouveau build, même si le commit est inchangé.

Comme le cache ne dispose que d'un seul emplacement, l'export d'un deuxième paramètre régional ou d'un nouveau build remplace ce qui s'y trouvait auparavant. 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 :

La régénération peut être cliquée sans retenue. Si aucun nouveau build n'est terminé, elle ne relancera pas le rendu ni l'envoi d'e-mail.

Limitation du débit

Vous pouvez produire un export complété par projet toutes les cinq minutes. Les requêtes dans cette fenêtre renvoient Réessayez dans quelques minutes. Le chemin de cache ne tient pas compte de la limitation du débit, donc les téléchargements répétés d'un PDF inchangé n'atteignent jamais la limite.

Un PDF en cours de génération depuis plus de vingt minutes est considéré comme obsolète. Vous pouvez cliquer à nouveau sur Générer le 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 dans votre dépôt qui ne sont pas intégrés à la navigation) ne sont pas incluses.

Chaque page est générée via la même URL qu'un lecteur utiliserait (https://<slug>.jamdesk.app/<path>), donc tout ce qui s'affiche dans le navigateur apparaît dans le PDF. Jusqu'à 10 % des pages peuvent échouer au rendu ; au-delà de ce seuil, l'export est interrompu et vous pouvez réessayer.

Sites protégés par mot de passe

Si votre site est protégé par un mot de passe, l'exporteur PDF ne peut pas le déverrouiller. Le navigateur headless effectuant le rendu ne porte pas de session. Les pages protégées n'apparaîtront pas dans le PDF et comptent dans le budget d'échec de 10 % décrit ci-dessus. Si la majeure partie de votre site est verrouillée, désactivez la protection par mot de passe avant d'exécuter l'export, ou n'utilisez que les pages non protégées.

Envoi par e-mail

Lorsque le PDF est prêt, la personne qui a cliqué sur Générer le 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 les paramètres régionaux (pour les projets multilingues). Le dashboard lui-même passe également à l'état prêt en temps réel ; vous n'avez pas besoin de l'e-mail pour télécharger.

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

Durée de vie du lien de téléchargement

L'URL de téléchargement dans le dashboard et dans l'e-mail est une URL signée à courte durée de vie. Si elle renvoie une erreur 403, rechargez la page Paramètres. Jamdesk génère une nouvelle URL à chaque fois que la page interroge le statut de l'export.

Dépannage

Et ensuite ?