Re: d-i manual: add warning and call for help on outdated translations
Hi,
Holger Wansing <linux@wansing-online.de> wrote:
> Package: installation-guide
> Severity: wishlist
>
>
> Javier Fernández-Sanguino Peña <jfs@debian.org> wrote:
> > On Thu, Mar 12, 2015 at 08:48:47PM +0100, Holger Wansing wrote:
> > > The situation for the d-i manual is similar: we have some languages,
> > > that did not receive no or nearly no translation updates since the
> > > release of Wheezy.
> > > Should those languages be deactivated?
> > > These are: japanese (no update since 17 months)
> > > russian (no update since 24 months)
> > > swedish (no update since 2 years 7 months)
> > > vietnamese (no update since 2 years 7 months)
> > > chinese zh_CN (no update since 2 years 3 months)
> > > All of them are po-based translations, so the manuals are strictly
> > > spoken not outdated (changed paragraphs fall-back to english), but it of
> > > no good use for users probably?
> >
> > Even though the documents are not translated fully some content might still
> > be useful.
> >
> > Also, showing that the translation is not finished, but partial, might
> > actually spur some people to take it over.
>
> Good point.
>
> > I think it would be best to keep the languages and try to find a way to
> > (automatically) add a disclaimer to the top of the document saying something
> > like: "This document is not fully translated and it is not actively being
> > updated. If you can help please contact xxxxx"
>
> Yes, good idea.
> I will prepare a patch as proposal for that soon.
>
> > When I mean automatically I mean that the text should be added when the PO
> > statistics show a large part of the content untranslated.
>
> Hmm, as first variant I will start with a fix setting.
> Such automatism is probably out of my skills, we will see.
>
> To track it, I turn this into a bugreport with this mail.
So here is a proposal attached for review.
Generally I have added a paragraph (warning) on the first page of the manual,
which is only displayed in selected languages, controlled over a newly created
condition, which will be set (or not set) in the corresponding file in
../build/lang-options.
To have a dedicated place for setting that condition in the future, I
created a language file in that directory for all languages, even if that
file will remain empty for currently up-to-date languages.
In the translations, I will copy the english text of the new paragraph
into the foreign language too, since we have no translator to do that
job for outdated languages (that's what this all is about, he :-) )
So the warning and call for help will be displayed in English, but not
in the foreign language. Should be no problem, since people being able
to do the translator job, can read it in English too :-)
Holger
--
============================================================
Created with Sylpheed 3.2.0 under
D E B I A N L I N U X 7 . 0 W H E E Z Y !
Registered Linux User #311290 - https://linuxcounter.net/
============================================================
Index: build/lang-options/nn
===================================================================
--- build/lang-options/nn (Revision 0)
+++ build/lang-options/nn (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/tl
===================================================================
--- build/lang-options/tl (Revision 0)
+++ build/lang-options/tl (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/ro
===================================================================
--- build/lang-options/ro (Revision 0)
+++ build/lang-options/ro (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/da
===================================================================
--- build/lang-options/da (Revision 0)
+++ build/lang-options/da (Revision 0)
@@ -0,0 +1 @@
+# empty placeholder file
Index: build/lang-options/ru
===================================================================
--- build/lang-options/ru (Revision 0)
+++ build/lang-options/ru (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/zh_TW
===================================================================
--- build/lang-options/zh_TW (Revision 0)
+++ build/lang-options/zh_TW (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/README
===================================================================
--- build/lang-options/README (Revision 69877)
+++ build/lang-options/README (Arbeitskopie)
@@ -1,3 +1,10 @@
+ABOUT THIS DIRECTORY
+====================
+
+Each language, for which a translation is existing, should have a file
+here with the language code as its name, even if the file is empty.
+
+
INSTRUCTIONS FOR USING OPTIONAL PARAGRAPHS
==========================================
@@ -7,7 +14,7 @@
To include an optional paragraph for your translation, you need to "enable"
it:
-- creating a file in this directory with your language code as its name
+- creating a file in this directory (if not already existing, see above)
- add a singe line in this file containing:
optional_paras="condition(s)"
- if you want to enable more than one optional paragraph, separate their
Index: build/lang-options/el
===================================================================
--- build/lang-options/el (Revision 0)
+++ build/lang-options/el (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: build/lang-options/en
===================================================================
--- build/lang-options/en (Revision 0)
+++ build/lang-options/en (Revision 0)
@@ -0,0 +1 @@
+# empty placeholder file
Index: build/lang-options/cs
===================================================================
--- build/lang-options/cs (Revision 0)
+++ build/lang-options/cs (Revision 0)
@@ -0,0 +1 @@
+# empty placeholder file
Index: build/lang-options/eu
===================================================================
--- build/lang-options/eu (Revision 0)
+++ build/lang-options/eu (Revision 0)
@@ -0,0 +1 @@
+optional_paras="outdated-translation"
Index: en/bookinfo.xml
===================================================================
--- en/bookinfo.xml (Revision 69877)
+++ en/bookinfo.xml (Arbeitskopie)
@@ -36,6 +36,18 @@
</para></note>
</para>
+<warning condition="outdated-translation"><para>
+This paragraph will not be displayed in the english d-i manual, of
+course.
+Translators: This paragraph will be displayed only in translations
+which are heavily out-of-date and not in active maintenance. It shall
+be left untranslated. Keep it as the following:
+This translation of the installation manual is not up-to-date and
+currently there is noone actively working on updating it. If you can
+help with this, please contact debian-boot or the debian-l10n-xxx
+mailinglist for this language. Many thanks
+</para></warning>
+
<para condition="translation-status">
Translators can use this paragraph to provide some information about
the status of the translation, for example if the translation is still
Reply to: