Справочная информация программы локализации генерируется из единого источника информации.
Формат этого источника - AsciiDoc, из которого формируется DocBook и затем все необходимые форматы CHM/PDF/HTML.
Соответственно, справка во всех форматах полностью идентична.
О AsciiDoc подробно изложено в статье "Подготовка технической документации с использованием asciidoc и DocBook"
http://iportnov.blogspot.ru/2011/03/asciidoc-docbook.html
На тему справочной информации имеется интересная презентация "Разработка справочной документации, ч.1", в которой рассмотрены основные аспекты разработки справочной информации.
Данная презентация подвигла на создание онлайн справки кроме уже созданной "оффлайновой" в форматах CHM и PDF.
Постепенно буду добавлять все рассмотренные в презентации специальные разделы: HowTo, QuickStart и пр.
Созданная онлайн справка позволяет:
1. пользователю до скачивания самой программы ознакомиться с интересующими возможностями программы;
2. переходить на нее по ссылкам из видеороликов(youtube) с примерами в которых рассмотрен функционал программы;
3. поисковые системы позволят искать по ней интересующую информацию;
4. по ссылке ("PDF") вверху страницы онлайн справки можно скачать/посмотреть справку в формате PDF.
Формат этого источника - AsciiDoc, из которого формируется DocBook и затем все необходимые форматы CHM/PDF/HTML.
Соответственно, справка во всех форматах полностью идентична.
О AsciiDoc подробно изложено в статье "Подготовка технической документации с использованием asciidoc и DocBook"
http://iportnov.blogspot.ru/2011/03/asciidoc-docbook.html
На тему справочной информации имеется интересная презентация "Разработка справочной документации, ч.1", в которой рассмотрены основные аспекты разработки справочной информации.
Данная презентация подвигла на создание онлайн справки кроме уже созданной "оффлайновой" в форматах CHM и PDF.
Постепенно буду добавлять все рассмотренные в презентации специальные разделы: HowTo, QuickStart и пр.
Созданная онлайн справка позволяет:
1. пользователю до скачивания самой программы ознакомиться с интересующими возможностями программы;
2. переходить на нее по ссылкам из видеороликов(youtube) с примерами в которых рассмотрен функционал программы;
3. поисковые системы позволят искать по ней интересующую информацию;
4. по ссылке ("PDF") вверху страницы онлайн справки можно скачать/посмотреть справку в формате PDF.
Онлайн справка: http://sourcelocalizer.ru/help
Комментариев нет:
Отправить комментарий