Catégories

Commentaires vers PDF

Genere un PDF de docs depuis les commentaires

Extrait les commentaires JSDoc et genere un PDF.

Entree : code avec /** */
Sortie : PDF

Exemples de résultats

1 Exemples

Exemple : Doc Comment Docs

Exemple PDF genere automatiquement : Source comments rendered as docs PDF

doc-comment-to-pdf-docs-example1.pdf Voir fichier
Voir paramètres d'entrée
{ "sourceText": "/**\n * Adds two values\n * @param {number} a\n * @param {number} b\n */\nfunction add(a,b){ return a+b }", "docTitle": "Utility Docs", "version": "1.0.0" }

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: text/plain, application/octet-stream

Points clés

Catégorie
Document Tools
Types d’entrée
textarea, file, text, number, select, checkbox
Type de sortie
file
Couverture des échantillons
4
API disponible
Yes

Vue d’ensemble

Transformez instantanément vos commentaires JSDoc en une documentation technique professionnelle au format PDF grâce à cet outil de conversion automatisé.

Quand l’utiliser

  • Pour générer rapidement une documentation API à partir de votre code source.
  • Pour partager des spécifications techniques lisibles avec des collaborateurs non-développeurs.
  • Pour archiver des versions documentées de vos bibliothèques de fonctions.

Comment ça marche

  • Copiez votre code source contenant des commentaires JSDoc dans la zone de texte ou téléversez votre fichier.
  • Personnalisez les paramètres de mise en page tels que le format de page, les marges et la taille de la police.
  • Lancez la génération pour convertir les annotations de code en un document PDF structuré et prêt à être partagé.

Cas d’usage

Création de manuels d'utilisation pour des bibliothèques de fonctions internes.
Génération de rapports de conformité technique pour les audits de code.
Préparation de documentation API pour les équipes de développement front-end.

Exemples

1. Documentation d'une bibliothèque utilitaire

Développeur Full-stack
Contexte
Le développeur doit fournir une documentation claire pour une nouvelle bibliothèque de fonctions mathématiques partagée avec l'équipe.
Problème
La documentation manuelle est fastidieuse et risque de ne pas être synchronisée avec le code.
Comment l’utiliser
Coller le code source dans le champ texte et définir le titre sur 'MathUtils API'.
Configuration d’exemple
docTitle: 'MathUtils API', version: '1.0.0', pageSize: 'A4'
Résultat
Un fichier PDF propre et structuré contenant toutes les signatures de fonctions et descriptions de paramètres.

Tester avec des échantillons

pdf, text, file

Hubs associés

FAQ

Quels formats de commentaires sont pris en charge ?

L'outil est optimisé pour extraire et formater les commentaires de style JSDoc (/** ... */).

Puis-je personnaliser le titre du document ?

Oui, vous pouvez définir un titre personnalisé et une version dans les options de configuration.

Quels formats de page sont disponibles ?

Vous pouvez choisir entre A4, Letter, Legal et A5 selon vos besoins d'impression ou de lecture.

Est-il possible d'ajuster les marges du PDF ?

Oui, vous pouvez configurer précisément les marges supérieure, inférieure, gauche et droite en millimètres.

Le rendu PDF inclut-il les styles CSS ?

Oui, l'option 'Imprimer le fond' permet d'inclure les styles de fond et les couleurs définis dans le rendu.

Documentation de l'API

Point de terminaison de la requête

POST /fr/api/tools/doc-comment-to-pdf-docs

Paramètres de la requête

Nom du paramètre Type Requis Description
sourceText textarea Non -
sourceFile file (Téléchargement requis) Non -
docTitle text Non -
version text Non -
baseFontSize number Non -
pageSize select Non -
landscape checkbox Non -
printBackground checkbox Non -
marginTop number Non -
marginBottom number Non -
marginLeft number Non -
marginRight number Non -
waitUntil select Non -
waitTime number Non -

Les paramètres de type fichier doivent être téléchargés d'abord via POST /upload/doc-comment-to-pdf-docs pour obtenir filePath, puis filePath doit être passé au champ de fichier correspondant.

Format de réponse

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Fichier: Fichier

Documentation de MCP

Ajoutez cet outil à votre configuration de serveur MCP:

{
  "mcpServers": {
    "elysiatools-doc-comment-to-pdf-docs": {
      "name": "doc-comment-to-pdf-docs",
      "description": "Genere un PDF de docs depuis les commentaires",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=doc-comment-to-pdf-docs",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Vous pouvez chaîner plusieurs outils, par ex.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 outils.

Prend en charge les liens de fichiers URL ou la codification Base64 pour les paramètres de fichier.

Si vous rencontrez des problèmes, veuillez nous contacter à [email protected]