diff --git a/contributing.md b/contributing.md index 3cbbf073a..66c1da85a 100644 --- a/contributing.md +++ b/contributing.md @@ -1,4 +1,4 @@ -**English** | [Українська](docs/contributing/contributing_ua.md) | [Русский](docs/contributing/contributing_ru.md) | [Türkçe](docs/contributing/contributing_tr.md) | [Deutsch](docs/contributing/contributing_de.md) | [Français](docs/contributing/contributing_fr.md) | [Português (BR)](docs/contributing/contributing_pt_br.md) | [বাংলা](docs/contributing/contributing_bn.md) | [Español](docs/contributing/contributing_es.md) | [Română](docs/contributing/contributing_ro.md) +**English** | [Українська](docs/contributing/contributing_ua.md) | [Русский](docs/contributing/contributing_ru.md) | [Türkçe](docs/contributing/contributing_tr.md) | [Deutsch](docs/contributing/contributing_de.md) | [Français](docs/contributing/contributing_fr.md) | [Português (BR)](docs/contributing/contributing_pt_br.md) | [বাংলা](docs/contributing/contributing_bn.md) | [Español](docs/contributing/contributing_es.md) | [Română](docs/contributing/contributing_ro.md) | [Polski](docs/contributing/contributing_pl.md) ## Let's make bruno better, together !! diff --git a/docs/contributing/contributing_pl.md b/docs/contributing/contributing_pl.md new file mode 100644 index 000000000..6365c45f2 --- /dev/null +++ b/docs/contributing/contributing_pl.md @@ -0,0 +1,88 @@ +[English](/contributing.md) | [Українська](docs/contributing/contributing_ua.md) | [Русский](docs/contributing/contributing_ru.md) | [Türkçe](docs/contributing/contributing_tr.md) | [Deutsch](docs/contributing/contributing_de.md) | [Français](docs/contributing/contributing_fr.md) | [Português (BR)](docs/contributing/contributing_pt_br.md) | [বাংলা](docs/contributing/contributing_bn.md) | [Español](docs/contributing/contributing_es.md) | [Română](docs/contributing/contributing_ro.md) | **Polski** + +## Wspólnie uczynijmy Bruno lepszym !! + +Cieszymy się, że chcesz udoskonalić Bruno. Poniżej znajdziesz wskazówki, jak rozpocząć pracę z Bruno na Twoim komputerze. + +### Stos Technologiczny + +Bruno jest zbudowane przy użyciu Next.js i React. Używamy również electron do stworzenia wersji desktopowej (która obsługuje lokalne kolekcje) + +Biblioteki, których używamy + +- CSS - Tailwind +- Edytory Kodu - Codemirror +- Zarządzanie Stanem - Redux +- Ikony - Tabler Icons +- Formularze - formik +- Walidacja Schematu - Yup +- Klient Zapytań - axios +- Obserwator Systemu Plików - chokidar + +### Zależności + +Będziesz potrzebować [Node v18.x lub najnowszej wersji LTS](https://nodejs.org/en/) oraz npm 8.x. W projekcie używamy npm workspaces + +## Rozwój + +Bruno jest rozwijane jako aplikacja desktopowa. Musisz załadować aplikację, uruchamiając aplikację Next.js w jednym terminalu, a następnie uruchomić aplikację electron w innym terminalu. + +### Zależności + +- NodeJS v18 + +### Lokalny Rozwój + +```bash +# użyj wersji nodejs 18 +nvm use + +# zainstaluj zależności +npm i --legacy-peer-deps + +# zbuduj dokumentację graphql +npm run build:graphql-docs + +# zbuduj zapytanie bruno +npm run build:bruno-query + +# uruchom aplikację next (terminal 1) +npm run dev:web + +# uruchom aplikację electron (terminal 2) +npm run dev:electron + + +### Rozwiązywanie Problemów + +Możesz napotkać błąd `Unsupported platform` podczas uruchamiania `npm install`. Aby to naprawić, będziesz musiał usunąć `node_modules` i `package-lock.json`, a następnie uruchomić `npm install`. Powinno to zainstalować wszystkie niezbędne pakiety potrzebne do uruchomienia aplikacji. + +```shell +# Usuń node_modules w podkatalogach +find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do + rm -rf "$dir" +done + +# Usuń package-lock w podkatalogach +find . -type f -name "package-lock.json" -delete + +``` + +### Testowanie + +```bash +# bruno-schema +npm test --workspace=packages/bruno-schema + +# bruno-lang +npm test --workspace=packages/bruno-lang +``` + +### Tworzenie Pull Request + +- Prosimy, aby PR były małe i skoncentrowane na jednej rzeczy +- Prosimy przestrzegać formatu tworzenia gałęzi + - feature/[nazwa funkcji]: Ta gałąź powinna zawierać zmiany dotyczące konkretnej funkcji + - Przykład: feature/dark-mode + - bugfix/[nazwa błędu]: Ta gałąź powinna zawierać tylko poprawki dla konkretnego błędu + - Przykład bugfix/bug-1 diff --git a/docs/publishing/publishing_pl.md b/docs/publishing/publishing_pl.md new file mode 100644 index 000000000..acbb026a4 --- /dev/null +++ b/docs/publishing/publishing_pl.md @@ -0,0 +1,8 @@ +[English](/publishing.md) | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) | **Polski** + +### Publikowanie Bruno w nowym menedżerze pakietów + +Chociaż nasz kod jest otwartoźródłowy i dostępny dla każdego do użytku, uprzejmie prosimy o kontakt z nami przed rozważeniem publikacji w nowych menedżerach pakietów. Jako twórca Bruno, posiadam znak towarowy `Bruno` dla tego projektu i chciałbym zarządzać jego dystrybucją. Jeśli chcesz zobaczyć Bruno w nowym menedżerze pakietów, proszę zgłoś problem na GitHubie. + +Chociaż większość naszych funkcji jest darmowa i otwartoźródłowa (co obejmuje REST i GraphQL Apis), +staramy się osiągnąć harmonijny balans między zasadami open-source a zrównoważonym rozwojem - https://github.com/usebruno/bruno/discussions/269 diff --git a/docs/readme/readme_pl.md b/docs/readme/readme_pl.md new file mode 100644 index 000000000..413788aef --- /dev/null +++ b/docs/readme/readme_pl.md @@ -0,0 +1,129 @@ +
+ + +### Bruno - Otwartoźródłowe IDE do exploracji i testów 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) + +[English](/readme.md) | [Українська](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) | [Português (BR)](docs/readme/readme_pt_br.md)) | [한국어](docs/readme/readme_kr.md) ) | [বাংলা](docs/readme/readme_bn.md) | [Español](docs/readme/readme_es.md) | [Italiano](docs/readme/readme_it.md) | [Română](docs/readme/readme_ro.md) | **Polski** + +Bruno to nowy i innowacyjny klient API, którego celem jest zrewolucjonizowanie status quo reprezentowy przez Postman i podobne narzędzia. + +Bruno przechowuje twoje kolekcje bezpośrednio w folderze na twoim systemie plików. Używamy prostego języka znaczników, Bru, do zapisywania informacji o żądaniach API. + +Możesz użyć Git lub dowolnego systemu kontroli wersji do współpracy nad swoimi kolekcjami API. + +Bruno działa tylko w trybie offline. Nie planujemy nigdy dodawać synchronizacji w chmurze do Bruno. Cenimy prywatność Twoich danych i wierzymy, że powinny one pozostać na Twoim urządzeniu. Przeczytaj naszą długoterminową wizję [tutaj](https://github.com/usebruno/bruno/discussions/269) + +📢 Obejrzyj naszą ostatnią rozmowę na konferencji India FOSS 3.0 [tutaj](https://www.youtube.com/watch?v=7bSMFpbcPiY) + +![bruno](assets/images/landing-2.png)

+ +### Instalacja + +Bruno jest dostępny jako plik binarny do pobrania [na naszej stronie internetowej](https://www.usebruno.com/downloads) dla Mac, Windows i Linux. + +Możesz również zainstalować Bruno za pomocą menedżerów pakietów, takich jak Homebrew, Chocolatey, Scoop, Snap i Apt. + +```sh +# On Mac via Homebrew +brew install bruno + +# On Windows via Chocolatey +choco install bruno + +# On Windows via Scoop +scoop bucket add extras +scoop install bruno + +# On Linux via Snap +snap install bruno + +# On Linux via 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 +``` + +### Uruchom na wielu platformach 🖥️ + +![bruno](assets/images/run-anywhere.png)

+ +### Współpracuj przez Git 👩‍💻🧑‍💻 + +Lub dowolny inny system kontroli wersji, który wybierzesz + +![bruno](assets/images/version-control.png)

+ +### Ważne Linki 📌 + +- [Nasza Długoterminowa Wizja](https://github.com/usebruno/bruno/discussions/269) +- [Mapa Drogi](https://github.com/usebruno/bruno/discussions/384) +- [Dokumentacja](https://docs.usebruno.com) +- [Stack Overflow](https://stackoverflow.com/questions/tagged/bruno) +- [Strona Internetowa](https://www.usebruno.com) +- [Cennik](https://www.usebruno.com/pricing) +- [Pobieranie](https://www.usebruno.com/downloads) +- [Sponsorzy Github](https://github.com/sponsors/helloanoop). + +### Zobacz 🎥 + +- [Opinie](https://github.com/usebruno/bruno/discussions/343) +- [Centrum Wiedzy](https://github.com/usebruno/bruno/discussions/386) +- [Scriptmania](https://github.com/usebruno/bruno/discussions/385) + +### Wsparcie ❤️ + +Jeśli podoba Ci się Bruno i chcesz wspierać naszą pracę opensource, rozważ sponsorowanie nas przez [Sponsorzy Github](https://github.com/sponsors/helloanoop). + +### Udostępnij Opinie 📣 + +Jeśli Bruno pomógł Tobie w pracy i Twoim zespołom, nie zapomnij podzielić się swoimi [opiniami na naszej dyskusji GitHub](https://github.com/usebruno/bruno/discussions/343) + +### Publikowanie w Nowych Menedżerach Pakietów + +Więcej informacji znajdziesz [tutaj](publishing.md). + +### Współpraca 👩‍💻🧑‍💻 + +Cieszę się, że chcesz udoskonalić bruno. Proszę sprawdź [przewodnik współpracy](contributing.md) + +Nawet jeśli nie jesteś w stanie przyczynić się poprzez kod, nie wahaj się zgłaszać błędów i wniosków o funkcje, które muszą zostać zaimplementowane, aby rozwiązać Twój przypadek użycia. + +### Autorzy + +
+ + + +
+ +### Pozostań w kontakcie 🌐 + +[𝕏 (Twitter)](https://twitter.com/use_bruno)
+[Strona Internetowa](https://www.usebruno.com)
+[Discord](https://discord.com/invite/KgcZUncpjq)
+[LinkedIn](https://www.linkedin.com/company/usebruno) + +### Znak Towarowy + +**Nazwa** + +`Bruno` jest znakiem towarowym należącym do [Anoop M D](https://www.helloanoop.com/) + +**Logo** + +Logo pochodzi z [OpenMoji](https://openmoji.org/library/emoji-1F436/). Licencja: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) + +### Licencja 📄 + +[MIT](license.md) diff --git a/publishing.md b/publishing.md index 1e747d530..ae27d6790 100644 --- a/publishing.md +++ b/publishing.md @@ -1,4 +1,4 @@ -**English** | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) +**English** | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) | [Polski](docs/publishing/publishing_pl.md) ### Publishing Bruno to a new package manager diff --git a/readme.md b/readme.md index 8ea195870..9aa0aa064 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) | [Português (BR)](docs/readme/readme_pt_br.md)) | [한국어](docs/readme/readme_kr.md) ) | [বাংলা](docs/readme/readme_bn.md) | [Español](docs/readme/readme_es.md) | [Italiano](docs/readme/readme_it.md) | [Română](docs/readme/readme_ro.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) | [Português (BR)](docs/readme/readme_pt_br.md)) | [한국어](docs/readme/readme_kr.md) ) | [বাংলা](docs/readme/readme_bn.md) | [Español](docs/readme/readme_es.md) | [Italiano](docs/readme/readme_it.md) | [Română](docs/readme/readme_ro.md) | [Polski](docs/readme/readme_pl.md) Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.