[docs] Re: Docbook root element

Vitaly Ostanin vyt на vzljot.ru
Чт Окт 21 10:31:38 MSD 2004


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 стилей в своей рассылке 
озвучили мнение, что навигацию нужно делать не модификацией стилей, а 
параметром родных стилей.

> Конечно, лучше спросить Уолша, но может у вас есть свои соображения? 
> Ведь повторение кода неизбежно в этом случае.


Соображений есть :) Что именно Вы хотите?

-- 
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/20041021/80ff4779/signature.bin


Подробная информация о списке рассылки docs