From 8018072611ca2a9aafcd0988a41ad5290e458b29 Mon Sep 17 00:00:00 2001 From: casungo Date: Tue, 13 Aug 2024 11:05:27 +0200 Subject: i18n(it): Updates `guides/i18n.mdx` (#2192) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> Co-authored-by: Chris Swithinbank --- docs/src/content/docs/it/guides/i18n.mdx | 47 +++++++++++++++++++++++++++++++- 1 file changed, 46 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/it/guides/i18n.mdx b/docs/src/content/docs/it/guides/i18n.mdx index ed4da0e3..3607f349 100644 --- a/docs/src/content/docs/it/guides/i18n.mdx +++ b/docs/src/content/docs/it/guides/i18n.mdx @@ -67,6 +67,8 @@ Starlight offre il supporto per siti multilingua, compreso di indirizzamento, co +Per scenari di internazionalizzazione più avanzati, Starlight supporta anche la configurazione dell'internazionalizzazione utilizzando l'[opzione `i18n` di Astro](https://docs.astro.build/it/guides/internationalization/#configure-i18n-routing). + ### Utilizzare una lingua principale Puoi utilizzare una lingua principale per non avere il prefisso i18n nel percorso. Per esempio, se l'inglese è la lingua principale, un indirizzo sarà del tipo `/about` invece che `/en/about`. @@ -143,6 +145,34 @@ Starlight si aspetta che crei pagine equivalenti per tutte le lingue impostate. Se una traduzione non è ancora disponibile per una lingua, Starlight mostrerà ai lettori i contenuti per quella pagina nel linguaggio predefinito (impostato da `defaultLocale`). Per esempio, se non hai ancora creato una versione italiana della pagina About e la lingua predefinita è inglese, gli utenti che visiteranno `/it/about` vedranno i contenuti in inglese di `/en/about` con un avviso che la pagina non è stata ancora tradotta. +## Traduci il titolo del sito + +Di default, Starlight utilizzerà lo stesso titolo del sito per tutte le lingue. +Se hai bisogno di personalizzare il titolo per ogni locale, puoi passare un oggetto a [`title`](/it/reference/configuration/#title-obbligatorio) nelle opzioni di Starlight: + +```diff lang="js" +// astro.config.mjs +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; + +export default defineConfig({ + integrations: [ + starlight({ +- title: 'My Docs', ++ title: { ++ en: 'My Docs', ++ it: 'I Miei Documenti', ++ }, + defaultLocale: 'en', + locales: { + en: { label: 'English' }, + it: { label: 'Italiano', lang: 'it' }, + }, + }), + ], +}); +``` + ## Tradurre l'interfaccia Starlight import LanguagesList from '~/components/languages-list.astro'; @@ -151,7 +181,8 @@ import UIStringsList from '~/components/ui-strings-list.astro'; In aggiunta alla possibilità di avere pagine multilingua, Starlight permette di tradurre le scritte dell'interfaccia (per esempio l'intestazione "In questa pagina" nella tabella dei contenuti) in modo che i lettori possano vedere il sito interamente nella lingua selezionata. Le stringhe dell'interfaccia utente tradotte in sono disponibili di default -e accettiamo [contributi per aggiungere altre lingue predefinite](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md). +e accettiamo [contributi per aggiungere altre lingue +predefinite](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md). Puoi fornire traduzioni per lingue aggiuntive — o sovrascrivere i valori predefiniti — con la collezione `i18n`. @@ -244,3 +275,17 @@ export const collections = { ``` Per saperne di più sugli schemi di raccolta dei contenuti, consulta [ "Definire uno schema di raccolta"](https://docs.astro.build/it/guides/content-collections/#defining-a-collection-schema) nella documentazione di Astro. + +## Accesso alla lingua in utilizzo + +Puoi utilizzare [`Astro.currentLocale`](https://docs.astro.build/it/reference/api-reference/#astrocurrentlocale) per leggere la lingua in utilizzo nei componenti `.astro`. + +Il seguente esempio legge la lingua in utilizzo e la utilizza per generare un link a una pagina "about" nella lingua in utilizzo: + +```astro +--- +// src/components/AboutLink.astro +--- + +Chi siamo +``` -- cgit