Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Spanish translation #2

Merged
merged 1 commit into from
Jun 3, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/es/complete-user-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,19 +9,19 @@ Esta sección contiene instrucciones detalladas sobre cómo instalar, configurar

<!--@include: ../parts/es/block_want-to-try.md-->

## De los autores
## Sobre los autores

¡Siempre valoramos tu tiempo y queremos que empieces a construir productos web realmente geniales sobre esta impresionante pila tecnológica lo antes posible! Por ello, para que tengas una guía completa para usar y entender los principios básicos de la CLI de **Gowebly**, hemos preparado una explicación exhaustiva del proyecto en esta **Guía de usuario completa**.
¡Siempre valoramos tu tiempo y queremos que empieces a construir web apps realmente geniales utilizando este increible stack! Es por ello, que hicimos esta **Guía de usuario completa** para que puedas usar y entender los principios básicos de la CLI de **Gowebly**.

Nos hemos preocupado de hacerte **lo más cómodo** el aprendizaje de esta maravillosa herramienta, por lo que cada comando CLI tiene una descripción textual suficiente, así como un diagrama visual de su funcionamiento.
Nos preocupamos por que el aprendizaje de esta herramienta sea **lo más amigable** posible, por lo que cada comando tiene una descripción, así como un diagrama visual de su funcionamiento.

Esperamos que encuentre respuesta a todas sus preguntas.

<!--@include: ../parts/es/block_cant-find-answer.md-->

## Empezar a explorar

Es muy recomendable empezar a explorar con las dos secciones para entender el principio básico y los principales componentes incorporados en el **Gowebly** CLI:
Es muy recomendable empezar a explorar con estas dos secciones para entender los principios básicos y los principales componentes incorporados en el CLI de **Gowebly**:

1. [¿Qué es Gowebly CLI?](/es/getting-started)
2. [¿Cómo funciona?](/es/getting-started/how-does-it-work)
Expand Down
64 changes: 32 additions & 32 deletions docs/es/complete-user-guide/create-new-project.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Create a new project
# Crear un nuevo proyecto

To start a new project, execute the `create` command:
Para iniciar un nuevo proyecto, ejecuta el comando `create`:

::: code-group
```bash [CLI]
Expand All @@ -12,25 +12,25 @@ go run github.com/gowebly/gowebly@latest create
```
:::

And result will be:
Y el resultado será algo como:

<img width="100%" alt="gowebly create" src="https://raw.githubusercontent.com/gowebly/.github/main/images/gowebly_create.gif"/>

Typically, the created project contains the following files and folders:
Generalmente, el proyecto creado contiene los siguientes archivos y carpetas:

- The templates are located in the `./templates` folder.
- The main CSS file `styles.scss` is located in the `./assets` folder.
- The main JavaScript file `scripts.js` is located in the `./assets` folder.
- The PWA manifest file `manifest.json` and images are located in the `./static` folder.
- Los templates se encuentran en la carpeta `./templates`.
- El archivo CSS principal `styles.scss` se encuentra en la carpeta `./assets`.
- El archivo JavaScript principal `scripts.js` se encuentra en la carpeta `./assets`.
- El archivo para la PWD `manifest.json` y las imágenes se encuentran en la carpeta `./static`.

::: warning Go structure disclaimer
Please note, that the **Gowebly** does not impose any restrictions on the architecture, style or structure of your project. The CLI only helps you **quickly start a new project** and generates all the necessary files for you.
Por favor ten en cuenta que **Gowebly** no impone ninguna restricción sobre la arquitectura, estilo o estructura de tu proyecto. La CLI solo te ayuda a **iniciar rápidamente un nuevo proyecto** y genera todos los archivos necesarios para ti.

Therefore, you are **free to create** any project structure you wish.
Por lo tanto, eres **libre de crear** la estructura de tu proyecto como desees.
:::

::: code-group
```bash{18,19} [Using html/template]
```bash{18,19} [Usando html/template]
.
├── assets
│ ├── scripts.js
Expand Down Expand Up @@ -65,7 +65,7 @@ Therefore, you are **free to create** any project structure you wish.
└── server.go
```

```bash{19,21} [Using Templ]
```bash{19,21} [Usando Templ]
.
├── assets
│ ├── scripts.js
Expand Down Expand Up @@ -103,34 +103,34 @@ Therefore, you are **free to create** any project structure you wish.
```
:::

::: danger Auto-generated files by Templ
Please do **not** edit `*_templ.go` Go files in the `./templates` folder of your project! They're auto-generated by the **Templ** CLI from `*.templ` templates.
::: danger Archivos generados por Templ
Por favor **no** edites los archivos Go `*_templ.go` en la carpeta `./templates` de tu proyecto! Son generados automáticamente por la CLI de **Templ** a partir de las plantillas `*.templ`.
:::

## What CLI does for you?
## ¿Qué hace la CLI por ti?

Every time you execute the `create` command for a project, the **Gowebly** CLI does the following under the hood:
Cada vez que ejecutas el comando `create` para un crear un nuevo proyecto, la CLI de **Gowebly** hace lo siguiente:

| Step | Description |
| Paso | Descripción |
| :---: | ---------------------------------------------------------------------------------------------------------------- |
| **1** | **The structure of your project** |
| | CLI creates the project folders and all needed miscellaneous files |
| **2** | **The backend part of your project** |
| | CLI generates the backend files (`go.mod`, chosen Go framework files, and so on) |
| | CLI runs `go mod tidy` and `go fmt` for the first time |
| **3** | **The frontend part of your project** |
| | CLI generates the `scripts.js` file with importing the chosen reactivity library |
| | CLI generates the `styles.scss` file with minimal styles for the chosen CSS framework |
| | CLI generates the needed utility files (`package.json`, config for the chosen CSS framework, and so on) |
| | CLI runs `install` and `build` scripts from the `package.json` file with the chosen frontend runtime environment |

To visualize the workflow, please refer to the diagram:
| **1** | **La estructura de tu proyecto** |
| | CLI crea las carpetas del proyecto y todos los archivos necesarios |
| **2** | **La parte del backend de tu proyecto** |
| | CLI genera los archivos backend (`go.mod`, archivos de los framework elegidos, etc.) |
| | CLI corre `go mod tidy` y `go fmt` por primera vez |
| **3** | **La parte del frontend de tu proyecto** |
| | CLI genera el archivo `scripts.js` con la librería escogida |
| | CLI genera el archivo `styles.scss` con estilos mínimos del framework CSS escogido |
| | CLI genera los archivos necesarios (`package.json`, configuraciones para el framework CSS, entre otros) |
| | CLI ejecuta los scripts `install` y `build` desde el archivo `package.json` con el entorno frontend seleccionado|

Para visualizar el flujo de trabajo, consulta el diagrama:

```mermaid
stateDiagram-v2
Structure: Generate project structure
Backend: Prepare backend part
Frontend: Prepare frontend part
Structure: Genera la estructura del proyecto
Backend: Prepara el backend
Frontend: Prepara el frontend
direction LR
[*] --> Structure
Structure --> Backend
Expand Down
6 changes: 3 additions & 3 deletions docs/es/complete-user-guide/info-about-system.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Info about your system
# Información sobre el sistema

To view information about your system, execute the `doctor` command:
Para ver información sobre tu sistema, ejecuta el comando `doctor`:

::: code-group
```bash [CLI]
Expand All @@ -12,7 +12,7 @@ go run github.com/gowebly/gowebly@latest doctor
```
:::

And result will be:
Y el resultado será algo como:

```
✓ Your system information has been collected successfully!
Expand Down
20 changes: 9 additions & 11 deletions docs/es/complete-user-guide/installation.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,35 @@
# Installation
# Instalación

The basics for installing the **Gowebly** CLI on your system are covered in this section.
Los fundamentos para instalar la CLI de **Gowebly** se cubren en esta sección.

## Go

[Download][go_download_url] and install **Go**. Version `1.22` (or higher) is required.
[Descarga][go_download_url] e instala **Go**. Se requiere la versión `1.22` (o superior).

Then, use the [`go install`][go_install_url] command:
Luego, usa el comando [`go install`][go_install_url]:

``` bash
go install github.com/gowebly/gowebly/v2@latest
```

## Homebrew

GNU/Linux and Apple macOS users available way to install **Gowebly** CLI via [Homebrew][other_brew_url].

Tap a new formula:
Los usuarios de GNU / Linux y Apple macOS tienen disponible la instalación de la CLI a través de [Homebrew][other_brew_url].

``` bash
brew tap gowebly/tap
```

Install:
Luego instala usando:

``` bash
brew install gowebly/tap/gowebly
```

## Manual mode
## Modo manual

Download ready-made `exe` files for Windows, `deb` (for Debian, Ubuntu), `rpm` (for CentOS, Fedora), `apk` (for Alpine), or Arch Linux packages from the [Releases][repo_releases_url] page.
Descargue el `exe` ya compilado para Windows, `deb` (para Debian, Ubuntu), `rpm` (para CentOS, Fedora), `apk` (para Alpine), o el paquete para Arch Linux desde la página [Releases][repo_releases_url].

Install it like you normally would.
Instálalo como lo haría normalmente.

<!--@include: ../../parts/links.md-->
34 changes: 17 additions & 17 deletions docs/es/complete-user-guide/run-your-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ next:
link: '/es/faq'
---

# Run your project
# Ejecutar tu proyecto

To run your project in a development mode, execute the `run` command:
Para ejecutar tu proyecto en modo de desarrollo, ejecuta el comando `run`:

::: code-group
```bash [CLI]
Expand All @@ -18,28 +18,28 @@ go run github.com/gowebly/gowebly@latest run
```
:::

## What CLI does for you?
## ¿Qué hace la CLI por ti?

Every time you execute the `run` command for a project, the **Gowebly** CLI does the following under the hood:
Cada vez que ejecutas el comando `run` para un crear un nuevo proyecto, la CLI de **Gowebly** hace lo siguiente:

| Step | Description |
| Paso | Descripción |
| :---: | ------------------------------------------------------------------------------------- |
| **1** | **Start Air tool** |
| | CLI runs your project with live-reloading mode in a simple `air -c .air.toml` command |
| **2** | **Live-reloading mode** |
| | Air tool builds frontend part of your project in production mode |
| | Air tool generates Go functions from `*.templ` templates, if needed |
| | Air tool builds the backend part of your project |
| | Air tool watches for changes in your project files and rebuilds them |
| **1** | **Inicia la herramienta Air** |
| | CLI corre tu proyecto en modo live-reloading con un simple comando `air -c .air.toml` |
| **2** | **Modo Live-reloading** |
| | Air builds el frontend en modo producción |
| | Air genera las funciones de Go desde los templates `*.templ` templates, si se requiere|
| | Air builds el backend de tu proyecto |
| | Air queda a la espera de cambios en tu proyecto para hacer rebuilds |

To visualize the workflow, please refer to the diagram:
Para visualizar el flujo de trabajo, consulta el diagrama:

```mermaid
stateDiagram-v2
Backend: Prepare backend part
Frontend: Prepare frontend part
Watch: Watch for changes
Changes: Changes occurred
Backend: Prepara el backend
Frontend: Prepara el frontend
Watch: Espera cambios
Changes: Ocurre un cambio
direction LR
Watch --> Changes
state Changes {
Expand Down
36 changes: 19 additions & 17 deletions docs/es/faq.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
prev:
text: 'Complete user guide'
text: 'Guía de usuario completa'
link: '/es/complete-user-guide'
next:
text: 'Troubleshooting'
Expand All @@ -9,14 +9,16 @@ next:

# FAQ

The most common questions that may come up when using the **Gowebly** CLI are collected in this section.
Las preguntas más comunes que pueden surgir al usar la CLI de **Gowebly** se recopilan en esta sección.

<!--@include: ../parts/es/block_cant-find-answer.md-->

## What is the right way to ask a question or report a bug?
## ¿Cuál es la forma correcta de hacer una pregunta o reportar un error?

Running the `doctor` command will give you a list of all the tools you need to work properly with the **Gowebly** CLI that are installed on your system:

Ejecutar el comando `doctor` te dará una lista de todas las herramientas que están instaladas en tu sistema y que son necesarias para trabajar con la CLI de **Gowebly**.

::: code-group
``` bash [CLI]
gowebly doctor
Expand All @@ -27,31 +29,31 @@ go run github.com/gowebly/gowebly@latest doctor
```
:::

Next, open [GitHub Issues][repo_issues_url] and follow the instructions.
Después, abre un [GitHub Issues][repo_issues_url] y sigue las instrucciones.

::: warning Output of the `doctor` command
Don't forget to include output of the `doctor` command to the issue description! This is a very helpful information for the debugging process.
::: warning Output del comando `doctor`
No olvides incluir el output del comando `doctor` en la descripción del problema. Esta información es muy útil para el proceso de depuración.
:::

## Is it possible to see a demonstration of how the CLI works without installation?
## ¿Es posible ver una demostración de cómo funciona la CLI sin instalarla?

Yes, of course! :smile: To give you a visual understanding of the project, we have recorded a short demonstration GIF for `gowebly create` command:
¡Claro que sí! :smile: Para darte una comprensión visual del proyecto, hemos grabado un GIF de demostración corto para el comando `gowebly create`:

<img width="100%" alt="gowebly create" src="https://raw.githubusercontent.com/gowebly/.github/main/images/gowebly_create.gif"/>

## Where else can I read something about the CLI?
## ¿Dónde más puedo leer sobre la CLI?

We prepared articles demonstrating the main features and the major updates:
Hemos preparado artículos que demuestran las principales características y las actualizaciones más importantes:

- [A next-generation CLI tool for building amazing web apps in Go using htmx & hyperscript][article_devto_article_1_url]
- [Big update: the Gowebly CLI now supports Templ][article_devto_article_2_url]
- [Frontend update: the Gowebly CLI now supports daisyUI components library][article_devto_article_3_url]
- [Big frontend update: the Gowebly CLI now supports Bootstrap and Bulma][article_devto_article_4_url]
- [The Gowebly CLI has grown to v2.0.0][article_devto_article_5_url]
- [CLI de última generación para crear increíbles aplicaciones web en Go utilizando htmx & hyperscript.][article_devto_article_1_url]
- [Gran actualización: la CLI de Gowebly ahora soporta Templ][article_devto_article_2_url]
- [Actualización del frontend : la CLI Gowebly ahora es compatible con la biblioteca de componentes daisyUI][article_devto_article_3_url]
- [Gran actualización del frontend: la CLI de Gowebly ahora soporta Bootstrap y Bulma][article_devto_article_4_url]
- [La CLI de Gowebly ha llegado a la versión v2.0.0][article_devto_article_5_url]
- [Preline UI + Gowebly CLI = ❤️][article_devto_article_6_url]

::: tip Want to see your article here?
If you want to see your article here, feel free to send a [PR][repo_docs_pr_url] to the **Gowebly** Docs repository.
::: tip ¿Quieres ver tu artículo aquí?
Si quieres ver tu artículo aquí, no dudes en enviar una [PR][repo_docs_pr_url] al repositorio de **Gowebly** Docs.
:::

<!--@include: ../parts/links.md-->
18 changes: 9 additions & 9 deletions docs/es/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,25 +3,25 @@ editLink: false
lastUpdated: false
---

# What is Gowebly CLI?
# ¿Qué es Gowebly CLI?

This section will help you understand what **Gowebly** CLI is.
Esta sección te ayudará a entender qué es **Gowebly** CLI.

<!--@include: ../parts/es/block_want-to-try.md-->

The **Gowebly** CLI is a free and open source software that helps to easily build amazing web applications with Go on the backend, using htmx & hyperscript and the most popular CSS frameworks on the frontend.
La CLI de **Gowebly** es un software de código abierto y gratuito que ayuda a construir fácilmente aplicaciones web increíbles con Go en el backend, utilizando htmx & hyperscript y los más populares frameworks de CSS en el frontend.

CLI generates a ready-to-use project that helps to understand **Go** + **htmx** technology stack as quickly as possible and start working on it with maximum developer comfort. Many project elements are already optimally configured and ready for production.
Con esta CLI pudes generar un proyecto listo para usar que te ayuda a entender **Go** y **htmx** lo más rápido posible y comenzar a trabajar en ella con el máximo confort. Muchos elementos del proyecto están configurados de forma óptima, listos para producción.

To visualize the workflow, please refer to the diagram:
Para visualizar el flujo de trabajo, consulte el diagrama:

```mermaid
stateDiagram-v2
direction LR
Install: Install CLI
Doctor: View diagnostics
Create: Create new project
Run: Run project
Install: Instalar CLI
Doctor: Ver diagnostico
Create: Crear nuevo proyecto
Run: Correr proyecto
[*] --> Install
Install --> Create
Install --> Doctor
Expand Down
Loading
Loading