Skip to content

Commit fe392e1

Browse files
fellyphCopilot
fellyph
and
Copilot
authored
[i18n] Adding Italian translations (#2865)
This pull request adds new Italian translations for the WordPress Playground documentation, specifically for the "Contributing" section. It introduces three new files: a category label, a comprehensive code contribution guide, and documentation for contributor badges. These additions provide Italian-speaking contributors with localized guidelines and information on how to participate and be recognized within the project. **New Italian documentation:** * Contributing section label: - Added `_category_.json` to label the section as "Contribuire". * Code contribution guidelines: - Added `code.md` with detailed instructions on contributing code, running a local development environment, debugging, and best practices, all translated into Italian. - Added `coding-standards.md` outlining coding principles, error message standards, API design, and blueprint guidelines, fully localized. * Contributor recognition: - Added `contributor-badge.md` explaining the criteria and process for obtaining the WordPress Playground Contributor and Team badges, including instructions and visual examples, in Italian. --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 26e6e1e commit fe392e1

File tree

12 files changed

+1986
-0
lines changed

12 files changed

+1986
-0
lines changed

‎packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/_category_.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"label": "Contribuire"
3+
}

‎packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/code.md‎

Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,173 @@
1+
---
2+
slug: /contributing/code
3+
title: Contributi al codice
4+
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.
5+
---
6+
7+
<!--
8+
# Code contributions
9+
-->
10+
11+
# Contributi al codice
12+
13+
<!--
14+
Like all WordPress projects, Playground uses GitHub to manage code and track issues. The main repository is at [https://github.com/WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground) and the Playground Tools repository is at [https://github.com/WordPress/playground-tools/](https://github.com/WordPress/playground-tools/).
15+
16+
:::info Contribute to Playground Tools
17+
18+
This guide includes links to the main repository, but all the steps and options apply for both. If you're interested in the plugins or [local development](/developers/local-development/) tools—start there.
19+
20+
:::
21+
22+
Browse [the list of open issues](https://github.com/wordpress/wordpress-playground/issues) to find what to work on. The [`Good First Issue`](https://github.com/wordpress/wordpress-playground/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22) label is a recommended starting point for first-time contributors.
23+
24+
Be sure to review the following resources before you begin:
25+
26+
- [Coding principles](/contributing/coding-standards)
27+
- [Architecture](/developers/architecture)
28+
- [Vision and Philosophy](https://github.com/WordPress/wordpress-playground/issues/472)
29+
- [WordPress Playground Roadmap](https://github.com/WordPress/wordpress-playground/issues/525)
30+
-->
31+
32+
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/).
33+
34+
:::info Contribuire a Playground Tools
35+
36+
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ì.
37+
38+
:::
39+
40+
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.
41+
42+
Assicurati di rivedere le seguenti risorse prima di iniziare:
43+
44+
- [Principi di codifica](/contributing/coding-standards)
45+
- [Architettura](/developers/architecture)
46+
- [Visione e Filosofia](https://github.com/WordPress/wordpress-playground/issues/472)
47+
- [Roadmap di WordPress Playground](https://github.com/WordPress/wordpress-playground/issues/525)
48+
49+
<!--
50+
## Contribute Pull Requests
51+
52+
[Fork the Playground repository](https://github.com/WordPress/wordpress-playground/fork) and clone it to your local machine. To do that, copy and paste these commands into your terminal:
53+
54+
```bash
55+
git clone -b trunk --single-branch --depth 1 --recurse-submodules
56+
57+
# replace `YOUR-GITHUB-USERNAME` with your GitHub username:
58+
git@github.com:YOUR-GITHUB-USERNAME/wordpress-playground.git
59+
cd wordpress-playground
60+
npm install
61+
```
62+
63+
Create a branch, make changes, and test it locally by running the following command:
64+
65+
```bash
66+
npm run dev
67+
```
68+
69+
Playground will open in a new browser tab and refresh automatically with each change.
70+
71+
When your'e ready, commit the changes and submit a Pull Request.
72+
73+
:::info Formatting
74+
75+
We handle code formatting and linting automatically. Relax, type away, and let the machines do the work.
76+
77+
:::
78+
-->
79+
80+
## Contribuire con Pull Request
81+
82+
[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:
83+
84+
```bash
85+
git clone -b trunk --single-branch --depth 1 --recurse-submodules
86+
87+
# sostituisci `YOUR-GITHUB-USERNAME` con il tuo username GitHub:
88+
git@github.com:YOUR-GITHUB-USERNAME/wordpress-playground.git
89+
cd wordpress-playground
90+
npm install
91+
```
92+
93+
Crea un branch, fai le modifiche e testalo localmente eseguendo il seguente comando:
94+
95+
```bash
96+
npm run dev
97+
```
98+
99+
Playground si aprirà in una nuova scheda del browser e si aggiornerà automaticamente ad ogni modifica.
100+
101+
Quando sei pronto, committa le modifiche e invia una Pull Request.
102+
103+
:::info Formattazione
104+
105+
Gestiamo automaticamente la formattazione del codice e il linting. Rilassati, scrivi e lascia che le macchine facciano il lavoro.
106+
107+
:::
108+
109+
<!--
110+
### Running a local Multisite
111+
112+
WordPress Multisite has a few [restrictions when run locally](https://developer.wordpress.org/advanced-administration/multisite/prepare-network/#restrictions). If you plan to test a Multisite network using Playground's `enableMultisite` step, make sure you either change `wp-now`'s default port or set a local test domain running via HTTPS.
113+
114+
To change `wp-now`'s default port to the one supported by WordPress Multisite, run it using the `--port=80` flag:
115+
116+
```bash
117+
npx @wp-now/wp-now start --port=80
118+
```
119+
120+
There are a few ways to set up a local test domain, including editing your `hosts` file. If you're unsure how to do that, we suggest installing [Laravel Valet](https://laravel.com/docs/11.x/valet) and then running the following command:
121+
122+
```bash
123+
valet proxy playground.test http://127.0.0.1:5400 --secure
124+
```
125+
126+
Your dev server is now available on https://playground.test.
127+
-->
128+
129+
### Eseguire un Multisite locale
130+
131+
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.
132+
133+
Per cambiare la porta predefinita di `wp-now` a quella supportata da WordPress Multisite, eseguilo usando il flag `--port=80`:
134+
135+
```bash
136+
npx @wp-now/wp-now start --port=80
137+
```
138+
139+
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:
140+
141+
```bash
142+
valet proxy playground.test http://127.0.0.1:5400 --secure
143+
```
144+
145+
Il tuo server di sviluppo è ora disponibile su https://playground.test.
146+
147+
<!--
148+
## Debugging
149+
150+
### Use VS Code and Chrome
151+
152+
If you're using VS Code and have Chrome installed, you can debug Playground in the code editor:
153+
154+
- Open the project folder in VS Code.
155+
- Select Run > Start Debugging from the main menu or press `F5`/`fn`+`F5`.
156+
157+
### Debugging PHP
158+
159+
Playground logs PHP errors in the browser console after every PHP request.
160+
-->
161+
162+
## Debug
163+
164+
### Usa VS Code e Chrome
165+
166+
Se stai usando VS Code e hai Chrome installato, puoi fare il debug di Playground nell'editor di codice:
167+
168+
- Apri la cartella del progetto in VS Code.
169+
- Seleziona Esegui > Avvia debug dal menu principale o premi `F5`/`fn`+`F5`.
170+
171+
### Debug di PHP
172+
173+
Playground registra gli errori PHP nella console del browser dopo ogni richiesta PHP.

‎packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/coding-standards.md‎

Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
---
2+
slug: /contributing/coding-standards
3+
title: Principi di codifica
4+
description: Dettaglia i principi di codifica per Playground, concentrandosi su messaggi di errore utili, un'API pubblica minimale e Blueprints.
5+
---
6+
7+
<!--
8+
# Coding principles
9+
-->
10+
11+
# Principi di codifica
12+
13+
<!--
14+
## Error messages
15+
16+
A good error message informs the user of the following steps to take. Any ambiguity in errors thrown by Playground [Public APIs](/developers/apis/) will prompt the developers to open issues.
17+
18+
Consider a network error, for example—can we infer the type of error and display a relevant message summarizing the next steps?
19+
20+
- **Network error**: "Your internet connection twitched. Try to reload the page.
21+
- **404**: "Could not find the file".
22+
- **403**: "The server blocked access to the file".
23+
- **CORS**: clarify it's a browser security feature and add a link to a detailed explanation (on MDN or another reliable source). Suggest the user move their file somewhere else, like `raw.githubusercontent.com`, and link to a resource explaining how to set up CORS headers on their servers.
24+
25+
We handle code formatting and linting automatically. Relax, type away, and let the machines do the work.
26+
-->
27+
28+
## Messaggi di errore
29+
30+
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.
31+
32+
Considera un errore di rete, per esempio—possiamo dedurre il tipo di errore e visualizzare un messaggio rilevante che riassuma i prossimi passaggi?
33+
34+
- **Errore di rete**: "La tua connessione internet ha avuto un problema. Prova a ricaricare la pagina."
35+
- **404**: "Impossibile trovare il file".
36+
- **403**: "Il server ha bloccato l'accesso al file".
37+
- **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.
38+
39+
Gestiamo automaticamente la formattazione del codice e il linting. Rilassati, scrivi e lascia che le macchine facciano il lavoro.
40+
41+
<!--
42+
## Public API
43+
44+
Playground aims to keep the narrowest possible API scope.
45+
46+
Public APIs are easy to add and hard to remove. It only takes one PR to introduce a new API, but it may take a thousand to remove it, especially if other projects have already consumed it.
47+
48+
- Don't expose unnecessary functions, classes, constants, or other components.
49+
-->
50+
51+
## API pubblica
52+
53+
Playground mira a mantenere lo scope dell'API il più ristretto possibile.
54+
55+
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.
56+
57+
- Non esporre funzioni, classi, costanti o altri componenti non necessari.
58+
59+
<!--
60+
## Blueprints
61+
62+
[Blueprints](/blueprints/getting-started) are the primary way to interact with Playground. These JSON files describe a set of steps that Playground executes in order.
63+
64+
### Guidelines
65+
66+
Blueprint steps should be **concise and focused**. They should do one thing and do it well.
67+
68+
- If you need to create a new step, try refactoring an existing one first.
69+
- If that's not enough, ensure the new step delivers a new capability. Don't replicate the functionality of existing steps.
70+
- Assume the step would be called more than once.
71+
- Assume it would run in a specific order.
72+
- Add unit tests to verify that.
73+
74+
Blueprints should be **intuitive and straightforward**.
75+
76+
- Don't require arguments that can be optional.
77+
- Use plain argument. For example, `slug` instead of `path`.
78+
- Define constants in virtual JSON files—don't modify PHP files.
79+
- Define a TypeScript type for the Blueprint. That's how Playground generates its JSON schema.
80+
- Write a function to handle a Blueprint step. Accept the argument of the type you defined.
81+
- Provide a usage example in the doc string. It's automatically reflected in the docs.
82+
-->
83+
84+
## Blueprints
85+
86+
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.
87+
88+
### Linee guida
89+
90+
I passaggi dei Blueprints dovrebbero essere **concisi e mirati**. Dovrebbero fare una cosa e farla bene.
91+
92+
- Se devi creare un nuovo passaggio, prova prima a refactorizzare uno esistente.
93+
- Se non è sufficiente, assicurati che il nuovo passaggio fornisca una nuova capacità. Non replicare la funzionalità dei passaggi esistenti.
94+
- Assumi che il passaggio verrà chiamato più di una volta.
95+
- Assumi che verrà eseguito in un ordine specifico.
96+
- Aggiungi test unitari per verificarlo.
97+
98+
I Blueprints dovrebbero essere **intuitivi e diretti**.
99+
100+
- Non richiedere argomenti che possono essere opzionali.
101+
- Usa argomenti semplici. Per esempio, `slug` invece di `path`.
102+
- Definisci le costanti in file JSON virtuali—non modificare i file PHP.
103+
- Definisci un tipo TypeScript per il Blueprint. È così che Playground genera il suo schema JSON.
104+
- Scrivi una funzione per gestire un passaggio del Blueprint. Accetta l'argomento del tipo che hai definito.
105+
- Fornisci un esempio di utilizzo nella stringa di documentazione. Viene automaticamente riflesso nella documentazione.

‎packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-badge.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
title: Badge Contributore WordPress Playground
3+
slug: /contributing/contributor-badge
4+
description: Scopri i criteri per il Badge Contributore WordPress Playground e come richiederlo per il tuo profilo WordPress.org.
5+
---
6+
7+
<!--
8+
# Playground Contributor Badge
9+
10+
This page provides detailed information on the Playground Contributor Badge and the process of requesting it on your [WordPress.org](https://wordpress.org) profile.
11+
12+
---
13+
-->
14+
15+
# Badge Contributore Playground
16+
17+
Questa pagina fornisce informazioni dettagliate sul Badge Contributore Playground e sul processo per richiederlo sul tuo profilo [WordPress.org](https://wordpress.org).
18+
19+
---
20+
21+
<!--
22+
## Getting Started
23+
24+
Any contribution to the WordPress Playground project is highly valued. The Playground team recognizes contributions across several key areas:
25+
26+
- **Playground Code:** Making code changes and reviewing the core project.
27+
- **Playground UI:** Improving the user interface of the web experience.
28+
- **Documentation:** Writing, updating, and reviewing documentation.
29+
- **Translation:** Translating any part of the project.
30+
- **Blueprints Gallery:** Creating new blueprints or improving existing ones.
31+
-->
32+
33+
## Per iniziare
34+
35+
Ogni contributo al progetto WordPress Playground è molto apprezzato. Il team Playground riconosce i contributi in diverse aree chiave:
36+
37+
- **Codice Playground:** Fare modifiche al codice e rivedere il progetto principale.
38+
- **Interfaccia Playground:** Migliorare l'interfaccia utente dell'esperienza web.
39+
- **Documentazione:** Scrivere, aggiornare e rivedere la documentazione.
40+
- **Traduzione:** Tradurre qualsiasi parte del progetto.
41+
- **Galleria Blueprints:** Creare nuovi blueprints o migliorare quelli esistenti.
42+
43+
<!--
44+
## Playground Contributor Badge
45+
46+
To get a Playground Contributor Badge, you must have made at least one eligible contribution from the list above. The team may choose to award the badge for other contributions or a combination of the above at the team's discretion.
47+
48+
![Playground Contributor Badge](@site/static/img/contributing/playground-contributor-badge.webp)
49+
-->
50+
51+
## Badge Contributore Playground
52+
53+
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.
54+
55+
![Badge Contributore Playground](@site/static/img/contributing/playground-contributor-badge.webp)
56+
57+
<!--
58+
## Playground Team Badge
59+
60+
If you are currently a contributor and have been actively involved in the Playground project for the past **twelve months**, you are eligible for a **Playground Team Badge**.
61+
62+
![Playground Contributor Badge](@site/static/img/contributing/playground-team-badge.webp)
63+
-->
64+
65+
## Badge Team Playground
66+
67+
Se sei attualmente un contributore e sei stato attivamente coinvolto nel progetto Playground negli ultimi **dodici mesi**, sei idoneo per un **Badge Team Playground**.
68+
69+
![Badge Team Playground](@site/static/img/contributing/playground-team-badge.webp)
70+
71+
<!--
72+
## Requesting a Profile Badge
73+
74+
If you meet the criteria, you can request a badge. Please include links to resources (such as GitHub pull requests, issues, or translated strings) that show you have met the criteria. Send a request at the links bellow:
75+
76+
- [Contributor Badge](https://profiles.wordpress.org/associations/playground-contributor/)
77+
- [Team Badge](https://profiles.wordpress.org/associations/playground-team/)
78+
79+
### Request form
80+
81+
![Playground Contributor Badge](@site/static/img/contributing/request-contributor-badge.webp)
82+
83+
To access the request, the user should be logged in with their WordPress.org account and open the Request Membership tab, after submitting the required information. A Playground Team Representative will confirm your contribution and assign the badge. The team will perform a weekly review of contributions and award badges at that time. Updates on new badges awarded will be posted during the Playground Team meeting.
84+
-->
85+
86+
## Richiedere un Badge Profilo
87+
88+
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:
89+
90+
- [Badge Contributore](https://profiles.wordpress.org/associations/playground-contributor/)
91+
- [Badge Team](https://profiles.wordpress.org/associations/playground-team/)
92+
93+
### Modulo di richiesta
94+
95+
![Badge Contributore Playground](@site/static/img/contributing/request-contributor-badge.webp)
96+
97+
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.

0 commit comments

Comments
 (0)