[docs] Re: new package 'alt-entities' available

[Anton V. Boyarshinov]

On Fri, 27 Sep 2002 14:51:41 +0400
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> Господа, высказывайтесь - в cvs нет ни одного документа со 
> скриншотами, и положить нельзя, потому как не ясно, куда.

Есть. sound-plaing-and-encoding
> 
> >>'public-document', с тем чтобы выполнять подготовку документа
> >>для включения в общий набор.
> > 
> > Тут палка о двух концах:
> >  * для web публикации действительно имеет смысл включать все
> > документы, которые созрели.
> 
> Хорошо, тогда никто не мешает сделать public-document в xml и 
> сказать в нём что-то вроде online=yes и print=no.
> 
> И пользоваться разными целями при подготовке для разных
> форматов. Например, базы для ссылок между печатными и online
> документами должны различаться.
Дело тут не только в базе ссылок. В нормальной книге части идут в
том порядке, в котором надо, а не по алфавиту. И структура
конкретной книги может не во всём совпадать со структурой
каталогов в cvs.

 
> >  * для бумажной публикации всё сложнее и не может быть
> > автоматическим процессом. Включение документа в печатную
> > версию руководства может делаться только вручную.
> 
> Можно описать все сложности печатной публикации?

Печатная публикация стоит намного дороже, а обновляется реже.
Таким обрахом, все надостатки печатной документации остаются
нашим позором надолго.

Хорошая печатная публикация это не просто сборник разрозненных
статей. Она должна быть действительно единой. В ряде случаев
может потребоваться ручная доводка внешнего вида (типа тут
сделать отступ побольше, а тут поставить pagebreak). Нормальную
книгу практически невозможно получить автомагическим запуском
make.
 
Антон
-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
  3:28pm  up 35 days,  7:43,  5 users,  load average: 0.00, 0.00,
0.00