Какие способы создания справки для пользователя программы вы знаете?
3 ответа
Можно использовать HTML-страницы. Браузеры сейчас установлены на большей части компов.
-
Не подскажите программу для создания такого рода справки 25 дек 2010 в 10:58
-
-
Под Windows, но кросс-платформенное решение будет лучше. 25 дек 2010 в 16:25
-
Любой hTML-редактор подойдет, т.к. это не CHM-формат а просто набор файлов *.html, которые открываются в браузере. Под Windows я раньше использовал Adobe Dreamveawer, т.к. в нем и визуальное редактирование и редактор кода совмещены. Под Linux виуальных редакторов мало Кроссплатформенных я не видел. Ещё как вариант формата для документации можно использовать PDF, но он по сравнению с HTML на мой взгляд имеет недостаток -- навигацию сложно сделать (по разделам, документ то один).– DOOMer25 дек 2010 в 17:37
Какие способы создания справки для пользователя программы вы знаете?
Для пользователя? Открываете любой текстовый редактор и набиваете. В любом случае, первично - "мясо", затравка документа. А потом можно уже навернуть красивости: оглавление, форматирование, картинки и пр. Причем вариантов как сохранить документацию масса: начиная от обычных txt-файлов, кончая навороченными CHM и PDF. Посмотрите как сделано у других и решите, что лучше подходит Вам лично. Напомню, что стандартная справка в Windows реализуется через HLP-файлы (уже уходят в прошлое) и CHM-файлы (по сути - архив с HTML-документами). PDF же очень легко получить из RTF, DOC или ODT (OpenOffice)-документа.
В автоматическом же режиме удастся сделать "документацию для программиста": описание внутреннего мира программы, который нужен при ее доработке. Да и то это возможно только при комментировании кода по определенному стандарту, чтобы эти комментарии легко было найти и обработать автоматизированными утилитами.