Les nouveautés de Jamdesk, la plateforme docs-as-code pour MDX, GitHub et la documentation API. Sorties de fonctionnalités, mises à jour CLI et changements de plateforme.
Nouvelles fonctionnalités, changements de plateforme et mises à jour CLI pour Jamdesk.
Les captures d'écran montrent l'interface en anglais.
Export PDF. Rendez l'ensemble de votre site de documentation en un seul PDF depuis Paramètres → Exports PDF dans le dashboard. Plans payants uniquement. Les projets multilingues choisissent une locale par export, les résultats sont mis en cache par commit, et vous recevez un e-mail avec un lien de téléchargement à la fin du rendu. Voir Export PDF.
Specs OpenAPI multilingues. Les pages d'endpoint affichent désormais des specs OpenAPI traduites aux côtés du MDX traduit. Déposez un fichier <spec>.<lang>.<ext> (par ex., openapi/api.fr.yaml) à côté de votre spec source et Jamdesk le prend en compte sur les URL de cette langue, avec repli vers la spec anglaise si une variante linguistique est manquante. Les résumés d'opérations, les descriptions de paramètres, les descriptions de réponses et les descriptions de schémas sont tous localisés. Voir Traduire les specs OpenAPI.
Composant Visibility. Le nouveau composant <Visibility for="humans|agents"> vous permet de délimiter du contenu pour les lecteurs humains ou les agents IA sur la même page. Les blocs réservés aux humains s'affichent dans le navigateur mais sont supprimés des exports .md et de llms-full.txt ; les blocs réservés aux agents font l'inverse. Les agents effectuant une requête Accept: text/markdown sur les URL canoniques reçoivent automatiquement la vue agent. Voir Visibility.
Protection par mot de passe, reconstruite. Vous pouvez désormais verrouiller l'ensemble de votre site avec un mot de passe partagé, ou protéger uniquement quelques pages pendant que le reste reste public. Définissez auth.password.enabled: true pour le mode site entier, ou marquez des pages individuelles avec private: true dans le frontmatter (ou listez-les sous auth.password.private) pour le mode pages spécifiques. La page Paramètres dans le dashboard vous guide pour définir, faire tourner et révoquer le mot de passe. Les visiteurs arrivent sur un écran de déverrouillage personnalisé avec le logo de votre site, la couleur principale et un indice optionnel que vous définissez dans docs.json. Voir Protection par mot de passe.
Conversion automatique d'images en WebP. Jamdesk peut convertir vos images PNG et JPG en WebP au moment du build. Les fichiers convertis sont généralement 60 à 80 % plus petits que les originaux sans perte de qualité visible, ce qui accélère le chargement de vos pages sans traitement manuel des images. Activez cette option via images.convertToWebp: true dans docs.json. Les favicons, og:image et twitter:image restent dans leur format d'origine pour la compatibilité avec les robots des réseaux sociaux. Une nouvelle étape Optimisation des images affiche la progression en temps réel dans le dashboard et le CLI lors de chaque build. Voir Conversion automatique d'images.
API playground. Les pages d'endpoint disposent désormais d'un bouton interactif « Essayer ». Renseignez les paramètres, regardez les exemples de code se mettre à jour en temps réel et envoyez des requêtes en direct sans quitter votre documentation. Activé par défaut sur toutes les pages API. Fonctionne avec les endpoints OpenAPI et MDX. Voir API playground.
Plugin Claude Code. Installez le plugin Jamdesk pour Claude Code pour donner à Claude une connaissance approfondie des composants MDX, de la configuration docs.json, des modèles de navigation et des commandes CLI. Installation en deux étapes depuis la marketplace de plugins. Fonctionne avec CLAUDE.md et le serveur MCP pour une rédaction de documentation entièrement assistée par IA.
Avertissements de build pour les éléments de marque manquants. Les builds avertissent désormais lorsque les chemins favicon ou logo dans docs.json référencent des fichiers qui n'existent pas dans votre projet. Les avertissements apparaissent dans les détails du build dans le dashboard et dans le CLI via jamdesk dev et jamdesk validate. Pas d'e-mail ; l'avertissement est uniquement informatif.
YouTube Shorts. Le composant <YouTube> prend désormais en charge les Shorts verticaux via la prop short, affichant un lecteur 9:16 centré sans barres noires. Utilisez <YouTube id="VIDEO_ID" short />. Voir Intégrations YouTube.
Menu Actions IA. Un menu déroulant sur chaque page permet aux lecteurs de copier le Markdown, d'ouvrir la page dans ChatGPT/Claude/Perplexity, de récupérer la configuration du serveur MCP, ou de l'installer en un clic dans Cursor ou VS Code. Activé par défaut ; choisissez les options affichées via contextual dans docs.json. Voir Menu Actions IA.
Analytique. Suivi des analyses de pages sans cookies mesurant les vues, les sources de trafic et les tendances des visiteurs avec des détails par page. Aucune bannière de consentement nécessaire. Voir Présentation de l'analytique.
Intégrations. Google Analytics 4, Google Tag Manager, Plausible Analytics, et notifications de build Slack (Pro).
Flux RSS pour les journaux des modifications. Les pages avec rss: true dans le frontmatter génèrent désormais automatiquement un flux RSS auquel il est possible de s'abonner. Une icône RSS apparaît à côté du titre de la page, et un feed.xml est construit à partir de vos composants Update lors de chaque build. Utilisez la nouvelle prop date sur Update pour des dates de flux correctes. Voir Composant Update.
Connexion & déployer en CLI. jamdesk login s'authentifie via le navigateur, jamdesk deploy package votre projet et déclenche un build depuis le terminal. Aucune connexion GitHub requise. Le CLI respecte .gitignore, avertit des fichiers secrets et diffuse la progression du build en ligne. Voir Authentification et Déploiement CLI.
Vérification orthographique CLI. jamdesk spellcheck vérifie l'orthographe de votre documentation avec plus de 180 termes techniques intégrés (anglais uniquement). jamdesk spellcheck --fix lance un mode interactif pour corriger les fautes de frappe ou ajouter des mots à votre liste d'exclusions. Voir Présentation CLI.
Intégrations vidéo. Intégrez des fichiers .mp4 et .webm directement dans votre documentation. Déposez-les dans un répertoire /videos et utilisez la syntaxe Markdown (<Video src="/_jd/videos/demo.mp4?v=moa8o29o" title="Démo" />) ou le composant <Video> pour la lecture automatique, la boucle et d'autres contrôles. Voir Vidéos.
JavaScript personnalisé. Ajoutez des scripts côté client pour des widgets de chat, des outils d'analytique ou des intégrations tierces via styling.js dans docs.json. Voir JavaScript personnalisé.
Chat IA. Assistant de chat intégré sur chaque site de documentation. Les visiteurs posent des questions et obtiennent des réponses avec des liens de citation vers les pages sources. Propulsé par Claude, activé sur tous les plans. Voir Chat IA.
Intégration IA. Chaque site génère llms.txt pour les fenêtres de contexte LLM, expose le Markdown brut aux URL .md, et inclut un serveur MCP à /_mcp avec les outils searchDocs et getPage. Guides de configuration pour Claude Code, Cursor, et Codex. Voir aussi Rédiger avec l'IA et Mises à jour automatisées.
CLI. jamdesk dev pour la preview locale avec rechargement à chaud, jamdesk validate pour les liens brisés, jamdesk migrate pour convertir depuis Mintlify/GitBook/Docusaurus, jamdesk doctor pour les problèmes de configuration. Installation via npm, curl ou Homebrew. Voir Présentation CLI.
Extension VS Code. Démarrez, arrêtez et redémarrez le serveur de développement depuis la barre d'état VS Code, sans terminal requis. Voir Extension VS Code.
Vérification TXT de domaine personnalisé. Tous les domaines personnalisés nécessitent désormais un enregistrement TXT (_jamdesk.votredomaine.com) avant l'activation du routage. Cela évite la prise de contrôle de domaine sur les sous-domaines non revendiqués. Les domaines nouvellement ajoutés verront l'enregistrement TXT dans le flux de configuration du dashboard. Voir le guide des domaines personnalisés.
Support multilingue. Définissez des arbres de navigation et des répertoires de contenu séparés par locale. Les lecteurs changent de langue depuis un menu déroulant dans la barre supérieure. Voir Support multilingue.
Analytique de recherche. Voyez ce que les lecteurs recherchent, quelles requêtes ne renvoient aucun résultat et ce sur quoi ils cliquent. Utile pour identifier les lacunes de contenu. Voir Analytique de recherche.
Jamdesk est lancé. Rédigez de la documentation en MDX, poussez vers GitHub, et obtenez un site sur un CDN mondial. Les builds se terminent en moins de 60 secondes.
MDX et composants. Plus de 20 composants intégrés : onglets, accordéons, étapes, groupes de code, diagrammes Mermaid, formules mathématiques KaTeX et icônes. Coloration syntaxique avec numéros de ligne dans les blocs de code. Créez des composants React personnalisés avec Tailwind et des hooks, et réutilisez du contenu avec des snippets. Voir Présentation des composants.
Documentation OpenAPI. Générez des pages de référence API depuis votre spec OpenAPI via api.openapi dans docs.json. Voir Exemple OpenAPI.
Déploiement. Déployer automatiquement depuis GitHub au push avec un délai de 10 secondes. Domaines personnalisés avec SSL automatique, hébergement en sous-chemin à /docs (Vercel, CloudFront, Cloudflare, nginx), et support monorepo.
Personnalisation. Trois thèmes (jam, nebula, pulsar) avec couleurs personnalisées, logos et pied de page. CSS personnalisé pour les remplacements de style. Navigation flexible avec onglets, groupes et icônes. Redirections avec correspondance exacte et caractères génériques.
Recherche et SEO. Recherche plein texte Cmd+K, zéro configuration. Sitemaps, images OG et méta par page prêts à l'emploi.
Référence docs.json. Référence de configuration complète pour tous les paramètres et options.
Centre d'aide. Guides de gestion de compte, facturation et dépannage.
