How to localize TkHTMLtidy ?

Since v0.30, it's now possible to localize TkHTMLtidy into your native language. You don't need to know Tcl or Tk to do it. I tried to make this howto for everybody, programmer or not.

Contents

What you need to modify
How to modify
Take Care...
Distribution

What you need to modify

All is in the beginning of the source file. The best way to find where the strings are, is to search this : "L10Nbegin". All you need to modify is here and it ends at "L10Nend".

How to modify

You have just to change the strings between quotes. Beware, some characters need to be escaped with a backslash :

• \ is \\
• [ and ] are \[ and \]

And another thing, if you want to write a one-line sentence that takes more than one line in the source code, you can escape it like you do in your shell : a backslash at the end of the line, with nothing after it. This is an example :

"This is a \
multiple line \
sentence"

You will need to write some text on more than one line (l10n_notice at least) To do it add a \n and Tk will make a newline character. For example :

Source code :

This is the line one. \nThis is the line two.

TkHTMLtidy :

This is the line one
This is the line two

At last but not at least, don't modify the lines beginning with a #. There are comments, and it should stay in english.

Take care...

The "encoding" Tk_optionMenu strings have a special format , you can't do what you want or TkHTMLtidy will crash. This format is defined like this :

<-option><space>:<space><what it means>

This takes effect for all variables beginning with s_.

Distribution

I DON'T SUPPORT localizations, but i'll make a link to your l10n in the TkHTMLtidy homepage if you follow these rules :

• You must not translate the GNU/GPL notice and license. Only the english one is the authentic text
• You must fill the l10n_notice variable with the example following these rules, in your language. This will appear in the About dialog. This variable is for you :)
• You must mention it's not the original TkHTMLtidy but a localization
• You must mention your email adress and a small message like this :"It's a modified version of TkHTMLtidy. Please don't bug the author about this author"

Example

All of that should be in the README file, in your language. Here is an example :

This is a localized version of TkHTMLtidy.
Translated by YOUR NAME <your@email.net>
It's a modified version so please don't bug the original author with it.