Chapter 19. Wrting This Book

This book is written with the technique kindly provided by PostgreSQL community. Please refer its original documentation for full detail. This chapter is a 3-minute DocBook tutorial.

• To write a new chapter, follow this:

  1. cd to ~/en/.

  2. Copy this file documentation.sgml to my-chapter.sgml.

  3. Edit file my-chapter.sgml and change id="chapter-doc" to id="chapter-my-chapter".

  4. Edit file filelist.sgml and duplicate the line with documentation and replace documentation in the new line with my-chapter.

  5. Edit file posterp.sgml and add line &my-chapter; beneath line &documentation;.

  6. Type command:

     make

     Use browser to open file index.html and you will notice that the new book has your new chapter added.

• Now assume you are translating this book from English to tradition Chinese.

  1. Duplicate everything under ~/en/ to ~/tw/.

  2. cd to ~/tw/. Translate all texts.

  3. Edit file language.sgml and change the new line from use-en to use-tw.

  4. Edit file constants.sgml: Swap IGNORE and INCLUDE for lines with use-tw and use-en.

  5. Use your Chinese image file mzf3.png to replace the English one under ~/images/.

  6. Type command:

     SP_ENCODING=UTF-8 make

• To publish this new book, copy *.html, *.css, and ~/images/* to your target location.