i18nHTML

About

i18nHTML is a collection of PHP files that can be used to write webpages that visitors can translate into their respective native languages. i18nHTML uses a database to match sentences from the webpage against translations. i18nHTML defines a set of PHP functions that generate either the translated HTML sentences or the original (typically English) text with decorations that allow users to provide translations. i18nHTML requires the internationalized webpages to be written using the provided PHP functions but does not constrain the page design in any way. Webpages internationalized with i18nHTML can be updated without loosing existing translations for sentences that were not changed. Note that it is important that you use the i18nHTML TITLE command in your documents in order to ensure that the character set and other meta-data is set properly.

News

i18nHTML 0.3.1 released

This release provides some minor improvements to various parts of the user interface. If the language specified by the user is not in the approved list, it is automatically changed to the language of the original text. Administrators can now quickly delete accounts of users that never contributed translations.

i18nHTML 0.3.0 released

This release adds an administrative interface to PHP. Translators must now register accounts, making it easier to limit abuse. The overall codebase was restructured, separating the interface webpages from the include files. Heuristics for detecting invalid translations were added. The release also contains various minor bugfixes and cosmetic improvements. The code can now be installed using the new configure script (use /usr for the prefix). For Debian users, an unofficial Debian package is provided. Read the README file for installation and update instructions. You should backup your old translation database first.

i18nHTML 0.2.1 released

This release adds support for PHP installations with and without magic quotes. It is now possible to specify a prefix for the SQL tables used by i18nHTML. The .inc files were renamed to .inc.php for security reasons. Finally there are now additional Bulgarian translations in the database.

i18nHTML 0.2.0 released

i18nHTML 0.2.0 is a cleanup release, removing dead and redundant code. A few additional convenience functions (TH, TD) have been added. The release also fixes problems with voting for translations and problems with escaping quotes. The format of the database changed (slightly) again. The necessary update can be done by running the update0_2_0.php script and feeding the SQL statements that update.php generates into MySQL. Running update0_2_0.php by itself will not do the data conversion (for security reasons). You should backup your old translation database first.
The new release also contains additional initial translations to boostrap the webpage. Existing i18nHTML webpages should work with the new release without changes to the code.

i18nHTML 0.1.0 released

i18nHTML 0.1.0 is expected to solve various character set encoding issues. It also ensures that all entered translations match the original sentence in the number of escape sequences. The new version also resolves various minor bugs (such as editor mode only working with php-register-globals enabled).

Upgrading from i18nHTML 0.0.2 to 0.1.0 requires changes to the encoding of strings in the database (which is now hopefully properly based on unicode). This can be done by running the update.php script and feeding the SQL statements that update.php generates into MySQL. Running update.php by itself will not do the data conversion (for security reasons). You should backup your old translation database first. mysqldump should be useful here. Note that update.php may discard translations that it believes have serious character set (or other) problems. The total number of discarded translations can be found at the end of the output (in a generated comment).

Another important step in upgrading from 0.0.2 to 0.1.0 is to use the new TITLE function to generate the title of all webpages. The reason is that the TITLE function will generate other HTML tags that should be placed in the HTML header to help ensure that the browser picks up the character encodings correctly.

Download

You can find the latest version here. The latest SVN version can be obtained using

$ svn checkout https://gnunet.org/svn/i18nHTML/

If you want to be notified about updates, subscribe to i18nHTML on freshmeat

Bugtrack

i18nHTML uses Mantis for bugtracking. Visit https://gnunet.org/mantis/ to report bugs. You need to sign up for a reporter account. Please make sure you report bugs under I18nHTML and not under any of the other projects.

If you dislike Mantis and need to report a bug contact christian@grothoff.org via e-mail (good luck getting by the spam-filter).

Sites using i18nHTML

We are aware of the following sites using i18nHTML:

If your sites uses i18nHTML and you would like it to be listed here, please let me know!

go to i18nHTML administration page