[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