New version of this document after Geert suggestions and some thinking on my side...:-)
Some clues for translators ========================== Translation order ----------------- When starting to translate debian-installer, you should first make sure to get your language choice included, then translate the core udebs, next translate the common udebs, and finally complete the rest of the udebs. The second stage installer should also be translated, but it consists of normal deb-packages, and not udebs. Suggested translation order: -languagechooser (read debian-installer/tools/languagechooser/README.trans for details) -common udebs -supported architectures udebs -second stage -future architectures udebs See the complete packages list at the end of this document. How to get files to be translated --------------------------------- -Go to http://people.debian.org/~barbier/d-i/l10n/xx where xx is your language ISO code (or xx_YY for languages which have country-dependent flavours such as pt_BR or zh_CN). -Look at the STATUS.utf8.txt file -For files reported as missing, go pick up the templates.pot file in the debian-installer CVS : http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/debian-installer/?cvsroot=d-i. Example : "Missing file: debian-installer/retriever/choose-mirror/debian/po/xx.po" --> pick up http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/debian-installer/retriever/choose-mirror/debian/po/templates.pot?cvsroot=d-i Rename this file to xx.po and start working on it -For files reported as incomplete, get the file in http://people.debian.org/~barbier/d-i/l10n/xx and complete it. Don't forget to contact the original translator (see PO file header) Rename this file to xx.po and start working on it How to translate ---------------- This document is intended to be a tutorial for gettext-related stuff. Please look for documentation of PO editing software such as KBabel, PoEdit, EMacs PO-mode, etc. Please use a dedicated PO-editing tool unless you become very familiar with translation work. Don't forget to properly fill up the PO files header, especially the Last-Translator field. If a translation team exists for your language, WORK WITH THEM. First check the debian-l10n-xxxxx mailing list where xxxxx is your language name in english (e.g. debian-l10n-polish, debian-l10n-portuguese...). For general translation issues or for finding other translators for your language, you may also use the debian-i18n mailing list (don't post translations there, however). How to get your work included in debian-installer ------------------------------------------------- Choose either of the methods below. CVS commits are encouraged. Create an alioth account and ask in -boot for getting write access. CVS commit ---------- If you have CVS write access, don't forget to update changelogs and remember: changelog files use UTF-8!! The debian-installer CVS is hosted on alioth.debian.org ("debian-installer" and "base-config" projects). File a bug ---------- You may send your translations as bug reports against the given packages. The packages names are the last part of the lines below (for instance, "languagechooser" for tools/languagechooser). Some packages have different names which are mentioned when needed. For bug reports, please use the "d-i" tag. Send to debian-boot ------------------- You may also send the translations to the debian-boot mailing list. Please use [INTL:xx] in Subjects where xx is your language code (or xx_YY) PACKAGES LIST ------------- Language choice --------------- tools/languagechooser Core udebs ---------- tools/cdebconf anna main-menu tools/kbd-chooser tools/base-installer tools/prebaseconfig utils (package: di-utils) Common udebs ------------ tools/ddetect tools/cdrom-detect retriever/cdrom (cdrom-retriever) retriever/floppy (floppy-retriever) tools/netcfg retriever/net (net-retriever) retriever/choose-mirror tools/cdrom-checker tools/iso-scan tools/bugreporter-udeb tools/partitioner tools/partconf tools/baseconfig-udeb tools/lvmcfg tools/autopartkit Architecture-dependent udebs ---------------------------- 1) Already supported architectures specific tools ------------------------------------------------- tools/grub-installer tools/lilo-installer tools/mips/arcboot-installer tools/yaboot-installer 2) Will be supported soon/in the future --------------------------------------- tools/aboot-installer tools/ia64/elilo-installer tools/hppa/palo-installer tools/sparc/silo-installer tools/s390/netdevice tools/s390/dasd Post-reboot installation stage ------------------------------ (some of these packages do not only need debconf-type translation, but also program translation) Translations must be reported as wishlist bugs against these packages. Base-config is an exception because it is a separate project on alioth, so other methods (CVS commits and -boot filing) may apply for it. base-config (debconf) shadow (debconf+programs) console-data (debconf) discover (debconf) tasksel (debconf) aptitude (programs) dselect (programs) apt (programs) dpkg (programs) exim4-config (debconf) This guide is supposed to be be a first start for translators. There are probably errors, and some packages we forgot. Please add them if you discover such packages, and fix it if you find errors. Petter Reinholdtsen, 2003-11-08 Christian Perrier, 2003-12-20 (updated packages list and more information) -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]