Gentoo Archives: gentoo-dev

From: Sven Vermeulen <swift@g.o>
To: gentoo-dev@g.o
Subject: [gentoo-dev] Gentoo Documentation Project Status Update
Date: Mon, 24 Nov 2003 14:06:29
Message-Id: 20031124140625.GA1681@gentoo.org
1 This is the status of the Gentoo Documentation Project. It will be posted
2 regularly, but not with a static frequency. All questions can be posted to
3 gentoo-doc@g.o or to me personally.
4
5 The Gentoo Documentation Project, from now on abbreviated to GDP, has its own
6 project page (just like almost all other Gentoo projects). You can find it at
7 http://www.gentoo.org/proj/en/gdp.
8
9 This status mail will briefly discuss the following tasks, objectives and/or
10 projects related to the GDP:
11 - Supported languages
12 - PDF documentation
13 - GuideXML Update
14 - Gentoo Handbook
15 - WYSIWYG editor
16 - Stylesheets
17
18 ** Supported languages
19
20 The Danish translations are fully integrated in the documentation project. Their
21 documentation can be found at http://www.gentoo.org/doc/da/index.xml. We welcome
22 broeman and Aaby to our team :)
23
24 Dertobi123 has also joined our team as new lead translator for the German
25 language. He has taken over Pylon's position. We ofcourse also welcome
26 dertobi123 aboard :)
27
28 ** PDF documentation
29
30 As is mentioned in previous status mails, we will create PDFs using FOP.
31 However, development of the script is on a hiatus until the new infrastructure
32 design is ready to be deployed (namely having webnodes sync from a master
33 webnode instead of from the gentoo cvs server).
34
35 ** GuideXML Update
36
37 The GuideXML format, used to develop the documentation, has been extended with
38 the possibility to identify chapters or sections so that internal references are
39 dealt with more easily. More information on this can be found at [1]
40
41 ** Gentoo Handbook
42
43 The part on "Installing Gentoo" is now the official source for installation
44 instructions. The "older" installation guides are still maintained though up
45 until the new Gentoo Linux comes out.
46
47 ** WYSIWYG editor
48
49 ian@g.o is working on a (GPL'd) tool that allows editors to create
50 documents through a webbased WYSIWYG editor. Currently it works but lacks some
51 necessary features, such as 100% GuideXML compliance, and the use of the Coding
52 Style. However, the project looks very promising. Certainly one to keep an eye
53 on :)
54
55 ** Stylesheets
56
57 The guide-print.xsl style has been updated so that the printable versions of our
58 documentation is really printable. Before, a margin was left unprinted,
59 rendering the "printer friendly" feature useless.
60
61 [1] http://article.gmane.org/gmane.linux.gentoo.documentation/688
62
63 Wkr,
64 Sven Vermeulen
65
66 --
67 ^__^ And Larry saw that it was Good.
68 (oo) Sven Vermeulen
69 (__) http://www.gentoo.org Gentoo Documentation Project