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

Anton V. Boyarshinov boyarsh на ru.echo.fr
Пт Сен 27 17:38:34 MSD 2002


On Fri, 27 Sep 2002 17:24:04 +0400
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> Anton V. Boyarshinov пишет:
> > On Fri, 27 Sep 2002 14:51:41 +0400
> > Vitaly Ostanin <vyt на vzljot.ru> wrote:
> > 
> >>Господа, высказывайтесь - в cvs нет ни одного документа со 
> >>скриншотами, и положить нельзя, потому как не ясно, куда.
> > 
> > Есть. sound-plaing-and-encoding
> 
> А что мы будем делать, если при сборе картинок всех
> объединённых элементов попадуются файлы с одинаковыми именами?
Испрлять один из документов и, соответственно, имя картинки.

 
> <skipped/>
> 
> >>И пользоваться разными целями при подготовке для разных
> >>форматов. Например, базы для ссылок между печатными и online
> >>документами должны различаться.
> > 
> > Дело тут не только в базе ссылок. В нормальной книге части
> > идут в том порядке, в котором надо, а не по алфавиту. И
> > структура
> 
> Так никто не мешает доработать вывод автообъединения. Или
> вообще его отключить для печатной версии.
> 
> > конкретной книги может не во всём совпадать со структурой
> > каталогов в cvs.
> 
> Когда будет жизненный пример, можно переработать структуру cvs.

У нас одновременно должна быть возможность поддержки как минимум
двух разных видов документации (Junior, Master). Часть документов
в них может пересекаться. ИМХО -- менять структуру cvs под
конкретную публикацию -- не выход. cvs должна иметь хорошую
структуру, удобную для разработки, но не обязательно 1 к одному
копировать структуру выходящих книг и наоборот. Впрочем, ручное
объединение тоже не решает всех проблем двух пересекающихся
документов.

> > Хорошая печатная публикация это не просто сборник
> > разрозненных статей. Она должна быть действительно единой. В
> > ряде случаев
> 
> Это относится и к хорошей online-публикации :)

Только вот её можно обновить в любой момент совершенно бесплатно.
И rendering engine находится у клиента и по крайней мере этой
мороки нет ;)
 
> > может потребоваться ручная доводка внешнего вида (типа тут
> > сделать отступ побольше, а тут поставить pagebreak).
> > Нормальную книгу практически невозможно получить
> > автомагическим запуском make.
> 
> Полностью согласен. Давайте сделаем возможность автосбора 
> документов для подготовки и объединения опциональной, идёт?
Давайте. Надо только подумать, как сделать не конфликтующую
поддержку для разных способов сборки...

Антон
-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
  5:28pm  up 35 days,  9:43,  5 users,  load average: 0.00, 0.01,
0.00



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