Jamdesk Documentation logo

Journal des modifications

Les nouveautés de Jamdesk, plateforme docs-as-code pour MDX, GitHub et API. 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. Générez l'intégralité de votre site de documentation en un seul PDF depuis Paramètres → Exports PDF dans le dashboard. Réservé aux plans payants. 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 une fois le rendu terminé.

Specs OpenAPI multilingues. Les pages d'endpoint affichent désormais des specs OpenAPI traduites en parallèle du MDX traduit. Déposez un fichier <spec>.<lang>.<ext> (ex. : openapi/api.fr.yaml) à côté de votre spec source et Jamdesk l'utilise sur les URLs de cette langue, en revenant à la spec anglaise si une variante linguistique est absente. Les résumés d'opérations, descriptions de paramètres, descriptions de réponses et descriptions de schémas sont tous localisés. Configuration : Traduction des specs OpenAPI.

Composant Visibility. Le nouveau composant <Visibility for="humans|agents"> permet de réserver du contenu aux lecteurs humains ou aux 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 qui envoient Accept: text/markdown sur des URLs canoniques obtiennent automatiquement la vue agent.

Protection par mot de passe, refonte. 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 du dashboard vous guide pour définir, renouveler et révoquer le mot de passe. Les visiteurs accèdent à un écran de déverrouillage personnalisé avec le logo de votre site, la couleur principale et un indice optionnel défini dans docs.json. Guide de configuration : Protection par mot de passe.

Conversion automatique des images en WebP. Jamdesk peut convertir vos images PNG et JPG en WebP lors 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 des pages sans traitement manuel des images. Activez cette option via images.convertToWebp: true dans docs.json. Les favicons, og:image et twitter:image conservent leur format d'origine pour la compatibilité avec les crawlers de 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. Conversion automatique des images →

API Playground. Les pages d'endpoint disposent désormais d'un bouton « Essayer » interactif. Renseignez les paramètres, observez 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. Compatible avec OpenAPI et les endpoints rédigés en MDX.

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 schémas de navigation et des commandes CLI. Installation en deux étapes depuis le marketplace de plugins. Fonctionne avec CLAUDE.md et le serveur MCP pour la rédaction de documentation assistée par IA.

Avertissements de build pour le branding manquant. Les builds émettent désormais un avertissement lorsque les chemins favicon ou logo dans docs.json référencent des fichiers absents de votre projet. Les avertissements apparaissent dans les détails du build du dashboard et dans le CLI via jamdesk dev et jamdesk validate. Aucun e-mail ; l'avertissement est purement informatif.

YouTube Shorts. Le composant <YouTube> prend désormais en charge les Shorts verticaux via la prop short, affichant un lecteur centré en 9:16 sans bandes noires. Utilisez <YouTube id="VIDEO_ID" short />.

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.

Analytics. Suivi d'analytics de pages sans cookies mesurant les vues, les sources de trafic et les tendances des visiteurs avec détails par page. Aucune bannière de consentement requise. Aperçu : Analytics.

Intégrations. Google Analytics 4, Google Tag Manager, Plausible Analytics, et notifications de build Slack (Pro).

Flux RSS pour les changelogs. 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.

Connexion et déploiement 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 en cas de fichiers sensibles, et diffuse la progression du build en ligne.

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 ou ajouter des mots à votre liste d'exclusions.

Intégration de vidéos. Intégrez directement des fichiers .mp4 et .webm dans votre documentation. Déposez-les dans un répertoire /videos et utilisez la syntaxe Markdown (<Video src="/_jd/videos/demo.mp4?v=mp4qj7v2" title="Demo" />) ou le composant <Video> pour l'autoplay, la lecture en boucle et d'autres contrôles.

JavaScript personnalisé. Ajoutez des scripts côté client pour des widgets de chat, des analytics ou des intégrations tierces via styling.js dans docs.json.

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, disponible sur tous les plans.

Intégration IA. Chaque site génère llms.txt pour les fenêtres de contexte des LLM, expose le Markdown brut sur les URLs .md, et inclut un serveur MCP à /_mcp avec les outils searchDocs et getPage. Guides de configuration pour Claude Code, Cursor, et Codex. Également : 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 cassés, jamdesk migrate pour convertir depuis Mintlify/GitBook/Docusaurus, jamdesk doctor pour les problèmes de configuration. Installation via npm, curl ou Homebrew. Référence complète →

Extension VS Code. Démarrez, arrêtez et redémarrez le serveur de développement depuis la barre d'état VS Code, sans terminal.

Vérification de domaine personnalisé par TXT. Tous les domaines personnalisés requièrent désormais un enregistrement TXT (_jamdesk.votredomaine.com) avant l'activation du routage. Cela prévient 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. Consultez le guide des domaines personnalisés.

Support multilingue. Définissez des arborescences de navigation et des répertoires de contenu distincts par locale. Les lecteurs changent de langue depuis un menu déroulant dans la barre supérieure.

Analytics de recherche. Ce que les lecteurs recherchent, les requêtes sans résultat, et les résultats effectivement cliqués. Utile pour identifier les lacunes de contenu.

Jamdesk est lancé. Rédigez la documentation en MDX, poussez sur GitHub, 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 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. Aperçu des composants →

Documentation OpenAPI. Générez des pages de référence API à partir de votre spec OpenAPI via api.openapi dans docs.json.

Déploiement. Déploiement automatique depuis GitHub à chaque 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 surcharges de style. Navigation flexible avec onglets, groupes et icônes. Redirections avec correspondance exacte et par joker.

Recherche et SEO. Recherche plein texte Cmd+K, sans configuration. Sitemaps, images OG et méta par page inclus d'emblée.

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.


Rester informé

Blog Jamdesk

Annonces détaillées et tutoriels

GitHub Releases

Notes de version du CLI