Lost in Translation? Explora les capacitats multilingües de tabi

tabi simplifica el procés de creació de llocs web multilingües perquè puguis connectar amb una audiència global. En aquesta guia, t’explicarem tot el que necessites saber, des de com configurar la llengua principal en el teu lloc fins a com contribuir amb les teves pròpies traduccions. Comencem!

Preguntes Freqüents

Quines llengües admet tabi?

tabi admet les següents llengües:

  • Alemany
  • Àrab
  • Anglès
  • Català
  • Coreà
  • Espanyol
  • Francès
  • Hindi
  • Italià
  • Japonès
  • Persa
  • Portuguès (Europeu)
  • Rus
  • Ucraïnès
  • Xinès (Simplificat)

Per a una llista sempre actualitzada de llengües suportades, consulta la carpeta i18n en el repositori de tabi.

Com estableixo la llengua predeterminada del meu lloc?

Pots definir la llengua principal del teu lloc configurant la variable default_language a config.toml.

Per exemple, si vols que la llengua principal sigui el Xinès, simplement afegeix aquesta línia a l’arxiu config.toml:

base_url = "https://welpo.github.io/tabi"
title = "~/tabi"
default_language = "zh"

Si el valor de default_language coincideix amb el nom d’un fitxer TOML al directori i18n, tots els textos de tabi es traduiran a aquest idioma.

Com gestiona tabi el suport multilingüe?

Zola genera automàticament URLs per a cada llengua que no sigui la predeterminada de la següent manera: {base_url}/{codi_idioma}/{post}.

tabi facilita la navegació entre llengües afegint un commutador de llengua en la barra de navegació (que només es mostra quan hi ha més d’una llengua habilitada).

Si pujes a la barra de navegació, veuràs el commutador de llengua. Si cliques sobre ell, es mostrarà un desplegable amb les llengües disponibles. Si fas clic en el nom d’una llengua, et portarà a la mateixa pàgina en aquesta llengua.

Si una pàgina específica no està disponible en una llengua, tabi mostrarà una pàgina 404 amb el text:

La pàgina que has sol·licitat sembla que no existeix o encara no s’ha traduït al teu idioma. Comprova l’URL per detectar errors o torna a la pàgina d’inici.

Aquest text es mostrarà una vegada per cada llengua activada en el teu lloc. Pots veure aquesta pàgina en acció aquí.

Com activo el suport multilingüe?

Per habilitar el suport per a diverses llengües, necessites configurar la variable languages a config.toml. Per exemple, si vols un lloc amb anglès com a llengua principal que també admeti hindi i espanyol, pots configurar el teu config.toml de la següent manera:

base_url = "https://example.com"
title = "My Site"
default_language = "en"

[languages.hi]
title = "मेरी वेबसाइट"

[languages.es]
title = "El meu web"

En cada secció de llengua pots establir altres variables com taxonomies, description… Consulta la documentació de suport multilingüe de Zola per a més informació.

Què són aquests codis de dues lletres?

Els codis de dues lletres són codis d’idioma ISO 639-1 (o IETF BCP 47, quan cal), que serveixen per identificar idiomes d’una manera estandarditzada.

tabi utilitza aquests codis per permetre la navegació entre idiomes i traduir el tema.

Com personalitzo o reemplaço una cadena de text específica al meu lloc web?

tabi cerca els fitxers de cadenes en el següent ordre. $base_directory és on resideix el teu lloc Zola (allà on està config.toml):

  1. $base_directory + "i18n"
  2. $base_directory + "themes/tabi/i18n"

Per tant, si crees i18n/ca.toml al teu directori base, tabi llegirà les cadenes de text d’aquest fitxer en lloc de les cadenes predeterminades en català. Pots fer això per a qualsevol idioma, suportat o no.

Assegura’t de copiar tot el fitxer per a aquest idioma primer, o el tema utilitzarà l’anglès per les claus que faltin.

Què passa si falta una traducció o està incompleta?

Si una cadena no es troba en el fitxer d’idioma, tabi utilitzarà a la cadena predeterminada en anglès.

El meu idioma no està suportat. Puc contribuir amb una traducció?

És clar! Sempre estem buscant afegir suport per a més idiomes. Pots contribuir amb una traducció creant una Pull Request al repositori de tabi.

Pots utilitzar el fitxer en català com a base per traduir les cadenes al teu idioma. Assegura’t de mantenir la mateixa estructura.

El fitxer ha de portar el nom del codi de dues lletres del teu idioma i ha de ser un fitxer TOML. Per exemple, si vols afegir suport per al suahili, pots crear un fitxer anomenat sw.toml al directori i18n.

Nota: quan provis la teva traducció, és possible que necessitis reiniciar zola serve per veure els canvis, ja que Zola no sempre detecta canvis en els fitxers TOML.

He trobat un error en una traducció. Com el corregeixo?

Si trobes un error en una traducció, pots crear una issue o una Pull Request al repositori de tabi.

Com actualitzo les traduccions després d’una actualització del tema?

Si no vas personalitzar les traduccions, simplement actualitza el tema.

Si ho vas fer, hauràs d’actualitzar manualment les traduccions. Pots fer-ho copiant les noves cadenes dels fitxers corresponents i enganxant-les al teu fitxer personalitzat.

tabi tradueix el meu contingut?

No. tabi només tradueix les cadenes de text del tema. Hauràs de traduir el teu contingut tu mateix.