[docs] Re: Docbook root element

[Ildar Mulyukov]

Vitaly Ostanin wrote:

> Ildar Mulyukov пишет:
>
>>       Здраствуйте, уважаемые!
>> у Докбука мне известны два официальных рут элемента: BOOK и ARTICLE. 
>
> Наоборот, у DocBook известно несколько элементов (в основном, inline), 
> которые не могут быть корневыми. Оригинальные стили DocBook 
> поддерживают почти все теги как корневые.
>
>> Есть ещё неофициальный - WEBSITE (пакет website).
>
> Website - это одна из модификаций DocBook, довольно неудачная и 
> относительно заброшенная.
>
>> Возникают вопросы:
>> 1. расширябелен ли Docbook в этом отношении? Что если мне захотелось 
>> создать NOTE, MEMORANDUM и т.д.?
>
> Насчёт memorandum не знаю, а тег note точно поддерживается в website. 
> У website другая проблема - поддержка больших документов с разбиением 
> на страницы.
>
> Частичное решение этой проблемы:
> http://docs.altlinux.ru/releases/xsl/current/website/
>
> Результат:
> http://docs.altlinux.ru/beta/
>
>> То есть мне понятно, что я могу включать *какие-то* стайлшиты Докбука 
>> в свой стайлшит и использовать их. Но документировано ли это? Есть ли 
>> какие-нибудь указания на этот счёт? Быть может, вы дадите 
>> практический совет?
>
> Кроме родной документации, есть отличная книга:
> http://sagehill.net/docbookxsl/index.html
>
> Совет дать не могу, поскольку не понял, в чём проблема.
>
>> 2. Website сделан абсолютно независимо. Интересно, это с умыслом? 
>
> Website появился, как очередная модификация xsl стилей DocBook, со 
> всеми недостатками первой пробы. Разработчики xsl стилей в своей 
> рассылке озвучили мнение, что навигацию нужно делать не модификацией 
> стилей, а параметром родных стилей.
>
>> Конечно, лучше спросить Уолша, но может у вас есть свои соображения? 
>> Ведь повторение кода неизбежно в этом случае.
>
> Соображений есть :) Что именно Вы хотите?

       Виталий, уважаемое сообщество!
чувствую, что получу поддержку, что очень радует :-) Спасибо за ссылку 
на Complete Guide, там можно научиться многому полезному. Про Website 
больше речь не веду, принимая, что это - тупиковая ветвь (вернее 
совершенно неудачный предмет для того, чтобы на него ссылаться в данном 
контексте).
По-видимому, я недопонимаю чего-то важного, поэтому задаю вопросы, на 
которые ответ: "а чего Вы хотите?"
Попробую изложить с самого начала:
* Во всяких материалах по DBk описано, как делать докумены, то есть 
использовать BOOK и ARTICLE, в качестве root-элементов.
* Соответственно есть принятые DTD для таких документов. При этом 
root-элементом является <book/> или <article/>. (Это обязательно? Или 
DTD не декларирует, какой будет root-элемент?)
* Есть потребность создать новый вид документа, который не является ни 
книгой, ни статьёй: <my-type-of-doc/>
В связи с такой потребностью возникают следующие вопросы:
1. Надо для такого документа написать DTD. Предположим, эта проблема 
решаема :-) Надо только почитать доки по DTD.
2. Для реального использования надо как-то подцепиться к DBk-ским xsl. 
Видимо, это делается простым include-ированием html/docbook.xsl?
3. Есть ли примеры успешной реализации поставленной задачи? Кто-нибудь 
так уже делал?
Пока это всё. Посмотрим, что принесёт грядущий день.
Спасибо. С уважением, Ильдар.

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