|
467
|
1 Welcome to the OS-9 documentation effort. The motivation behind scanning
|
|
|
2 and reissuing the documentation is that without documentation no new
|
|
|
3 users will discover OS-9. This little operating system is more than 20
|
|
|
4 years old, and we want it to be here for at least another 20 years.
|
|
|
5
|
|
|
6 We have therefore tried to find the most durable and rich format
|
|
|
7 for documents possible. DocBook is more than 10 years old. Older than
|
|
|
8 MS-Word. It began in 1991 as a joint project of HaL Computer Systems and
|
|
|
9 O'Reilly. It will very likely be around in 2020 also. If it isn't it is
|
|
|
10 a text-based format, so it is possible to reverse-engineer and convert
|
|
|
11 the format.
|
|
|
12
|
|
992
|
13 Docbook is in a transition from an SGML-based format to XML. The two formats are
|
|
|
14 not compatible. Primary differences are that the DTD is different. For SGML it is
|
|
|
15 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
|
|
|
16 and for XML it is
|
|
|
17 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
|
18 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
|
|
|
19 Furthermore, some elements are terminated with /, such as <void/>, <colspec/> etc.
|
|
|
20
|
|
|
21 DOCBOOK SGML SOFTWARE:
|
|
|
22 ---------------------
|
|
467
|
23 To create HTML, PDF or PostScript you must have these RPMs installed on
|
|
|
24 your RedHat system:
|
|
|
25
|
|
|
26 docbook-dtd41-sgml
|
|
|
27 sgml-common
|
|
|
28 docbook-utils
|
|
|
29 docbook-utils-pdf
|
|
|
30 tetex-dvips
|
|
|
31 tetex
|
|
|
32 jadetex
|
|
992
|
33 ..see also http://sources.redhat.com/docbook-tools/
|
|
|
34
|
|
|
35 DocBook Install mini-HOWTO: http://www.tldp.org/HOWTO/mini/DocBook-Install/
|
|
|
36
|
|
|
37 Another approach is the xmlto application installed on newer RedHat systems.
|
|
467
|
38
|
|
|
39 DOCBOOK REFERENCES:
|
|
992
|
40 -------------------
|
|
467
|
41 The Duck book
|
|
|
42 http://www.docbook.org/
|
|
|
43
|
|
|
44 The KDE DocBook Authors guide
|
|
|
45 http://i18n.kde.org/doc/markup/
|
|
|
46
|
|
|
47 The Crash Course to Docbook
|
|
|
48 http://www.caldera.de/~eric/crash-course/HTML/index.html
|
|
992
|
49
|
|
|
50 Mark Galassi's tutorial/introduction to writing in DocBook.
|
|
|
51 http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html
|
|
1148
|
52
|
|
|
53 DOCBOOK EXTENSIONS:
|
|
|
54 -------------------
|
|
|
55 At the time of this writing Docbook is undergoing modularisation work.
|
|
|
56 One of the new modules is the Extended Backhus-Naur Form, which can
|
|
|
57 be used to describe syntax for shell and the C language. But currently
|
|
|
58 the renderers don't understand the new elements, so we can't use them.
|
|
|
59 I've started to rewrite the shell syntax in os9guide/shell.refentry
|
|
|
60
|
|
|
61 For Extended Backhus-Naur Forms use:
|
|
|
62 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook EBNF Module V1.1CR1//EN"
|
|
|
63 "http://www.oasis-open.org/docbook/xml/ebnf/1.1CR1/dbebnf.dtd" [
|
|
|
64
|
|
|
65
|
|
|
66 DSSSL STYLESHEET:
|
|
|
67 ----------------
|
|
|
68 Docbook2pdf uses DSSSL stylesheet. The main one is located in this directory.
|
|
|
69 Since the default DSSSL stylesheet is updated once in a while and you must
|
|
|
70 reapply your preferences to the new one, here is what is different from
|
|
|
71 the default:
|
|
|
72 - Enumerate chapters and sections
|
|
|
73 - Use element ids as filenames
|
|
|
74 - Don't generate article titlepage on separate page
|
