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 XL Page() no PmWiki, que carrega um conjunto de variáveis de tradução de uma página wiki (tipicamente nomeada XL Page, 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 Group Customizations?). 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 Pmwiki Fr?.php with the same content to access the French documentation in the Pmwiki Fr? 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 XL Page 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 XL Page 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 XL Page 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 XL Page 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 Wiki Links?

To enable “special” characters like for example German umlauts in Wiki Links?, 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 XL Page 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

  XL Page(‘es’,’PmWiki Es.XL Page?’);
  XL Page(‘fr’,’PmWiki Fr.XL Page?’);
  XL Page(‘ru’,’PmWiki Ru.XL Page?’);
  $XLLangs = array(‘en’);

   XL Page(‘fr’, ‘PmWiki Fr.XL Page?’);
   XL Page(‘fr-ca’, ‘PmWiki Fr Ca.XL Page?’);

   $XLLangs = array(‘fr’, ‘en’);

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

   ‘my English expression’ => ‘bla bla’,