[docs] Re: некоторые вопросы на обсуждение

[Vitaly Ostanin]

On Tue, 11 Mar 2003 17:47:35 +0300
Sergey Pinaev <dfo на antex.ru> wrote:

> hi.
> On Mon, 10 Mar 2003 11:19:09 +0300
> Alexandre Prokoudine <avp на altlinux.ru> wrote:
> 
> >> 1. с ENTITY в началах документов какой-то бардак
> >> постоянные <!ENTITY LINUX "<systemitem
> >> class='osname'>Linux</systemitem>"> в практически каждом
> >> документе.
> 
> AP> И что? :-)
> 
> а не "прямее" ли было бы вынести их всех в ent/common.ent?

Прямее. В BTS, pls.
http://bugs.altlinux.ru
проект "Docs"

<skipped/>

> >> 10. install/intro/documentation/documentation.xml
> >>     	<filename>man-страницы</filename>. Команда
> >> разве "man-страницы" - это "filename"?
> 
> AP> Временный вариант. Буду рад более релевантному.
> 
> грепнулся по всей документации - "man-страница" хоть
> как-то выделена _только_ в
> intro/documentation/documentation.xml то есть есть вариант не
> выделять никак. (кстати, в документации на docbook "man page",
> как термин, никак не выделяется) 

Выделяется.
http://docbook.org/tdg/en/html/citerefentry.html

Кстати, tdg docbook продуктивнее читать по "see also" от
чего-то близкого по смыслу, чем по поиску слова.

<skipped/>

> AP> Спасибо за правку. Предлагаю just for fun ознакомиться с
> AP> DocBook: The Definitive Guide --
> AP> http://docbook.org/tdg/en/html/docbook.html.
> AP> Это снимет большую часть вопросов по разметке текста.
> 
> а ни у кого нельзя ее в бумажном виде позаимствовать?

Даже если найдётся, то сильно устаревший вариант. Или можно слить
tdg cvs и собрать из него pdf.

PS Гораздо удобнее читать фразы, которые начинаются с большой
буквы.

<skipped/>

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