Traducción por: — victor castelan 2008/12/02 00:21

Este plugin muestra una lista de las traducciones disponibles en una página. Es muy simple y está diseñado con las necesidades de www.dokuwiki.org y es usado para traducir documentación aquí. Existen algunas limitaciones:

• namespaces separados son usados para guardar las traducciones
• el idioma predeterminado es usado como el idioma principal
• para el idioma principal, no hay un namespace especial
• páginas traducidas requieren tener el mismo pagename como la página del idioma principal

Use este URL para descargar el archivo manualmente o via el extension manager:

• translation-plugin-latest.tgz

• Se ha producido un error mientras se leían los datos de este feed: http://dev.splitbrain.org/darcsweb/darcsweb.cgi?r=dwplugins/translation;a=rss

1. Descargar e instalar el plugin via el Extension Manager.
2. Configurar via el Config Manager
3. Agregar el siguiente código en la plantilla main.php (o agregarlo en el archivo dokuwiki\lib\tpl\default\pageheader.html de la plantilla predeterminada)

<?php
$translation = &plugin_load('syntax','translation');
echo $translation->_showTranslations();
?>

Nota: No agregar este código en la parte superior de main.php, debe ir donde se vea mejor. Necesita experimentar un poco para obtener la mejor posición.

Si se tienen varios temas instalados, es necesario agregar este código en cada main.php para que el plugin esté presente en cada plantilla.

Existen varias opciones para configurar, todas desde el config manager.

Se puede definir un namespace en donde se realizarán las traducciones (usado para activar el plugin sólamente en ese namespace). Esto es opcional, dejándolo vacío se activará el plugin en toda la wiki.

Similar al parámetro anterior, también se puede establecer una expresión regular que coincida con los nombres de páginas. Cuando esto ocurra, el cambio de traducción no será mostrada. Útil para mantener fuera ciertos namespaces de la traducción. El regexp es aplicado al nombre de página completo que comiense con un punto.

Se necesitan dar de alta los idiomas que se requieren para que las páginas sean traducidas. Separar cada idioma con una coma o un espacio. El idioma predeterminado será añadido automáticamente, así que no añadirlo en este parámetro.

Se puede opcionalmente permitir al plugin traducir la Interfase de Usuario completa de DokuWiki cuando una página de un idioma no predeterminado es seleccionada. Sólo active la opción correspondiente.

Se puede explicar a los usuarios cómo funcionan las traducciones en la wiki. Para hacer esta descripción de fácil acceso desde el selector de idioma, escriba la pagename de su descripción en la configuración.

Si no quiere utilizar el Config Manager y prefiere configurar la wiki editando el archivo de configuración, la lineas que se tienen que agregar al archivo de configuración local.php son:

$conf['plugin']['translation']['translations'] = 'en,fr,de,it';          // idiomas disponibles
$conf['plugin']['translation']['translationns'] = 'wiki';                // namespace donde se activará la traducción
$conf['plugin']['translation']['skiptrans'] = '^:(plugin|template):';    // lo que se omitirá (regexp)
$conf['plugin']['translation']['translateui']  = 1;                      // traducir la interfase de usuario también
$conf['plugin']['translation']['about']  = 'wiki:translation:about';     // página que describe el proceso 
                                                                            de traducción a los usuarios

No especificar el idioma predeterminado! Si la wiki está en español, especificar:

$conf['plugin']['translation']['translations'] = 'en,fr,de,it';           // idiomas disponibles

De otra forma el menú de idiomas, mostrará 'es' dos veces.

Este plugin hace su trabajo automáticamente, siendo llamado por la plantilla (ver instalación, pero se puede desactivar para alguna página específica agregando el siguiente código al inicio de la página:

~~NOTRANS~~