this.Mode = Modes.Rant;
Существуют огромные проблемы почти со всеми форматами файлов справки, потому что создатели (как правило, Microsoft для довольно многих из них), кажется, не хотят выполнять работу больше, чем просто слегка , достаточно хороший для их собственное использование.
Я не могу сказать вам, сколько раз новый формат HXS полностью скрывал мою помощь Visual Studio при интеграции сторонних разработчиков. Вы могли бы сказать, что это вина сторонних инсталляционных инструментов, но в течение некоторого времени не было никакой документации о том, как это сделать, поэтому им пришлось выбирать между реверс-инжинирингом (и ошибкой, иногда) или вообще не интегрируется. Я до сих пор не знаю, работает ли интеграция, но сейчас я просто переключаю Visual Studio, чтобы использовать онлайн-справку. В основном это работает, в то время как встроенная справка неизменно падает на тот индикатор выполнения, который блокирует Visual Studio до тех пор, пока он не перестроит файл справки, за исключением того, что это не так, потому что файлы теперь повреждены, поэтому каждый раз, когда я нажимаю F1, Visual Studio просто блокируется, если я не убью программу DEXPLORE сколько угодно раз.
Как это закончилось как решение любой проблемы, я до сих пор не знаю.
Во-вторых, инструменты должны присутствовать. Средство просмотра CHM присутствует в предварительной версии, а не в Vista, но инструменты, необходимые для отображения HXS, отсутствуют в предварительной версии, но я полагаю, что они находятся в Vista. Хорошо, теперь у меня есть выбор между использованием одного формата, который необходимо установить на компьютере пользователя, или ... ошибочно, другого, который необходимо установить на компьютере других пользователей. Верно.
this.Mode = Modes.JustTicked;
Где я работаю, мы отправляем файлы CHM и HTML-версию на основе файлов для тех, кто развертывает свои приложения через общий сетевой ресурс. Что касается Vista, мы еще не видели этого, но html-версия тоже подойдет.
Я бы предпочел блестящий справочный файл .
Хорошим результатом html-версии является то, что мы можем ссылаться на те же файлы в веб-модуле, который следует за нашим продуктом. Таким образом, будет только одна версия, которая нужна клиенту.
Мы смотрим на обновление инструмента, который мы используем на работе, поэтому в моем расписании на эту неделю, приятно и тихо на работе, я буду смотреть на различные типы выходных данных, которые он может производить, среди прочего HXS.
Редактировать : Хм, быстрый взгляд на страницы справки для справки и руководства, продукта, который мы используем, имеет это сказать о HXS :
Справка Visual Studio также называется MS Help 2.0. Первоначально этот формат справки был задуман как преемник справки HTML. Однако затем Microsoft отложила выпуск на неопределенный срок, и теперь стало ясно, что он никогда не будет выпущен в качестве справочного формата для обычных пользовательских приложений.
Обратите внимание, что это специальный формат справки, который используется только для документирования сторонних программных компонентов, предназначенных для интеграции в Visual Studio .NET. Он не подходит для каких-либо других целей и не может использоваться для обычных проектов справки для прикладных программ!
Полагаю, тогда HXS полностью сошел со стола.
Примечание : веб-интерфейс не обязательно означает, что вам нужен веб- сервер , только то, что вам нужен веб- браузер . Независимо от того, интегрируете ли вы его в свое приложение, используете компонент веб-браузера или просто запускаете браузер пользователя по умолчанию, это будет выбор, который вам придется сделать, но большинство выводимых справок через Интернет, которые я видел, не требуют каких-либо настройка сервера вообще.