Comment intégrez-vous de l'aide dans votre application WPF? Des recommandations?

Question

La question dit tout vraiment. Si vous écrivez une application WPF, comment intégrez-vous l'aide de l'application? Quel est l'état des lieux à la mi-2013?

Il semble qu'il n'y ait pas de réponse claire à cette d'un après-midi avec un moteur de recherche, mais plusieurs options:

1. Écrivez votre propre aide à base d'info-bulle de fantaisie (mais où en êtes-vous vos données à partir?

2. Utilisez les fichiers .CHM et le système d'aide Windows Forms (cela me semble archaïque). Utilisez Microsoft Help Viewer 1.X ou Aide Microsoft 2.0.

   • Il existe une certaine confusion quant à savoir lequel est le plus récent/approuvé par MS. Il apparaît Help Viewer 1.X peut être l'option recommandée sur Microsoft Help 2.0. Cela n'aide pas que les noms sont si semblables ...
   • Quel est le statut de 2.0? Devrions-nous l'utiliser? A-t-il déjà été entièrement déployé?

3. Utilisez un produit tiers à l'auteur vos fichiers d'aide et un lien vers eux en quelque sorte - DocToHelp/Nethelp, NetAdvantage aide en ligne, etc ...

De plus, ce que XAML base balisage/attributs utilisez-vous pour fournir le contexte nécessaire? Quelle est la méthode recommandée?

Il semble surprenant qu'il n'existe aucun chemin clair pour la prise en charge de l'aide basée sur les applications dans WPF.

Answer 1

Ma préférence actuelle consiste à utiliser un système d'aide tiers pour générer une aide HTML.

Nous utilisons ensuite un WebBrowser pour afficher cette aide si nécessaire. Le système de création que nous utilisons facilite l'extraction d'une seule page de l'aide principale (chaque "sujet" est un fichier HTML unique, et peut être inclus avec le contenu complet ou non). Certes, cela semblait vraiment un peu un hack méchant au début - mais une fois que nous avons écrit la plomberie de base (certaines propriétés attachées pour xaml pour spécifier les attributs pour l'emplacement du contexte et ajouter un comportement pour déclencher l'aide, etc.), nettoyer. Cependant, un avantage unique de cette approche est qu'un système d'aide unique fonctionne parfaitement dans tous les contextes - nous pouvons inclure la documentation en ligne, l'exposer localement pour une utilisation dans un navigateur, et l'utiliser avec le contexte depuis notre application directement.