From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3533 invoked by uid 1002); 13 Nov 2003 13:17:31 -0000 Mailing-List: contact gentoo-dev-help@gentoo.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Received: (qmail 19743 invoked from network); 13 Nov 2003 13:17:30 -0000 Date: Thu, 13 Nov 2003 14:17:31 +0100 From: Sven Vermeulen To: gentoo-dev@gentoo.org Message-ID: <20031113131731.GA1530@gentoo.org> Mail-Followup-To: gentoo-dev@gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="0OAP2g/MAC+5xKAE" Content-Disposition: inline X-Operating-System: Linux 2.4.20 X-Telephone: +32 486 460306 User-Agent: Mutt/1.5.4i Subject: [gentoo-dev] Gentoo Documentation Project Status Update X-Archives-Salt: 4e75e6d1-3318-4224-8123-6479c1fb471f X-Archives-Hash: 070c25538b2cbcf34f777022985052ad --0OAP2g/MAC+5xKAE Content-Type: text/plain; charset=iso-8859-15 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [ Sorry for the crosspost, I should've sent this to -dev immediately ] This is the status of the Gentoo Documentation Project. It will be posted regularly, but not with a static frequency. All questions can be posted to gentoo-doc@gentoo.org or to me personally. The Gentoo Documentation Project, from now on abbreviated to GDP, has its o= wn project page (just like almost all other Gentoo projects). You can find it = at http://www.gentoo.org/proj/en/gdp.=20 This status mail will briefly discuss the following tasks, objectives and/or projects related to the GDP: - Gentoo Handbook - PDF documentation - Non-gdp documentation - Packaged documentation - New supported languages ** Gentoo Handbook The first part of the Gentoo Handbook (Installing Gentoo) is finished and should be production ready. It is available online [1] and contains the installation instructions for almost all supported architectures (x86, pp= c, sparc, hppa, alpha). I hope to extend it with the other architectures tha= t are lurking (amd64, ia64, mips) when I receive more information about those. I will start with designing the second part pretty soon now. This part sh= ould contain the Gentoo-specific items for administering your system (Portage, initscripts, conf.d/env.d) ** PDF documentation Using FOP gives us the best results and can be perfectly integrated with = our current GuideXML format (as it uses an XML format itself, XML-FO). The resulting transformation of our x86 installation guide can be found at my dev-page [2].=20 I am now working on a script to have the transformation (GuideXML -> PDF)= done on the server-level so that everything can be automated.=20 ** Non-GDP documentation We have started with the cluster project documentation and are integratin= g it in our documentation tree. Other documentation (and projects) should foll= ow soon. ** Packaged documentation After a discussion [3] we came to the agreement that it is not beneficial= to provide a package for our documentation. If a user wants the Gentoo documentation somewhere on his disk, (s)he should use wget, like this: wget --recursive --level=3D1 1 --no-parent --page-requisites --convert-= link \ --no-host-directories --html-extension \ http://www.gentoo.org/doc/en/index.xml ** New supported languages The Danish language is now an officially supported language, and the Greek language volunteers have stepped up and are "in training". [1] http://www.gentoo.org/doc/en/handbook/handbook.xml [2] http://emu.gentoo.org/~swift/gentoo-x86-install.pdf [3] http://article.gmane.org/gmane.linux.gentoo.documentation/619 --=20 ^__^ And Larry saw that it was Good. (oo) Sven Vermeulen (__) http://www.gentoo.org Gentoo Documentation Project --0OAP2g/MAC+5xKAE Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (GNU/Linux) iD8DBQE/s4RrXfqz7M26L9sRAtuQAJ9FYTFjbzol+Fo+DrvAmwpbqt6ynACfYV1R NPMjczPFFw55OOhqxEw2cFM= =rRV6 -----END PGP SIGNATURE----- --0OAP2g/MAC+5xKAE--