Будущее направление форматов Справочного файла

Для меня CHM является все еще ответом. Я создаю файлы CHM с инструмент Sandcastle Help File Builder , который доступен на Codeplex.

опасения по поводу доступности CHM являются обоснованными. Для обращения к этому я произвел преобразователь CHM к сети довольно легко, с некоторым взламыванием IStorage, текстовым поиском-и-заменой, и XSL преобразовывает. Эта страница является веб-сайтом, который был произведен автоматически приблизительно за 8 секунд. Это имеет расширение/сворачивание treeview на левой стороне военно-морской. Кадры базировались (не очень дружественный URL), но он работает достаточно хорошо.

Единственная полезная документация справки, которую я когда-либо видел, была простым HTML. Большинство, если не все, проектов с открытым исходным кодом я видел, что у всех есть страницы справки HTML (для API и справочных документов). Что-либо, что использует собственный формат или это требует собственного читателя, все рискуют идти устаревшие (CHM) или иметь совместимость или проблемы чрезмерного увеличения размера (PDFs).

По некоторым причинам, Microsoft просто плоха в справочных файлах. Справка онлайн для Visual Studio / Studio/Office SQL ужасна, MSDN является путаницей, CHMs являются неуклюжими, и поиск Microsoft никогда не возвращает результаты, которые Вы действительно хотите. (Просто мое мнение:)

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 2.0. Первоначально этот формат справки был предназначен, чтобы быть преемником Справки HTML. Однако Microsoft затем отложила свой выпуск неограниченно долго, и теперь ясно, что это никогда не будет выпущенным как формат справки для приложений обычного пользователя.

Обратите внимание на то, что это - специальный формат справки, который только используется для документирования стороннего программирования компонентов, разработанных для интеграции в Visual Studio.NET. Это не подходит ни для какой другой цели и не может использоваться для нормальных проектов справки для прикладных программ!

я предполагаю, что HXS полностью закрыт затем.

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

Adobe RoboHelp может использоваться для создания справочного контента, который имеет контент / индекс / поиск / глоссарий и работает в браузере, как созданный в HTML. Поддерживает 35 языков.

У нас есть веб-приложение на основе Flex, которое использует его для управления содержимым справки приложения. Приложение Flex и его справочная система работают в большинстве браузеров в Windows / MacOSX / Linux.

Некоторые обновленные мысли для тех, кто все еще читает этот вопрос ...

Согласно Википедии, Microsoft решила использовать язык разметки Microsoft Assistance после отказа от справки 2.

Существует также справочная система Microsoft , которая поставляется с Visual Studio 2010.

Почему вы думаете, что в Windows Vista нет программы просмотра .chm по умолчанию? (Он определенно есть на моем компьютере, а также на моем компьютере с Win7)

Вы можете спутать .chm с .hlp (Microsoft действительно отказалась от поддержки .hlp в Vista, а затем возобновила ее в обновлении Windows)

Итог: файлы .chm, похоже, все еще поддерживаются во всех версиях Windows, и единственной реальной альтернативой файлам .chm, о которых я знаю, является .html