xxjy / mybatisnet

Automatically exported from code.google.com/p/mybatisnet
0 stars 0 forks source link

Fix the doc build process for the 1.x line #14

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
The documentation in the 1.x line needs updating. However, the build process is 
not trivial, and took me a while to get running (I'm a new doc committer with 
no prior docbook experience).

I am now able to build the documentation on Windows, but the output is less 
than ideal in PDF. This needs fixing, probably through tweaking of the 
stylesheets.

I will also try to produce the PDF output from a linux setup, which seems to 
have better support for docbook.

One thing to consider is also to move the documentation source to docbook 5 
(currently version 4.1.2 of the docbook format is specified in the doc source). 
The impact of moving to docbook 5 needs to be evaluated, and might solve the 
PDF format problem described above.

I'm initially putting this High priority and Bug, but I am not familiar with 
the project's "standards" on issues. Please correct if I'm wrong.

Resolving this issue will obviously be useful for the 3.x line documentation 
build process.

Original issue reported on code.google.com by rcham...@gmail.com on 25 Oct 2010 at 1:39