Как вы интегрируете справку в ваше приложение WPF. Любые рекомендации?

Question

Вопрос говорит все это действительно. Если вы пишете приложение WPF, как вы интегрируете справку приложения? Каково состояние игры в середине 2013 года?

Кажется, что нет однозначного ответа на этот вопрос после полудня с поисковой системой, но есть несколько вариантов:

1. Напишите свою собственную причудливую подсказку на основе подсказок (но откуда вы берете свои данные?)

2. Используйте файлы.CHM и справочную систему Windows Forms (мне кажется, это архаично).

3. Используйте Microsoft Help Viewer 1.X или Microsoft Help 2.0.

   • Существует некоторая путаница относительно того, что является более недавним / одобренным MS. Похоже, что Help Viewer 1.X может быть рекомендованным вариантом по сравнению с Microsoft Help 2.0. Не помогает, что имена так похожи...
   • Каков статус 2.0? Должны ли мы использовать это? Был ли он когда-либо полностью развернут?

4. Используйте сторонний продукт для создания своих файлов справки и ссылки на них каким-либо образом - DocToHelp/NetHelp, интерактивная справка NetAdvantage и т. Д...

Кроме того, какую разметку / атрибуты на основе XAML вы используете для обеспечения необходимого контекста? Какой метод рекомендуется?

Кажется удивительным, что нет четкого пути для поддержки справки на основе приложений в WPF.

Answer 1

В настоящее время я предпочитаю использовать стороннюю систему авторизации справки для создания справки на основе HTML.

Затем мы используем WebBrowser отображать эту помощь по мере необходимости. Используемая нами система авторинга позволяет довольно легко извлечь отдельную страницу из главной справки (каждая "тема" представляет собой один файл HTML и может быть включена с полным содержимым или не по желанию).

Конечно, поначалу это определенно выглядело как неприятный хак - но как только мы написали базовую схему (некоторые прикрепленные свойства для xaml, чтобы указать атрибуты для расположения контекста и добавить поведение для запуска справки и т. Д.), Это довольно чисто.

Однако одним очень приятным преимуществом этого подхода является то, что сборка единой справочной системы прекрасно работает во всех контекстах - мы можем включить документацию в режиме онлайн, предоставить ее локально для использования в браузере и использовать ее с контекстом непосредственно из нашего приложения.