Re: Вопрос по docbook

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

Alexander Taranov wrote:

Pls поправь кодировку: у тебя в теле письма koi8, а в заголовке
charset=iso-8859-1

> Victor Sudakov writes:
>  > Boris Tobotras wrote:
>  > > On Tue, 30 Jun 1998 01:04:11 +0800, Victor Sudakov wrote:
>  > > 
>  > > > 
>  > > > Был у меня выбор: linuxdoc, TEI, docbook. Приглянулся мне почему-то docbook.
>  > > > Поставил я под FreeBSD из портов jade и docbook. Есть у меня файлик at1.sgm на
>  > > > docbook, который начинается так:
>  > > > 
>  > > > <!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V2.4.1//EN" [
>  > > > <!--ArborText, Inc., 1988-1995, v.4001-->
>  > > > <!NOTATION drw SYSTEM "DRW">
>  > > > <!ENTITY markups SYSTEM "markups.eps" ndata eps>
>  > > > <!ENTITY generic SYSTEM "generic.eps" ndata eps>
>  > > > <!ENTITY sgmlexa SYSTEM "sgmlexa.drw" ndata drw>
>  > > > <!ENTITY atilogo SYSTEM "atilogo.gif" ndata gif>
>  > > > <!ENTITY gloss SYSTEM "gloss.sgml">
>  > > > <!ENTITY www "World Wide Web">
>  > > > ]>
>  > > > <book>
>  > > > <bookinfo>
>  > > > 
>  > > > и так далее. Хочу из него получить, например, html. А что, собственно,
>  > > > дальше делать?
>  > > > 
>  > > > cat at1.sgm | jade -t html
>  > > > 
>  > > > дает кучу сообщений об ошибках и больше ничего.
>  > > > 
>  > > 
>  > > 	Пойти на www.jclark.com и прочитать man на jade. Как минимум, 
>  > > нужно указать stylesheet.
>  > 
>  > Спасибо, схожу.
>  > 
>  > > 
>  > > > 
>  > > > Кстати, этот jade делает только fot|rtf|html|tex|sgml|xml, как я понял. А
>  > > > где же обещанные man, troff, postscript?
>  > > 
>  > > 	Кем обещанные? :) Ну, PostScript ты из TeX получишь, надо 
>  > > полагать, а man (он же troff) -- обломись. Кажется.
>  > 
>  > Я нашел во FreeBSD простенькую утилитку sgmlfmt, которая умеет всё это
>  > сама внутри себя.
>  > 
>  > 
>  > SGMLFMT(1)		FreeBSD General Commands Manual 	    SGMLFMT(1)
>  > 
>  > NAME
>  >      sgmlfmt - Formats SGML files tagged according to the linuxdoc DTD.
>  > 
>  > SYNOPSIS
>  >      sgmlfmt -f format [-links] [-ssi] [-i name ...] file
>  > 
>  > DESCRIPTION
>  >      The sgmlfmt command reads SGML files tagged according to the linuxdoc
>  >      DTD, validates them using the sgmls(1) parser and then converts them to
>  >      the specified output format.  The input file must include the following
>  >      document type declaration before any uncommented text:
>  > 
>  > 	   <!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN">
>  > 
>  >      Options for sgmlfmt include the following:
>  > 
>  >      -f format
>  > 	     Determines the output format which can be one of the following:
>  > 
>  > 	     ascii   Generates a single output file with the extension .ascii
>  > 		     suitable for viewing on an ASCII terminal.
>  > 
>  > 	     html    Generates a set of linked HTML files suitable for use
>  > 		     with an HTML browser.  A top level file, file.html, con-
>  > 		     tains the title, author, date, abstract and brief table
>  > 		     of contents for the document.  A file file_toc.html con-
>  > 		     tains a complete table of contents.  A series of files
>  > 		     named file1.html, file2.html ... filen.html contain the
>  > 		     actual text of the document.
>  > 
>  > 	     koi8-r  Generates a single output file with the extension .koi8-r
>  > 		     suitable for viewing on an terminal supporting the KOI8-R
>  > 		     character encoding.
>  > 
>  > 	     latex   Generates a single output file with the extension .latex
>  > 		     suitable for processing with LaTeX.  Note that the LaTeX
>  > 		     style file /usr/share/sgml/FreeBSD/linuxdoc.sty must be
>  > 		     accessible to LaTeX for correct processing.
>  > 
>  > 	     latin1  Generates a single output file with the extension .latin1
>  > 		     suitable for viewing on an terminal supporting the
>  > 		     ISO8859-1 character encoding.
>  > 
>  > 	     ps      Generates a single output file with the extension .ps
>  > 		     suitable for printing or display on a PostScript compati-
>  > 		     ble device.
>  > 
>  > 	     roff    Generates a single output file with the extension .roff
>  > 		     suitable processing with groff(1).  This is actually an
>  > 		     intermediate conversion used by the -f ascii, -f latin1,
>  > 		     -f koi8-r, and -f ps format options.
>  > 
>  > > 
>  > > > Или плюнуть на всё и перейти на TEI+Cost+TEItools?
>  > > 
>  > > 	И что изменится? У меня тоже roff нет.
>  > 
>  > Тогда мне на первых порах, скорее всего, хватит Linuxdoc + эта мелкая
>  > утилитка. По Linuxdoc я нашел отличный Howto. Единственное что - насколько
>  > мне потом будет трудно перейти на что-нибудь более серьезное? А с другой
>  > стороны, надо ли будет вообще переходить? Или есть какие подводные камни в
>  > использовании этой утилитки + Linuxdoc? Более опытные коллеги, pls
>  > предупредите, если я сворачиваю на неверный путь.
> Это зависит от того, как долго будут жить твои документы.
> Дело в том, что насколько мне известно, Linuxdoc, как проект
> ( а не как dtd) переползает на docbook.

Так ведь, наверное, всё написанное на Linuxdoc можно будет сконвертить в
docbook без потерь? Или не всё так просто?

> Кроме того, Linuxdoc как dtd не очень хорош.
> С другой стороны:
> - dcbook ОЧЕНЬ велик

Это как раз не пугает. Буду осваивать новые фичи по мере возникновения
потребности. Или там steep learning curve и сначала будет очень трудно? Мне
же поначалу нужен некоторый минимум. Сильно сложнее освоить docbook, чем
HTML?

> - jade + Walsh's modular stylesheet требует времени для освоения
> + dcbook + jade +Walsh's modular stylesheet позволяет обрабатывать довольно
> большие документы (у меня сейчас зараз делается html-site из ~2M
> исходного sgml).

А вот тут можно вопрос: зачем? Почему не делать сразу site на HTML? Чем HTML
плох как DTD? Каковы преимущества изначально писать на docbook?

> - 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. Этого мне лично мало.

sgmlfmt во FreeBSD умеет 1, 2, 4, 5, 6 - и мне этого было бы на первых порах
достаточно. Но если он не умеет ничего, кроме Linuxdoc, от него придется
отказаться.

Какую engine мне тут посоветуют?

-- 
Victor Sudakov