Implement infrastructure that allows entities to be translated

24 files changed, 64 insertions, 2 deletions

diff --git a/build/entities/l10n/README b/build/entities/l10n/README
new file mode 100644
index 000000000..3d1b6369e
--- /dev/null
+++ b/build/entities/l10n/README
@@ -0,0 +1,57 @@
+INSTRUCTIONS FOR TRANSLATING ENTITIES
+=====================================
+
+It is possible to translate entities used in the installation guide.
+Note that only a few entities are suitable for translation. Others, for
+instance those refering to package names, should not be translated.
+
+There are several reasons for using entities in the manual. One is to
+improve consistency and to make it possible to maintain changing data in one
+central location; another is to make it easier for derived distributions to
+change the branding of the manual.
+Given these goals the intention is to increase the use of entities. 
+
+This also means that translators preferably should not replace entities by
+fixed text. However, the standard set of entities may not be sufficient for
+a good translation, for instance because a language needs different
+conjugations for a word while in English this is not needed.
+
+Translators are free to add additional entities if they need them for
+different conjugations. Try to keep the names of the entities you add
+logical. Examples:
+xxx-dat (for dative conjugation)
+
+If you feel some text in the English version of the manual could be replaced
+by an entity, please send a mail to the debian-i18n list for discussion.
+
+How to translate entities
+=========================
+- Look up the definition of the entity you want to translate in the relevant
+  entity file (e.g. ../common.ent) and copy it.
+- Add or edit a new file <your_language_code>.ent in this directory.
+- Add the definition of the entity you want to translate in this file.
+- Replace the English text in the entity with your translation. Do *not*
+  change any xml tags included in the entity.
+
+You can of course also copy the file for another language already in this
+directory as a starting point.
+
+Translatable entities
+=====================
+Please do not translate entities that are not listed below without discussing
+this first on the debian-boot list!
+Before the release of Etch, it is very unlikely that any new entities will be
+added. The infrastructure is mostly being added now to allow a few minor
+translations and to have it in place for the next release, Lenny.
+
+- enterkey
+- MSG-YES
+- MSG-NO
+
+Non-translatable entities
+=========================
+The entities below should _not_ be translated. If you think an entity listed
+below is used in a way that it should be translated, this is possably a bug
+that should be fixed in the original text rather than a reason to translate it.
+
+- releasename
diff --git a/build/entities/l10n/ca.ent b/build/entities/l10n/ca.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/ca.ent
diff --git a/build/entities/l10n/cs.ent b/build/entities/l10n/cs.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/cs.ent
diff --git a/build/entities/l10n/de.ent b/build/entities/l10n/de.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/de.ent
diff --git a/build/entities/l10n/el.ent b/build/entities/l10n/el.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/el.ent
diff --git a/build/entities/l10n/en.ent b/build/entities/l10n/en.ent
new file mode 100644
index 000000000..477405da3
--- /dev/null
+++ b/build/entities/l10n/en.ent
@@ -0,0 +1 @@
+<!-- Empty file to avoid warnings when the manual is built. -->
diff --git a/build/entities/l10n/es.ent b/build/entities/l10n/es.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/es.ent
diff --git a/build/entities/l10n/fi.ent b/build/entities/l10n/fi.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/fi.ent
diff --git a/build/entities/l10n/fr.ent b/build/entities/l10n/fr.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/fr.ent
diff --git a/build/entities/l10n/hu.ent b/build/entities/l10n/hu.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/hu.ent
diff --git a/build/entities/l10n/it.ent b/build/entities/l10n/it.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/it.ent
diff --git a/build/entities/l10n/ja.ent b/build/entities/l10n/ja.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/ja.ent
diff --git a/build/entities/l10n/ko.ent b/build/entities/l10n/ko.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/ko.ent
diff --git a/build/entities/l10n/nl.ent b/build/entities/l10n/nl.ent
new file mode 100644
index 000000000..ba20e4f08
--- /dev/null
+++ b/build/entities/l10n/nl.ent
@@ -0,0 +1,2 @@
+<!ENTITY MSG-YES "<userinput>Ja</userinput>">
+<!ENTITY MSG-NO "<userinput>Nee</userinput>">
diff --git a/build/entities/l10n/pt.ent b/build/entities/l10n/pt.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/pt.ent
diff --git a/build/entities/l10n/pt_BR.ent b/build/entities/l10n/pt_BR.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/pt_BR.ent
diff --git a/build/entities/l10n/ro.ent b/build/entities/l10n/ro.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/ro.ent
diff --git a/build/entities/l10n/ru.ent b/build/entities/l10n/ru.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/ru.ent
diff --git a/build/entities/l10n/sv.ent b/build/entities/l10n/sv.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/sv.ent
diff --git a/build/entities/l10n/vi.ent b/build/entities/l10n/vi.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/vi.ent
diff --git a/build/entities/l10n/zh_CN.ent b/build/entities/l10n/zh_CN.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/zh_CN.ent
diff --git a/build/entities/l10n/zh_TW.ent b/build/entities/l10n/zh_TW.ent
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/build/entities/l10n/zh_TW.ent
diff --git a/build/templates/install.xml.template b/build/templates/install.xml.template
index 038e7ae33..8f24c1591 100644
--- a/build/templates/install.xml.template
+++ b/build/templates/install.xml.template
@@ -9,7 +9,8 @@
  <!ENTITY % dbcent PUBLIC
       "-//OASIS//ENTITIES DocBook Character Entities V4.2//EN"
       "/usr/share/sgml/docbook/dtd/xml/4.2/dbcentx.mod"> %dbcent;
- <!ENTITY % dynamicdata    SYSTEM "../##TEMPDIR##/dynamic.ent"       > %dynamicdata;
+ <!ENTITY % dynamicdata    SYSTEM "../##TEMPDIR##/dynamic.ent"    > %dynamicdata;
+ <!ENTITY % langdata       SYSTEM "##ENTPATH##/l10n/##LANG##.ent" > %langdata;
  <!ENTITY % commondata     SYSTEM "##ENTPATH##/common.ent"        > %commondata;
  <!ENTITY % urlsdata       SYSTEM "##ENTPATH##/urls.ent"          > %urlsdata;
 
diff --git a/debian/changelog b/debian/changelog
index 9626be9d5..f6ddeb0a6 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,10 +1,11 @@
 installation-guide (2007xxxx) UNRELEASED; urgency=low
 
   * Cleaned up definitions of some entities and removed unused ones.
+  * Implement infrastructure that allows entities to be translated.
   * appendix/files: update information about mouse configuration, based on a
     patch from Peter Samuelson (for which thanks). Closes: #406290.
 
- -- Frans Pop <fjp@debian.org>  Mon, 22 Jan 2007 20:20:41 +0100
+ -- Frans Pop <fjp@debian.org>  Mon, 22 Jan 2007 22:31:26 +0100
 
 installation-guide (20070122) unstable; urgency=low