4

Pour l'application Web sur laquelle nous travaillons actuellement, nous devrons réfléchir à la manière de la déployer dans différents groupes d'utilisateurs. D'un point de vue fonctionnel, il est important de disposer d'un système de documentation pouvant être utilisé pour générer un guide de l'utilisateur et une aide contextuelle à partir des mêmes fichiers source.Structure extensible pour l'aide contextuelle dans une application Web

Nous avons prévu d'utiliser DITA comme système de documentation et pensons maintenant à une manière simple et extensible de laisser les développeurs spécifier des éléments qui fournissent une aide contextuelle et qui peuvent être remplis par les rédacteurs techniques et les formateurs.

Basé sur DITA, nous souhaitons générer un guide utilisateur en PDF et une aide contextuelle intégrée dans une application Web basée sur JSP. Quelles recommandations avez-vous?

Nous sommes déjà en train d'évaluer une application commerciale qui présente les caractéristiques suivantes outil

  • auteur pour identifier les éléments sur une page Web qui sera rempli avec des informations d'aide
  • intégration
  • avec les systèmes de gestion de l'apprentissage
  • support pour les applications qui ne sont pas sur le web-

avez-vous des recommandations cadres? En plus de ce qui précède, ce qui suit serait grand

  • intégrer DITA (de quelque manière concevable)
  • contenu spécifique du groupe d'utilisateurs
  • (utilisateur récupéré de l'application Web)
  • peut être utilisé à l'intérieur d'un simple l'application Web pour afficher (html) infobulles
  • association
  • contexte d'aide à la hiérarchie suivante: application> Page> élément HTML (id?)
+0

Avez-vous déjà trouvé une solution? Nous cherchons à faire quelque chose de similaire. –

+0

Malheureusement rien de ce qui pourrait être appelé une solution acceptable. Nous avons introduit un cadre d'instruction propriétaire en plus de notre application, car le client utilise déjà ce framework pour d'autres solutions. Je ne le recommanderais à personne, car cela augmente le coût de maintenance du système d'aide. – Kariem

Répondre

1

DITA est une architecture de document, pas un outil. Ainsi, il ne limite pas vos choix pour un outil de création, ou pour produire de l'aide PDF et en ligne à partir de votre source DITA. Le type d'aide en ligne que vous avez à l'esprit n'est pas clair, mais il semble que vous souhaitiez que les pages HTML puissent être affichées par l'application elle-même plutôt qu'un tripane comme CHM.

Plusieurs outils génèrent vos sorties depuis DITA. Le DITA-OT (Open Toolkit) est un outil FOSS sur Sourceforge qui peut faire XSL-FO, à partir de laquelle vous pouvez produire des PDF, et aussi HTML, CHM, et quelques autres. Puis il y a gratuitement DITA2Go http://dita2go.com qui fait Word RTF pour la production PDF, ainsi que HTML et plusieurs formes d'aide en ligne; il utilise l'attribut d'ID de rubrique en tant que partie (ou tout, si vous le souhaitez) des noms de fichier HTML. De plus, il existe des programmes commerciaux, mais pas avec beaucoup d'avantages sur DITA2Go. Il est préférable de ne pas considérer le format PDF comme un format de diffusion d'aide en ligne, mais simplement comme une version que les clients peuvent imprimer et utiliser comme copie papier. Et les info-bulles s'adressent plus à votre application Web qu'à un outil de génération d'aide.

+0

Bienvenue dans Stack Overflow!Merci d'avoir posté votre réponse! Veuillez vous assurer de lire attentivement la [FAQ sur l'autopromotion] (http://stackoverflow.com/faq#promotion). Notez également qu'il est * obligatoire * que vous publiez une clause de non-responsabilité chaque fois que vous créez un lien vers votre propre site/produit. –