[docs] Re: документация по docbook

[Vitaly Ostanin]

Kirill Maslinsky пишет:
> Добрый день!
>
>
>>>Я попробовал написать для тривиального случая, выглядит так:
>>>-----Begin sh-script--------------------------------------------
>>>#!/bin/sh
>>>STYLESHEET="/usr/share/xml/docbook/xsl-stylesheets-1.64.0/html/docbook-koi8-r.xsl"
>>
>>Наверное, здесь s/1.64.0/*/ (это нестрого, но afair несколько
>>версий штатно не сосуществуют).

Сосуществуют.

> Хотелось бы вообще избавиться от явного пути. Не уверен, подходит ли
> для этого xmlcatatlog?

http://www.sagehill.net/docbookxsl/index.html

>>>XSLPARAMS="--nonet"
>>>TRANSFORMATOR="/usr/bin/xsltproc"
>>>$TRANSFORMATOR $XSLPARAMS $STYLESHEET $1 > $2

Кирилл, не обижайтесь, но прочтите всё-таки хоть какую-нибудь
документацию по XML и DocBook. Ну как тут можно комментировать,
кроме как цитатами из документации? Посмотрите
doc-template/Makefile.* - они не зря стали такими толстыми.

>>>-----End sh-script----------------------------------------------
>>>При этом, предполагается:
>>>1. Документ xml ($1) -- это настоящий DocBook, без всяких там
>>>наворотов, alt-speciefic entities и тегов.
>>
>>А если?  У нас же вроде только с ними и наблюдалось?
>>(нет среза под рукой и пишу урывками между сборками)
>
> Если я правильно понимаю, для раскрытия alt-speciefic entities должно быть
> достаточно установить пакет alt-entites и как-то указать в документе, что
> они будут использоваться. Например, путём указания docs.dtd.
> Специфичный для alt тег один, <alt:distro>. Его нужно просто вычистить
> из всех текстов, если мы документируем Сизиф.

А потом добавить обратно, когда будете документировать дистрибутив?

--
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: 256 bytes
Desc: OpenPGP digital signature
Url : http://lists.altlinux.ru/pipermail/docs/attachments/20050225/19c5edf8/signature.bin