Windows, файлы справки - какие варианты?

голоса
34

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

Затем, Microsoft решила, что WinHelp не было бедро и прохладно больше и переключился на МП, до точки, они на самом деле колотого WinHelp от Vista.

Теперь, CHM, возможно, хорошо, но все, что пыталось открыть файл .chm в сети будет знать хорошую «Навигацию на веб-страницу отменен» экран, который вызывается ограничения безопасности.

Хотя есть способы, чтобы сделать CHM работать с сети, вряд ли это хороший выбор, потому что, когда пользователь нажимает кнопку Help он хочет помочь, и не должен сделать некоторые напуганные настройки.

Итог: Я считаю CHM абсолютно непригодным для использования. Но не WinHelp быть возможность больше либо, интересно, каковы альтернативы, особенно когда речь идет о интеграции с моим приложением (т.е. для WinHelp и CHM есть функции, которые позволяют непосредственно перейти к теме)?

PDF имеет тот недостаток, требующий Adobe Reader (или один из более легких тех, которые используют не так много людей). Я мог бы жить с этим видением, поскольку это является своего рода стандартом в настоящее время, но вы можете сказать это надежно, чтобы перейти к данной странице / якорь?

HTML-файлы, кажется, лучший выбор, то вы просто должны иметь дело с различными браузерами (CSS и прочее).

Изменить: Я ищу , чтобы создать свои собственные файлы справка. Так как я фанат «Нет установки, достаточно распаковать и запустить» Философия, я была эта проблема много раз в прошлом , потому что многие из моих пользователей будет запускать его из сети, что вызывает именно эту проблему.

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

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

Задан 04/08/2008 в 11:43
источник пользователем
На других языках...                            


10 ответов

голоса
15

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

Тем не менее, когда на самом деле в комплекте инсталляционного пакета, (вместо того, чтобы быть служил по сети), я нашел файлы CHM, чтобы работать хорошо.

Ото, другая ловушка о CHM файлах: Даже если вы пытаетесь открыть файл CHM на локальный диск, вы можете столкнуться с блоком защиты , если вы сначала загрузили его где - то, потому что файл может быть помечен как «пришел из внешнего источника» когда оно было получено.

Ответил 04/08/2008 d 11:51
источник пользователем

голоса
5

Мне не нравится вариант HTML, и фактически перешел от простого HTML для CHM путем сжатия и их индексации. Даже использовать их на нескольких клиентов, не Windows, даже. Он просто решил постоянную небольшую поломку людей положить его в сети (глубина вложенности ограниченные, странные запирающие эффекты), антивирус, который умер в каталогах с 30000 файлов HTML, и 20 минут времени декомпрессии при установке на старой системе, зоны безопасности браузера и особенности, просчеты необходимого пространства в программе установки и т.д.

И тогда я даже не включаю человек, которые начинают «исправляя» их, продукт 3-й партии с неисправной «интеграцией» попыткой и т.д., жалобами на slowliness (браузер запуск)

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

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

Ответил 06/09/2009 d 01:03
источник пользователем

голоса
3

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

  • Помощь источник Дита compilant XML, хранятся в SCC (ClearCase).
  • Помощь редактирования XMetal
  • Помощь сборник, настроить Open Дит Toolkit , с пользовательской Perl / Java предобработкой
  • Помощь перекрестных ссылки источника приложение ресурсы во время компиляции, .RC файлы и т.д.
  • Помощь ожидаемых результатов от одного источника, PDF, CHM, Eclipse Help , HTML.
  • Единый репозиторий исходных кодов позволяет помочь для нескольких продуктов 10+ с тысячами общих тем.

Из того, что вы описали, я хотел бы посмотреть на Eclipse Help, ее не просто интегрировать в .NET или MFC приложений, вы в основном должны сделать отображение справки, чтобы разрешить запрос на URL затем огонь URL в Eclipse Help обертку или браузер.

Ответил 21/09/2008 d 01:11
источник пользователем

голоса
3

Если вы не хотите использовать инсталлятор , и вы не хотите, чтобы пользователь выполнять какие - либо дополнительные шаги , чтобы позволить CHM файлов по сети, то почему бы не упасть обратно WinHelp? Vista , не включает в себя WinHlp32.exe из коробки, но он свободно доступен для загрузки как для Vista , и Server 2008.

Ответил 04/08/2008 d 14:48
источник пользователем

голоса
3

Наше программное обеспечение как распределены локально для клиентов и служил с сетевого ресурса. Мы выбрали для создания как файла CHM и набора HTML-файлов для обслуживания от сети. Пользователи начинают программу локально использовать файл CHM, и пользователи получают свою программу подаются с сетевым ресурса должны использовать HTML-файлы.

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

До сих пор все типы одного файла для Windows, кажется, сломана в той или иной форме:

  • WinHelp - устарел
  • HtmlHelp (МП) - на Vista, устарел, не работает от сетевого ресурса, кроме того, что работает очень хорошо
  • Microsoft Help 2 (HXS) - это, кажется, не работать вплоть до того момента, когда это не так, испорченные индексы или аналогичные, это используется в Visual Studio 2005 и выше, в качестве примера
Ответил 04/08/2008 d 12:02
источник пользователем

голоса
3

Есть вопрос, как создавать свои собственные файлы справки, или то, что это лучший формат файла справки?

Лично я считаю , CHM , чтобы быть превосходным. Одна из первых вещей , которые я делаю при настройке машины, чтобы загрузить Руководство PHP в формате CHM ( http://www.php.net/download-docs.php ) и добавить горячую клавишу для этого в Алом редакторе . Поэтому , когда я нажимаю F1 он загружает CHM и выполняет поиск слова моего курсор на (отлично подходит для быстрой справки функции).

Ответил 04/08/2008 d 11:52
источник пользователем

голоса
2

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

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

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

Ответил 27/11/2008 d 21:39
источник пользователем

голоса
2

PDF имеет тот недостаток, требующий Adobe Reader

Я использую Foxit Reader на Windows , дома и на работе. Много меньше , и очень быстро , чтобы открыть. Очень удобно , когда вы хотите знать , что именно a80000326.pdf и почему он засоряя папку документов.

Ответил 05/08/2008 d 19:55
источник пользователем

голоса
2

Если вы делаете «просто извлечь и запустить», вы собираетесь работать в вопросах безопасности. Это особенно верно, если вы работаете пользователи Vista (или более поздней версии). есть причина, почему вы хотите, чтобы избежать упаковок приложений внутри инсталлятора? Использование установки позволит смягчить «внешний источник» проблемы. Вы могли бы использовать .chm файлы без каких-либо проблем.

Мы используем InstallAware создать наши установки пакетов. Это не дешево, но очень хорошо. Если стоимость ваша проблема, WIX является открытым исходным кодом и очень надежным. WIX имеет кривую обучения, но это легко работать.

Ответил 04/08/2008 d 13:11
источник пользователем

голоса
1

Я использую коммерческий пакет под названием AuthorIT, который может генерировать множество различных форматов, таких как CHM, HTML, PDF, Word, Windows Help, XML, XHTML, и некоторые другие, я никогда не слышал (делает Дита кольцо колокола?). Это система управления контентом ориентирована на удовлетворение потребностей технических писателей документации. Преимущество заключается в том, что вы можете использовать и повторно использовать один и тот же контент для создания набора руководств, а затем генерировать их в различных форматах.

Таким образом, нижняя линия по отношению к вопросу о выборе CHM или HTML или что-то в том, что если вы используете это, вы не заперли в данном формате, но вы можете предоставить несколько, среди которых пользователь может выбрать, и вы даже можете добавить больше форматов как вы идете вперед, без каких-либо дополнительных затрат.

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

Ответил 18/09/2008 d 15:47
источник пользователем

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more