Matrice de génération, éléments de la bibliothèque de code brut et prise en charge des extraits de code externes dans HelpNDoc 10.7

Nous sommes heureux d’annoncer la sortie de HelpNDoc 10.7, une nouvelle mise à jour conçue pour offrir aux rédacteurs techniques une vision plus claire, une réutilisation plus flexible du contenu et des flux de travail de rédaction quotidiens plus fluides. Cette version introduit une puissante matrice de génération dans l’analyseur de chapitres, permettant de comprendre facilement pourquoi un chapitre est ou n’est pas inclus dans chaque construction d’un projet. Elle améliore également la gestion du contenu réutilisable grâce au nouvel élément de bibliothèque “Code brut” et à la prise en charge des fichiers d’extraits externes, tout en apportant des améliorations importantes à l’éditeur d’images, à l’éditeur de chapitres, à l’éditeur d’équations, à la génération de contenu conditionnel et à la fiabilité globale.

Comme toujours, HelpNDoc est gratuit pour un usage personnel et à des fins d’évaluation ; vous pouvez donc télécharger HelpNDoc 10.7 dès aujourd’hui et découvrir par vous-même toutes ces améliorations.

🧩 Matrice de génération : comprenez exactement pourquoi les chapitres sont exportés

La nouvelle matrice de génération de l’analyseur de chapitres explique pourquoi le chapitre actuellement analysé sera, ou ne sera pas, exporté pour chaque construction du projet.

L’Analyseur de chapitres d’HelpNDoc est un outil indispensable pour comprendre chaque chapitre. Il fournit des statistiques détaillées telles que le nombre de paragraphes, de mots et d’éléments de bibliothèque utilisés dans un chapitre. Il répertorie également les hyperliens, les ancres, les hyperliens entrants, les conditions, les mots-clés, les fautes d’orthographe et même les caractères individuels contenus dans le chapitre.

HelpNDoc 10.7 rend l’Analyseur de chapitre encore plus utile grâce à la nouvelle matrice de génération. Pour le chapitre en cours d’analyse, cette matrice fournit une explication, construction par construction, indiquant si le chapitre sera exporté et pourquoi. Cela s’avère particulièrement utile dans les projets générant plusieurs sorties, telles qu’un manuel d’utilisation public, une base de connaissances interne, un guide au format PDF et une exportation Markdown, chacune avec ses propres règles de visibilité, de statut et de balises.

Pour chaque construction, la Matrice de génération vérifie le chapitre et sa hiérarchie parentale. Si le chapitre lui-même, ou l’un de ses parents, est masqué pour une construction, la matrice indique clairement que le chapitre ne sera pas exporté. Elle vérifie également les règles de statut des chapitres : par exemple, lorsqu’une construction exclut les chapitres marqués comme “En cours”, tout chapitre ou chapitre parent utilisant ce statut sera exclu de ce résultat. Enfin, elle analyse la correspondance des balises intégrées et personnalisées entre les chapitres, les chapitres parents et les constructions, indiquant clairement quand un chapitre est exclu parce qu’il ne correspond pas à la configuration des balises de la construction.

Cela apporte une réponse immédiate à l’une des questions les plus courantes concernant la publication de documentation : “Pourquoi ce chapitre est-il absent de ma sortie ?” Au lieu de vérifier manuellement, un par un, les paramètres de construction, la visibilité des chapitres, celle des chapitres parents, les filtres de statut et les règles de balises, les rédacteurs peuvent désormais consulter l’explication complète en un seul endroit.

🧾 Élément de bibliothèque “Code brut” : code personnalisé spécifique au format pour chaque sortie

L’ancien élément de bibliothèque Code HTML a été renommé et étendu en Code brut, ajoutant la prise en charge du HTML, du Markdown et du contenu de secours au format texte.

L’élément de bibliothèque anciennement appelé Code HTML a été considérablement amélioré dans HelpNDoc 10.7 et s’appelle désormais Code brut. Ce nouveau nom reflète mieux son rôle élargi : au lieu de se limiter au code HTML brut pour les formats de documentation basés sur le HTML, il peut désormais fournir du contenu spécifique à chaque format pour plusieurs types de sortie.

Les éléments “Code brut” peuvent toujours inclure du code HTML pour les formats de documentation basés sur le HTML, tels que CHM, HTML et les formats compatibles avec les liseuses électroniques. Mais ils peuvent désormais également inclure du contenu Markdown brut pour les constructions Markdown, où le code est exporté directement au format Markdown. Pour tous les autres formats de documentation, les éléments “Code brut” peuvent fournir du contenu en texte brut qui est exporté tel quel.

Cela ouvre la voie à une personnalisation de la sortie bien plus précise. Les rédacteurs techniques et les développeurs peuvent désormais définir un seul élément de bibliothèque réutilisable qui s’adapte à la sortie générée. Par exemple, un même bloc conceptuel pourrait générer un widget HTML personnalisé dans un manuel Web, de la syntaxe Markdown brute dans une exportation Markdown, et un texte de secours lisible dans une documentation sous forme de rapports.

En rendant la personnalisation spécifique au format réutilisable via la bibliothèque, HelpNDoc 10.7 aide les utilisateurs avancés à éviter le post-traitement, à réduire les doublons de contenu et à maintenir des projets plus clairs lorsqu’ils ciblent plusieurs formats de documentation à partir d’une source unique.

📚 Prise en charge des extraits externes : partagez du contenu enrichi entre projets

Les extraits peuvent désormais être chargés à partir de fichiers externes lors de la génération, ce qui facilite le partage et la maintenance du contenu en texte enrichi réutilisable entre plusieurs projets.

Les éléments de la bibliothèque “extraits” constituent un moyen puissant de réutiliser du contenu enrichi dans les projets HelpNDoc. Ils peuvent contenir du texte et des paragraphes mis en forme, des hyperliens, des images, des tableaux et d’autres éléments de contenu enrichi pour les chapitres. Jusqu’à présent, les extraits étaient stockés exclusivement dans le fichier de projet HelpNDoc, ce qui les rendait pratiques au sein d’un même projet mais plus difficiles à partager entre plusieurs projets.

HelpNDoc 10.7 introduit la prise en charge des fichiers d’extraits externes. Les extraits peuvent désormais être modifiés et chargés à partir du disque, ce qui leur permet d’exister en dehors du projet. Lors de la génération de la documentation, HelpNDoc charge le contenu des extraits externes à la demande, en utilisant le contenu actuel du fichier au moment de la génération.

Cela simplifie considérablement la réutilisation de contenus en texte enrichi courants entre plusieurs projets. Les équipes peuvent désormais gérer des avertissements, des mentions légales, des instructions d’assistance, des descriptions de produits, des procédures, des clauses de non-responsabilité ou des blocs de documentation réutilisables dans des fichiers externes et y faire référence depuis plusieurs projets HelpNDoc. Lorsque le fichier partagé est mis à jour, chaque projet qui l’utilise peut bénéficier de la dernière version lors de la prochaine génération de la documentation.

🖼️ Améliorations de l’éditeur d’images, de l’éditeur de chapitres et de l’éditeur d’équations

HelpNDoc 10.7 améliore plusieurs processus d’édition courants, avec un meilleur comportement lors du collage d’images, des opérations de copie Markdown plus fiables et une édition d’équations plus rapide.

L’éditeur d’images intégré à HelpNDoc permet d’enrichir facilement les images avec des annotations visuelles telles que des tampons, du texte, des lignes, des formes et d’autres éléments. Dans HelpNDoc 10.7, le collage d’une image lorsque le calque d’arrière-plan est sélectionné offre désormais plus de souplesse : vous pouvez choisir de remplacer l’image d’arrière-plan ou de créer un nouveau calque d’image.

Cela rend l’éditeur d’images plus polyvalent et plus facile à utiliser. Le remplacement de l’arrière-plan est idéal lors de la mise à jour de la capture d’écran ou de l’illustration d’origine, tandis que la création d’un nouveau calque est préférable lorsque vous ajoutez une image collée en tant qu’élément de superposition ou de composition. HelpNDoc vous permet désormais de choisir le comportement approprié au moment du collage, ce qui réduit les erreurs et rend l’édition d’images plus prévisible. Cette version corrige également un problème où le collage d’une image en tant que calque d’arrière-plan pouvait la déformer : le calque est désormais redimensionné correctement pour s’adapter à la nouvelle image collée.

L’éditeur de chapitres bénéficie également d’une amélioration importante du flux de travail Markdown. Lors de la copie du contenu d’un chapitre sélectionné au format Markdown, les images intégrées sont désormais incluses sous forme de données en ligne encodées en Base64. Cela signifie que lorsque le contenu est collé dans un éditeur Markdown tiers, un visualiseur, un outil de suivi des tickets, un outil de prise de notes ou une plateforme de documentation, les images restent disponibles aux côtés du texte au lieu d’être perdues.

Cela offre un flux de travail bien plus fiable lors de l’extraction de contenu depuis HelpNDoc au format Markdown. Cette fonctionnalité est particulièrement utile pour les révisions, la collaboration, la publication rapide de brouillons, les réponses d’assistance, la documentation technique et toute situation où le Markdown copié doit rester autonome sans nécessiter de fichiers image séparés.

L’éditeur d’équations a également été optimisé. Son temps de chargement a été considérablement réduit, en particulier lors de la première ouverture après le démarrage de l’application ; l’édition des équations est donc désormais plus rapide et plus réactive. L’expérience d’édition des équations est également plus fluide grâce à une saisie au clavier virtuel plus fiable, à une navigation du curseur améliorée et à une mise en forme plus précise des expressions accentuées, des parenthèses et des opérateurs de relation.

Plusieurs corrections de fiabilité viennent compléter ces améliorations. Les équations volumineuses éditées s’affichent désormais correctement dans l’éditeur de chapitres, sans recadrage indésirable ni barres de défilement horizontales, et HelpNDoc ne risque plus d’afficher l’équation par défaut E=mc2 à la place de l’équation en cours d’édition. Ensemble, ces améliorations rendent la rédaction mathématique et scientifique plus rapide, plus claire et plus fiable.

🛠️ Autres nouvelles fonctionnalités, corrections de bogues et améliorations

HelpNDoc 10.7 inclut également des corrections sélectionnées pour obtenir un résultat de génération plus propre, des opérations de copie plus fiables et un comportement amélioré de l’éditeur.

La génération de contenu conditionnel a été améliorée : les lignes de marqueurs autonomes IF, ELSE et END sont désormais supprimées proprement sans laisser de lignes vides supplémentaires. Cela permet d’obtenir une documentation générée plus propre et réduit le besoin d’ajustements manuels de mise en forme lorsque l’on utilise intensivement le contenu conditionnel.

Cette version corrige également une erreur “Accès refusé” qui pouvait se produire lors de la copie de contenu de l’éditeur de chapitres contenant des images. La copie de contenu enrichi depuis HelpNDoc est désormais plus fiable, en particulier lors de la gestion de chapitres comportant de nombreuses images ou lors du transfert de contenu entre HelpNDoc et des applications externes.

Comme toujours, la liste complète des modifications est disponible dans les notes de version détaillées ci-dessous.

🚀 Téléchargez HelpNDoc 10.7 dès aujourd’hui

HelpNDoc 10.7 est disponible gratuitement pour un usage personnel et à des fins d’évaluation. Téléchargez-le dès maintenant et découvrez par vous-même les améliorations apportées.

Que vous auditiez des règles de publication complexes à l’aide de la nouvelle matrice de génération, que vous personnalisiez la sortie multiformat avec les éléments de bibliothèque “code brut”, que vous partagiez du contenu enrichi réutilisable via des extraits externes, ou que vous profitiez de processus d’édition et de génération plus fluides, HelpNDoc 10.7 apporte des améliorations concrètes aux rédacteurs techniques travaillant sur des projets de toutes tailles.

👉 Téléchargez HelpNDoc 10.7 dès aujourd’hui et découvrez comment ces améliorations peuvent rendre votre processus de documentation plus clair, plus rapide et plus fiable.