From e20ded3279330ec2212159d3a2451aa23677b8e5 Mon Sep 17 00:00:00 2001 From: jackestar Date: Thu, 9 Jul 2026 17:09:17 -0400 Subject: [PATCH 01/10] fix(i18n): correct spanish translation for timestamp MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change the Spanish translation of "Last Updated Timestamp" from "Sello temporal de actualización" to "Última actualización". The original translation doesn't make sense. "Última actualización" is the most general and natural, though "Actualizado por última vez el" or "Fecha de última actualización" might be more appropriate depending on the exact context. --- docs/es/config.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/es/config.ts b/docs/es/config.ts index 382ad71b4..e12a145ff 100644 --- a/docs/es/config.ts +++ b/docs/es/config.ts @@ -114,7 +114,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] { ] }, { - text: 'Pesonalización', + text: 'Personalización', collapsed: false, items: [ { text: 'Usando un tema personalizado', link: 'custom-theme' }, @@ -169,7 +169,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' } ] From c32dfc0824da5928b90ccf57ad5aedcfe5251b5c Mon Sep 17 00:00:00 2001 From: jackestar Date: Thu, 9 Jul 2026 17:12:46 -0400 Subject: [PATCH 02/10] fix(i18n): correct spanish translation of slogan MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change the Spanish translation of "Markdown to beautiful docs in minutes" from "Markdown para obtener lindos documentos en minutos" to "Markdown en documentación atractiva en minutos". VitePress is focused on creating documentation, not documents (right?), so translating "docs" to "documentación" is more accurate. Additionally, replace "lindo" with "atractiva" as the former sounds too informal. Include minor orthographic corrections. --- docs/es/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/es/index.md b/docs/es/index.md index b4c8673fa..08eddfa29 100644 --- a/docs/es/index.md +++ b/docs/es/index.md @@ -5,10 +5,10 @@ layout: home hero: name: VitePress text: Generador de Sitios Estáticos Vite y Vue - tagline: Markdown para obtener lindos documentos en minutos + tagline: Markdown en documentación atractiva en minutos actions: - theme: brand - text: Qué es VitePress? + text: ¿Qué es VitePress? link: ./guide/what-is-vitepress - theme: alt text: Iniciar @@ -26,7 +26,7 @@ features: details: Cree lindos sitios de documentación apenas con markdown. - icon: title: Disfruta de la experiencia Vite - details: Inicio instantaneo de servidor, actualizaciones ultrarrápidas, y plugins del ecosistema Vite. + details: Inicio instantáneo de servidor, actualizaciones ultrarrápidas, y plugins del ecosistema Vite. - icon: title: Personaliza con Vue details: Usa la sintaxis y componentes Vue directamente en markdown, o construye temas personalizados con Vue. From f345c5519153cb0981d5df9c29d4d1cbfe9ec7ce Mon Sep 17 00:00:00 2001 From: jackestar Date: Thu, 9 Jul 2026 17:54:09 -0400 Subject: [PATCH 03/10] docs(i18n): update asset-handling.md and correct translation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Change "path" translation to "directorio". - Add the missing tip from the English version - Capitalize headings to match the English version (e.g., "El directorio público"). - Use "ubicación" instead of "localización" to avoid semantic ambiguity. - Fix markdown formatting for the `withBase` helper link. - Correct various spelling and syntax --- docs/es/guide/asset-handling.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/docs/es/guide/asset-handling.md b/docs/es/guide/asset-handling.md index c3580347f..75f954dea 100644 --- a/docs/es/guide/asset-handling.md +++ b/docs/es/guide/asset-handling.md @@ -12,27 +12,31 @@ 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 directorios públicos absolutos (en base a la raíz del proyecto) o directorios 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 directorios 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. -## El directorio público {#the-public-directory} +Todas las referencias de directorios **estáticas**, incluyendo directorios 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 directorio absoluto 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: @@ -48,7 +52,7 @@ Sin embargo, se estuviera creando un componente de tema que vincula assets diná ``` -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 el path con el [auxiliar `withBase`](../reference/runtime-api#withbase) proporcionado por VitePress: ```vue ``` -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 +138,13 @@ const { page, frontmatter } = useData() @@ -144,7 +163,7 @@ const { page, frontmatter } = useData()