Traducciones

Las traducciones requieren una licencia.

La compatibilidad con traducciones ofrece la posibilidad de usar un proveedor especial para devolver cadenas según el idioma del usuario que accede a la API o al panel.

Definir cadenas

Vaya a Engranaje de configuración > Traducciones en la consola de administración para definir cadenas de idioma.

Para definir un nuevo idioma, haga clic en Create New Language Translation. El ID de idioma debe ser el ID de idioma que el navegador presentará cuando un usuario acceda a la API o al panel (p. ej. en-US).

Una vez creado el idioma, puede empezar a añadirle cadenas haciendo clic en Edit. La clave (Key) se utilizará dentro de sus scripts y devolverá el valor. El valor cambiará según el idioma.

Usar cadenas

Para usar una cadena, aprovechará el nuevo proveedor $tl:. Al usar este proveedor en sus scripts, la clave se traducirá automáticamente a la cadena correspondiente al idioma del usuario.

Por ejemplo, usaría la variable de esta manera.

$tl:String1

El valor devuelto, cuando la configuración regional del usuario sea en, será USA.

Actualmente, las cadenas están disponibles automáticamente en API y paneles, y en scripts cuando se establece la variable LanguageID.

Tenga en cuenta que el proveedor $t: también está disponible, pero debido a conflictos con el proveedor FileSystem y con unidades T: asignadas, sugerimos usar en su lugar el proveedor $tl:. El proveedor $t: se asignará en equipos que no tengan ya una unidad T: asignada.

Seleccionar un idioma

PowerShell Universal selecciona el idioma del usuario examinando el encabezado Accept-Language de la solicitud HTTP cuando los usuarios visitan la página del panel o realizan una llamada a la API. Si desea establecer un idioma al ejecutar un script, deberá establecer la variable $LanguageID en el idioma que desea devolver.

Lógica de reserva

Si no hay un idioma definido para el ID de idioma específico (p. ej. en-US), PowerShell Universal intentará localizar el siguiente mejor idioma. Por ejemplo, en ese caso buscaría en.

Si no se encuentra ningún idioma, se utilizará el idioma de reserva de todo el servidor. Si no se ha definido, se usará en. Puede especificar el idioma de reserva en Engranaje de configuración > General.

Si no se encuentra ningún idioma para la clave especificada, se devolverá la clave.

Ficheros de idioma

Los ficheros de idioma se generan en la carpeta translations dentro del repositorio. Cada idioma tendrá un fichero .ps1 con el nombre del ID de idioma. New-PSUTranslation se usa para definir el idioma y establecer las cadenas.

Puede resultar conveniente editar los ficheros de idioma de esta manera para facilitar copiar y pegar claves entre ficheros de idioma.