diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 16c7e5901..c48012b6d 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -96,7 +96,7 @@ export default defineConfig({ ], }, }, - sp: { + es: { label: "Español", lang: "es-EC", description: "Git hooks se vuelven fáciles", @@ -110,7 +110,7 @@ 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: { @@ -118,15 +118,6 @@ export default defineConfig({ }, 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", - }, - ], - }, ], }, }, diff --git a/docs/es/get-started.md b/docs/es/get-started.md index 31ef85e22..78171a744 100644 --- a/docs/es/get-started.md +++ b/docs/es/get-started.md @@ -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 @@ -58,13 +58,13 @@ 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 @@ -72,8 +72,8 @@ prettier $(git diff --cached --name-only --diff-filter=ACMR | sed 's| |\\ |g') - 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. diff --git a/docs/es/how-to.md b/docs/es/how-to.md index fa2b1ecf7..bedce1b62 100644 --- a/docs/es/how-to.md +++ b/docs/es/how-to.md @@ -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` @@ -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 @@ -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 @@ -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 @@ -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): @@ -167,7 +167,7 @@ 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: @@ -175,7 +175,7 @@ Dicho esto, si su equipo no usa Windows, puede usar Bash de esta manera: # .husky/pre-commit bash << EOF -# Put your bash script inside +# Coloque dentro su script de bash # ... EOF ``` @@ -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: @@ -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 diff --git a/docs/es/index.md b/docs/es/index.md index 2a4cdf3d6..9d373e386 100644 --- a/docs/es/index.md +++ b/docs/es/index.md @@ -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 @@ -15,14 +15,14 @@ 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 @@ -30,7 +30,7 @@ Y más: ## 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) diff --git a/docs/es/troubleshoot.md b/docs/es/troubleshoot.md index 1628bfd81..9a4184528 100644 --- a/docs/es/troubleshoot.md +++ b/docs/es/troubleshoot.md @@ -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 @@ -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 () {