Skip to content

Commit

Permalink
docs(spanish): improve spanish translation (#1504)
Browse files Browse the repository at this point in the history
  • Loading branch information
Byron2016 authored Sep 6, 2024
1 parent dcf3aed commit 3b3e7f1
Show file tree
Hide file tree
Showing 5 changed files with 32 additions and 41 deletions.
13 changes: 2 additions & 11 deletions docs/.vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ export default defineConfig({
],
},
},
sp: {
es: {
label: "Español",
lang: "es-EC",
description: "Git hooks se vuelven fáciles",
Expand All @@ -110,23 +110,14 @@ export default defineConfig({
{ text: "Migrar desde v4", link: "/es/migrate-from-v4" },
],
docFooter: {
prev: "Pagina anterior",
prev: "Página anterior",
next: "Página siguiente",
},
outline: {
label: "Contenido de la página",
},
nav: [
{ text: "Sponsor", link: "https://github.com/sponsors/typicode" },
{
text: "v9.1.5",
items: [
{
text: "Registro de cambios",
link: "https://github.com/typicode/husky/releases/tag/v9.1.5",
},
],
},
],
},
},
Expand Down
12 changes: 6 additions & 6 deletions docs/es/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ bun add --dev husky

## `husky init` (recomendado)

El comando `init` simplifica la configuración de husky en un proyecto. Crea un script `pre-commit` en `.husky/` y actualiza el script `prepare` en `package.json`. Se pueden realizar modificaciones más tarde para que se adapten a su flujo de trabajo.
El comando `init` simplifica la configuración de husky en un proyecto. Crea un script `pre-commit` en `.husky/` y actualiza el script `prepare` en `package.json`. Luego se pueden realizar modificaciones para que se adapten a su flujo de trabajo.

::: code-group

Expand Down Expand Up @@ -58,22 +58,22 @@ git commit -m "Keep calm and commit"
# El script de prueba se ejecutará cada vez que realices un commit
```

## Algunas palabras...
## Unas pocas palabras...

### Scripting

Si bien la mayoría de las veces, solo ejecutarás algunos comandos `npm run` o `npx` en tus ganchos (hooks), también puedes crear scripts con el shell POSIX para flujos de trabajo personalizados (custom workflows).

Por ejemplo, aquí se muestra cómo puedes analizar (lint) tus archivos preparados (staged files) en cada commit con solo dos líneas de código de shell y sin dependencia externa:
Por ejemplo, aquí se muestra cómo puedes analizar (lint) tus archivos preparados (staged files) en cada confirmación (commit) con solo dos líneas de código de shell y sin dependencia externa:

```shell
# .husky/pre-commit
prettier $(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') --write --ignore-unknown
git update-index --again
```

_Este es un ejemplo básico pero funcional, verifique [lint-staged](https://github.com/lint-staged/lint-staged) si necesitas más._
_Este es un ejemplo básico pero funcional, si necesita saber más verifique [lint-staged](https://github.com/lint-staged/lint-staged)._

### Deshabilitar ganchos
### Deshabilitar ganchos (hooks)

Husky no fuerza los ganchos de Git (Git hooks). Se pueden deshabilitar globalmente (`HUSKY=0`) o se pueden habilitar si se desea. Consulta la sección [Cómo hacerlo](cómo hacerlo) para obtener más información y realizar una configuración manual.
Husky no fuerza los ganchos de Git (Git hooks). Se pueden deshabilitar globalmente (`HUSKY=0`) o se pueden habilitar si se desea. Consulta la sección [Cómo hacerlo](how-to) para obtener más información y realizar una configuración manual.
24 changes: 12 additions & 12 deletions docs/es/how-to.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ echo "npm test" > .husky/pre-commit

## Archivos de inicio

Husky le permite ejecutar comandos locales antes de ejecutar ganchos (hooks). Lee comandos de estos archivos:
Husky le permite ejecutar comandos locales antes de ejecutar ganchos (hooks). Husky lee comandos de estos archivos:

- `$XDG_CONFIG_HOME/husky/init.sh`
- `~/.config/husky/init.sh`
Expand All @@ -37,7 +37,7 @@ git ... # Los ganchos (Hooks) se ejecutarán nuevamente

### Para varios comandos

Para deshabilitar los ganchos (hooks) durante un período prolongado (por ejemplo, durante la rebase/fusión (merge)):
Para deshabilitar los ganchos (hooks) durante un período prolongado (por ejemplo, durante la rebase/fusión (rebase/merge)):

```shell
export HUSKY=0 # Deshabilita todos los ganchos (hooks) de Git
Expand All @@ -57,7 +57,7 @@ export HUSKY=0 # Husky no instalará ni ejecutará ganchos (hooks) en tu máquin

## Servidor CI y Docker

Para evitar instalar ganchos de Git (Git Hooks) en servidores de CI o en Docker, use `HUSKY=0`. Por ejemplo, en GitHub Actions:
Para evitar instalar ganchos de Git (Git Hooks) en servidores de CI o en Docker, use `HUSKY=0`. Por ejemplo, en acciones de GitHub (GitHub Actions):

```yml
# https://docs.github.com/en/actions/learn-github-actions/variables
Expand Down Expand Up @@ -95,9 +95,9 @@ Luego, úsalo en `prepare`:
"prepare": "node .husky/install.mjs"
```

## Probar Ganchos (Hooks) sin comitear (Committing)
## Probar (testear) Ganchos (Hooks) sin confirmar (Committing)

Para probar un gancho (hook), agregue `exit 1` al script del gancho (hook) para cancelar el comando Git:
Para probar/testear un gancho (hook), agregue `exit 1` al script del gancho (hook) para cancelar el comando Git:

```shell
# .husky/pre-commit
Expand Down Expand Up @@ -140,11 +140,11 @@ cd frontend
npm test
```

## Ganchos (Hooks) que no son de shell
## Ganchos (hooks) que no son de shell

Para ejecutar scripts que requieren el uso de un lenguaje de script, use el siguiente patrón para cada gancho (hook) en el que aplique:

(Ejemplo usando el gancho `pre-commit` y NodeJS)
(Ejemplo usando el gancho (hook) `pre-commit` y NodeJS)

1. Cree un punto de entrada para el gancho (hook):

Expand All @@ -167,15 +167,15 @@ node .husky/pre-commit.js

## Bash

Los scripts de hook deben ser compatibles con POSIX para garantizar la mejor compatibilidad, ya que no todos tienen "bash" (por ejemplo, los usuarios de Windows).
Los scripts de gancho (hook) deben ser compatibles con POSIX para garantizar la mejor compatibilidad, ya que no todos tienen "bash" (por ejemplo, los usuarios de Windows).

Dicho esto, si su equipo no usa Windows, puede usar Bash de esta manera:

```shell
# .husky/pre-commit
bash << EOF
# Put your bash script inside
# Coloque dentro su script de bash
# ...
EOF
```
Expand All @@ -192,8 +192,8 @@ Ejecute `echo $PATH` en un shell para ver su contenido.

Los administradores de versiones funcionan de la siguiente manera:

1. Agregar el código de inicialización al archivo de inicio de su shell (`.zshrc`, `.bashrc`, etc.), que se ejecuta cada vez que abre una terminal.
2. Descargar versiones de Node a un directorio en su carpeta de inicio.
1. Agregando el código de inicialización al archivo de inicio de su shell (`.zshrc`, `.bashrc`, etc.), que se ejecuta cada vez que abre una terminal.
2. Descargando versiones de Node a un directorio en su carpeta de inicio (home folder).

Por ejemplo, si tiene dos versiones de Node:

Expand All @@ -210,7 +210,7 @@ echo $PATH
~/version-manager/Node-Y/:...
```

Ahora, el nodo hace referencia a `Nodo-Y`. Al cambiar a `Nodo-X`, `PATH` cambia en consecuencia:
Ahora, el node hace referencia a `Nodo-Y`. Al cambiar a `Nodo-X`, `PATH` cambia en concordancia:

```shell
echo $PATH
Expand Down
12 changes: 6 additions & 6 deletions docs/es/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
Husky mejora tus commits y más 🐶 _¡guau!_

Automáticamente hace un **lint de tus mensages de commit** **código** y **ejecuta pruebas (test)** al confirmar (commit) o enviar (push).
Automáticamente hace un **análisis (lint) de tus mensages de commit**, **código**, y **ejecuta pruebas (test)** al confirmarse (committing ) o al enviar (pushing).

Comienza [aquí](/get-started.md).
Comienza [aquí](/es/get-started.md).

## Características

Expand All @@ -15,22 +15,22 @@ Comienza [aquí](/get-started.md).
- Utiliza la nueva característica de Git (`core.hooksPath`)
- Soporta:
- macOS, Linux, Windows
- GUI de Git (Git GUIs), administradores de versiones de Node, directorio de custom hooks, proyectos anidados, monorepositorios (monorepos)
- [Los 13 ganchos de Git (Git hooks) del lado del cliente](https://git-scm.com/docs/githooks)
- GUI de Git (Git GUIs), administradores de versiones de Node, directorio de ganchos personalizados (custom hooks directory), proyectos anidados, monorepositorios (monorepos)
- [Todos los 13 ganchos de Git (Git hooks) del lado del cliente](https://git-scm.com/docs/githooks)

Y más:

- Ganchos específicos de la rama
- Uso de shell POSIX para crear scripts de casos avanzados
- Se adhiere a la organización de ganchos nativa de Git (Git's native hook organization)
- Se adhiere a la organización de ganchos (hooks) nativa de Git (Git's native hook organization)
- Se alinea con las mejores prácticas de [npm](https://docs.npmjs.com/cli/v10/using-npm/scripts#best-practices) usando el script `prepare`
- Opciones de inclusión/exclusión (Opt-in/opt-out)
- Se puede deshabilitar globalmente
- Mensajes de error amigables con el usuario

## Patrocinadores (Sponsors)

Apoya este proyecto convirtiéndote en patrocinador (sponsor) [here](https://github.com/sponsors/typicode) 💖
Apoya este proyecto convirtiéndote en patrocinador (sponsor) [aquí](https://github.com/sponsors/typicode) 💖

### Patrocinador especial (Special Sponsor)

Expand Down
12 changes: 6 additions & 6 deletions docs/es/troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

## Comando no encontrado

Consulta [Cómo hacerlo](how-to) para obtener soluciones.
Consulte [Cómo hacerlo](how-to) para obtener soluciones.

## Los ganchos no se están ejecutando
## Los ganchos (hooks) no se están ejecutando

1. Verifica que el nombre del archivo sea correcto. Por ejemplo, `precommit` o `pre-commit.sh` son nombres inválidos. Consulta la [documentación](https://git-scm.com/docs/githooks) de los Ganchos de Git (Git hooks ) para conocer los nombres válidos.
2. Ejecuta `git config core.hooksPath` y asegúrate de que apunte a `.husky/_` (o a tu directorio de ganchos (hooks) personalizado).
3. Confirma que tu versión de Git sea superior a `2.9`.
1. Verifique que el nombre del archivo sea correcto. Por ejemplo, `precommit` o `pre-commit.sh` son nombres inválidos. Consulte la [documentación](https://git-scm.com/docs/githooks) de los Ganchos de Git (Git hooks ) para conocer los nombres válidos.
2. Ejecute `git config core.hooksPath` y asegúrase de que apunte a `.husky/_` (o a su directorio de ganchos personalizado (custom hooks directory)).
3. Confirme que su versión de Git sea superior a `2.9`.

## `.git/hooks/` no funciona después de la desinstalación

Expand All @@ -18,7 +18,7 @@ Si los ganchos (hooks) en `.git/hooks/` no funcionan después de desinstalar `hu

Los ganchos de Git (Git hooks) pueden fallar con Yarn en Windows usando Git Bash (`stdin no es un tty`). Para los usuarios de Windows, implemente esta solución alternativa (workaround):

1. Crear `.husky/common.sh`:
1. Cree `.husky/common.sh`:

```shell
command_exists () {
Expand Down

0 comments on commit 3b3e7f1

Please sign in to comment.