Internationalizations

O PmWiki suporta a internacionalização de páginas web, permitindo que caracteres acentuados apareçma em nomes de página e a quese completa customização dos prompts e mensagens do pmwiki. Grande parte da customização é fornecida pela função XLPage() no PmWiki, que carrega um conjunto de variáveis de tradução de uma página wiki (tipicamente nomeada XLPage, mas pode ter qualquer nome que você desejar).

O resto desa página é devotada à instalação, configuração e uso de outros idiomas. Se você está procurando por ferramentas e ajuda para localização do PmWiki na sua lingua, ou como você pode melhorar traduções existentes, comece em pmwiki.org com a página Localization - O portal de tradução.

Carregando páginas de tradução

Muitas páginas em Outras Linguas já foram criadas e mantidas no site pmwiki.org. Você pode baixar um arquivo com essas traduções do endereço http://www.pmwiki.org/pub/pmwiki/i18n/ . Simplismente faça o download dos arquivos de linguagens aprorpiados, e desempacote-os no diretório contendo o arquivo pmwiki.php da sua instalação. Cada arquivo contém um número de arquivos de página que serão colocados dentro do diretório wikilib.d/, e alguns scripts especiais para a tradução que usam um a character set outro que não o iso-8859-1 (padrão do PmWiki). Você também pode usar o charset UTF-8.

Uma vez que as páginas de tradução estejam instaladas, você habilita uma linguagem adicionando uma chamada para o XLPage() no seu arquivo config.php. Por exemplo, para selecionar prompts em francês, você deve especificar

Que diz para carregar as traduções para o francês ('fr') da página PmWikiFr.XLPage. É perfeitamente normal carregar multiplas páginas; assim, se você quer criar suas próprias traduções sem mudar as que você tem no arquivo i18n, simplesmente crie uma nova página (veja abaixo) e carregue-a no topo. certifique-se de carregar primeiro a página com as suas mudanças locais:

XLPage('fr','PmWikiFr.XLPageLocal');  # minhas traduções locais 
XLPage('fr','PmWikiFr.XLPage');       # do pacote i18n.tgz

Se a sua intenção é oferecer múltiplas linguagens no seu site, e usar Grupo como seletores de linguagem, você talvez queira colocar este código no seu arquivo de customizações por grupo (veja GroupCustomizations). Por exemplo, se o seu site está publicado em Francês e Inglês, e as páginas em francês estão no grupo chamado Fr, você poderia criar um arquivo nomeado como Fr.php no seu diretório local/ , contendo:

<?php if (!defined('PmWiki')) exit();
## mude para o francês
XLPage('fr','PmWikiFr.XLPage');

You may wish to create a page called PmwikiFr.php with the same content to access the French documentation in the PmwikiFr group. En.php is not necessary in this case since English is the default language.

An alternative to the above would be to add to config.php the following, which tests if there is an XLPage in a group, and if it finds one it gets loaded:

    
$xlpage = FmtPageName('$Group.XLPage', $pagename);
if (PageExists($xlpage)) XLPage($xlpage, $xlpage);

With this method you would need to copy any relevant XLPage into any group which needs the different language support.

See also Cookbook:MultiLanguage

Creating New Translations

If language pages don't exist for your desired language, it's easy to create one! An XLPage translation file simply contains lines of the form

where "phrase" is an internationalized phrase (denoted by $[phrase]) in PmWiki's $...Fmt variables, and "translated phrase" is what should be printed in your particular language. For example, the line (in PmWikiFr.XLPage)

converts "$[Search]" to "Rechercher" on output. The file Localization:XLPageTemplate is a good starting point for creating a new XLPage and has most of PmWiki's key phrases already listed in it.

If you create new versions of PmWiki pages in other languages, please consider adding them to the main PmWiki site so that they can be made available to others in the i18n archives! (Be sure to check out The Localization Portal for further information on effectively internationalizing PmWiki.)

Enabling "Special" Characters in WikiLinks

To enable "special" characters like for example German umlauts in WikiLinks, it is necessary to configure the server locale to ensure that PmWiki uses the proper character set definition.

If this is not possible due to limited access to the server configuration, PmWiki can be configured to use a specific locale by using the XLPage options (see XLPageTemplate).

For German umlauts, you'd need for example:

• 'Locale' => 'deu', <- for Windows servers, see MSDN List of locale identifiers
• 'Locale' => 'de_DE', <- for Linux servers

Note that the locale identifier depends on the operation system and perhaps on the specific installation.

Notes

   XLPage('es','PmWikiEs.XLPage');
   XLPage('fr','PmWikiFr.XLPage');
   XLPage('ru','PmWikiRu.XLPage');
   $XLLangs = array('en');

    XLPage('fr', 'PmWikiFr.XLPage');
    XLPage('fr-ca', 'PmWikiFrCa.XLPage');

    $XLLangs = array('fr', 'en');

    XLSDV('nl', array('my English expression'=>'mijn Nederlandse uitdrukking'));

    'my English expression' => 'bla bla',