“One of the main philosophies of Emacs is that you should spend your time being a genius instead of doing trivial monotonous tasks!”
    -Sams Teach Yourself Emacs in 24 Hours

For days of trying/downloading/install/configure, I get most help from below two documents.

#1Installing And Using An XML/SGML DocBook Editing Suite

Of cource, there are more interesting stuff on the same web site, The University Of Birmingham Department Of Computer Science Software Documentation Project

#2 SGML for NT

Frankly speaking, I hope I need not use ms word. However, if you still use it, you must try to use well or you’ll suffer. I hate MS word, however, the best way to hate something is to use it well.

Introduction to DSSSL is a good artile for newbie to docbook like me. I believe that you will get a big picture on what DSSSL is after reading it. BTW, the author point the relationship between DSSSL and Scheme. Interesting topic!

For the last 2-3 weeks, all I know about docbook is just the a few docbook tags and “docbook2html”. It works for me in the early stage. However, I feel frustrated when some error happens. So I think it’s time for me to know something behind “docbook”. Something like DTD, SGML, OpenJade, DSSSL. It proves right choice for me. Know-how is a must for me to do more with docbook.

The same thing goes to “prefer Makefile, editor, compiler to IDE”. Know what’s inside and know-how is always the best way to learn new things. For the shortcut way or IDE, you can use it latter.

the linux documentation project

sources.redhat.com mailing lists

I use RH7.2 box and the docbook toolchain is from RH 7.2 CD. I don’t know whether I should update the docbook toolchain.

The detail version info is :
    docbook2html -v
    DocBook-utils version 0.6.9 (jw version 1.1)

Q #1, Need I update the docbook toolchain

In the DocBook intro, I download the Original DocBook source.
Using the “docbook2html”, I get the html version book. Strange thing is, I can’t see the result of
” <revhistory>
      <revision>”
Q #2, Who can help me out?

Q #3, Who ever use docbook on windows? Any difference with linux version? Better or worse?
I’m going to install the windows version for some guys in team.

Want to create a python.org like homepage? Don’t hesitate, just check the http://ht2html.sourceforge.net/.

Brief usage:

1. Download the package from sf . Download from SF

2. cd “doc” after extracting the package

3. make clean. (Yes, you need make & Makefile)

4. make

want to know brief usage of ht2html? Just check the “Makefile”

Want to change the links on the sidebar? Open the “links.h” and go on.

Want to change the style or layout? Open the “Makefile” and check line below:

   ”HTSTYLE =       SelfGenerator”

What’s SelfGenerator? It’s the controler related to the page style & layout.

“ls *Generator*” under the root path of the package, you can find all the sample generators.

Which is the most simple “Generator”?. “StandardGenerator”! Change the

   ”HTSTYLE =       SelfGenerator”

to

   “HTSTYLE =       StandardGenerator”

and run “make”, you’ll see changes immediately.

And no, you can’t have one

Screen ouput

Docbook Source
==========================================
<revhistory>
<revision>
<revnumber>1.0</revnumber>
<date>2004/7/6</date>
<authorinitials>Forestsong</authorinitials>
<revremark>Frst version</revremark>
</revision>
==========================================

Command:

   docbook2html -u table.docbook

Docbook source
====================================
<!DOCTYPE article PUBLIC “-//OASIS//DTD DocBook V3.1//EN”>
<article>
<artheader>
<title></title>
</artheader>
<sect1>
<title></title>
<para>
<table frame=’all’><title>Simple Table</title>
<tgroup cols=’3′ align=’left’ colsep=’1′ rowsep=’1′>
<colspec colname=’c1′/>
<colspec colname=’c2′/>
<colspec colname=’c3′/>
<thead>
<row>
<entry>a3</entry>
<entry>a4</entry>
<entry>a5</entry>
</row>
</thead>
<tfoot>
<row>
<entry>f1</entry>
<entry>f2</entry>
<entry>f3</entry>
</row>
</tfoot>
<tbody>
<row>
<entry>b1</entry>
<entry>b2</entry>
<entry>b3</entry>
</row>
<row>
<entry>d1</entry>
<entry>d2</entry>
<entry>d3</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</sect1>
</article>

====================================