[kde-doc-english] branches/work/doc

[T.C. Hollingsworth]

On 8/6/11, Yuri Chornoivan <yurchor at ukr.net> wrote:
> написане Sun, 07 Aug 2011 06:55:46 +0300, Thomas Hollingsworth
> <tchollingsworth at gmail.com>:
>
>> Methinks this would make translating easier as the shared chapter
>> between kate and
>> kwrite will always be exactly the same except for the lead paragraph.
>> It certainly
>> makes syncing much easier.  Please let me know if entities shouldn't be
>> (ab)used
>> this way and I'll sed them to normal text instead.
>
> To be honest it makes translation somewhat non-trivial. ;)
>
> Local (per-docbook) entities are untranslatable. Translator should guess
> that the translation from kwrite cannot be used in kate and re-translate
> &powermode; in kate docbook (suggestion from kwrite is the false friend,
> it leaves "(power user mode)" untranslated). The knowledge of that cannot
> be guessed from common sense. ;)

I see.  I'll just use comments I can sed then.  :-)

I'm really trying to reduce the amount of manual labor involved in
keeping the kwrite & kate docs in sync.  The programmer within me dies
a little inside when a lot of copying and pasting is required.
Especially considering that it's not just me doing it, hundreds of
translators have to do so as well.

Do you think it would be helpful if I made a script available that
allowed translators to fill in a translation for the power user mode
thing and did the copying and substitution automatically?  (Perhaps
changing it to use a sentence instead of a parenthetical expression.
Something tells me there exists a language which doesn't have an
analog for that.  :-)  If translators watch diffs, I could split up my
commits such that what's gets caught by said script would be obvious
too.

Or perhaps I'm overthinking things and should just leave you all to
your own devices.  ;-)

-T.C.