[docs] Re: principal discussion

[Alexandre Prokoudine]

On Mon, 9 Jun 2003 18:13:35 +0400
Vitaly Ostanin <vyt на vzljot.ru> wrote:

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

Это_НЕ_ начало флейма.

> Что именно говорит о невозможности получения "красивой"
> документации?

Уточняю: о её получении в обозримом будущем.

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

Печатная документация для М2.2 и J 2.2

> "Заставить выглядеть" - не проще. На мой взгляд, стили XSL-FO
> менять проще, чем переписывать макросы TeX.
> 
> > Учитывая это, у нас есть три сценария дальнейшего развития
> > событий.
> > 
> > Сценарий первый: оставить всё как есть. Совершенствовать
> > текущие стили, ждать появления свободного редактора XSL-FO...
> 
> emacs-mode-xslide - свободный редактор xsl/fo.
> 
> > Плюсы: меньше трудозатрат
> > Минусы: неудовлетворительное качество оформления книжек
> 
> Чем именно неудовлетворительное?

Ты видел документацию к М2.2?

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

Второй вариант не исключает модульной сборки, равно как и сборки
HTML

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