Re: Вопрос по docbook

[Victor Sudakov <vas@vas.tsu.tomsk.su>]

Alexander Taranov wrote:
> Victor Sudakov writes:
>  
>  > > Кроме того, Linuxdoc как dtd не очень хорош.
>  > > С другой стороны:
>  > > - dcbook ОЧЕНЬ велик
>  > 
>  > Это как раз не пугает. Буду осваивать новые фичи по мере возникновения
>  > потребности. Или там steep learning curve и сначала будет очень трудно? Мне
>  > же поначалу нужен некоторый минимум. Сильно сложнее освоить docbook, чем
>  > HTML?
> 
> Ежели постепенно, да еще пользоваться psgml-mode, то все освояемо

Что-то psgml-1.0.1 у меня не собрался так вот сразу. 

'./configure ; gmake ; gmake install' оставили пустую директорию psgml в
share/emacs/site-lisp и больше ничего. 

> 
>  > 
>  > > - jade + Walsh's modular stylesheet требует времени для освоения
>  > > + dcbook + jade +Walsh's modular stylesheet позволяет обрабатывать довольно
>  > > большие документы (у меня сейчас зараз делается html-site из ~2M
>  > > исходного sgml).
>  > 
>  > А вот тут можно вопрос: зачем? Почему не делать сразу site на HTML? Чем HTML
>  > плох как DTD? 
> Чем плох HTML -- отдельная тема. В двух словах:
> нет стандарта, ориентирован на визуализацию, нет структуры.
>  > Каковы преимущества изначально писать на docbook?
> Тоже в 2х:
> есть структура, не заботишься о внешнем виде,
> выдаешь в разных форматах (Пример: у меня пользовательская
> документация одна и для хелпов и для книжки)

Вот здесь сразу вопрос возникает. Книжку как получаешь - через tex? С
русским языком проблем не бывает при этом?

> 
> 
>  > 
>  > > - tex backend (называется jadetex) до последнего времени плохо
>  > > обрабатывал таблицы, но есть надежда, что скоро будет хорошо.
>  > > 
>  > > так что . . .
>  > > 
>  > 
>  > А теперь самый животрепещущий вопрос - о выходных форматах.  Мне в сладком
>  > сне приснилась штука, которая позволяет из sgml-исходника получать:
>  > 
>  > 1. html 
>  > 2. txt  
>  > 3. rtf (в том числе с уникодом для нормального чтения в Word 8 по-русски)
>  > 4. latex,tex
>  > 5. roff, man
>  > 6. Postscript (напрямую, без участия tex)
>  > 7. PDF (напрямую, без участия tex)
>  > 
>  > Существует ли в жизни нечто подобное? jade, как я понял, умеет только 3
>  > (причем насчет русского неясно), 1 и 4. Этого мне лично мало.
> 
> Jade умеет 1,2,3,4 + mif + sgml

Опять же несколько вопросов. 

1. Тот RTF, что получается в итоге, читабелен ли в нем русский язык самым
последним микрософтовским вордом, который, как известно, уникодный?

2. У jade  я не нашел вывода в txt, он предлагает fot|rtf|html|tex|sgml|xml

3. Если ты, как говоришь, документацию к софту пишешь, как ты обходишься без
man, который roff?

> 
>  > 
>  > sgmlfmt во FreeBSD умеет 1, 2, 4, 5, 6 - и мне этого было бы на первых порах
>  > достаточно. Но если он не умеет ничего, кроме Linuxdoc, от него придется
>  > отказаться.
>  > 
>  > Какую engine мне тут посоветуют?
> 
> Из freeware вне конкуренции cost и jade

Ты сам что используешь?

Видимо, раз в портах к фре есть только jade, мне и суждено им пользоваться.
Я поставил из портов:

docbook-3.0
dsssl-docbook-modular-1.08
iso8879-1986
jade-1.1.1

Прописал переменную среды SGML_CATALOG_FILES на все catalog файлы, какие только
есть. По-хорошему всё должно начать работать?

Не пришлешь ли мне образчик документации твоей какой-нибудь, чтобы я мог всё
это хозяйство опробовать? 

-- 
Victor Sudakov