Файлы справки Windows
В прежние времена справка была не простой, а возможной: сгенерируйте какой-нибудь забавный файл.rtf со специальными тегами, запустите его через компилятор, и вы получите файл WinHelp (.hlp), который действительно работает действительно хорошо.
Затем Microsoft решила, что WinHelp больше не является хип-хопом и переключилась на CHM, вплоть до того момента, когда они фактически отказались от WinHelp из Vista.
Теперь CHM может быть хорошим, но каждый, кто пытался открыть файл.chm в сети, будет знать приятный экран "Переход на веб-страницу был отменен", вызванный ограничениями безопасности.
Хотя есть способы заставить CHM работать вне сети, это вряд ли удачный выбор, потому что, когда пользователь нажимает кнопку "Справка", ему нужна помощь, и ему не нужно делать какие-то прикольные настройки.
Итог: я считаю CHM абсолютно непригодным для использования. Но поскольку WinHelp больше не является опцией, мне интересно, какие есть альтернативы, особенно когда речь идет об интеграции с моим приложением (т. Е. Для WinHelp и CHM есть функции, позволяющие напрямую перейти к теме)?
Недостатком PDF является необходимость использования Adobe Reader (или одного из более легких, которые используют не так много людей). Я мог бы жить с этим видением, так как это является своего рода стандартом в наше время, но можете ли вы сказать ему надежно перейти на заданную страницу / якорь?
HTML-файлы кажутся лучшим выбором, вам просто нужно иметь дело с различными браузерами (CSS и прочее).
Изменить: я ищу, чтобы создать свои собственные файлы справки. Поскольку я являюсь поклонником философии "Нет установки, просто распакуй и запусти", у меня была такая проблема много раз в прошлом, потому что многие из моих пользователей запускали ее из сети, что и вызывает именно эту проблему.
Поэтому я ищу более надежный и ориентированный на будущее способ оказания помощи моим пользователям без необходимости кодировать разные справочные системы для каждого приложения, которое я создаю.
CHM - действительно хороший формат, но это делает Security Stuff непригодным для использования, поскольку предполагается, что справочная система должна предоставлять помощь пользователю, а не создавать еще больше проблем.
1 ответ
Да, в какой-то момент они хотят добавить поведение к своим файлам справки, что делает его проблемой безопасности, и угадайте, что произойдет, средство защиты часто хуже угрозы.
Или это слишком просто или слишком сложно и заменяется чем-то новым, не заботясь о обратной совместимости.
Если вы хотите, чтобы это было действительно просто и строили на века, переходите на.TXT
Вы не указали, в каком коде находятся ваши приложения, так что это зависит.
Если это веб-приложение, лучшим вариантом будет простой HTML, для файла справки вам не нужны специальные функции или javascript, поэтому независимость от браузера должна быть простой. Но также и для настольных приложений HTML, on- или offline часто используются с хорошими результатами.
PDF является другим общим решением, и да, вы можете перейти к конкретным страницам, см. Этот ответ. На каждом компьютере установлен (или должен быть) один клиент или другой, я бы об этом не беспокоился. Я сам никогда не выбираю Acrobat Reader, более быстрые, более сложные и зачастую более качественные решения, мой любимый - Суматра.
Я уверен, что.Net-приложения имеют свою собственную справочную систему (здесь нет опыта), и многие языки имеют опции для отображения всплывающих подсказок, окон или страниц с помощью либо нажатия горячей клавиши (F1), либо щелчка по некоторому диалоговому окну управления.