51 lines
2.3 KiB
HTML
51 lines
2.3 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
|
|
<TITLE>: The Format of HOWTOs </TITLE>
|
|
<LINK HREF="Howtos-with-LinuxDoc-4.html" REL=next>
|
|
<LINK HREF="Howtos-with-LinuxDoc-2.html" REL=previous>
|
|
<LINK HREF="Howtos-with-LinuxDoc.html#toc3" REL=contents>
|
|
</HEAD>
|
|
<BODY>
|
|
<A HREF="Howtos-with-LinuxDoc-4.html">Next</A>
|
|
<A HREF="Howtos-with-LinuxDoc-2.html">Previous</A>
|
|
<A HREF="Howtos-with-LinuxDoc.html#toc3">Contents</A>
|
|
<HR>
|
|
<H2><A NAME="s3">3.</A> <A HREF="Howtos-with-LinuxDoc.html#toc3">The Format of HOWTOs </A></H2>
|
|
|
|
<H2><A NAME="ss3.1">3.1</A> <A HREF="Howtos-with-LinuxDoc.html#toc3.1">Introduction</A>
|
|
</H2>
|
|
|
|
<P> Our HOWTOs are released to the public in various formats: Plain
|
|
Text, HTML, PostScript, and PDF. Instead of having to write the same
|
|
HOWTO in all of these formats, just one HOWTO is written in a source
|
|
format, DocBook or LinuxDoc, which gets converted by computer into all
|
|
of the other formats.</P>
|
|
<P>To get an idea of what a source format looks like, take a look at the
|
|
source file of a webpage (if you haven't already). You will see all
|
|
sorts of words in <angle brackets>. These are called tags.
|
|
These webpages (tags and all) are in html: <EM>Hypertext Markup
|
|
Language</EM>. The LDP uses formats something like this for its
|
|
documents.</P>
|
|
<P>The markup languages LDP uses meet the requirements of either
|
|
<EM>Standard Generalized Markup Language (SGML)</EM> or <EM>XML</EM>.
|
|
The LDP now uses the following two flavors of sgml: <EM>LinuxDoc</EM> and
|
|
<EM>DocBook</EM> as well as the <EM>DocBook</EM> flavor of XML.
|
|
Interestingly, it turns out that html is just another flavor of sgml
|
|
(but some features people use in html violate sgml rules so it's not
|
|
pure sgml anymore).</P>
|
|
<P>This mini-HOWTO is all about using the simple LinuxDoc flavor of sgml.
|
|
You may call it "LinuxDoc markup". It can be converted by computer to
|
|
html, plain text, postscript, pdf, and DocBook. It's a lot easier
|
|
than HTML or DocBook and you don't need a special editor for it as
|
|
it's easy to type in the tags (or use macros for them) using your
|
|
favorite editor or word processor.</P>
|
|
|
|
<HR>
|
|
<A HREF="Howtos-with-LinuxDoc-4.html">Next</A>
|
|
<A HREF="Howtos-with-LinuxDoc-2.html">Previous</A>
|
|
<A HREF="Howtos-with-LinuxDoc.html#toc3">Contents</A>
|
|
</BODY>
|
|
</HTML>
|