[docs] Re: Docbook root element

[Ildar Mulyukov]

Vitaly Ostanin wrote:

> Ildar Mulyukov пишет:
>
> <skipped/>
>
>>> Там просто указывается, что такой-то элемент не поддерживается 
>>> стилями в качестве корневого. 
>>
>> Угу. Очень хорошо. А вообще, кроме book и article, нет элементов, 
>> которые бы имело смысл использовать, как корневые? 
>
> Есть раздел (section), глава (chapter), ман-страница (refentry) и т.д.

Так. Очень странно. Не вижу, как можно рассматривать главу, как 
документ. По моему разумению, глава - это часть документа, т.е. элемент 
для сборки настоящего документа, т.е. явно не корневой элемент.

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


> <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.

во! это - ответ мужчины мужчине. Спасибо.

В общем, если разрешите, я подытожу.

В действительности, в Докбуке есть огромное множество элементов, которые 
уже готовы к использованию и годятся почти для всего.
То немногое, что не вписывается в стандартные схемы (например, 
свойственные для отдельных организаций документы), легко составляются из 
готовых элементов:
1. DTD на основе Docbook DTD с добавлением собственных элементов.
2. XSLT на основе docbook-style-xsl с добавлениями новых элементов и 
кастомизацией существующих согласно соотв. документации (было в переписке).

На этом, пожалуй, можно закончить. Спасибо всем. кто принял участи и 
просто прочёл переписку. Специальная благодарность -> Vitaly Ostanin.

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

-- 
Ildar  Mulyukov, 
  free SW designer/programmer
================================================
email: ildar at users.sourceforge.net
projects: http://os-development.sourceforge.net/
home: http://tuganger.narod.ru/
ALT Linux Sisyphus
================================================