diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/_category_.json b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/_category_.json new file mode 100644 index 0000000000..477e153fdc --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/_category_.json @@ -0,0 +1,3 @@ +{ + "label": "Contribuire" +} diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/code.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/code.md new file mode 100644 index 0000000000..d987fbb4b0 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/code.md @@ -0,0 +1,173 @@ +--- +slug: /contributing/code +title: Contributi al codice +description: Una guida per i contributi al codice, che copre come fare il fork del repository, configurare un ambiente locale e inviare una pull request. +--- + + + +# Contributi al codice + + + +Come tutti i progetti WordPress, Playground usa GitHub per gestire il codice e tracciare le issue. Il repository principale è su [https://github.com/WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) e il repository Playground Tools è su [https://github.com/WordPress/playground-tools/](https://github.com/WordPress/playground-tools/). + +:::info Contribuire a Playground Tools + +Questa guida include link al repository principale, ma tutti i passaggi e le opzioni si applicano ad entrambi. Se sei interessato ai plugin o agli strumenti di [sviluppo locale](/developers/local-development/)—inizia da lì. + +::: + +Sfoglia [l'elenco delle issue aperte](https://github.com/wordpress/wordpress-playground/issues) per trovare su cosa lavorare. L'etichetta [`Good First Issue`](https://github.com/wordpress/wordpress-playground/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22) è un punto di partenza consigliato per i contributori alle prime armi. + +Assicurati di rivedere le seguenti risorse prima di iniziare: + +- [Principi di codifica](/contributing/coding-standards) +- [Architettura](/developers/architecture) +- [Visione e Filosofia](https://github.com/WordPress/wordpress-playground/issues/472) +- [Roadmap di WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/525) + + + +## Contribuire con Pull Request + +[Fai il fork del repository Playground](https://github.com/WordPress/wordpress-playground/fork) e clonalo sulla tua macchina locale. Per farlo, copia e incolla questi comandi nel tuo terminale: + +```bash +git clone -b trunk --single-branch --depth 1 --recurse-submodules + +# sostituisci `YOUR-GITHUB-USERNAME` con il tuo username GitHub: +git@github.com:YOUR-GITHUB-USERNAME/wordpress-playground.git +cd wordpress-playground +npm install +``` + +Crea un branch, fai le modifiche e testalo localmente eseguendo il seguente comando: + +```bash +npm run dev +``` + +Playground si aprirà in una nuova scheda del browser e si aggiornerà automaticamente ad ogni modifica. + +Quando sei pronto, committa le modifiche e invia una Pull Request. + +:::info Formattazione + +Gestiamo automaticamente la formattazione del codice e il linting. Rilassati, scrivi e lascia che le macchine facciano il lavoro. + +::: + + + +### Eseguire un Multisite locale + +WordPress Multisite ha alcune [restrizioni quando viene eseguito localmente](https://developer.wordpress.org/advanced-administration/multisite/prepare-network/#restrictions). Se prevedi di testare una rete Multisite usando il passo `enableMultisite` di Playground, assicurati di cambiare la porta predefinita di `wp-now` o di impostare un dominio di test locale in esecuzione tramite HTTPS. + +Per cambiare la porta predefinita di `wp-now` a quella supportata da WordPress Multisite, eseguilo usando il flag `--port=80`: + +```bash +npx @wp-now/wp-now start --port=80 +``` + +Ci sono diversi modi per impostare un dominio di test locale, incluso modificare il tuo file `hosts`. Se non sei sicuro di come farlo, suggeriamo di installare [Laravel Valet](https://laravel.com/docs/11.x/valet) e poi eseguire il seguente comando: + +```bash +valet proxy playground.test http://127.0.0.1:5400 --secure +``` + +Il tuo server di sviluppo è ora disponibile su https://playground.test. + + + +## Debug + +### Usa VS Code e Chrome + +Se stai usando VS Code e hai Chrome installato, puoi fare il debug di Playground nell'editor di codice: + +- Apri la cartella del progetto in VS Code. +- Seleziona Esegui > Avvia debug dal menu principale o premi `F5`/`fn`+`F5`. + +### Debug di PHP + +Playground registra gli errori PHP nella console del browser dopo ogni richiesta PHP. diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/coding-standards.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/coding-standards.md new file mode 100644 index 0000000000..947899bd75 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/coding-standards.md @@ -0,0 +1,105 @@ +--- +slug: /contributing/coding-standards +title: Principi di codifica +description: Dettaglia i principi di codifica per Playground, concentrandosi su messaggi di errore utili, un'API pubblica minimale e Blueprints. +--- + + + +# Principi di codifica + + + +## Messaggi di errore + +Un buon messaggio di errore informa l'utente sui passaggi successivi da seguire. Qualsiasi ambiguità negli errori generati dalle [API pubbliche](/developers/apis/) di Playground spingerà gli sviluppatori ad aprire issue. + +Considera un errore di rete, per esempio—possiamo dedurre il tipo di errore e visualizzare un messaggio rilevante che riassuma i prossimi passaggi? + +- **Errore di rete**: "La tua connessione internet ha avuto un problema. Prova a ricaricare la pagina." +- **404**: "Impossibile trovare il file". +- **403**: "Il server ha bloccato l'accesso al file". +- **CORS**: chiarisci che è una funzionalità di sicurezza del browser e aggiungi un link a una spiegazione dettagliata (su MDN o un'altra fonte affidabile). Suggerisci all'utente di spostare il proprio file altrove, come `raw.githubusercontent.com`, e linka a una risorsa che spiega come impostare gli header CORS sui loro server. + +Gestiamo automaticamente la formattazione del codice e il linting. Rilassati, scrivi e lascia che le macchine facciano il lavoro. + + + +## API pubblica + +Playground mira a mantenere lo scope dell'API il più ristretto possibile. + +Le API pubbliche sono facili da aggiungere e difficili da rimuovere. Serve solo una PR per introdurre una nuova API, ma potrebbero servire mille per rimuoverla, specialmente se altri progetti l'hanno già utilizzata. + +- Non esporre funzioni, classi, costanti o altri componenti non necessari. + + + +## Blueprints + +I [Blueprints](/blueprints/getting-started) sono il modo principale per interagire con Playground. Questi file JSON descrivono una serie di passaggi che Playground esegue in ordine. + +### Linee guida + +I passaggi dei Blueprints dovrebbero essere **concisi e mirati**. Dovrebbero fare una cosa e farla bene. + +- Se devi creare un nuovo passaggio, prova prima a refactorizzare uno esistente. +- Se non è sufficiente, assicurati che il nuovo passaggio fornisca una nuova capacità. Non replicare la funzionalità dei passaggi esistenti. +- Assumi che il passaggio verrà chiamato più di una volta. +- Assumi che verrà eseguito in un ordine specifico. +- Aggiungi test unitari per verificarlo. + +I Blueprints dovrebbero essere **intuitivi e diretti**. + +- Non richiedere argomenti che possono essere opzionali. +- Usa argomenti semplici. Per esempio, `slug` invece di `path`. +- Definisci le costanti in file JSON virtuali—non modificare i file PHP. +- Definisci un tipo TypeScript per il Blueprint. È così che Playground genera il suo schema JSON. +- Scrivi una funzione per gestire un passaggio del Blueprint. Accetta l'argomento del tipo che hai definito. +- Fornisci un esempio di utilizzo nella stringa di documentazione. Viene automaticamente riflesso nella documentazione. diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-badge.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-badge.md new file mode 100644 index 0000000000..9b0cbb3d65 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-badge.md @@ -0,0 +1,97 @@ +--- +title: Badge Contributore WordPress Playground +slug: /contributing/contributor-badge +description: Scopri i criteri per il Badge Contributore WordPress Playground e come richiederlo per il tuo profilo WordPress.org. +--- + + + +# Badge Contributore Playground + +Questa pagina fornisce informazioni dettagliate sul Badge Contributore Playground e sul processo per richiederlo sul tuo profilo [WordPress.org](https://wordpress.org). + +--- + + + +## Per iniziare + +Ogni contributo al progetto WordPress Playground è molto apprezzato. Il team Playground riconosce i contributi in diverse aree chiave: + +- **Codice Playground:** Fare modifiche al codice e rivedere il progetto principale. +- **Interfaccia Playground:** Migliorare l'interfaccia utente dell'esperienza web. +- **Documentazione:** Scrivere, aggiornare e rivedere la documentazione. +- **Traduzione:** Tradurre qualsiasi parte del progetto. +- **Galleria Blueprints:** Creare nuovi blueprints o migliorare quelli esistenti. + + + +## Badge Contributore Playground + +Per ottenere un Badge Contributore Playground, devi aver fatto almeno un contributo idoneo dall'elenco sopra. Il team può scegliere di assegnare il badge per altri contributi o una combinazione di quelli sopra a discrezione del team. + +![Badge Contributore Playground](@site/static/img/contributing/playground-contributor-badge.webp) + + + +## Badge Team Playground + +Se sei attualmente un contributore e sei stato attivamente coinvolto nel progetto Playground negli ultimi **dodici mesi**, sei idoneo per un **Badge Team Playground**. + +![Badge Team Playground](@site/static/img/contributing/playground-team-badge.webp) + + + +## Richiedere un Badge Profilo + +Se soddisfi i criteri, puoi richiedere un badge. Per favore includi link a risorse (come pull request GitHub, issue o stringhe tradotte) che dimostrino che hai soddisfatto i criteri. Invia una richiesta ai link seguenti: + +- [Badge Contributore](https://profiles.wordpress.org/associations/playground-contributor/) +- [Badge Team](https://profiles.wordpress.org/associations/playground-team/) + +### Modulo di richiesta + +![Badge Contributore Playground](@site/static/img/contributing/request-contributor-badge.webp) + +Per accedere alla richiesta, l'utente dovrebbe essere loggato con il proprio account WordPress.org e aprire la scheda Richiedi Appartenenza, dopo aver inviato le informazioni richieste. Un Rappresentante del Team Playground confermerà il tuo contributo e assegnerà il badge. Il team eseguirà una revisione settimanale dei contributi e assegnerà i badge in quel momento. Gli aggiornamenti sui nuovi badge assegnati verranno pubblicati durante la riunione del Team Playground. diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day-table-lead.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day-table-lead.md new file mode 100644 index 0000000000..3603d77ccf --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day-table-lead.md @@ -0,0 +1,162 @@ +## + +--- + +slug: /contributing/table-lead-guide +title: Guida per il Leader del Tavolo al Contributor Day +description: Come guidare un tavolo WordPress Playground al Contributor Day di un WordCamp. + +--- + +# Guida per il Leader del Tavolo al Contributor Day + +Questa guida aiuta i leader dei tavoli a preparare e gestire un tavolo contributori WordPress Playground agli eventi WordCamp. + +## Prima del Contributor Day + +### Checklist di preparazione + +- **Curato "Good First Issues"**: Rivedi e aggiorna l'[elenco delle good first issues](https://github.com/WordPress/wordpress-playground/labels/good%20first%20issue) su GitHub. Questi dovrebbero essere compiti semplici che i nuovi contributori possono completare autonomamente. Se trovi un bug che non è nell'elenco ma potrebbe farne parte, contatta il team playground sul canale Slack. +- **Coordina con il Team Playground**: Conferma se i membri del team Playground sono disponibili online per fornire supporto remoto durante l'evento, specialmente per i WordCamp principali. A causa delle differenze di fuso orario, allineati in anticipo sul canale #playground per verificare la loro disponibilità. +- **Connettiti con i Contributori Locali**: Identifica i contributori regolari nella regione che partecipano all'evento. Controlla sul canale Slack #playground se un membro attivo della community sta partecipando al contributor day. Questa è un'opportunità per raccogliere feedback e rafforzare le connessioni della community. +- **Controlla il Repository Playground**: Se non hai mai contribuito al repository WordPress Playground, dovresti familiarizzare con questa buona sezione della documentazione che può guidarti a capire il progetto è [Developers > Architecture](/developers/architecture) conterrà informazioni su come il progetto è organizzato. Se hai domande, per favore contatta il team sul canale Slack Playground. + +## Inizio della giornata + +### Setup e onboarding + +1. **Crea la tua agenda**: Prepara un elenco flessibile di attività chiave permettendo la collaborazione organica. Condividilo nella documentazione del progetto se utile. + +2. **Guida i contributori a Slack**: Indirizza tutti al canale [`#playground` su WordPress Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K). Questo centralizza la comunicazione e abilita la collaborazione asincrona con gli arrivi tardivi. + +3. **Pubblica un messaggio di benvenuto**: Condividi un messaggio iniziale nel canale Slack annunciando la tua presenza (di persona o online) e accogliendo i contributi da tutti. + +4. **Condividi link essenziali**: Pubblica queste risorse nel canale `#playground`: + + - [Istanza web WordPress Playground](https://playground.wordpress.net/) + - [Documentazione Playground](https://wordpress.github.io/wordpress-playground/) + - [Libreria Step Playground](https://akirk.github.io/playground-step-library/) + - [Repository GitHub](https://github.com/WordPress/wordpress-playground) + - [Guida Contributor Day](/contributing/contributor-day/) + +5. **Introduci il repository GitHub**: Fornisci una breve panoramica della struttura del repository, evidenziando i diversi pacchetti e i loro scopi per i contributori alle prime armi. + +## Durante la giornata + +### Gestione dei contributi + +**Incoraggia diversi tipi di contributi**: + +Controlla i livelli dei contributori, prova a capire in base al loro livello come possono contribuire al progetto nella breve finestra di un contributor day. Chiedi se i partecipanti hanno bisogno di aiuto e reindirizzali alla pagina di documentazione correlata. Inoltre, incoraggiali a fare domande sul [canale Slack #playground](https://wordpress.slack.com/archives/C04EWKGDJ0K). Ecco alcuni suggerimenti per modi di contribuire: + +- Miglioramenti alla documentazione e traduzioni. +- Issue accuratamente redatte che descrivono problemi con soluzioni praticabili. +- Creazione di Blueprints e demo di plugin nel repository plugin WordPress. +- Test e feedback sul prodotto. + +**Favorisci la collaborazione**: Cerca opportunità cross-table. Per esempio, i contributori al [tavolo Polyglots/Traduzione](https://make.wordpress.org/polyglots/) potrebbero tradurre la documentazione Playground, o il [team Core Test](https://make.wordpress.org/test/) potrebbe fornire feedback preziosi su Playground. + +**Raccogli feedback**: Chiedi ai contributori della loro esperienza e annota suggerimenti di miglioramento. Segnala questo nel [canale Slack #playground](https://wordpress.slack.com/archives/C04EWKGDJ0K) se possibile. + +## Dopo l'evento + +### Follow-up e supporto + +1. **Rivedi le Pull Request**: Elenca le PR create durante la giornata e valuta la probabilità di completamento. La maggior parte dei contributi ha una finestra di slancio breve—il coinvolgimento entro le prime due settimane è critico. + +2. **Stabilisci aspettative chiare**: Per le PR incomplete, segui questo approccio: + + - Dopo un mese di inattività, lascia un commento chiedendo se l'autore prevede di completare il lavoro. + - Se non c'è risposta dopo altre due settimane, informali che la PR potrebbe essere presa in carico da un altro contributore o chiusa. + +3. **Rimani attivo su Slack**: Continua a supportare i nuovi contributori attraverso il canale `#playground`, rispondendo alle domande e aiutandoli a diventare contributori regolari. + +4. **Rifletti e migliora**: Rivedi il feedback raccolto e la tua esperienza per affinare questa guida per eventi futuri. Sentiti libero di inviare una Pull Request a questa guida! + +## Ottenere aiuto + +- **Durante l'evento**: Connettiti con i contributori al tavolo Playground. +- **Supporto continuo**: Usa il [canale Slack `#playground`](https://wordpress.slack.com/archives/C04EWKGDJ0K). +- **Segnala issue**: Invia al [repository GitHub WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/new). + +Per maggiori informazioni su come contribuire a WordPress Playground, vedi la [guida Contributor Day](/contributing/contributor-day). diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md new file mode 100644 index 0000000000..fb938e8b05 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md @@ -0,0 +1,418 @@ +--- +slug: /contributing/contributor-day +title: WordCamp Contributor Day +description: Una guida su come contribuire a WordPress Playground e come può supportarti al Contributor Day. +--- + + + +# WordCamp Contributor Day + +Il WordCamp Contributor Day è un evento in cui la community WordPress si riunisce per contribuire al progetto WordPress. Questa guida si concentra su come puoi contribuire al progetto WordPress Playground o su come Playground può aiutarti a contribuire a WordPress Core. + + + +## Chi può contribuire? + +Alcuni eventi avranno un tavolo dedicato per il progetto. I tavoli contributori WordPress Playground accolgono tutti i tipi di contributi, non solo dagli sviluppatori. Che tu sia uno scrittore, programmatore, tester, sviluppatore di plugin o temi, marketer, proprietario di sito o qualsiasi altro tipo di utente, sei incoraggiato a contribuire. + +Valutiamo contributi diversificati in varie aree, inclusi community building, testing, documentazione e design. + + + +## Come contribuire al progetto Playground + +Questa sezione descrive come puoi contribuire direttamente al progetto WordPress Playground e ai suoi strumenti associati: + +- **Documentazione:** Migliora la nostra documentazione migliorando il contenuto esistente, sviluppando nuove guide o traducendo materiali in diverse lingue. +- **Blueprints:** Crea demo di plugin per i plugin nel repository WordPress Plugin, o sviluppa nuovi Blueprints per arricchire la nostra documentazione del progetto. +- **Testare l'ambiente Playground:** Impegnati nel testare il progetto WordPress Playground stesso. Puoi farlo creando attentamente nuove issue che descrivono i problemi che incontri e suggerendo soluzioni praticabili. Testa la nostra istanza web WordPress (il sito playground.wordpress.net), o esplora le varie applicazioni alimentate da Playground. Testa questi strumenti, osserva la loro funzionalità e fornisci feedback dettagliati. +- **Feedback sul prodotto:** Le tue intuizioni sono preziose per migliorare l'esperienza Playground. Questo include feedback generale sull'istanza web, l'applicazione e qualsiasi strumento lato server. + +Tutti i feedback, inclusi issue segnalate e risultati dei test, possono essere inviati tramite il nostro repository GitHub. + + + +### Follow-up e coinvolgimento continuo + +Mentre molti compiti vengono completati durante l'evento, il tuo viaggio di contribuzione non deve finire lì. Sei il benvenuto a continuare a lavorare sulle tue issue o pull request dopo il Contributor Day. Prevediamo attività continuative dai contributori che si assumono compiti oltre l'evento. Nota che se una pull request non mostra attività per un mese, può essere considerata abbandonata e successivamente chiusa. + + + +### Ottenere aiuto e rimanere coinvolti + +Durante il Contributor Day, puoi trovare assistenza diretta e interagire con noi al tavolo Playground dedicato. Per supporto continuo e interazione con la community, puoi contattarci sul canale `#playground` su WordPress Slack o tramite GitHub. + + + +## Come usare Playground al Contributor Day + +Ora copriremo come Playground può aiutarti durante il Contributor Day. L'[estensione WordPress Playground VS Code](https://marketplace.visualstudio.com/items?itemName=WordPressPlayground.wordpress-playground) e [@wp-playground/cli](https://www.npmjs.com/package/@wp-playground/cli) semplificano il processo di configurazione di un ambiente WordPress locale. WordPress Playground alimenta entrambi—non sono richiesti Docker, MySQL o Apache. + +Continua a leggere per imparare come usare questi strumenti per lo [sviluppo locale](/developers/local-development/wp-playground-cli) quando contribuisci a WordPress. Nota che l'estensione e il pacchetto NPM sono in sviluppo, e non tutti i [team Make WordPress](https://make.wordpress.org/) sono completamente supportati. + + + +## Per iniziare + +### Estensione VS Code Playground + +L'[estensione Visual Studio Code Playground](https://marketplace.visualstudio.com/items?itemName=WordPressPlayground.wordpress-playground) è un ambiente di sviluppo amichevole senza configurazione. + +1. Apri VS Code e naviga alla scheda **Estensioni** (**Visualizza > Estensioni**). +2. Nella barra di ricerca, digita _WordPress Playground_ e clicca **Installa**. +3. Per interagire con Playground, clicca la nuova icona nella **Barra delle attività** e premi il pulsante **Avvia server WordPress**. +4. Una nuova scheda si aprirà nel tuo browser in pochi secondi. + + + +### Pacchetto NPM @wp-playground/cli + +[`@wp-playground/cli`](/developers/local-development/wp-playground-cli) è uno strumento CLI che ti permette di avviare un sito WordPress con un singolo comando. Non sono richiesti Docker, MySQL o Apache. + +#### Prerequisiti + +`@wp-playground/cli` richiede Node.js 20.18 o più recente e NPM. Se non li hai ancora, [scarica e installa](https://nodejs.org/en/download) entrambi prima di iniziare. + +A seconda del team Make WordPress a cui contribuisci, potresti aver bisogno di una versione Node.js diversa da quella che hai installato. Puoi usare Node Version Manager (NVM) per passare tra le versioni. [Trova la guida all'installazione qui](https://github.com/nvm-sh/nvm#installing-and-updating). + +#### Eseguire `@wp-playground/cli` + +Non devi installare `@wp-playground/cli` sul tuo dispositivo per usarlo. Naviga nella directory del tuo plugin o tema e avvia `@wp-playground/cli` con i seguenti comandi: + +```bash +cd my-plugin-or-theme-directory +npx @wp-playground/cli@latest server --auto-mount +``` + + + +## Idee per i contributori + +### Creare una Pull Request (PR) Gutenberg + +1. Fai il fork del [repository Gutenberg](https://github.com/WordPress/gutenberg) nel tuo account GitHub. +2. Poi, clona il repository forkato per scaricare i file. +3. Installa le dipendenze necessarie e compila il codice in modalità sviluppo. + +```bash +git clone git@github.com:WordPress/gutenberg.git +cd gutenberg +npm install +npm run dev +``` + +:::info + +Se non sei sicuro dei passaggi elencati sopra, visita la [Guida ufficiale per contributori del progetto Gutenberg](https://developer.wordpress.org/block-editor/contributors/). Nota che in questo caso, `@wp-playground/cli` sostituisce `wp-env`. + +::: + +Apri una nuova scheda del terminale, naviga nella directory Gutenberg e avvia WordPress usando `@wp-playground/cli`: + +```bash +cd gutenberg +npx @wp-playground/cli@latest server --auto-mount +``` + +Quando sei pronto, committa e invia le tue modifiche al tuo repository forkato su GitHub e apri una Pull Request sul repository Gutenberg. + +### Testare una PR Gutenberg + +1. Per testare altre PR Gutenberg, fai il checkout del branch associato. +2. Esegui il pull delle ultime modifiche per assicurarti che la tua copia locale sia aggiornata. +3. Poi, installa le dipendenze necessarie, assicurandoti che il tuo ambiente di test corrisponda alle ultime modifiche. +4. Infine, compila il codice in modalità sviluppo. + +```bash +# copia il nome del branch da GitHub # +git checkout branch-name +git pull +npm install +npm run dev + +# In un terminale diverso all'interno della directory Gutenberg * +npx @wp-playground/cli@latest server --auto-mount +``` + +#### Testare una PR Gutenberg con Playground nel browser + +Non hai bisogno di un [ambiente di sviluppo locale](/developers/local-development/) per testare le PR Gutenberg—usa Playground per farlo direttamente nel browser. + +1. Copia l'ID della PR che vorresti testare (scegli una dall'[elenco delle Pull Request aperte](https://github.com/WordPress/gutenberg/pulls)). +2. Apri il [Gutenberg PR Previewer](https://playground.wordpress.net/gutenberg.html) di Playground e incolla l'ID che hai copiato. +3. Una volta che clicchi **Vai**, Playground verificherà che la PR sia valida e aprirà una nuova scheda con la PR rilevante, permettendoti di rivedere le modifiche proposte. + +## Tradurre plugin WordPress con Playground nel browser + +Puoi tradurre i plugin WordPress supportati caricando il plugin che vuoi tradurre e usando la traduzione inline. Se gli sviluppatori del plugin hanno aggiunto l'opzione, troverai il link **Traduci in tempo reale** nella barra degli strumenti in alto a destra della vista di traduzione. Puoi leggere di più su questa entusiasmante nuova opzione su [questo post del blog Polyglots](https://make.wordpress.org/polyglots/2023/05/08/translate-live-updates-to-the-translation-playground/). + +## Ottenere aiuto e contribuire a WordPress Playground + +Hai una domanda o un'idea per una nuova funzionalità? Hai trovato un bug? Qualcosa non funziona come previsto? Siamo qui per aiutare: + +- Durante il Contributor Day, puoi raggiungerci al **tavolo Playground**. +- Apri una issue sul [repository GitHub WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/new). Se il tuo focus è l'estensione VS Code, il pacchetto NPM o i plugin, apri una issue sul [repository Playground Tools](https://github.com/WordPress/playground-tools/issues/new). +- Condividi il tuo feedback sul canale Slack [**#playground**](https://wordpress.slack.com/archives/C04EWKGDJ0K). + +## Chi può contribuire? + +Alcuni eventi avranno un tavolo dedicato per il progetto. I tavoli contributori WordPress Playground accolgono tutti i tipi di contributi, non solo dagli sviluppatori. Che tu sia uno scrittore, programmatore, tester, sviluppatore di plugin o temi, marketer, proprietario di sito o qualsiasi altro tipo di utente, sei incoraggiato a contribuire. + +Valutiamo contributi diversificati in varie aree, inclusi community building, testing, documentazione e design. + +## Come contribuire al progetto Playground + +Questa sezione descrive come puoi contribuire direttamente al progetto WordPress Playground e ai suoi strumenti associati: + +- **Documentazione:** Migliora la nostra documentazione migliorando il contenuto esistente, sviluppando nuove guide o traducendo materiali in diverse lingue. +- **Blueprints:** Crea demo di plugin per i plugin nel repository WordPress Plugin, o sviluppa nuovi Blueprints per arricchire la nostra documentazione del progetto. +- **Testare l'ambiente Playground:** Impegnati nel testare il progetto WordPress Playground stesso. Puoi farlo creando attentamente nuove issue che descrivono i problemi che incontri e suggerendo soluzioni praticabili. Testa la nostra istanza web WordPress (il sito playground.wordpress.net), o esplora le varie applicazioni alimentate da Playground. Testa questi strumenti, osserva la loro funzionalità e fornisci feedback dettagliati. +- **Feedback sul prodotto:** Le tue intuizioni sono preziose per migliorare l'esperienza Playground. Questo include feedback generale sull'istanza web, l'applicazione e qualsiasi strumento lato server. + +Tutti i feedback, inclusi issue segnalate e risultati dei test, possono essere inviati tramite il nostro repository GitHub. + +### Follow-up e coinvolgimento continuo + +Mentre molti compiti vengono completati durante l'evento, il tuo viaggio di contribuzione non deve finire lì. Sei il benvenuto a continuare a lavorare sulle tue issue o pull request dopo il Contributor Day. Prevediamo attività continuative dai contributori che si assumono compiti oltre l'evento. Nota che se una pull request non mostra attività per un mese, può essere considerata abbandonata e successivamente chiusa. + +### Ottenere aiuto e rimanere coinvolti + +Durante il Contributor Day, puoi trovare assistenza diretta e interagire con noi al tavolo Playground dedicato. Per supporto continuo e interazione con la community, puoi contattarci sul canale `#playground` su WordPress Slack o tramite GitHub. + +## Come usare Playground al Contributor Day + +Ora copriremo come Playground può aiutarti durante il Contributor Day. L'[estensione WordPress Playground VS Code](https://marketplace.visualstudio.com/items?itemName=WordPressPlayground.wordpress-playground) e [@wp-playground/cli](https://www.npmjs.com/package/@wp-playground/cli) semplificano il processo di configurazione di un ambiente WordPress locale. WordPress Playground alimenta entrambi—non sono richiesti Docker, MySQL o Apache. + +Continua a leggere per imparare come usare questi strumenti per lo [sviluppo locale](/developers/local-development/wp-playground-cli) quando contribuisci a WordPress. Nota che l'estensione e il pacchetto NPM sono in sviluppo, e non tutti i [team Make WordPress](https://make.wordpress.org/) sono completamente supportati. + +## Per iniziare + +### Estensione VS Code Playground + +L'[estensione Visual Studio Code Playground](https://marketplace.visualstudio.com/items?itemName=WordPressPlayground.wordpress-playground) è un ambiente di sviluppo amichevole senza configurazione. + +1. Apri VS Code e naviga alla scheda **Estensioni** (**Visualizza > Estensioni**). +2. Nella barra di ricerca, digita _WordPress Playground_ e clicca **Installa**. +3. Per interagire con Playground, clicca la nuova icona nella **Barra delle attività** e premi il pulsante **Avvia server WordPress**. +4. Una nuova scheda si aprirà nel tuo browser in pochi secondi. + +### Pacchetto NPM @wp-playground/cli + +[`@wp-playground/cli`](/developers/local-development/wp-playground-cli) è uno strumento CLI che ti permette di avviare un sito WordPress con un singolo comando. Non sono richiesti Docker, MySQL o Apache. + +#### Prerequisiti + +`@wp-playground/cli` richiede Node.js 20.18 o più recente e NPM. Se non li hai ancora, [scarica e installa](https://nodejs.org/en/download) entrambi prima di iniziare. + +A seconda del team Make WordPress a cui contribuisci, potresti aver bisogno di una versione Node.js diversa da quella che hai installato. Puoi usare Node Version Manager (NVM) per passare tra le versioni. [Trova la guida all'installazione qui](https://github.com/nvm-sh/nvm#installing-and-updating). + +#### Eseguire `@wp-playground/cli` + +Non devi installare `@wp-playground/cli` sul tuo dispositivo per usarlo. Naviga nella directory del tuo plugin o tema e avvia `@wp-playground/cli` con i seguenti comandi: + +```bash +cd my-plugin-or-theme-directory +npx @wp-playground/cli@latest server --auto-mount +``` + +## Idee per i contributori + +### Creare una Pull Request (PR) Gutenberg + +1. Fai il fork del [repository Gutenberg](https://github.com/WordPress/gutenberg) nel tuo account GitHub. +2. Poi, clona il repository forkato per scaricare i file. +3. Installa le dipendenze necessarie e compila il codice in modalità sviluppo. + +```bash +git clone git@github.com:WordPress/gutenberg.git +cd gutenberg +npm install +npm run dev +``` + +:::info + +Se non sei sicuro dei passaggi elencati sopra, visita la [Guida ufficiale per contributori del progetto Gutenberg](https://developer.wordpress.org/block-editor/contributors/). Nota che in questo caso, `@wp-playground/cli` sostituisce `wp-env`. + +::: + +Apri una nuova scheda del terminale, naviga nella directory Gutenberg e avvia WordPress usando `@wp-playground/cli`: + +```bash +cd gutenberg +npx @wp-playground/cli@latest server --auto-mount +``` + +Quando sei pronto, committa e invia le tue modifiche al tuo repository forkato su GitHub e apri una Pull Request sul repository Gutenberg. + +### Testare una PR Gutenberg + +1. Per testare altre PR Gutenberg, fai il checkout del branch associato. +2. Esegui il pull delle ultime modifiche per assicurarti che la tua copia locale sia aggiornata. +3. Poi, installa le dipendenze necessarie, assicurandoti che il tuo ambiente di test corrisponda alle ultime modifiche. +4. Infine, compila il codice in modalità sviluppo. + +```bash +# copia il nome del branch da GitHub # +git checkout branch-name +git pull +npm install +npm run dev + +# In un terminale diverso all'interno della directory Gutenberg * +npx @wp-playground/cli@latest server --auto-mount +``` + +#### Testare una PR Gutenberg con Playground nel browser + +Non hai bisogno di un [ambiente di sviluppo locale](/developers/local-development/) per testare le PR Gutenberg—usa Playground per farlo direttamente nel browser. + +1. Copia l'ID della PR che vorresti testare (scegli una dall'[elenco delle Pull Request aperte](https://github.com/WordPress/gutenberg/pulls)). +2. Apri il [Gutenberg PR Previewer](https://playground.wordpress.net/gutenberg.html) di Playground e incolla l'ID che hai copiato. +3. Una volta che clicchi **Vai**, Playground verificherà che la PR sia valida e aprirà una nuova scheda con la PR rilevante, permettendoti di rivedere le modifiche proposte. + +## Tradurre plugin WordPress con Playground nel browser + +Puoi tradurre i plugin WordPress supportati caricando il plugin che vuoi tradurre e usando la traduzione inline. Se gli sviluppatori del plugin hanno aggiunto l'opzione, troverai il link **Traduci in tempo reale** nella barra degli strumenti in alto a destra della vista di traduzione. Puoi leggere di più su questa entusiasmante nuova opzione su [questo post del blog Polyglots](https://make.wordpress.org/polyglots/2023/05/08/translate-live-updates-to-the-translation-playground/). + +## Ottenere aiuto e contribuire a WordPress Playground + +Hai una domanda o un'idea per una nuova funzionalità? Hai trovato un bug? Qualcosa non funziona come previsto? Siamo qui per aiutare: + +- Durante il Contributor Day, puoi raggiungerci al **tavolo Playground**. +- Apri una issue sul [repository GitHub WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/new). Se il tuo focus è l'estensione VS Code, il pacchetto NPM o i plugin, apri una issue sul [repository Playground Tools](https://github.com/WordPress/playground-tools/issues/new). +- Condividi il tuo feedback sul canale Slack [**#playground**](https://wordpress.slack.com/archives/C04EWKGDJ0K). diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/documentation.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/documentation.md new file mode 100644 index 0000000000..9da3f847d2 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/documentation.md @@ -0,0 +1,127 @@ +--- +slug: /contributing/documentation +title: Contributi alla documentazione +description: Una guida su come contribuire alla documentazione Playground, dall'apertura di issue all'invio di pull request. +--- + + + +# Contributi alla documentazione + + + +Il [sito di documentazione di WordPress Playground](/) è mantenuto da volontari come te, che apprezzerebbero il tuo aiuto. + + + +Tutte le issue relative alla documentazione sono etichettate [`[Type] Documentation`](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%5BType%5D%20Documentation%22) o [`[Type] Developer Documentation`](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%5BType%5D%20Developer%20Documentation%22) nel repository [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground). Sfoglia l'elenco delle issue aperte per trovarne una su cui vorresti lavorare. In alternativa, se ritieni che qualcosa manchi dalla documentazione attuale, apri una issue per discutere il tuo suggerimento. + + + +## Come posso contribuire? + + + +Puoi contribuire [aprendo una issue nel repository del progetto](https://github.com/WordPress/wordpress-playground/issues/new) e descrivendo cosa vorresti aggiungere o cambiare. + + + +Se ti senti all'altezza, scrivi il contenuto nella descrizione dell'issue, e i contributori del progetto si occuperanno del resto. + + + +Vorresti vedere la documentazione nella tua lingua? Controlla la [sezione Traduzioni](/contributing/translations). + + + +### Fare il fork del repository, modificare i file localmente e aprire Pull Request + +Se hai familiarità con markdown, puoi [fare il fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) del repository `wordpress-playground` e proporre modifiche e nuove pagine di documentazione inviando una Pull Request. + +Il processo di creazione di un branch per aprire nuove PR con pagine tradotte sul repository [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) è lo stesso del contribuire ad altri repository WordPress come gutenberg: +https://developer.wordpress.org/block-editor/contributors/code/git-workflow/ + +I file di documentazione (file `.md`) sono memorizzati nel repository GitHub di Playground, [sotto `/packages/docs/site/docs`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/docs) per l'inglese e [`/packages/docs/site/i18n`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/i18n) per altre lingue. + + + +### Modificare nel browser + +Se sei loggato su GitHub, puoi anche modificare file esistenti (o aggiungerne di nuovi) e inviare una PR direttamente dall'interfaccia GitHub: + +1. Trova la pagina che vorresti modificare o la directory del capitolo a cui vorresti aggiungere una nuova pagina. +2. Clicca il pulsante **Add Files** per aggiungere un nuovo file, o clicca su un file esistente e poi clicca l'icona della matita per modificarlo. +3. GitHub ti chiederà di fare il fork del repository e creare un nuovo branch con le tue modifiche. +4. Si aprirà un editor dove puoi fare le modifiche. +5. Quando hai finito, clicca il pulsante **Commit Changes** e invia una Pull Request. + +Ecco fatto! Hai appena contribuito alla documentazione WordPress Playground. + +Questo approccio significa che non devi clonare il repository, configurare un ambiente di sviluppo locale o eseguire comandi. + +Lo svantaggio è che non sarai in grado di visualizzare in anteprima le tue modifiche. Continua a leggere per imparare come rivedere le tue modifiche prima di inviare una Pull Request. + + + +### Anteprima locale + +Clona il repository e naviga nella directory sul tuo dispositivo. Ora esegui i seguenti comandi: + +```bash +npm install +npm run build:docs +npm run dev:docs +``` + +Il sito di documentazione si apre in una nuova scheda del browser e si aggiorna automaticamente ad ogni modifica. Continua a modificare il file rilevante nel tuo editor di codice e testa le modifiche in tempo reale. diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/index.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/index.md new file mode 100644 index 0000000000..71050fb6df --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/index.md @@ -0,0 +1,102 @@ +--- +title: Contribuire al progetto WordPress Playground +slug: /contributing +id: introduction +description: Il punto di partenza per contribuire a WordPress Playground. Trova le linee guida per codice, documentazione e segnalazione di bug. +--- + + + +# Contribuire al progetto WordPress Playground + + + +WordPress Playground è un progetto open-source che accoglie contributori di tutti i tipi, dal codice al design, dalla documentazione al triage. + + + +## Come posso contribuire? + +- Codice? Vedi la [sezione sviluppatori](/contributing/code). +- Documentazione? Vedi la [sezione documentazione](/contributing/documentation). +- Segnalare bug? Apri una [nuova issue](https://github.com/WordPress/wordpress-playground/issues/new) nel repository principale GitHub, o in [Playground Tools](https://github.com/WordPress/playground-tools/issues/new). +- Idee, design o qualsiasi altra cosa? Apri una [discussione GitHub](https://github.com/WordPress/wordpress-playground/discussions), e parliamone! +- Traduzione? Vedi la [sezione traduzioni](/contributing/translations). + + + +## Linee guida + +- Come in tutti i progetti WordPress, vogliamo garantire un ambiente accogliente e rispettoso per tutti. Per favore leggi il [Codice di Condotta](https://make.wordpress.org/handbook/community-code-of-conduct/) della nostra community per saperne di più. +- I contributori di codice dovrebbero rivedere i [principi di codifica](/contributing/coding-standards). +- Mantieni il copyright su qualsiasi contributo che fai. Inviando una Pull Request, accetti di rilasciare quel codice sotto la [Licenza WordPress Playground](https://github.com/WordPress/wordpress-playground?tab=GPL-2.0-1-ov-file#readme). + + + +## Gestione delle issue + +Vuoi aiutare a ordinare le issue aperte e risolvere potenziali bug? Ecco come: + +1. Rivedi l'[elenco delle issue aperte](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aopen+is%3Aissue) e trova quelle con cui puoi aiutare. Lo stesso vale per il [repository Playground Tools](https://github.com/WordPress/playground-tools/issues?q=is%3Aopen+is%3Aissue). +2. Leggi la descrizione e i commenti. +3. Se è un bug che puoi riprodurre, aggiungi un commento descrittivo o una potenziale soluzione. +4. Altrimenti, aggiungi un commento con qualsiasi informazione aggiuntiva che possa essere utile. + + + +## Una nota su contribuire e la licenza GPL + +WordPress Playground e il progetto WordPress sono fortemente radicati nel software libero e open source. In particolare, WordPress Playground è rilasciato sotto licenza GPLv2 (o successiva) dalla [Free Software Foundation](https://www.fsf.org/). Puoi [leggere il testo della licenza qui](https://github.com/WordPress/wordpress-playground/blob/trunk/LICENSE) e se ti sembra troppo complesso, WordPress.org ha un [GPL Primer amichevole](https://make.wordpress.org/community/handbook/wordcamp-organizer/planning-details/gpl-primer/). + +Di conseguenza, per favore sii consapevole delle implicazioni che i tuoi contributi avranno: + +- Quando contribuisci, accetti di rilasciare i tuoi contributi sotto la licenza GPLv2 (o successiva) +- La licenza GPL ha forti disposizioni copyleft che garantiscono che tutte le opere derivate rimangano open-source e sotto gli stessi termini di licenza, promuovendo così un ambiente di sviluppo collaborativo. +- La licenza GPL incoraggia a contribuire con qualsiasi modifica, correzione di bug o nuova funzionalità al codice sorgente originale. +- La licenza GPL garantisce che il progetto rimanga libero e open-source, non solo in termini di costo ma anche rispetto alla libertà di utilizzare, modificare e distribuire il software. + +Se hai domande su come quanto sopra potrebbe influenzare i tuoi contributi, sentiti libero di contattarci su WP Slack nel canale [`meta-playground`](https://wordpress.slack.com/archives/C04EWKGDJ0K). + +Grazie ancora per i tuoi contributi! 🎉 diff --git a/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/translations.md b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/translations.md new file mode 100644 index 0000000000..c261aa36cb --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/translations.md @@ -0,0 +1,712 @@ +--- +slug: /contributing/translations +title: Contributi alle traduzioni +description: Impara come tradurre la documentazione Playground, inclusa la struttura dei file, i test locali e il processo di revisione. +--- + + + +# Contributi alle traduzioni + + + +Aiuta a rendere WordPress Playground accessibile a un pubblico globale traducendo la sua documentazione. Questa guida fornisce tutto ciò che devi sapere per iniziare. Contribuire alle traduzioni segue lo stesso workflow di qualsiasi altra modifica alla documentazione. Puoi fare il fork del repository [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) e creare una pull request (PR) con le tue modifiche o modificare le pagine direttamente usando l'interfaccia GitHub. + + + +:::info +Per una guida dettagliata sul workflow di contribuzione (fork, creazione di PR, ecc.), per favore vedi la nostra [guida ai contributi alla documentazione](/contributing/documentation#how-can-i-contribute) +::: + + + +## Come funzionano le traduzioni + + + +Il sito di documentazione Playground è costruito con Docusaurus, che gestisce le funzionalità di internazionalizzazione (i18n). + + + +:::info +Per saperne di più su come Docusaurus gestisce le traduzioni, vedi la [sezione Internazionalizzazione](https://docusaurus.io/docs/i18n/introduction) della documentazione ufficiale di Docusaurus. +::: + + + +### Configurazione + +Le lingue disponibili sono definite nel file `packages/docs/site/docusaurus.config.js`. Per esempio: + +``` +i18n: { + defaultLocale: 'en', + path: 'i18n', + locales: ['en', 'fr'], + localeConfigs: { + en: { + label: 'English', + path: 'en', + }, + fr: { + label: 'French', + path: 'fr', + }, + }, +} +``` + + + +### Struttura dei file + +Tutte le pagine di documentazione tradotte si trovano nella directory `packages/docs/site/i18n/`, organizzate per codice lingua. + +Affinché una lingua funzioni correttamente, la sua struttura dei file deve rispecchiare la documentazione inglese originale trovata in `packages/docs/site/docs`. + +Per esempio, la traduzione spagnola (es) per `docs/main/intro.md` deve essere posizionata in: +`packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/intro.md`. + +Se un file tradotto non esiste per una lingua specifica, Docusaurus passerà automaticamente alla versione inglese di quella pagina. + + + +### Generare i file di traduzione + +Quando aggiungi una nuova lingua, puoi generare i file JSON necessari per le stringhe dell'interfaccia utente (come etichette dei pulsanti e elementi di navigazione) eseguendo il seguente comando dalla directory `packages/docs/site`: + +```bash +npm run write-translations -- --locale +``` + +Con la configurazione i18n corretta in `docusaurus.config.js` e i file sotto `i18n`, quando esegui `npm run build:docs` dalla root del progetto, verranno create cartelle specifiche sotto `dist` per ogni lingua. + + + +## Testare le traduzioni localmente + +Per visualizzare in anteprima le tue modifiche per una lingua esistente: + +1. Modifica o aggiungi un file tradotto nella directory della lingua appropriata, come `packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/`. +2. Dalla directory `/packages/docs/site`, esegui il server di sviluppo locale per la tua lingua target. Per esempio, per testare lo spagnolo (es): + +```bash + +npm run dev -- --locale es + +``` + + + +## Il selettore della lingua + +Il selettore della lingua è un menu a tendina che permette agli utenti di selezionare la loro lingua preferita. + +![Selettore lingua documentazione](@site/static/img/contributing/language-switcher-docs.webp) + + + +### Rendere una lingua pubblicamente disponibile nel selettore della lingua + +Raccomandiamo di aggiungere una lingua al selettore solo quando una parte significativa della documentazione è stata tradotta. Questo evita una scarsa esperienza utente dove passare a una nuova lingua risulta nel vedere principalmente contenuto inglese non tradotto. + +Come linea guida, una lingua dovrebbe essere resa pubblicamente disponibile nel selettore solo quando l'intero hub "Documentazione" è tradotto, inclusi questi capitoli chiave: + +- [Guida rapida](https://wordpress.github.io/wordpress-playground/quick-start-guide) +- [Istanza web Playground](https://wordpress.github.io/wordpress-playground/web-instance) +- [Informazioni su Playground](https://wordpress.github.io/wordpress-playground/about) +- [Guide](https://wordpress.github.io/wordpress-playground/guides) +- [Contribuire](https://wordpress.github.io/wordpress-playground/contributing) +- [Link e risorse](https://wordpress.github.io/wordpress-playground/resources) + +Tutte le lingue sono disponibili una volta che la configurazione i18n per una lingua è completa e la struttura dei file corretta è in posto sotto `i18n`. + +- https://wordpress.github.io/wordpress-playground/ +- https://wordpress.github.io/wordpress-playground/es/ +- https://wordpress.github.io/wordpress-playground/fr/ + +Assumendo che la lingua `fr` sia la prima lingua con le pagine dell'hub Documentazione (Guida rapida, Istanza web Playground, Informazioni su Playground, Guide,... ) completamente tradotte in francese, il `docusaurus.config.js` dovrebbe apparire così in quel branch così `npm run build:docs` genera correttamente il sottosito `fr` e mostra solo la lingua francese nel selettore della lingua `localeDropdown`. + +``` + { + "i18n": { + "defaultLocale": "en", + "path": "i18n", + "locales": [ + "en", + "fr" + ], + "localeConfigs": { + "en": { + "label": "English", + "path": "en" + }, + "fr": { + "label": "French", + "path": "fr" + } + } + } + }, + { + "type": "localeDropdown", + "position": "right" + } +``` + +`. + +- The assets are listed at `packages/docs/site/static/img/` only place assets inside the translation folder when it requires localized content. +- Once the translations are ready, check if the docs build script is running properly `npm run build:docs`. + +4. **Create a pull request with your changes** + +- Add a prefix to the title `[i18n]` to help to identify the translations +- Describe the pages that you translated +- Request a review at `#playground` or `#polyglots` at `wordpress.slack.com` + +:::info +We highly recommend submitting pull requests with a small number of translated pages. This approach simplifies the review process and allows for a more gradual and manageable integration of your work. +::: +--> + +## Workflow di traduzione + +Segui questi passaggi per tradurre una pagina: + +1. **Cerca una issue di traduzione esistente**: Prima, [cerca le issue del repository](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aissue%20state%3Aopen%20%5Btranslation%5D%20progress) per vedere se esiste già una issue di tracciamento per la lingua desiderata. Se esiste, commenta l'issue per rivendicare la/e pagina/e che vorresti tradurre. +2. **Crea una nuova issue di traduzione**: Se non esiste una issue, per favore creane una nuova per tracciare i progressi della traduzione per la lingua. Puoi modellarla sull'issue [#2202](https://github.com/WordPress/wordpress-playground/issues/2202) e usare la checklist markdown qui sotto per tracciare i progressi. +3. **Traduci il file**: + +- Controlla se hai l'ultima versione della documentazione +- Copia il file .md originale da `packages/docs/site/docs/...` al percorso corrispondente nella directory della lingua (es., `packages/docs/site/i18n//...`). È cruciale replicare la struttura dei file originale. +- Traduci il contenuto del nuovo file, mantenendo il contenuto originale commentato ``. +- Le risorse sono elencate in `packages/docs/site/static/img/` posiziona le risorse dentro la cartella di traduzione solo quando richiede contenuto localizzato. +- Una volta che le traduzioni sono pronte, controlla se lo script di build della documentazione funziona correttamente `npm run build:docs`. + +4. **Crea una pull request con le tue modifiche** + +- Aggiungi un prefisso al titolo `[i18n]` per aiutare a identificare le traduzioni +- Descrivi le pagine che hai tradotto +- Richiedi una revisione su `#playground` o `#polyglots` su `wordpress.slack.com` + +:::info +Raccomandiamo fortemente di inviare pull request con un piccolo numero di pagine tradotte. Questo approccio semplifica il processo di revisione e permette un'integrazione più graduale e gestibile del tuo lavoro. +::: + + + +### Template di tracciamento traduzioni + +Puoi usare il seguente markdown nella tua issue di tracciamento: + +``` +## Pagine di traduzione rimanenti + +
+

Main

 + +- about + - [ ] build.md #2291 + - [ ] index.md #2282 + - [ ] launch.md #2292 + - [ ] test.md #2302 +- contributing + - [ ] code.md #2218 + - [ ] coding-standards.md #2219 + - [ ] contributor-day.md #2246 + - [ ] contributor-badge.md + - [ ] documentation.md #2271 + - [ ] translations.md #2201 +- guides + - [ ] for-plugin-developers.md #2210 + - [ ] for-theme-developers.md #2211 + - [ ] index.md #2209 + - [ ] providing-content-for-your-demo.md #2213 + - [ ] wordpress-native-ios-app.md #2214 +- [ ] intro.md #2198 +- [ ] quick-start-guide.md #2204 +- [ ] resources.md #2207 +- [ ] web-instance.md #2208 + +
+ +
+

Blueprints

 + +- blueprints + - [ ] 01-index.md #2305 + - [ ] 02-using-blueprints.md #2330 + - [ ] 03-data-format.md #2340 + - [ ] 04-resources.md #2352 + - [ ] 05-steps-shorthands.md #2386 + - [ ] 05-steps.md #2386 + - [ ] 06-bundles.md #2438 + - [ ] 07-json-api-and-function-api.md #2438 + - [ ] 08-examples.md #2474 + - [ ] 09-troubleshoot-and-debug-blueprints.md #2474 + - [ ] intro.md #2489 + - tutorial + - [ ] 01-what-are-blueprints-what-you-can-do-with-them.md #2511 + - [ ] 02-how-to-load-run-blueprints.md #2526 + - [ ] 03-build-your-first-blueprint.md + - [ ] index.md #2511 +
+ +
+

Developers

 + +- [ ] developers + - [ ] 03-build-an-app + - [ ] 01-index.md + - [ ] 05-local-development + - [ ] 01-wp-now.md + - [ ] 02-vscode-extension.md + - [ ] 03-php-wasm-node.md + - [ ] intro.md + - [ ] 06-apis + - [ ] 01-index.md + - [ ] javascript-api + - [ ] 01-index.md + - [ ] 02-index-html-vs-remote-html.md + - [ ] 03-playground-api-client.md + - [ ] 04-blueprint-json-in-api-client.md + - [ ] 05-blueprint-functions-in-api-client.md + - [ ] 06-mount-data.md + - [ ] query-api + - [ ] 01-index.md + - [ ] 23-architecture + - [ ] 01-index.md + - [ ] 02-wasm-php-overview.md + - [ ] 03-wasm-php-compiling.md + - [ ] 04-wasm-php-javascript-module.md + - [ ] 05-wasm-php-filesystem.md + - [ ] 07-wasm-asyncify.md + - [ ] 08-browser-concepts.md + - [ ] 09-browser-tab-orchestrates-execution.md + - [ ] 10-browser-iframe-rendering.md + - [ ] 11-browser-php-worker-threads.md + - [ ] 12-browser-service-workers.md + - [ ] 13-browser-scopes.md + - [ ] 14-browser-cross-process-communication.md + - [ ] 15-wordpress.md + - [ ] 16-wordpress-database.md + - [ ] 17-browser-wordpress.md + - [ ] 18-host-your-own-playground.md + - [ ] 24-limitations + - [ ] 01-index.md + - [ ] intro-devs.md +
+``` + + + +### Tradurre con l'interfaccia web GitHub + +Se preferisci non usare strumenti per sviluppatori, puoi facilmente contribuire alle traduzioni direttamente sul sito GitHub. Tutto ciò di cui hai bisogno è un account GitHub gratuito. + +Questa guida ti mostrerà come aggiornare una traduzione esistente e aggiungerne una completamente nuova. + +--- + + + +#### Aggiornare una traduzione esistente + +1. **Naviga al file.** Vai al repository e trova il file che vuoi aggiornare. I file di traduzione si trovano in una cartella denominata con il codice della lingua. Per esempio, tutte le traduzioni francesi sono in `packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/`. + +2. **Apri l'editor.** Seleziona il file che desideri modificare e clicca l'icona della matita (**Modifica questo file**) nell'angolo in alto a destra. + ![Modifica traduzione esistente](@site/static/img/contributing/editing-translations.webp) + +3. **Fai il fork del repository.** GitHub ti chiederà automaticamente di **Fare il fork di questo repository**. Questo crea una copia personale per te da modificare in sicurezza. Clicca il pulsante per procedere. + +4. **Fai le tue modifiche.** L'editor si aprirà nel tuo browser. Aggiorna il testo con le tue traduzioni migliorate. + +5. **Proponi le tue modifiche.** Una volta finito, scorri fino in fondo alla pagina. Aggiungi un breve titolo e descrizione delle tue modifiche (es., "Correzione di errori di battitura nella traduzione francese") e clicca il pulsante **Proponi modifiche**. + +6. **Crea una Pull Request.** Nella schermata successiva, clicca il pulsante **Crea pull request**. Questo invierà le tue modifiche ai maintainer del progetto per la revisione. + +--- + + + + Ceci est le contenu traduit en français. + ``` + + ![GitHub UI Editor](@site/static/img/contributing/editor-github-ui.webp) + +5. **Commit the new file.** When you are done, scroll to the bottom. Add a title for your new file (e.g., "Add French translation for documentation.md") and click the **Commit new file** button. + +6. **Create a Pull Request.** On the next screen, click **Create pull request** to submit your new translation for review. + --> + +#### Aggiungere una nuova traduzione + +1. **Determina il percorso del file corretto.** Il percorso e il nome del nuovo file devono rispecchiare il file inglese originale. + + - **Originale inglese:** `packages/docs/site/docs/main/contributing/documentation.md` + - **Traduzione francese:** `packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/contributing/documentation.md` + +2. **Crea il nuovo file.** Naviga nella cartella della lingua corretta (es., `/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/`). Clicca **Add file** > **Create new file**. + ![Creazione nuova traduzione](@site/static/img/contributing/adding-file-github-ui.webp) + + - **Suggerimento:** Nella casella del nome file, puoi creare nuove cartelle digitando il nome della cartella seguito da `/`. Per esempio, digitando `main/contributing/documentation.md` creerà automaticamente le cartelle `main` e `contributing`. + +3. **Fai il fork del repository.** Proprio come prima, GitHub ti chiederà di **Fare il fork di questo repository**. Clicca il pulsante per creare la tua copia personale. + +4. **Aggiungi il contenuto tradotto.** L'editor si aprirà con un file vuoto. Per comodità dei revisori, per favore copia il contenuto dal file inglese originale e incollalo nel tuo nuovo file, avvolgendolo in tag di commento. Aggiungi la tua traduzione sotto di esso. + + ```markdown + + + Questo è il contenuto tradotto in italiano. + ``` + + ![Editor interfaccia GitHub](@site/static/img/contributing/editor-github-ui.webp) + +5. **Committa il nuovo file.** Quando hai finito, scorri fino in fondo. Aggiungi un titolo per il tuo nuovo file (es., "Aggiungi traduzione italiana per documentation.md") e clicca il pulsante **Commit new file**. + +6. **Crea una Pull Request.** Nella schermata successiva, clicca **Create pull request** per inviare la tua nuova traduzione per la revisione. + + + +👋 Olá! Bem vindo a documentação oficial do WordPress Playground. + +WordPress Playground é uma ferramenta online onde podes testar e aprender mais sobre o WordPress. Nesta página(Documentação) irá encontrar todas as informações necessárias para começar a trabalhar com o Playground. + +``` + +:::info +This practice also helps the maintenance team identify outdated translations. When the original English content is updated, we can search the codebase for the old text (now in comments) and flag the corresponding translation for review. +::: + +To find a reviewer fluent in the language of your PR, you can post a request on the [Make WordPress Polyglots blog](https://make.wordpress.org/polyglots/). Be sure to include the locale tag (e.g., #ja for Japanese) to notify the appropriate General Translation Editors (GTEs). + +When the PR is merged, the translated version of that page should appear under `https://wordpress.github.io/wordpress-playground/{%LANGUAGE%}`, if you are contributing for the first time request your [Contributor Badge](/contributing/contributor-badge). +--> + +## Processo di revisione + +Per semplificare il processo di revisione, per favore mantieni il testo inglese originale come commento direttamente sopra il contenuto tradotto. + +``` + + + +👋 Ciao! Benvenuto nella documentazione ufficiale di WordPress Playground. + +WordPress Playground è uno strumento online dove puoi testare e imparare di più su WordPress. In questa pagina (Documentazione) troverai tutte le informazioni necessarie per iniziare a lavorare con Playground. + +``` + +:::info +Questa pratica aiuta anche il team di manutenzione a identificare traduzioni obsolete. Quando il contenuto inglese originale viene aggiornato, possiamo cercare nel codebase il vecchio testo (ora nei commenti) e segnalare la traduzione corrispondente per la revisione. +::: + +Per trovare un revisore fluente nella lingua della tua PR, puoi pubblicare una richiesta sul [blog Make WordPress Polyglots](https://make.wordpress.org/polyglots/). Assicurati di includere il tag locale (es., #it per l'italiano) per notificare gli Editor Generali di Traduzione (GTE) appropriati. + +Quando la PR viene mergiata, la versione tradotta di quella pagina dovrebbe apparire su `https://wordpress.github.io/wordpress-playground/{%LANGUAGE%}`, se stai contribuendo per la prima volta richiedi il tuo [Badge Contributore](/contributing/contributor-badge). +``` diff --git a/packages/docs/site/i18n/it/docusaurus-theme-classic/footer.json b/packages/docs/site/i18n/it/docusaurus-theme-classic/footer.json new file mode 100644 index 0000000000..d713c13265 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-theme-classic/footer.json @@ -0,0 +1,42 @@ +{ + "link.title.Docs": { + "message": "Documentazione", + "description": "The title of the footer links column with title=Docs in the footer" + }, + "link.title.Community": { + "message": "Community", + "description": "The title of the footer links column with title=Community in the footer" + }, + "link.item.label.Documentation": { + "message": "Documentazione", + "description": "The label of footer link with label=Documentation linking to /" + }, + "link.item.label.Blueprints": { + "message": "Blueprint", + "description": "The label of footer link with label=Blueprints linking to /blueprints" + }, + "link.item.label.Developers": { + "message": "Sviluppatori", + "description": "The label of footer link with label=Developers linking to /developers" + }, + "link.item.label.API Reference": { + "message": "Riferimento API", + "description": "The label of footer link with label=API Reference linking to /api" + }, + "link.item.label.GitHub": { + "message": "GitHub", + "description": "The label of footer link with label=GitHub linking to https://github.com/WordPress/wordpress-playground" + }, + "link.item.label.#playground on Slack": { + "message": "#playground su Slack", + "description": "The label of footer link with label=#playground on Slack linking to https://make.wordpress.org/chat" + }, + "copyright": { + "message": "Copyright © 2025 WordPress Playground, Inc. Costruito con Docusaurus.", + "description": "The footer copyright" + }, + "logo.alt": { + "message": "Il Codice è Poesia", + "description": "The alt text of footer logo" + } +} diff --git a/packages/docs/site/i18n/it/docusaurus-theme-classic/navbar.json b/packages/docs/site/i18n/it/docusaurus-theme-classic/navbar.json new file mode 100644 index 0000000000..6b3d9204d9 --- /dev/null +++ b/packages/docs/site/i18n/it/docusaurus-theme-classic/navbar.json @@ -0,0 +1,26 @@ +{ + "title": { + "message": "WordPress Playground", + "description": "The title in the navbar" + }, + "logo.alt": { + "message": "WordPress Playground", + "description": "The alt text of navbar logo" + }, + "item.label.Documentation": { + "message": "Documentazione", + "description": "Navbar item with label Documentation" + }, + "item.label.Blueprints": { + "message": "Blueprint", + "description": "Navbar item with label Blueprints" + }, + "item.label.Developers": { + "message": "Sviluppatori", + "description": "Navbar item with label Developers" + }, + "item.label.API Reference": { + "message": "Riferimento API", + "description": "Navbar item with label API Reference" + } +} diff --git a/packages/docs/site/i18n/it/kapa-ai-plugin/kapa-ai.json b/packages/docs/site/i18n/it/kapa-ai-plugin/kapa-ai.json new file mode 100644 index 0000000000..dbdf2d4f90 --- /dev/null +++ b/packages/docs/site/i18n/it/kapa-ai-plugin/kapa-ai.json @@ -0,0 +1,18 @@ +{ + "kapaAi.modalTitle": { + "message": "Assistente IA di WordPress Playground", + "description": "Title for Kapa AI modal" + }, + "kapaAi.exampleQuestionsTitle": { + "message": "Prova a chiedermi...", + "description": "Title for example questions section" + }, + "kapaAi.disclaimer": { + "message": "Questo **assistente IA risponde a domande su WordPress Playground** utilizzando la [documentazione](https://wordpress.github.io/wordpress-playground/) e le issue di GitHub (https://github.com/WordPress/wordpress-playground/issues) dell'anno scorso", + "description": "Disclaimer text for Kapa AI" + }, + "kapaAi.exampleQuestions": { + "message": "Come usare l'API dei Blueprint?,Come cambiare la versione di PHP?,Come importare un file WXR?,Come montare file locali?", + "description": "Example questions for Kapa AI" + } +}