[docs] Re: Docbook root element

[Vitaly Ostanin]

Ildar Mulyukov пишет:

<skipped/>

>> Там просто указывается, что такой-то элемент не поддерживается 
>> стилями в качестве корневого. 
>
>
> Угу. Очень хорошо. А вообще, кроме book и article, нет элементов, 
> которые бы имело смысл использовать, как корневые? 


Есть раздел (section), глава (chapter), ман-страница (refentry) и т.д.

> То есть для нормального использования: вёрстки, публикации на ВВВ...


Тут нужно перечитать следующий абзац.

>
>> Нужно понять разницу между:
>> - самим документом в структурном виде
>
>
> угу. Это *.dbk (по крайней мере abiword сохраняет с этим расширением)
>
>> - описанием этой структуры
>
>
> DTD. Необязательное описание. Но удобное.
>
>> - стилями для обработки документа.
>
>
> угу, apt-get install docbook-style-{xsl,dsssl}
>
>> В самом документе можно использовать _любой_ элемент как корневой, 
>> руководствоваться нужно только здравым смыслом. Если Вы пишете статью 
>> - корнем должен быть article. Если Вам нужен только email адрес, ну 
>> вдруг понадобилось иметь такие маленькие документы, всегда можно 
>> добавить поддержку email как корня в стили обработки.
>

<skipped/>

>>> * Есть потребность создать новый вид документа, который не является 
>>> ни книгой, ни статьёй: <my-type-of-doc/>
>>
>>
>> Сейчас почти невозможно создать новый вид документа :) :) 
>
>
> Это непонятно. Правда, что ли? Всё так плохо и нет смысла браться?


Уже существуют виды докуметов на почти все случаи жизни.

>
>
>> Любой документ имеет смысл (ну должен иметь :)). Вам нужно написать 
>> документацию к программе? Статью, диссертацию, хранить данные?
>
>
> Очевидно, я имею в виду что-то, не совпадающее с понятиями "книга" и 
> "статья". Как пример, лицензионное соглашение (или какое-нибудь EULA) 
> - это ни книга, ни статья. 


Для лицензионного соглашения в DocBook есть
http://docbook.org/tdg/en/html/legalnotice.html
который состоит, например, из параграфов (para). Из чего может состоять 
- см. список children.

> То есть суть вопроса такая: я что-то имею в виду, и хочу использовать 
> docbook-style-xsl для поддержки этого "что-то", то есть моего типа 
> документа.


- Доктор, у меня что-то болит...
- Сейчас я вам дам какую-то таблеточку...
:)

<skipped/>

>>> 3. Есть ли примеры успешной реализации поставленной задачи? 
>>> Кто-нибудь так уже делал?
>>
>>
>> Задача всё-таки не поставлена.
>
>
> Таки я попытаюсь ещё раз. Повторюсь:
> Я имею в виду что-то, не совпадающее с понятиями "книга" и "статья". 
> Нельзя сказать, что вся печатная (и, заметьте, непечатная) продукция - 
> это только книги и статьи. Есть ещё много чего. Как пример, 
> лицензионное соглашение (или какое-нибудь EULA) - это ни книга, ни 
> статья. Или те же website-ы. Или, например (иллюстрация), существует 
> ThML (http://www.ccel.org/ThML/). (Правда, он по идеологии далёк от DBk)
>
> То есть последний вопрос таков: я что-то (мой тип документа) имею в 
> виду, и хочу использовать docbook-style-xsl для поддержки этого 
> "что-то", то есть моего типа документа. Что для этого мне надо сделать?


Дописать поддержку этого "чего-то" своими стилями, если её ещё нет в 
docbook-style-xsl.

>
> С уважением, Ильдар.
>


-- 
Regards, Vyt
mailto:  vyt at vzljot.ru
JID:     vyt at vzljot.ru

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 252 bytes
Desc: OpenPGP digital signature
Url : http://lists.altlinux.ru/pipermail/docs/attachments/20041027/56dbf6dc/signature.bin