From b8f4236c1a7322ab9962d622b6ba7257e099d349 Mon Sep 17 00:00:00 2001 From: Riccardo Consolandi Date: Tue, 7 Nov 2023 22:51:46 +0100 Subject: [PATCH] feat: add italian readME translation, link and contributing --- docs/contributing/contributing_it.md | 89 ++++++++++++++++++++ docs/readme/readme_it.md | 121 +++++++++++++++++++++++++++ readme.md | 2 +- 3 files changed, 211 insertions(+), 1 deletion(-) create mode 100644 docs/contributing/contributing_it.md create mode 100644 docs/readme/readme_it.md diff --git a/docs/contributing/contributing_it.md b/docs/contributing/contributing_it.md new file mode 100644 index 000000000..53bf61e74 --- /dev/null +++ b/docs/contributing/contributing_it.md @@ -0,0 +1,89 @@ +## Insieme, miglioriamo Bruno! + +Sono felice di vedere che hai intenzione di migliorare Bruno. Di seguito, troverai le regole e le guide per ripristinare Bruno sul tuo computer. + +### Tecnologie utilizzate + +Bruno è costruito utilizzando Next.js e React. Utilizziamo anche Electron per incorporare la versione desktop (che consente raccolte locali). + +Le librerie che utilizziamo sono: + +- CSS - Tailwind +- Code Editors - Codemirror +- State Management - Redux +- Icons - Tabler Icons +- Forms - formik +- Schema Validation - Yup +- Request Client - axios +- Filesystem Watcher - chokidar + +### Dependences + +Hai bisogno di [Node v18.x o dell'ultima versione LTS](https://nodejs.org/en/) di npm 8.x. Utilizziamo gli spazi di lavoro npm (_npm workspaces_) in questo progetto. + +### Iniziamo a codificare + +Si prega di fare riferimento alla [documentazione di sviluppo](docs/development_it.md) per le istruzioni su come avviare l'ambiente di sviluppo locale. + +### Aprire una richiesta di pull (Pull Request) + +- Si prega di mantenere le Pull Request (PR) brevi e concentrate su un singolo obiettivo. +- Si prega di seguire il formato di denominazione dei rami. + - feature/[feature name]: Questo ramo dovrebbe contenere una specifica funzionalità. + - Esempio: feature/dark-mode + - bugfix/[bug name]: Questo ramo dovrebbe contenere solo una soluzione per un bug specifico. + - Esempio: bugfix/bug-1 + +## Sviluppo + +Bruno è sviluppato come un'applicazione "heavy". È necessario caricare l'applicazione avviando Next.js in una finestra del terminale e quindi avviare l'applicazione Electron in un altro terminale. + +### Sviluppo + +- NodeJS v18 + +### Sviluppo locale + +```bash +# use nodejs 18 version +nvm use + +# install deps +npm i --legacy-peer-deps + +# build graphql docs +npm run build:graphql-docs + +# build bruno query +npm run build:bruno-query + +# run next app (terminal 1) +npm run dev:web + +# run electron app (terminal 2) +npm run dev:electron +``` + +### Risoluzione dei problemi + +Potresti trovare un errore `Unsupported platform` durante l'esecuzione di `npm install`. Per risolvere questo problema, ti preghiamo di eliminare la cartella `node_modules`, il file `package-lock.json` e di seguito nuovamente `npm install`. Qeusto dovrebbe installare tutti i pacchetti necessari per avviare l'applicazione. + +```shell +# delete node_modules in sub-directories +find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do + rm -rf "$dir" +done + +# delete package-lock in sub-directories +find . -type f -name "package-lock.json" -delete +``` + +### Tests + +```bash +# bruno-schema +npm test --workspace=packages/bruno-schema + +# bruno-lang +npm test --workspace=packages/bruno-lang +``` diff --git a/docs/readme/readme_it.md b/docs/readme/readme_it.md new file mode 100644 index 000000000..671d51993 --- /dev/null +++ b/docs/readme/readme_it.md @@ -0,0 +1,121 @@ +
+ + +### Bruno - Opensource IDE per esplorare e testare gli APIs. + +[![GitHub version](https://badge.fury.io/gh/usebruno%2Fbruno.svg)](https://badge.fury.io/gh/usebruno%bruno) +[![CI](https://github.com/usebruno/bruno/actions/workflows/unit-tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/workflows/unit-tests.yml) +[![Commit Activity](https://img.shields.io/github/commit-activity/m/usebruno/bruno)](https://github.com/usebruno/bruno/pulse) +[![X](https://img.shields.io/twitter/follow/use_bruno?style=social&logo=x)](https://twitter.com/use_bruno) +[![Website](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com) +[![Download](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads) + +Bruno è un nuovo ed innovativo API client, mirato a rivoluzionare lo status quo rappresentato da Postman e strumenti simili disponibili. + +Bruno memorizza le tue raccolte direttamente in una cartella del tuo filesystem. Utilizziamo un linguaggio di markup in testo semplice chiamato Bru per salvare informazioni sulle richeste API. + +Puoi utilizzare Git o qualsiasi sistema di controllo che preferisci per collaborare sulle tue raccolte di API. + +Bruno funziona solo in modalità offline. Non ci sono piani per aggiungere la sincronizzazione su cloud a Bruno in futuro. Valorizziamo la privacy dei tuoi dati e crediamo che dovrebbero rimanere sul tuo dispositivo. Puoi leggere la nostra visione a lungo termine [qui (in inglese)](https://github.com/usebruno/bruno/discussions/269) + +📢 Guarda la nostra presentazione più recente alla conferenza India FOSS 3.0 [qui](https://www.youtube.com/watch?v=7bSMFpbcPiY) + +![bruno](/assets/images/landing-2.png)

+ +### Installazione + +Bruno è disponisible come download binario [sul nostro sito](https://www.usebruno.com/downloads) per Mac, Windows e Linux. + +Puoi installare Bruno anche tramite package manger come Homebrew, Chocolatey, Snap e Apt. + +```sh +# Su Mac come Homebrew +brew install bruno + +# Su Windows come Chocolatey +choco install bruno + +# Su Linux tramite Snap +snap install bruno + +# Su Linux tramite Apt +sudo mkdir -p /etc/apt/keyrings +sudo gpg --no-default-keyring --keyring /etc/apt/keyrings/bruno.gpg --keyserver keyserver.ubuntu.com --recv-keys 9FA6017ECABE0266 + +echo "deb [signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" | sudo tee /etc/apt/sources.list.d/bruno.list + +sudo apt update +sudo apt install bruno +``` + +### Funziona su diverse piattaforme 🖥️ + +![bruno](/assets/images/run-anywhere.png)

+ +### Collabora tramite Git 👩‍💻🧑‍💻 + +O con qualsiasi sistema di controllo di versioni a tua scelta + +![bruno](/assets/images/version-control.png)

+ +### Collegamenti importanti 📌 + +- [La nostra visione a lungo termine](https://github.com/usebruno/bruno/discussions/269) +- [Roadmap](https://github.com/usebruno/bruno/discussions/384) +- [Documentazione](https://docs.usebruno.com) +- [Sito internet](https://www.usebruno.com) +- [Prezzo](https://www.usebruno.com/pricing) +- [Download](https://www.usebruno.com/downloads) + +### Showcase 🎥 + +- [Testimonianze](https://github.com/usebruno/bruno/discussions/343) +- [Centro di conoscenza](https://github.com/usebruno/bruno/discussions/386) +- [Scriptmania](https://github.com/usebruno/bruno/discussions/385) + +### Supporto ❤️ + +Woof! se ti piace il progetto, premi quel ⭐ pulsante !! + +### Testimonianze condivise 📣 + +Se Bruno ti ha aiutato con il tuo lavoro ed il tuo team, per favore non dimenticare di condividere le tue [testimonianze nella nostra discussione su GitHub](https://github.com/usebruno/bruno/discussions/343) + +### Pubblica Bruno su un nuovo gestore di pacchetti + +Per favore vedi [qui](publishing.md) per accedere a più informazioni. + +### Contribuire 👩‍💻🧑‍💻 + +Sono felice che vuoi migliorare Bruno. Per favore controlla la [guida per la partecipazione](contributing.md) + +Anche se non sei in grado di contribuire tramite il codice, non esitare a segnalare bug e richieste di funzionalità che devono essere implementati per risolvere il tuo caso d'uso. + +### Autori + +
+ + + +
+ +### Resta in contatto 🌐 + +[𝕏 (Twitter)](https://twitter.com/use_bruno)
+[Sito internet](https://www.usebruno.com)
+[Discord](https://discord.com/invite/KgcZUncpjq)
+[LinkedIn](https://www.linkedin.com/company/usebruno) + +### Marchio + +**Nome** + +`Bruno` è un marchio registrato appartenente a [Anoop M D](https://www.helloanoop.com/) + +**Logo** + +Il logo è stato creato da [OpenMoji](https://openmoji.org/library/emoji-1F436/). Licenza: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) + +### Licenza 📄 + +[MIT](license.md) diff --git a/readme.md b/readme.md index 96a9d7c88..9e6734fce 100644 --- a/readme.md +++ b/readme.md @@ -10,7 +10,7 @@ [![Website](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com) [![Download](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads) -**English** | [Українська](docs/readme/readme_ua.md) | [Русский](docs/readme/readme_ru.md) | [Türkçe](docs/readme/readme_tr.md) | [Deutsch](docs/readme/readme_de.md) | [Français](docs/readme/readme_fr.md) +**English** | [Українська](docs/readme/readme_ua.md) | [Русский](docs/readme/readme_ru.md) | [Türkçe](docs/readme/readme_tr.md) | [Deutsch](docs/readme/readme_de.md) | [Français](docs/readme/readme_fr.md) | [Italiano](docs/readme/readme_it.md) Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.