[docs] Re: Making docs status in cvs

[Vitaly Ostanin]

On Sun, 10 Nov 2002 22:31:19 +0300
cornet <cornet на altlinux.ru> wrote:

<skipped/>

> > > Фактически это лицо ответственное за выпуск документа и
> > > поддержание его в актуальном состоянии.
> > 
> > Это, скорее, редактор.
> 
> Не совсем. Детактор это скорее лит-вычитка. А я говорю про
> выпускающего - такой человек и за содержание отвечает и за код
> xml.
> 
> Пример:
> samba.xml
> Имеется 3 автора - я, Игорь Вергейчик, Александр Боковой. 
> При этом майнтейнер документа именно я. Когда мне потребуется
> доработать контент по samba3 - обращусь к Вергейчику или
> Боковому, когда доработка по samba2 - сделаю сам, когда
> потребуется лит-вычитка - обращусь к Александру Прокудину. Но
> за коректность xml, за правильность оформления и за готовность
> документа к нужному сроку в нужном виде отвечаю именно я.

Обязательно нужно быть одному? Поскольку это не принципиальный
вопрос, а разрешение в DTD нескольких мантейнеров ничем не мешает
(и может быть изменено в дальнейшем), пусть оно будет.

> > > Разумеется этот человек одновременно может быть (и как
> > > правило будет) одним из авторов.
> > > Всё общение с авторами документа возлагается на
> > > майнтейнера.
> > 
> > Это когда дойдём до policy с документами. Авторы здесь вообще
> > ни при чём.
> 
> А какие мысли есть на счет policy ??

Что неплохо бы его написать (вписать в docs-howto), но не сейчас.

<skipped/>

> > > Например, в ent/authors.ent записываем:
> > > <!ENTITY cornet
> > > "<firstname>Vlasenko</firstname><surname>Oleg</surname><af
> > > fili
> > > ation><address><email>cornet на altlinux.ru</email><otheraddr
> > > ></o
> > > theraddr></address></affiliation>">
> > >
> > > А в теле документа пишем:
> > > <authorgroup>
> > >   <author lang="en">
> > >     &cornet;
> > >   </author>
> > > </authorgroup>
> > 
> > Лучше взять уровнем выше - делать сущности с началом на
> > <author>.
> 
> Не уверен что это правильно - один и тот же человек в разных
> документах может быть и author и othercredit и ещё как то.
> Как раз суть моего предолжения - загонять в сущность свойства
> самого человека. А вот его роль в создании документа должна
> описываться в самом документе.

Ясно. В общем, мысль хорошая, но делать это надо не в ENTITIES
(которые вообще-то не XML, а SGML-ориентированы), а в одном
xml-файле со всеми авторами. В него можно записать имена авторов
на (пока) обоих языках, адреса, и уникальный идентификатор
автора (сочетание имени, отчества и фамилии), по которому автор
будет включен в документ через XInclude(#xpointer).

> > Кстати, недавно пришли к тому, что имена должны быть на
> > русском.
> 
> А нельзя выбор написания имени как то завязать с lang="ru" и
> lang="en"
> ??

Можно, если включать имена авторов без явного указания
языка, и запинав стили на использование общего авторского
xml-файла. Это сложно делать, комфортно использовать, но времени
сейчас нет.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20021111/d207cd3a/attachment.bin