Sameer D. Sahasrabuddhe <sam_buddhe@yahoo.com>
30th October 2001

The set of sgml files that are present in this tarball together
form the whole document called Newbie's Guide to Linux.

The document uses the SGML version of Docbook, which can then be
converted into other formats using sgmltools.

Each chapter is maintained as a separate SGML file, so that it is easy
to modularise the document. The chapters can then be added into the main
document by declaring them as entities. Each chapter file can be edited
on its own and processed to see the output in different formats. Only
when putting it in the main document, the DTD declaration at the top
has to be commented out.

Tools required are docbook, modular stylesheets, jade, psgml, emacs
among others that I can't think of right now. Although any text editor
could be used to edit the files, it makes more sense to use emacs
because of a lot of great functions built into it, like validation,
easy manipulation of tags etc.

The file ngl.dsl defines the HTML-stylesheet that is used to generate
the HTML files from the original sources. All it takes is a simple
command:

$ sgmltools -b html -s ngl.dsl <filename>

The images folder contains the images used by Docbook for things like
"note" symbols etc. This directory needs to be copied to the directory
that is generated by the above folder, so that the images may be
correctly included in the displayed HTML file.