Fundamentos de análisis geográfico con SEXTANTE - La Salle

20.9. SOPORTE MULTILINGÜE Y AYUDA CONTEXTUAL 339
Parameters.Add_Value(NULL, "BOOLEAN", _TL("Boolean"),
_TL("A value of type boolean."), PARAMETER_TYPE_Bool, true);
Parameters.Add_Value(NULL, "INTEGER", "Integer",
_TL("A value of type integer."), PARAMETER_TYPE_Int, 200);
Parameters.Add_Value(NULL, "DOUBLE", "Double",
_TL("A floating point value."), PARAMETER_TYPE_Double, 3.145);
Parameters.Add_Choice(NULL, "METHOD" , _TL("Method",
_TL("Choose a method from this select option."),
_TL("First Method|"
"Second Method|"),
0 );
Observa que, aun siendo cadenas de texto, los descriptores internos de los módulos (las
cadenas INPUT o RESULT) no se aplican con la función TL().
Una vez hecho esto, ahora debes crear un fichero llamado como la librería que contiene
al módulo, pero con extension .lng, situado en el mismo directorio donde se encuentre dicha
librería. En él debes añadir una entrada con el siguiente formato para cadena a traducir.
ENTRY(cadena_de_texto_en_código_fuente)
’’cadena_de_texto_traducida’’
Por ejemplo, aquí tienes una parte del fichero que correspondería al la librería que hemos
creado (que debería llamarse MiLibreria.lng
ENTRY(Method)
’’Método’’
ENTRY(Input)
’’Entrada’’
ENTRY(Output)
’’Salida’’
ENTRY(Choose a method from this select option.)
’’Seleccione un método’’
La función TL() es sensible a mayúsculas, así que vigila que estés copiando las cadenas
de forma literal.
Si se le pasa una cadena para la cual no se encuentra traducción en el fichero asociado (o
éste no existe), la función devuelve la misma cadena pasada como parámetro.
Como ves, la programación de un buen módulo incluye no sólo el propio código, sino también
preocuparse por aspectos tales como una posible traducción del mismo a otros idiomas.
Además de esto, otra de las tareas relacionadas es la de documentar el módulo para en la
medida de lo posible facilitar su uso.
Recuerda que SEXTANTE incluye una función para mostrar ayuda contextual, simplemente
debes incluir una carpeta con el nombre de la librería y dentro de ésta un fichero html
con el nombre del módulo en cuestión. Si usas una versión traducida (es decir, que éste tomando
los nombres de módulo y librería de un fichero .lng), debes nombrar ambos ficheros