docs: updates and corrections for Spanish translation

docs/es/config.ts

@@ -118,7 +118,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
       collapsed: false,
       items: [
         { text: '¿Qué es VitePress？', link: 'what-is-vitepress' },
-        { text: 'Iniciando', link: 'getting-started' },
+        { text: 'Comenzar', link: 'getting-started' },
         { text: 'Enrutamiento', link: 'routing' },
         { text: 'Despliegue', link: 'deploy' }
       ]
@@ -135,7 +135,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
       ]
     },
     {
-      text: 'Pesonalización',
+      text: 'Personalización',
       collapsed: false,
       items: [
         { text: 'Usando un tema personalizado', link: 'custom-theme' },
@@ -190,7 +190,7 @@ function sidebarReference(): DefaultTheme.SidebarItem[] {
             { text: 'Página del equipo', link: 'team-page' },
             { text: 'Links Anterior / Siguiente', link: 'prev-next-links' },
             { text: 'Editar Link', link: 'edit-link' },
-            { text: 'Sello temporal de actualización', link: 'last-updated' },
+            { text: 'Última Actualización', link: 'last-updated' },
             { text: 'Búsqueda', link: 'search' },
             { text: 'Carbon Ads', link: 'carbon-ads' }
           ]

docs/es/guide/asset-handling.md

@@ -12,29 +12,33 @@ Todos los archivos Markdown son compilados en componentes Vue y procesados por [
 ![Una imagen](./imagen.png)
 ```
 
-Puede referenciar assets estáticos en sus archivos markdown, sus componentes `*.vue` en el tema, estilos y simples archivos `.css`, usando paths públicos absolutos (com base en la raiz del projeto) o paths relativos (con base en su sistema de arhivos). Este último es semejante al comportamiento que está acostumbrado se ya usó Vite, Vue CLI o el `file-loader` de webpack.
+Puede referenciar assets estáticos en sus archivos markdown, sus componentes `*.vue` en el tema, estilos y simples archivos `.css`, usando rutas públicas absolutas (en base a la raíz del proyecto) o rutas relativos (en base en su sistema de archivos). Este último es semejante al comportamiento que está acostumbrado se ya usó Vite, Vue CLI o el `file-loader` de webpack.
 
-Tipos comunes de archivos de imagen, media y fuente son detectados e incluidos automaticamente como assets.
+Tipos comunes de archivos de imagen, media y fuente son detectados e incluidos automáticamente como assets.
 
-Todos los assets referenciados, incluyendo aquellos usando paths absolutos, serán copiados al directorio de salida con un nombre de archivo hash en la compilación de producción. Assets nunca referenciados no serán copiados. Assets de imagen menores que 4KB serán incorporados en base64 - esto puede ser configurado por la opción [`vite`](../reference/site-config#vite) en configuración.
+::: tip Los archivos vinculados no se tratan como recursos.
+Los PDF u otros documentos a los que se hace referencia mediante enlaces dentro de archivos Markdown no se tratan automáticamente como recursos. Para que los archivos vinculados sean accesibles, debe colocarlos manualmente en el directorio [`public`](#the-public-directory) de su proyecto.
+:::
 
-Todas las referencias de path **estáticas**, incluyendo paths absolutos, deben ser basadas en la estructura de su directorio de trabajo.
+Todos los assets referenciados, incluyendo aquellos usando rutas absolutas, serán copiados al directorio de salida con un nombre de archivo hash en la compilación de producción. Assets nunca referenciados no serán copiados. Assets de imagen menores que 4KB serán incorporados en base64 - esto puede ser configurado por la opción [`vite`](../reference/site-config#vite) en configuración.
 
-## El directorio público {#the-public-directory}
+Todas las referencias de rutas **estáticas**, incluyendo rutas absolutos, deben ser basadas en la estructura de su directorio de trabajo.
 
-A veces, puede ser necesario proveer assets estáticos que no son referenciados directamente en ninguno de sus componentes del tema o Markdown, o usted puede querer servir ciertos archivos con el nombre del archivo original. Ejemplos de tales archivos incluyen `robots.txt`, favicons e iconos PWA.
+## El Directorio Público {#the-public-directory}
 
-Puede colocar esos archivos en el directorio `public` sobre el [directorio de origen](./routing#source-directory). Por ejemplo, se la raiz de su proyecto fuera `./docs` y estuviera usando localización por defecto del directorio fuente, entonces el directorio público será `./docs/public`.
+A veces, puede ser necesario proveer assets estáticos que no son referenciados directamente en ningún Markdown o componentes del tema, o usted puede querer servir ciertos archivos con el nombre del archivo original. Ejemplos de tales archivos incluyen `robots.txt`, favicons e iconos PWA.
 
-Los assets colocados en `public` serán copiados a la raiz del directorio de salida tal como son.
+Puede colocar esos archivos en el directorio `public` sobre el [directorio de origen](./routing#source-directory). Por ejemplo, se la raíz de su proyecto fuera `./docs` y estuviera usando ubicación por defecto del directorio fuente, entonces el directorio público será `./docs/public`.
 
-Observe que usted debe referenciar archivos colocados en `public` usando e path absoluto de la raiz - por ejemplo, `public/icon.png` debe siempre ser referenciado en el código fuente como `/icon.png`.
+Los assets colocados en `public` serán copiados a la raíz del directorio de salida tal como son.
+
+Observe que usted debe referenciar archivos colocados en `public` utilizando rutas absolutas de la raíz - por ejemplo, `public/icon.png` debe siempre ser referenciado en el código fuente como `/icon.png`.
 
 ## URL Base {#base-url}
 
-Si su sitio estuviera implantado en una URL que no sea la raiz, será necesario definir la opción `base` en `.vitepress/config.js`. Por ejemplo, se planea implantar su sitio en `https://foo.github.io/bar/`, entonces `base` debe ser definido como `'/bar/'` (siempre debe comenzar y terminar con una barra).
+Si su sitio estuviera implantado en una URL que no sea la raíz, será necesario definir la opción `base` en `.vitepress/config.js`. Por ejemplo, se planea implantar su sitio en `https://foo.github.io/bar/`, entonces `base` debe ser definido como `'/bar/'` (siempre debe comenzar y terminar con una barra).
 
-Todos los paths de sus assets estáticos son procesados automáticamente para ajustarse a los diferentes valores de configuración `base`. Por ejemplo, se tuviera una referencia absoluta a un asset sobre `public` en su Markdown:
+Todos las rutas de sus assets estáticos son procesados automáticamente para ajustarse a los diferentes valores de configuración `base`. Por ejemplo, se tuviera una referencia absoluta a un asset sobre `public` en su Markdown:
 
 ```md
 ![Una imagen](/imagen-dentro-de-public.png)
@@ -48,7 +52,7 @@ Sin embargo, se estuviera creando un componente de tema que vincula assets diná
 <img :src="theme.logoPath" />
 ```
 
-En este caso, es recomendable complementar el path con el [`auxiliar withBase`](../reference/runtime-api#withbase) proporcionado por VitePress:
+En este caso, es recomendable complementar la ruta con el [auxiliar `withBase`](../reference/runtime-api#withbase) proporcionado por VitePress:
 
 ```vue
 <script setup>

docs/es/guide/cms.md

@@ -7,9 +7,9 @@ outline: deep
 
 ## Flujo de Trabajo general {#general-workflow}
 
-Conectar VitePress a un CMS girará mayormente en torno a [Rutas dinámicas](./routing#dynamic-routes). Asegurese de entender cómo funcionan antes de proceder.
+Conectar VitePress a un CMS girará mayormente en torno a [Rutas dinámicas](./routing#dynamic-routes). Asegúrese de entender cómo funcionan antes de proceder.
 
-Como cada CMS funcionará de forma diferente, aqui podemos proveer apenas un flujo de trabajo genérico que requiere ser adaptado para cada escenario específico.
+Como cada CMS funcionará de forma diferente, aquí podemos proveer apenas un flujo de trabajo genérico que requiere ser adaptado para cada escenario específico.
 
 1. Si su CMS exige autenticación, cree un archivo `.env` para almacenar los tokens del API y cargarlos como:
 
@@ -20,15 +20,15 @@ Como cada CMS funcionará de forma diferente, aqui podemos proveer apenas un flu
     const env = loadEnv('', process.cwd())
     ```
 
-2. Obtenga los datos necesarios del CMS y aplique formato en paths de datos apropiados:
+2. Obtenga los datos necesarios del CMS y aplique formato en rutas de datos apropiados:
 
     ```js
     export default {
       async paths() {
         // use la biblioteca del cliente CMS respectiva si es necesario
         const data = await (await fetch('https://my-cms-api', {
           headers: {
-            // token caso necesario
+            // token si es necesario
           }
         })).json()
 
@@ -42,7 +42,7 @@ Como cada CMS funcionará de forma diferente, aqui podemos proveer apenas un flu
     }
     ```
 
-3. Presente el contenido en la página:
+3. Renderice el contenido en la página:
 
     ```md
     # {{ $params.title }}
@@ -52,6 +52,6 @@ Como cada CMS funcionará de forma diferente, aqui podemos proveer apenas un flu
     <!-- @content -->
     ```
 
-## Guias de Integración {#integration-guides}
+## Guías de Integración {#integration-guides}
 
-Se usted escribió una guía sobre cómo integrar VitePress con un CMS específico, por favor use el link "Edite esta página" abajo para enviarlo hacia aqui!
+Se usted escribió una guía sobre cómo integrar VitePress con un CMS específico, por favor use el link "Edite esta página" abajo para enviarlo hacia aquí!

docs/es/guide/custom-theme.md

@@ -10,7 +10,7 @@ Puede habilitar un tema personalizado creando un archivo `.vitepress/theme/index
 
 ```
 .
-├─ docs                # raiz del proyecto
+├─ docs                # raíz del proyecto
 │  ├─ .vitepress
 │  │  ├─ theme
 │  │  │  └─ index.js   # entrada de tema
@@ -19,16 +19,16 @@ Puede habilitar un tema personalizado creando un archivo `.vitepress/theme/index
 └─ package.json
 ```
 
-VitePress siempre usará el tema personalizado en vez del tema por defecto cuando detecte la precencia de un archivo de entrada de tema. Sin embargo, puede [extender el tema por defecto](./extending-default-theme) para realizar personalizaciones avanzadas sobre el.
+VitePress siempre usará el tema personalizado en vez del tema por defecto cuando detecte la presencia de un archivo de entrada de tema. Sin embargo, puede [extender el tema por defecto](./extending-default-theme) para realizar personalizaciones avanzadas sobre el.
 
 ## Interfaz del Tema {#theme-interface}
 
-Un tema personalizado de VitePress es definifo como un objeto con la siguiente interfaz:
+Un tema personalizado de VitePress es definido como un objeto con la siguiente interfaz:
 
 ```ts
 interface Theme {
   /**
-   * Componente raiz de layout para todas las páginas
+   * Componente raíz de layout para cada página
    * @required
    */
   Layout: Component
@@ -46,7 +46,7 @@ interface Theme {
 
 interface EnhanceAppContext {
   app: App // instancia de la aplicación Vue
-  router: Router // instancia del enrutador VitePress
+  router: Router //  Enrutador VitePress
   siteData: Ref<SiteData> // Metadata a nivel del sitio
 }
 ```
@@ -62,12 +62,33 @@ import Layout from './Layout.vue'
 export default {
   Layout,
   enhanceApp({ app, router, siteData }) {
-    // ...
+    // app.component(...)
+    // app.use(...)
   }
 }
 ```
 
-La exportación por defecto es el único contrato para un tema personalizado, y apenas la propiedad `Layout` es exigida. Tecnicamente, un tema de VitePress puede ser tan simple como un único componente Vue.
+El hook `enhanceApp` permite acceder a la [instancia de la aplicación Vue](https://vuejs.org/api/application.html) y otros datos de tiempo de ejecución, que se pueden usar para [registrar componentes globales](./extending-default-theme.md#registering-global-components), integrarse con bibliotecas de Vue, etc.
+
+El valor `router` es la misma instancia del enrutador VitePress que devuelve [`useRouter()`](../reference/runtime-api#userouter). Para escuchar los cambios de ruta, asigne manejadores al enrutador:
+
+```ts [.vitepress/theme/index.ts]
+export default {
+  enhanceApp({ router }) {
+    router.onBeforeRouteChange = (to) => {
+      console.log('navegando a', to)
+    }
+
+    router.onAfterRouteChange = (to) => {
+      console.log('navegando a', to)
+    }
+  }
+}
+```
+
+Devuelve `false` desde `onBeforeRouteChange` o `onBeforePageLoad` para cancelar la navegación.
+
+La exportación predeterminada es el único contrato para un tema personalizado, y solo se requiere la propiedad `Layout`. Por lo tanto, técnicamente, un tema de VitePress puede ser tan simple como un único componente de Vue.
 
 Dentro de su componente de layout, el funciona como una aplicación Vite + Vue 3 normal. Note que el tema también necesita ser [compatible con SSR](./ssr-compat).
 
@@ -77,9 +98,9 @@ El componente de layout más básico necesita un componente [`<Content />`](../r
 
 ```vue [.vitepress/theme/Layout.vue]
 <template>
-  <h1>Layout Personalizado!</h1>
+  <h1>¡Layout Personalizado!</h1>
 
-  <!-- aqui es donde el contenido markdown será presentado -->
+  <!-- aquí es donde el contenido markdown será presentado -->
   <Content />
 </template>
 ```
@@ -93,16 +114,16 @@ const { page } = useData()
 </script>
 
 <template>
-  <h1>Layout Personalizado!</h1>
+  <h1>¡Layout Personalizado!</h1>
 
   <div v-if="page.isNotFound">
-    Página 404 personalizada!
+    ¡Página 404 personalizada!
   </div>
   <Content v-else />
 </template>
 ```
 
-El auxiliar [`useData()`](../reference/runtime-api#usedata) proporciona todos los datos en tiempo de ejecución que necesitamos para mostrar layouts diferentes. Uno de los otros datos que podemos accesar es el frontmatter de la página actual. Podemos aprovechar esto para permitir que el usuario final controle el layout en cada página. Por ejemplo, el usuario puede indicar que la página debe usar un layout especial de la pagina inicial con:
+El auxiliar [`useData()`](../reference/runtime-api#usedata) proporciona todos los datos para condicionalmente en tiempo de ejecución mostrar layouts diferentes. Uno de los otros datos que podemos acceder es el frontmatter de la página actual. Podemos aprovechar esto para permitir que el usuario final controle el layout en cada página. Por ejemplo, el usuario puede indicar que la página debe usar un layout especial de la pagina inicial con:
 
 ```md
 ---
@@ -119,13 +140,13 @@ const { page, frontmatter } = useData()
 </script>
 
 <template>
-  <h1>Layout Personalizado!</h1>
+  <h1>¡Layout Personalizado!</h1>
 
   <div v-if="page.isNotFound">
-    Página 404 personalizada!
+    ¡Página 404 personalizada!
   </div>
   <div v-if="frontmatter.layout === 'home'">
-    Página inicial personalizada!
+    ¡Página inicial personalizada!
   </div>
   <Content v-else />
 </template>
@@ -144,7 +165,7 @@ const { page, frontmatter } = useData()
 </script>
 
 <template>
-  <h1>Layout Personalizado!</h1>
+  <h1>¡Layout Personalizado!</h1>
 
   <NotFound v-if="page.isNotFound" />
   <Home v-if="frontmatter.layout === 'home'" />
@@ -156,23 +177,23 @@ Consulte la [Referencia del API en tiempo de Ejecución](../reference/runtime-ap
 
 ## Distribuyendo un Tema Personalizado {#distributing-a-custom-theme}
 
-La manera más facil de distribuir un tema personalizado es proporcionarlo como un [repositorio de template en GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository).
+La manera más fácil de distribuir un tema personalizado es proporcionarlo como un [repositorio plantilla en GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository).
 
 Si desea distribuir su tema como un paquete npm, siga estos pasos:
 
-1. Exporte el objeto del tema como la exportación por defecto en su archivo de paquete.
+1. Exporta el objeto de tema como exportación predeterminada en la entrada de tu paquete.
 
-2. Si aplica, exporte la definición de configuración del tipo de tema como `ThemeConfig`.
+2. Si aplica, exporte la definición del tipo de configuración de su tema como `ThemeConfig`.
 
-3. Si su tema exige ajustes en la configuración de VitePress, exporte esa configuración en un subdirectorio del paquete (por ejemplo, `mi-tema/config`) para que el usuario pueda extenderlo.
+3. Si su tema exige ajustes en la configuración de VitePress, exporte esa configuración en un sub-ruta del paquete (por ejemplo, `mi-tema/config`) para que el usuario pueda ampliarla.
 
 4. Documente las opciones de configuración del tema (Ambos, via archivo y frontmatter).
 
-5. Proporcione instrucciones claras sobre cómo consumir su tema(vea abajo).
+5. Proporcione instrucciones claras sobre cómo consumir su tema (vea abajo).
 
 ## Consumiendo un Tema Personalizado {#consuming-a-custom-theme}
 
-Para consumir un tema extereno, importelo e reexportelo a partir del archivo de entrada del tema personalizado:
+Para consumir un tema externo, importelo y reexportelo a partir del archivo de entrada del tema:
 
 ```js [.vitepress/theme/index.js]
 import Theme from 'awesome-vitepress-theme'
@@ -195,8 +216,7 @@ export default {
 
 Si el tema exige una configuración especial de VitePress, también necesitará extenderlo en su propia configuración:
 
-```ts
-// .vitepress/theme/config.ts
+```ts [.vitepress/config.ts]
 import baseConfig from 'awesome-vitepress-theme/config'
 
 export default {
@@ -207,13 +227,12 @@ export default {
 
 Finalmente, si el tema proporciona tipos para la configuración del tema:
 
-```ts
-// .vitepress/theme/config.ts
+```ts [.vitepress/config.ts]
 import baseConfig from 'awesome-vitepress-theme/config'
-import { defineConfigWithTheme } from 'vitepress'
+import { defineConfig } from 'vitepress'
 import type { ThemeConfig } from 'awesome-vitepress-theme'
 
-export default defineConfigWithTheme<ThemeConfig>({
+export default defineConfig<ThemeConfig>({
   extends: baseConfig,
   themeConfig: {
     // El tipo es `ThemeConfig`