l i n u x - u s e r s - g r o u p - o f - d a v i s
L U G O D
 
Next Meeting:
October 20: Web Application Hacking: How to Make and Break Security on the Web
Next Installfest:
TBD
Latest News:
Oct. 10: LUGOD Installfests coming again soon
Page last updated:
2001 Dec 30 17:07

The following is an archive of a post made to our 'vox-tech mailing list' by one of its subscribers.

Report this post as spam:

(Enter your email address)
Re: [vox-tech] sgml, xml question
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [vox-tech] sgml, xml question



So I'm still fuzzy.

Is DocBook a specification (i.e. you have N tags to use in your document,
they must be specified in this structure/order)

Or is it an application (like MSWord) for writing documents and storing them
in XML?

 I suspect the former.  In which case is there a better tool (wysiwyg) than
vi/emacs/notepad for writing documentation?

Jay
----- Original Message -----
From: "Micah Cowan" <micah@cowanbox.com>
To: <vox-tech@franz.mother.com>
Sent: Monday, July 23, 2001 1:23 PM
Subject: Re: [vox-tech] sgml, xml question


> On Mon, Jul 23, 2001 at 10:08:21AM -0700, Peter Jay Salzman wrote:
> > hi all,
> >
> > i'm about to submit something to linuxdoc.  they want
> >
> > SGML or XML (DocBook). Or Linuxdoc SGML.
> >
> > for submission.  i should know this, but i'm unsure what SGML and XML
are.
> > i /think/ they're a generalized html, but other than that, i'm pretty
much in
> > the dark.
>
> Sort of.  It's more the reverse - HTML is an application of SGML,
> which is just a means of marking up content via <tag></tag> and such.
>
> I am using DocBook to write a Free book on C programming (when I have
> spare time).  It follows structure such as:
>
> <book>
> <intro>Blah blah blah...</intro>
> <section>
> <title>Section Title</title>
> <section>
> <title>This is a subsection</title>
> <para>This is a paragraph.</para>
> </section>
> </section>
> </book>
>
> The documentation for it is free:
>
http://www.oasis-open.org/docbook/documentation/reference/html/docbook.html
>
> > what i have is latex source, dvi, postscript and pdf.  does anyone know
how i
> > can convert a postscript (or latex) format to one of these formats?
>
> No.  These are all /target/ formats for SGML processors such as jade.
> DocBook is a purely content-oriented documentation method - more
> content-oriented than LaTeX, which is still a package written in a
> typesetting language (TeX); and so necessarily display-oriented to at
> least some degree.  Converting from LaTeX to SGML is about as
> difficult as converting PostScript to LaTeX.  You'll have to translate
> to SGML by hand.
>
> When I process my DocBook sources, I use OpenJade and target it to a
> specialized TeX purpose specifically created for the purpose,
> jadetex, which is analagous to LaTeX except that AFAIK it's not meant
> to be used directly by humans, but simply to process the output of
> Jade/OpenJade.  I usually use pdfjadetex to output to PDF with
> bookmarks and hyperlinks.
>
> IIRC, while they /accept/ Linuxdoc SGML, it is discouraged, and the
> official format for the LDP is DocBook AIUI.  DocBook is a more
> widely-used DTD and more general-purpose than Linuxdoc was.
>
> DocBook exists in both SGML and XML versions, but the current XML
> tools available for Linux don't seem up to snuff to me, so I've been
> using the SGML processing tools instead.
>
> Isn't Henry doing a talk on SGML/XML soon?  I'm sure he'll probably be
> talking about DocBook, since it's probably the single most widely used
> SGML application next to HTML (which is sort of bastardized SGML these
> days).
>
> Micah


_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com


LinkedIn
LUGOD Group on LinkedIn
Sign up for LUGOD event announcements
Your email address:
facebook
LUGOD Group on Facebook
'Like' LUGOD on Facebook:

Hosting provided by:
Sunset Systems
Sunset Systems offers preconfigured Linux systems, remote system administration and custom software development.

LUGOD: Linux Users' Group of Davis
PO Box 2082, Davis, CA 95617
Contact Us

LUGOD is a 501(c)7 non-profit organization
based in Davis, California
and serving the Sacramento area.
"Linux" is a trademark of Linus Torvalds.

Sponsored in part by:
EDGE Tech Corp.
For donating some give-aways for our meetings.