Собирать достаточно просто, когда будет нужно, найдем (или напишем документацию) по сборке документации.
По-моему, она уже где-то есть в нормальном виде.
#####################################################################
Разработка документации
#####################################################################
Документация разрабатывается в `reStructuredText
<
http://docutils.sourceforge.net/rst.html>`_ формате (сокращенно ReST).
Для написания документации в формате ReST достаточно изучить
`краткое описание <
http://docutils.sourceforge.net/docs/user/rst/quickref.html>`_.
Разработка документации ведется в отдельном проекте MSVS: ``Documents``.
У проекта две конфигурации: HTML и ALS.
Каждый разработчик сам пишет документацию на свои объекты, и
согласовывает с руководителем проекта в какую часть общей документации
будет входить документация по его разработке.
Для добавления произвольных html-файлов к сборке 1С++ нужно не забыть
добавить имена файлов в раздел "Учебник" в файле 1cpp.rst.
Сами файлы нужно поместить в подкаталог kb.
Для примера можно посмотреть подключение файла TSQLInV7FirstSteps
Компиляция документации
=====================================================================
Установка программного обеспечения
---------------------------------------------------------------------
- Установить Python:
http://www.python.org (рекомендуется версия 2.4)
- Установить Docutils:
http://docutils.sourceforge.net/index.html (рекомендованная версия 0.4). Распаковать \*.tgz архив, зайти в
каталог Docutils, запустить::
setup.py install
- В VS Tools/Options закладка Directories, Show Directories for:
Executable files прописать путь:
``<Каталог установки Docutils>\tools``
После этого файлы проекта Documents можно компилировать как обычно это
делается в VS.