diff --git a/contributing.md b/contributing.md index 0b1ee8fad..9e918a44b 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) +**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) ## Let's make bruno better, together !! diff --git a/docs/contributing/contributing_es.md b/docs/contributing/contributing_es.md new file mode 100644 index 000000000..3e69a2acc --- /dev/null +++ b/docs/contributing/contributing_es.md @@ -0,0 +1,85 @@ +## ¡Juntos, hagamos a Bruno mejor! + +Estamos encantados de que quieras ayudar a mejorar Bruno. A continuación encontrarás las instrucciones para empezar a trabajar con Bruno en tu computadora. + +### Tecnologías utilizadas + +Bruno está construido con NextJs y React. También usamos electron para distribuir una versión de escritorio (que soporta colecciones locales). + +Librerías que utilizamos: + +- CSS - Tailwind +- Editores de código - Codemirror +- Manejo del estado - Redux +- Íconos - Tabler Icons +- Formularios - formik +- Validación de esquemas - Yup +- Cliente de peticiones - axios +- Monitor del sistema de archivos - chokidar + +### Dependencias + +Necesitarás [Node v18.x o la última versión LTS](https://nodejs.org/es) y npm 8.x. Ten en cuenta que utilizamos espacios de trabajo de npm en el proyecto. + +## Desarrollo + +Bruno está siendo desarrollado como una aplicación de escritorio. Para ejecutarlo, primero debes ejecutar la aplicación de nextjs en una terminal y luego ejecutar la aplicación de electron en otra terminal. + +### Dependencias + +- NodeJS v18 + +### Desarrollo local + +```bash +# Utiliza la versión 18 de nodejs +nvm use + +# Instala las dependencias +npm i --legacy-peer-deps + +# Construye la documentación de graphql +npm run build:graphql-docs + +# Construye bruno-query +npm run build:bruno-query + +# Ejecuta la aplicación de nextjs (terminal 1) +npm run dev:web + +# Ejecuta la aplicación de electron (terminal 2) +npm run dev:electron +``` + +### Solución de problemas + +Es posible que encuentres un error de `Unsupported platform` cuando ejecutes `npm install`. Para solucionarlo, debes eliminar la carpeta `node_modules` y el archivo `package-lock.json`, luego, ejecuta `npm install`. Lo anterior debería instalar todos los paquetes necesarios para ejecutar la aplicación. + +```shell +# Elimina la carpeta node_modules en los subdirectorios +find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do + rm -rf "$dir" +done + +# Elimina el archivo package-lock en los subdirectorios +find . -type f -name "package-lock.json" -delete +``` + +### Pruebas + +```bash +# bruno-schema +npm test --workspace=packages/bruno-schema + +# bruno-lang +npm test --workspace=packages/bruno-lang +``` + +### Crea un Pull Request + +- Por favor, mantén los Pull Request pequeños y enfocados en una sola cosa. +- Por favor, sigue el siguiente formato para la creación de ramas: + - feature/[nombre de la funcionalidad]: Esta rama debe contener los cambios para una funcionalidad específica. + - Ejemplo: feature/dark-mode + - bugfix/[nombre del error]: Esta rama debe contener solo correcciones de errores para un error específico. + - Ejemplo: bugfix/bug-1 diff --git a/docs/readme/readme_es.md b/docs/readme/readme_es.md new file mode 100644 index 000000000..3e1a4dc64 --- /dev/null +++ b/docs/readme/readme_es.md @@ -0,0 +1,93 @@ +
+ + +### Bruno - IDE de código abierto para explorar y probar APIs. + +[![Versión en Github](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) +[![Actividad de Commits](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) +[![Sitio Web](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com) +[![Descargas](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads) + +Bruno un cliente de APIs nuevo e innovador, creado con el objetivo de revolucionar el panorama actual representado por Postman y otras herramientas similares. + +Bruno almacena tus colecciones directamente en una carpeta de tu sistema de archivos. Usamos un lenguaje de marcado de texto plano, llamado Bru, para guardar información sobre las peticiones a tus APIs. + +Puedes usar git o cualquier otro sistema de control de versiones que prefieras para colaborar en tus colecciones. + +Bruno funciona sin conexión a internet. No tenemos intenciones de añadir sincronización en la nube a Bruno, en ningún momento. Valoramos tu privacidad y creemos que tus datos deben permanecer en tu dispositivo. Puedes leer nuestra visión a largo plazo [aquí](https://github.com/usebruno/bruno/discussions/269) + +![bruno](/assets/images/landing-2.png)

+ +### Ejecútalo en múltiples plataformas 🖥️ + +![bruno](/assets/images/run-anywhere.png)

+ +### Colabora vía Git 👩‍💻🧑‍💻 + +O cualquier otro sistema de control de versiones que prefieras + +![bruno](/assets/images/version-control.png)

+ +### Enlaces importantes 📌 + +- [Nuestra Visión a Largo Plazo](https://github.com/usebruno/bruno/discussions/269) +- [Hoja de Ruta](https://github.com/usebruno/bruno/discussions/384) +- [Documentación](https://docs.usebruno.com) +- [Sitio Web](https://www.usebruno.com) +- [Precios](https://www.usebruno.com/pricing) +- [Descargas](https://www.usebruno.com/downloads) + +### Casos de uso 🎥 + +- [Testimonios](https://github.com/usebruno/bruno/discussions/343) +- [Centro de Conocimiento](https://github.com/usebruno/bruno/discussions/386) +- [Scripts de la Comunidad](https://github.com/usebruno/bruno/discussions/385) + +### Apoya el proyecto ❤️ + +¡Guau! Si te gusta el proyecto, ¡dale al botón de ⭐! + +### Comparte tus testimonios 📣 + +Si Bruno te ha ayudado en tu trabajo y con tus equipos, por favor, no olvides compartir tus testimonios en [nuestras discusiones de GitHub](https://github.com/usebruno/bruno/discussions/343) + +### Publicar en nuevos gestores de paquetes + +Por favor, consulta [aquí](publishing.md) para más información. + +### Contribuye 👩‍💻🧑‍💻 + +Estamos encantados de que quieras ayudar a mejorar Bruno. Por favor, consulta la [guía de contribución](contributing_es.md) para más información. + +Incluso si no puedes contribuir con código, no dudes en reportar errores y solicitar nuevas funcionalidades que necesites para resolver tu caso de uso. + +### Colaboradores + +
+ + + +
+ +### Mantente en contacto 🌐 + +[X](https://twitter.com/use_bruno)
+[Sitio Web](https://www.usebruno.com)
+[Discord](https://discord.com/invite/KgcZUncpjq)
+[LinkedIn](https://www.linkedin.com/company/usebruno) + +### Marca + +**Nombre** + +`Bruno` es una marca propiedad de [Anoop M D](https://www.helloanoop.com/). + +**Logo** + +El logo fue obtenido de [OpenMoji](https://openmoji.org/library/emoji-1F436/). Licencia: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) + +### Licencia 📄 + +[MIT](license.md) diff --git a/readme.md b/readme.md index ad78994e2..d18a1425c 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) +**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) Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.