Re: Вопрос по docbook

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

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
предупредите, если я сворачиваю на неверный путь.

-- 
Victor Sudakov