[docs] Re: principal discussion

Aleksey Smirnov smi на altlinux.ru
Пн Июн 9 19:44:18 MSD 2003


Alexandre Prokoudine wrote:

>Greetings,
>
>Беру на себя смелость поднять принципиальный вопрос о технологии
>подготовки нашей документации.
>
>Накопленный опыт показывает, что текущая технология получения
>печатной документации не вполне себя оправдывает ввиду фактической
>невозможности нормальной обработки XSL-FO до получения красивой
>конкурентоспособной документации.
>
>Давайте признаем, что заставить красиво выглядеть текст, созданный в
>LaTeX, гораздо проще, чем текст, созданный в DocBook/XML.
>
>Учитывая это, у нас есть три сценария дальнейшего развития событий.
>
>Сценарий первый: оставить всё как есть. Совершенствовать текущие
>стили, ждать появления свободного редактора XSL-FO...
>Плюсы: меньше трудозатрат
>Минусы: неудовлетворительное качество оформления книжек
>
>Сценарий второй. Держать документацию в DocBook/XML, создавать
>общий DB/XML для книжки, преобразовывать его в документ с
>разметкой LaTeX при помощи dblatex и довёрстывать уже в LaTeX.
>Плюсы: хорошее качество оформления книжек
>Минусы: высокие трудозатраты
>
>Сценарий третий: Полностью перейти на LaTeX с использованием
>dblatex. Плюсы: хорошее качество оформления книжек
>Минусы: невозможность такой же модульной сборки, как в случае с
>DB/XML; очень высокие трудозатраты
>
>Ваши мнения, коллеги?
>
>  
>
А что мешает комбинировать варианты 1 и 3 ? То есть готовить и 
накапливать документы в DocBook/XML, а затем, до момента готовности 
XSL-FO, "преобразовывать его в документ с разметкой LaTeX при помощи 
dblatex и довёрстывать уже в LaTeX". После же готовности XSL-FO 
использовать этот редактор.
Это позволит обеспечить и модульную сборку документа, и высокое качество 
верстки.

Алексей Смирнов




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