[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