From b532e018fdf448ec7d927d523051e6a3c68f48c7 Mon Sep 17 00:00:00 2001 From: "alex.ita" Date: Thu, 11 Jan 2024 12:51:42 +0100 Subject: [PATCH] Fixed lists and added translation for contributing.md --- docs/it/contributing.md | 46 +++++++++++++++++++++++++++++++++++ docs/it/server/manual.md | 1 + docs/it/support/game-faq.md | 1 + docs/it/support/server-faq.md | 2 ++ 4 files changed, 50 insertions(+) create mode 100644 docs/it/contributing.md diff --git a/docs/it/contributing.md b/docs/it/contributing.md new file mode 100644 index 00000000..20c72347 --- /dev/null +++ b/docs/it/contributing.md @@ -0,0 +1,46 @@ +# Contribuire alla creazione di BeamMP Docs + +BeamMP utilizza come tema [Material per MkDocs](https://squidfunk.github.io/mkdocs-material). Questo tema è per [MkDocs](https://www.mkdocs.org). +La documentazione completa è disponibile ai rispettivi siti web. + +## Per cominciare + +Se vuoi aiutare contribuendo a questa documentazione puoi seguire uno dei due approcci qui sotto: + +### 1. Modificare direttamente i file markdown + +Modificare direttamente i file markdown è il metodo più veloce per correzioni grammaticali, ortografici o nuove parti del contenuto. +Questo modo necessita di una conoscenza del linguaggio di Markdown, siccome devi essere alla luce di ciò che il tuo contributo produrrà. + +Se questo metodo fa per te, segui questi passi: + +1. Clicca "Modifica" sulla pagina che desideri modificare. +2. Fai una fork del progetto sul tuo account GitHub personale. +3. Fai le modifiche che vuoi. +4. Fai commit dei cambiamenti sulla tua fork. +5. Apri una pull request sul nostro repo [qui](https://github.com/BeamMP/Docs). + +Una volta che avrai creato la pull request, qualcuno del team di BeamMP la controllerà e potrà approvarla o richiedere delle modifiche. +Nel caso fossero richieste delle correzioni, a seguito del loro completamento ri-controlleremo la pull request. +La tua pull request, quando viene approvata, verrà unita tramite merge al repo e sarà automaticamente rilasciata al pubblico. + +### 2. Modificare con l'anteprima live + +La modifica della documentazione in questo modo è molto simile all'opzione 1, ma potrai vedere un'anteprima dei cambiamenti effettuati. + +1. Clicca "Modifica" sulla pagina che desideri modificare. +2. Fai una fork del progetto sul tuo account GitHub personale. +3. Clona il progetto in locale. +4. Prepara Material per MkDocs seguendo la loro guida [qui](https://squidfunk.github.io/mkdocs-material/getting-started/). +5. Esegui `mkdocs serve` per avviare il server per visualizzare l'anteprima live da dove hai clonato la fork. +6. Fai le modifiche che vuoi. +7. Fai commit dei cambiamenti sulla tua fork. +8. Apri una pull request sul nostro repo [qui](https://github.com/BeamMP/Docs). + + +## Layout del progetto + + mkdocs.yml # File di configurazione. + docs/ + index.md # La homepage della documentazione. + ... # Altre pagine markdown, immagini e altri file. diff --git a/docs/it/server/manual.md b/docs/it/server/manual.md index 86d595b9..7dd2f881 100644 --- a/docs/it/server/manual.md +++ b/docs/it/server/manual.md @@ -43,6 +43,7 @@ La cartella di lavoro del server, e non la posizione dell'eseguibile del server, # Limitazioni Le seguenti limitazioni sono imposte dal backend e riguardano il server: + - Il nome del server è limitato a 250 caratteri. - La descrizione del server è limitata a 1000 caratteri. - La mappa è limitata a 100 caratteri. diff --git a/docs/it/support/game-faq.md b/docs/it/support/game-faq.md index fb62a8df..d37b002c 100644 --- a/docs/it/support/game-faq.md +++ b/docs/it/support/game-faq.md @@ -52,5 +52,6 @@ Prima di modificare il codice, ricordati che è soggetto ai nostri [termini di u Se il problema è legato al codice e sai come usare GitHub, crea una nuova "Issue" nel repo corretto sul nostro [GitHub](https://github.com/BeamMP). Il nostro flusso di lavoro è basato sulle "Issue" di GitHub; anche se hai già una soluzione al bug, sei pregato di creare una nuova "Issue" e poi chiedere una "Pull Request" che risolva la "Issue". Maggiori informazioni [qui](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md). Nel caso non abbia o non sappia usare GitHub, puoi procedere nei seguenti modi: + - Se il problema non concerne nulla di sensibile, puoi creare un nuovo post sul nostro [forum](https://forum.beammp.com) o sul nostro [Discord](https://discord.gg/beammp). - Se il problema concerne informazioni sensibili, contatta un nostro membro dello staff su [Discord](https://discord.gg/beammp). \ No newline at end of file diff --git a/docs/it/support/server-faq.md b/docs/it/support/server-faq.md index 5770b122..0a6daf2b 100644 --- a/docs/it/support/server-faq.md +++ b/docs/it/support/server-faq.md @@ -39,6 +39,7 @@ Se giocatori esterni alla tua LAN non riescono a connettersi e ricevono sul laun Puoi vedere se la porta è aperta correttamente usando un sito come ['portchecker.co'](https://portchecker.co/) mentre il server è attivo. Note: + - Alcuni ISP non offrono un indirizzo IPv4 dedicato a tutti (trattasi di [CGNAT](https://en.wikipedia.org/wiki/Carrier-grade_NAT)), quindi il port forwarding potrebbe non essere possibile. - Non è possibile effettuare port forwarding su connessioni mobili (4G/5G). @@ -69,5 +70,6 @@ Prima di modificare il codice, ricordati che è soggetto ai nostri [termini di u Se il problema è legato al codice e sai come usare GitHub, crea una nuova "Issue" nel repo corretto sul nostro [GitHub](https://github.com/BeamMP). Il nostro flusso di lavoro è basato sulle "Issue" di GitHub; anche se hai già una soluzione al bug, sei pregato di creare una nuova "Issue" e poi chiedere una "Pull Request" che risolva la "Issue". Maggiori informazioni [qui](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md). Nel caso non abbia o non sappia usare GitHub, puoi procedere nei seguenti modi: + - Se il problema non concerne nulla di sensibile, puoi creare un nuovo post sul nostro [forum](https://forum.beammp.com) o sul nostro [Discord](https://discord.gg/beammp). - Se il problema concerne informazioni sensibili, contatta un nostro membro dello staff su [Discord](https://discord.gg/beammp). \ No newline at end of file