[docs] Re: new package 'alt-entities' available
Vitaly Ostanin
vyt на vzljot.ru
Пт Сен 27 14:51:41 MSD 2002
Anton V. Boyarshinov пишет:
> On Fri, 27 Sep 2002 13:25:33 +0400
> Vitaly Ostanin <vyt на vzljot.ru> wrote:
>
>>>А планируется перевод всех документов в cvs на эти рельсы?
>>
>>Да, и обновление документации про документацию тоже.
>
> Я, собственно к тому, что я мог бы это сделать, по крайней мере
> для admin.
Будет просто здорово. Заодно можно проверить, что все доки в
admin в docbook 4.2, а не 4.1.2
>>Надо ещё продумать сборку документов с profiling и с
>>картинками. Скорее всего, придётся всё-таки делать поиск
Господа, высказывайтесь - в cvs нет ни одного документа со
скриншотами, и положить нельзя, потому как не ясно, куда.
>>'public-document', с тем чтобы выполнять подготовку документа
>>для включения в общий набор.
>
> Тут палка о двух концах:
> * для web публикации действительно имеет смысл включать все
> документы, которые созрели.
Хорошо, тогда никто не мешает сделать public-document в xml и
сказать в нём что-то вроде online=yes и print=no.
И пользоваться разными целями при подготовке для разных форматов.
Например, базы для ссылок между печатными и online документами
должны различаться.
> * для бумажной публикации всё сложнее и не может быть
> автоматическим процессом. Включение документа в печатную версию
> руководства может делаться только вручную.
Можно описать все сложности печатной публикации?
Пока мне известны проблемы:
Создание диапазона страниц в индексах.
Иллюстрации.
Сноски для ссылок (и хорошо бы делать сноски только для первых
появлений ссылки, не особо повторяясь).
Это всё IMHO :)
<skipped/>
--
Regards, Vyt
mailto: vyt на vzljot.ru
JID: vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя : отсутствует
Тип : application/pgp-signature
Размер : 252 байтов
Описание: отсутствует
Url : /pipermail/docs/attachments/20020927/3409e76e/attachment.bin
Подробная информация о списке рассылки docs