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

docs: some spelling and grammar corrections for Spanish #4352

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
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
22 changes: 9 additions & 13 deletions docs/.vitepress/config/es.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ const require = createRequire(import.meta.url)
const pkg = require('vitepress/package.json')

export const es = defineConfig({
lang: 'es-CO',
description: 'Generador de Sitios Estaticos desarrollado con Vite y Vue.',
lang: 'es',
description: 'Generador de Sitios Estáticos desarrollado con Vite y Vue.',

themeConfig: {
nav: nav(),
Expand Down Expand Up @@ -36,11 +36,7 @@ export const es = defineConfig({
},

lastUpdated: {
text: 'Actualizado en',
formatOptions: {
dateStyle: 'short',
timeStyle: 'medium'
}
text: 'Actualizado en'
},

langMenuLabel: 'Cambiar Idioma',
Expand All @@ -55,7 +51,7 @@ export const es = defineConfig({
function nav(): DefaultTheme.NavItem[] {
return [
{
text: 'Guia',
text: 'Guía',
link: '/es/guide/what-is-vitepress',
activeMatch: '/es/guide/'
},
Expand Down Expand Up @@ -104,7 +100,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
]
},
{
text: 'Pesonalización',
text: 'Personalización',
collapsed: false,
items: [
{ text: 'Usando un tema personalizado', link: 'custom-theme' },
Expand Down Expand Up @@ -155,12 +151,12 @@ function sidebarReference(): DefaultTheme.SidebarItem[] {
{ text: 'Página Inicial', link: 'home-page' },
{ text: 'Pie de página', link: 'footer' },
{ text: 'Layout', link: 'layout' },
{ text: 'Distintivo', link: 'badge' },
{ text: 'Badge', link: 'badge' },
{ 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: 'Busqueda', link: 'search' },
{ text: 'Búsqueda', link: 'search' },
{ text: 'Carbon Ads', link: 'carbon-ads' }
]
}
Expand Down Expand Up @@ -200,13 +196,13 @@ export const search: DefaultTheme.AlgoliaSearchOptions['locales'] = {
selectText: 'Seleccionar',
navigateText: 'Navegar',
closeText: 'Cerrar',
searchByText: 'Busqueda por'
searchByText: 'Búsqueda por'
},
noResultsScreen: {
noResultsText: 'No fue posible encontrar resultados',
suggestedQueryText: 'Puede intentar una nueva búsqueda',
reportMissingResultsText:
'Deberian haber resultados para esa consulta?',
'Deberían haber resultados para esa consulta?',
reportMissingResultsLinkText: 'Click para enviar feedback'
}
}
Expand Down
6 changes: 1 addition & 5 deletions docs/.vitepress/config/pt.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,11 +36,7 @@ export const pt = defineConfig({
},

lastUpdated: {
text: 'Atualizado em',
formatOptions: {
dateStyle: 'short',
timeStyle: 'medium'
}
text: 'Atualizado em'
},

langMenuLabel: 'Alterar Idioma',
Expand Down
6 changes: 1 addition & 5 deletions docs/.vitepress/config/zh.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,11 +36,7 @@ export const zh = defineConfig({
},

lastUpdated: {
text: '最后更新于',
formatOptions: {
dateStyle: 'short',
timeStyle: 'medium'
}
text: '最后更新于'
},

langMenuLabel: '多语言',
Expand Down
2 changes: 1 addition & 1 deletion docs/en/reference/site-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ export default {
}
```

:::details Dynamic (Async) Config
::: details Dynamic (Async) Config

If you need to dynamically generate the config, you can also default export a function. For example:

Expand Down
14 changes: 7 additions & 7 deletions docs/es/guide/asset-handling.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

## Referenciando Assets Estáticos {#referencing-static-assets}

Todos los archivos Markdown son compilados en componentes Vue y procesados por [Vite](https://vitejs.dev/guide/assets.html). Usted puede **y debe** referenciar cualquier asset usando URLs relativas:
Todos los archivos Markdown son compilados en componentes Vue y procesados por [Vite](https://es.vite.dev/guide/assets). Usted puede **y debe** referenciar cualquier asset usando URLs relativas:

```md
![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 paths públicos absolutos (com base en la raíz del proyecto) o paths relativos (con 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.

Expand All @@ -20,15 +20,15 @@ Todas las referencias de path **estáticas**, incluyendo paths absolutos, deben

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.

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`.
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 localización por defecto del directorio fuente, entonces el directorio público será `./docs/public`.

Los assets colocados en `public` serán copiados a la raiz del directorio de salida tal como son.
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` usando e path absoluto de la raiz - por ejemplo, `public/icon.png` debe siempre ser referenciado en el código fuente como `/icon.png`.
Observe que usted debe referenciar archivos colocados en `public` usando e path 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:

Expand Down
8 changes: 4 additions & 4 deletions docs/es/guide/cms.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,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:

Expand Down Expand Up @@ -51,6 +51,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í!
18 changes: 9 additions & 9 deletions docs/es/guide/custom-theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,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
Expand All @@ -15,16 +15,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 todas las páginas
* @required
*/
Layout: Component
Expand Down Expand Up @@ -64,7 +64,7 @@ export default {
}
```

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.
La exportación por defecto es el único contrato para un tema personalizado, y apenas la propiedad `Layout` es exigida. Técnicamente, un tema de VitePress puede ser tan simple como un único componente 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).

Expand All @@ -77,7 +77,7 @@ El componente de layout más básico necesita un componente [`<Content />`](../r
<template>
<h1>Layout Personalizado!</h1>

<!-- aqui es donde el contenido markdown será presentado -->
<!-- aquí es donde el contenido markdown será presentado -->
<Content />
</template>
```
Expand All @@ -100,7 +100,7 @@ const { page } = useData()
</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 en tiempo de ejecución que necesitamos para mostrar layouts diferentes. Otro de los datos que podemos acceder es al 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
---
Expand Down Expand Up @@ -154,7 +154,7 @@ 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 de template en GitHub](https://docs.github.com/es/repositories/creating-and-managing-repositories/creating-a-template-repository).

Si desea distribuir su tema como un paquete npm, siga estos pasos:

Expand All @@ -170,7 +170,7 @@ Si desea distribuir su tema como un paquete npm, siga estos pasos:

## 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 personalizado:

```js
// .vitepress/theme/index.js
Expand Down
18 changes: 9 additions & 9 deletions docs/es/guide/data-loading.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Carga de Datos en Tiempo de Compilacion {#build-time-data-loading}
# Carga de Datos en Tiempo de Compilación {#build-time-data-loading}

VitePress proporciona un recurso llamado **cargadores de dato** que permite cargar datos arbitrarios e importarlos desde páginas o componentes. La carga de datos es ejecutada **apenas en el tiempo del build** los datos resultantes serán serializados como JSON en el paquete de JavaScript final.

Los cargadores de datos pueden ser usados para buscar datos remotos o generar metadatos con base en archivos locales. Por ejemplo, puede usar cargadores de datos para procesar todas sus pagínas API locales y generar automáticamente un indice de todas las entradas del API.
Los cargadores de datos pueden ser usados para buscar datos remotos o generar metadatos con base en archivos locales. Por ejemplo, puede usar cargadores de datos para procesar todas sus páginas API locales y generar automáticamente un indice de todas las entradas del API.

## Uso Básico {#basic-usage}

Expand Down Expand Up @@ -38,7 +38,7 @@ Salida:
}
```

Notará que el propio cargados de datos no exporta `data`. Es VitePress llamando el método `load()` entre bastidores y exponiendo implicitamente el resultado por medio de la exportación llamada `data`.
Notará que el propio cargados de datos no exporta `data`. Es VitePress llamando el método `load()` entre bastidores y exponiendo implícitamente el resultado por medio de la exportación llamada `data`.

Esto funciona incluso si el cargador fuera asíncrono:

Expand All @@ -55,7 +55,7 @@ export default {

Cuando necesita generar datos con base en archivos locales, debe usar la opción `watch` en el cargador de datos para que los cambios hechos en esos archivos puedan accionar actualizaciones rápidas.

La opción `watch` tabién es conveniente porque puede usar [patrones glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) para corresponder a vários archivos. Los patrones pueden ser relativos al propio archivo del cargador, y la función `load()` recibirá los archivos correspondientes como paths absolutos.
La opción `watch` también es conveniente porque puede usar [patrones glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) para corresponder a varios archivos. Los patrones pueden ser relativos al propio archivo del cargador, y la función `load()` recibirá los archivos correspondientes como paths absolutos.

El siguiente ejemplo muestra el cargamento de archivos CSV y la transformación de estos en JSON usando [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/). Como este archivo solo es ejecutado en el tiempo del build, usted no enviará el procesador de CSV para el cliente!

Expand All @@ -66,7 +66,7 @@ import { parse } from 'csv-parse/sync'
export default {
watch: ['./data/*.csv'],
load(watchedFiles) {
// watchedFiles será un array de paths absolutos de los archivos um array de caminhos absolutos dos arquivos correspondientes.
// watchedFiles será un array de paths absolutos de los archivos coincidentes
// generar un array de metadatos de post que puede ser usado para mostrar
// una lista en el layout del tema
return watchedFiles.map((file) => {
Expand All @@ -81,7 +81,7 @@ export default {

## `createContentLoader`

Al construir un sitio enfocado en contenido, frecuentemente necesitamos crear una página de "archivo" o "índice": una página donde listamos todas las entradas disponibles en nuestra colección de contenido, por ejemplo, articulos de blog o páginas de API. Nosotros **podemos** implementar esto directamente con el API de cargador de datos, pero como este es un caso de uso tan común, VitePress también proporciona un auxiliar `createContentLoader` para simplificar esto:
Al construir un sitio enfocado en contenido, frecuentemente necesitamos crear una página de "archivo" o "índice": una página donde listamos todas las entradas disponibles en nuestra colección de contenido, por ejemplo, artículos de blog o páginas de API. Nosotros **podemos** implementar esto directamente con el API de cargador de datos, pero como este es un caso de uso tan común, VitePress también proporciona un auxiliar `createContentLoader` para simplificar esto:

```js
// posts.data.js
Expand All @@ -90,7 +90,7 @@ import { createContentLoader } from 'vitepress'
export default createContentLoader('posts/*.md', /* opciones */)
```

El auxiliar acepta un patrón glob relativo al [diretório fuente](./routing#source-directory) y retorna un objeto de cargador de datos `{ watch, load }` que puede ser usado como exportación por defecto en un archivo de cargador de datos. El también implementa cache con base en los sellos se datos del archivo para mejorar el desempeño en el desarrollo.
El auxiliar acepta un patrón glob relativo al [directorio fuente](./routing#source-directory) y retorna un objeto de cargador de datos `{ watch, load }` que puede ser usado como exportación por defecto en un archivo de cargador de datos. El también implementa cache con base en los sellos se datos del archivo para mejorar el desempeño en el desarrollo.

Note que el cargador solo funciona con archivos Markdown - archivos no Markdown encontrados serán ignorados.

Expand All @@ -112,7 +112,7 @@ interface ContentData {
}
```

Por defecto, apenas `url` y `frontmatter` son proporcionados. Esto ocurre porque los datos cargados serán incorporados como JSON en el paquete del cliente, entonces necesitamos ser cautelosos con su tamaño. Aqui está un ejemplo de cómo usar los datos para construir una página de índice de blog mínima:
Por defecto, apenas `url` y `frontmatter` son proporcionados. Esto ocurre porque los datos cargados serán incorporados como JSON en el paquete del cliente, entonces necesitamos ser cautelosos con su tamaño. Aquí está un ejemplo de cómo usar los datos para construir una página de índice de blog mínima:

```vue
<script setup>
Expand Down Expand Up @@ -190,7 +190,7 @@ interface ContentOptions<T = ContentData[]> {
/**
* Si `boolean`, debe procesarse e incluir el resumen? (presentado como HTML)
*
* Si `function`, controla como el extracto es extraido del contenido.
* Si `function`, controla como el extracto es extraído del contenido.
*
* Si `string`, define un separador personalizado usado para extraer el
* extracto. El separados por defecto es `---` si `excerpt` fuera `true`.
Expand Down
Loading