/[d-i]/trunk/manual/doc/building-ng.txt
ViewVC logotype

Contents of /trunk/manual/doc/building-ng.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 56738 - (hide annotations) (download)
Tue Nov 18 18:59:55 2008 UTC (4 years, 7 months ago) by fjp
File MIME type: text/plain
File size: 2249 byte(s)
Move documentation files to separate directory
1 pronik-guest 25009 --------------------------------------------
2     Build Scripts NG for Debian Installer Manual
3     --------------------------------------------
4    
5 fjp 35667 =====================================================================
6     The development of the db2latex solution has completely stalled and
7     therefore been deleted from the repository. The last version is still
8     available from:
9     svn://svn.debian.org/svn/d-i/tags/manual/20060102
10     =====================================================================
11    
12    
13 pronik-guest 25009 NG == 'new-generation'
14    
15     The NG scripts are the extremely experimental version of the original
16     build scripts for the Debian Installer Manual.
17    
18     The main purpose for NG is to be able to generate print-ready
19     documentation in non-latin-based languages, like Russian, Japanese,
20     Greek etc. The ultimate goal could be creating a common base for
21     generating good-looking print documentation from DocBook using only free
22     (as in 'DFSG-free') software.
23    
24     ****
25     WARNING:
26     THIS IS HIGHLY EXPERIMENTAL. USE IT ONLY IF YOU KNOW WHAT YOU ARE DOING!
27     ****
28    
29     The main change consists in scrapping OpenJade and JadeTeX and moving to
30     using DB2LaTeX, which should be a more flexible solution anyway. Other
31     possible solutions like XSL:FO are not yet feasible, as all the
32     renderers are either proprietary or written in Java.
33    
34     The necessary parts of the package are:
35     - build_ng.sh
36     - buildone_ng.sh
37     - templates/driver.xsl.template
38     - stylesheets/style-pdf.xsl
39     - stylesheets/lang-drivers/
40     - stylesheets/db2latex/
41    
42     The last directory contains the current db2latex distribution. The main
43     reason for putting it here is the need to implement some features not
44     yet available through the upstream version. As soon as they are stable,
45     they will eventually get integrated into the main db2latex package and
46     removed from the SVN.
47    
48     Currently, not everything works as expected. The biggest problem is
49     getting the tables right - current db2latex does not support the
50     morerows property, which is actually quite useful. A patch needs to get
51     written to support that, but I currently lack the necessary time to
52     learn XSL to the extend needed and implement the changes. Thus, the
53     project is currently in pre-alpha state, so don't expect usable results
54     right now.
55    
56     Nikolai Prokoschenko (nikolai at prokoschenko dot de)

  ViewVC Help
Powered by ViewVC 1.1.5