Будущее направление форматов файлов справки

Ответ 1

Что именно заставляет вас думать, что нет окна просмотра по умолчанию .chm в Windows Vista? (Конечно, есть один на моем компьютере, а также на моем ящике Win7)

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

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

Ответ 2

this.Mode = Modes.Rant;

Существуют огромные проблемы почти со всеми форматами файлов справки, потому что производители (как правило, Microsoft для многих из них), похоже, не хотят делать работу больше, чем просто достаточно хорошо для собственного использования.

Я не могу сказать, сколько раз новый формат HXS полностью закрыл мою помощь Visual Studio, когда интегрируются сторонние стороны. Вы могли бы сказать, что это вина сторонних инструментов установки, но в течение довольно долгого времени не было никакой документации о том, как это сделать, поэтому им пришлось выбирать между реверсивным проектированием (иногда ошибочным) или не интегрироваться в все. Я все еще не знаю, работает ли интеграция, но в эти дни я просто переключаю Visual Studio на использование интерактивной справки. Это просто работает, в основном, в то время как встроенная справка неизменно падает на этот индикатор выполнения, который просто блокирует Visual Studio до тех пор, пока он не восстановит файл справки, за исключением того, что это произошло не потому, что файлы теперь повреждены, поэтому в любое время я попадал F1, Visual Studio просто блокируется, если я не убиваю программу DEXPLORE сколько угодно раз.

Как это получилось как решение любой проблемы, я до сих пор не знаю.

Во-вторых, инструменты должны присутствовать. Читатель CHM присутствует на pre-vista, а не на Vista, но инструменты, необходимые для показа HXS, отсутствуют на пре-Vista, но я понимаю, что они находятся на Vista. Приятно, поэтому теперь у меня есть выбор между использованием одного формата, который должен быть установлен на пользовательском компьютере, или... err, другой, который должен быть установлен на других компьютерах пользователей. Правильно.

this.Mode = Modes.JustTicked;

Где я работаю, мы отправляем CHM файлы и файловую версию html для тех, кто развертывает свои приложения через общий сетевой ресурс. Что касается Vista, мы еще ничего не видели, но html-версия тоже работала бы там.

Скорее всего, у меня есть блестящий файл справки.

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

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

Изменить. Хм, быстро просмотрите страницы справки для справки и руководства, которые мы используем, this to о HXS:

Справка Visual Studio также известна как MS Help 2.0. Первоначально этот формат справки должен был стать преемником справки HTML. Тем не менее, Microsoft отложила выпуск на неопределенный срок, и теперь стало ясно, что он никогда не будет выпущен в качестве формата справки для обычных пользовательских приложений.

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

Я предполагаю, что HXS полностью отключен от таблицы.

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

Ответ 3

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

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

Ответ 4

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

По какой-то причине Microsoft просто плоха в файлах справки. Онлайн-справка для Visual Studio/SQL Studio/Office ужасна, MSDN - беспорядок, CHM неудобны, и поиск Microsoft никогда не возвращает желаемых результатов. (Только мое мнение:)

Ответ 5

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

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

Ответ 6

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

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

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