[docs] principal discussion

Alexandre Prokoudine avp на altlinux.ru
Пн Июн 9 18:02:42 MSD 2003


Greetings,

Беру на себя смелость поднять принципиальный вопрос о технологии
подготовки нашей документации.

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

Давайте признаем, что заставить красиво выглядеть текст, созданный в
LaTeX, гораздо проще, чем текст, созданный в DocBook/XML.

Учитывая это, у нас есть три сценария дальнейшего развития событий.

Сценарий первый: оставить всё как есть. Совершенствовать текущие
стили, ждать появления свободного редактора XSL-FO...
Плюсы: меньше трудозатрат
Минусы: неудовлетворительное качество оформления книжек

Сценарий второй. Держать документацию в DocBook/XML, создавать
общий DB/XML для книжки, преобразовывать его в документ с
разметкой LaTeX при помощи dblatex и довёрстывать уже в LaTeX.
Плюсы: хорошее качество оформления книжек
Минусы: высокие трудозатраты

Сценарий третий: Полностью перейти на LaTeX с использованием
dblatex. Плюсы: хорошее качество оформления книжек
Минусы: невозможность такой же модульной сборки, как в случае с
DB/XML; очень высокие трудозатраты

Ваши мнения, коллеги?

-- 
Alexandre Prokoudine
ALT Linux Documentation Team
JabberID: avp на altlinux.org
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 481 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20030609/b4bf3620/attachment.bin


Подробная информация о списке рассылки docs