Skip to content
Merged
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
78 changes: 41 additions & 37 deletions es/optimize/seo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ keywords: ["meta tags", "sitemap", "robots.txt", "SEO", "search engine optimizat

Mintlify gestiona automáticamente muchas prácticas recomendadas de SEO, entre ellas:

- Generación de metaetiquetas
- Generación de `sitemap` y del archivo `robots.txt`
- Estructura HTML semántica
- Optimización móvil
* Generación de metaetiquetas
* Generación de `sitemap` y del archivo `robots.txt`
* Estructura HTML semántica
* Optimización móvil

Puedes personalizar por completo las metaetiquetas de tu sitio añadiendo el campo `metatags` a tu `docs.json` o al frontmatter de una página.

Expand All @@ -21,44 +21,44 @@ Mintlify genera las siguientes meta tags para cada página. Puedes sobrescribir

**Metadatos básicos:**

- `charset: utf-8` - Codificación de caracteres
- `og:type: website` - Tipo de Open Graph
- `og:site_name` - Nombre de tu sitio de documentación
- `twitter:card: summary_large_image` - Tipo de tarjeta de Twitter
* `charset: utf-8` - Codificación de caracteres
* `og:type: website` - Tipo de Open Graph
* `og:site_name` - Nombre de tu sitio de documentación
* `twitter:card: summary_large_image` - Tipo de tarjeta de Twitter

**Metadatos específicos de la página:**

- `title` - Título de la página, con el formato "Título de la página - Nombre del sitio"
- `og:title` - Título de Open Graph, igual que el título de la página
- `twitter:title` - Título de Twitter, igual que el título de la página
- `description` - Descripción de la página
- `og:description` - Descripción de Open Graph, igual que la descripción de la página
- `twitter:description` - Descripción de Twitter, igual que la descripción de la página
* `title` - Título de la página, con el formato "Título de la página - Nombre del sitio"
* `og:title` - Título de Open Graph, igual que el título de la página
* `twitter:title` - Título de Twitter, igual que el título de la página
* `description` - Descripción de la página
* `og:description` - Descripción de Open Graph, igual que la descripción de la página
* `twitter:description` - Descripción de Twitter, igual que la descripción de la página

**URL y canonical:**

- `canonical` - Se genera automáticamente a partir de la URL de la página
- `og:url` - Se establece en la URL canónica
* `canonical` - Se genera automáticamente a partir de la URL de la página
* `og:url` - Se establece en la URL canónica

**SEO e indexación:**

- `robots` - Generado a partir de los metadatos de la página
- `noindex` - Generado a partir de los metadatos de la página
- `keywords` - Generado a partir de los metadatos de la página
* `robots` - Generado a partir de los metadatos de la página
* `noindex` - Generado a partir de los metadatos de la página
* `keywords` - Generado a partir de los metadatos de la página

**Imágenes:**

- `og:image` - Imagen de Open Graph, `og:image:width` establecido en 1200 y `og:image:height` en 630
- `twitter:image` - Imagen de Twitter, `twitter:image:width` establecido en 1200 y `twitter:image:height` en 630
* `og:image` - Imagen de Open Graph, `og:image:width` establecido en 1200 y `og:image:height` en 630
* `twitter:image` - Imagen de Twitter, `twitter:image:width` establecido en 1200 y `twitter:image:height` en 630

**Metadatos del navegador y la aplicación:**

- `applicationName` - Nombre de tu sitio de documentación
- `generator: Mintlify` - Identifica a Mintlify como el generador del sitio
- `apple-mobile-web-app-title` - Nombre de la aplicación en la pantalla de inicio de iOS
- `msapplication-TileColor` - Color del mosaico de Windows
- Favicons e iconos de tu configuración
- Enlace de referencia al mapa del sitio (sitemap)
* `applicationName` - Nombre de tu sitio de documentación
* `generator: Mintlify` - Identifica a Mintlify como el generador del sitio
* `apple-mobile-web-app-title` - Nombre de la aplicación en la pantalla de inicio de iOS
* `msapplication-TileColor` - Color del mosaico de Windows
* Favicons e iconos de tu configuración
* Enlace de referencia al mapa del sitio (sitemap)

Cualquier meta tag en tu configuración `docs.json` `seo.metatags` también se inyecta automáticamente en cada página, como `google-site-verification` para la validación en Google Search Console.

Expand Down Expand Up @@ -96,7 +96,7 @@ Si utilizas un dominio personalizado, establece la metaetiqueta `canonical` para

Para configurar metaetiquetas específicas de página, agrégalas al frontmatter de la página.

Las siguientes metaetiquetas se admiten a nivel de página:
Las metaetiquetas específicas de página incluyen:

* `title` - Título de la página
* `description` - La descripción de la página aparece debajo del título en la página y en algunos resultados de motores de búsqueda
Expand All @@ -111,7 +111,7 @@ Las siguientes metaetiquetas se admiten a nivel de página:
* `twitter:title` - Título de la tarjeta de Twitter
* `twitter:description` - Descripción de la tarjeta de Twitter
* `twitter:image` - Imagen de la tarjeta de Twitter
* `twitter:card` - Tipo de tarjeta de Twitter como "summary" o "summary_large_image"
* `twitter:card` - Tipo de tarjeta de Twitter como `summary` o `summary_large_image`
* `twitter:site` - Cuenta del sitio en Twitter
* `twitter:image:width` - Ancho de la imagen de Twitter
* `twitter:image:height` - Altura de la imagen de Twitter
Expand All @@ -129,9 +129,10 @@ keywords: ["keyword1", "keyword2"]
```

<Note>
Las metaetiquetas con dos puntos deben ir entre comillas. El campo `keywords` debe estar en formato de lista YAML.
</Note>
Las metaetiquetas con dos puntos deben ir entre comillas. Por ejemplo, `og:title: "Social media title"`.

El campo `keywords` debe estar en formato de lista YAML. Por ejemplo, `keywords: ["keyword1", "keyword2", "keyword3"]`.
</Note>

<div id="common-meta-tags-reference">
## Referencia de etiquetas meta comunes
Expand All @@ -143,7 +144,7 @@ A continuación encontrarás una lista completa de etiquetas meta que puedes añ
La etiqueta `og:image` añade una imagen de fondo que Mintlify superpone automáticamente con tu logotipo, el título de la página y la descripción al generar las vistas previas para redes sociales.
</Note>

Puedes previsualizar cómo se mostrarán tus etiquetas meta en diferentes plataformas usando [metatags.io](https://metatags.io/).
Puedes previsualizar cómo se muestran tus etiquetas meta en diferentes plataformas usando [metatags.io](https://metatags.io/).

```json expandable
"seo": {
Expand Down Expand Up @@ -253,25 +254,28 @@ Por defecto, solo se incluyen las páginas presentes en tu `docs.json`. Para inc
}
```


<div id="custom-sitemaps-and-robotstxt-files">
### Sitemaps y archivos robots.txt personalizados
</div>

Para añadir un archivo `sitemap.xml` o `robots.txt` personalizado, crea un archivo `sitemap.xml` o `robots.txt` en la raíz de tu proyecto. Añadir un archivo personalizado sustituirá al archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado.
Para añadir un archivo `sitemap.xml` o `robots.txt` personalizado, crea un archivo `sitemap.xml` o `robots.txt` en la raíz de tu proyecto. Añadir un archivo personalizado sustituye al archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, el archivo predeterminado se aplicará de nuevo automáticamente.

<div id="disabling-indexing">
<div id="disable-indexing">
## Desactivar la indexación
</div>

Si quieres evitar que los motores de búsqueda indexen una página, puedes incluir lo siguiente en el [frontmatter](/es/organize/pages) de tu página:
Para evitar que los motores de búsqueda indexen una página, agrega `noindex: true` al [frontmatter](/es/organize/pages) de la página.

```
```yaml
---
noindex: true
---
```

<Tip>
Las páginas con `hidden: true` en su frontmatter se consideran automáticamente como `noindex`. Consulta [Páginas ocultas](/es/organize/hidden-pages) para más detalles.
</Tip>

También puedes especificar `noindex` para todas las páginas de tu documentación estableciendo el campo `metatags.robots` en `"noindex"` en tu `docs.json`:

```json
Expand Down
57 changes: 38 additions & 19 deletions es/organize/hidden-pages.mdx
Original file line number Diff line number Diff line change
@@ -1,36 +1,55 @@
---
title: "Páginas ocultas"
description: "Oculta páginas de tu navigation mientras las mantienes accesibles."
keywords: ["hide from navigation", "unlisted", "page visibility"]
description: "Oculta páginas de tu navegación mientras las mantienes accesibles."
keywords: ["ocultar de la navegación", "no listada", "visibilidad de la página"]
---

Las páginas ocultas no se incluyen en la navigation de tu sitio, pero siguen siendo accesibles públicamente para cualquiera que conozca su URL.
Las páginas ocultas no aparecen en la navegación de tu sitio, pero cualquiera que conozca la URL aún puede acceder a ellas. Por ejemplo, si creas una página oculta como `guides/hidden-page.mdx`, los visitantes pueden acceder a ella en `docs.yoursite.com/guides/hidden-page`.

Usa páginas ocultas para contenido que quieres que sea accesible en tu sitio o referenciado como contexto para herramientas de IA, pero que no sea detectable a través de la navigation.
Usa páginas ocultas para contenido al que quieras que los usuarios accedan o al que hagan referencia como contexto para herramientas de IA, pero que no quieras que aparezca listado en la navegación.

Para el contenido que requiere un control de acceso estricto, debes configurar la [Autenticación](/es/deploy/authentication-setup).
Si tu contenido requiere un control de acceso estricto, debes configurar la [autenticación](/es/deploy/authentication-setup).

Para restringir páginas a grupos específicos de usuarios, configura el [control de acceso basado en grupos](/es/deploy/authentication-setup#control-access-with-groups).
Para restringir páginas a grupos de usuarios específicos, configura el [control de acceso basado en grupos](/es/deploy/authentication-setup#control-access-with-groups).

<div id="hiding-a-page">
Consulta un [ejemplo de página oculta](/es/organize/hidden-page-example).

<Note>
Algunos elementos de navegación, como las barras laterales, los menús desplegables y las pestañas, pueden aparecer vacíos o cambiar de diseño en las páginas ocultas.
</Note>

<div id="hide-a-page">
## Ocultar una página
</div>

Para ocultar una página, elimínala de tu estructura de navegación. Cualquier página que no esté incluida en la navigation de tu `docs.json` estará oculta.
Para ocultar una página, configura `hidden: true` en el [frontmatter](/es/organize/pages) de la página o elimínala de la navigation de tu archivo `docs.json`.

Las páginas ocultas usan la misma estructura de URL que las páginas normales según su ruta de archivo. Por ejemplo, `guides/hidden-page.mdx` sería accesible en `docs.yoursite.com/guides/hidden-page`.
<div id="set-hidden-true-in-frontmatter">
### Establecer `hidden: true` en el frontmatter
</div>

Consulta un [ejemplo de página oculta](/es/organize/hidden-page-example).
Agrega `hidden: true` al frontmatter de una página para eliminarla de la navegación visible y seguir incluyéndola en tu configuración de `docs.json`.

<Note>
Algunos elementos de navegación, como las barras laterales, los menús desplegables y las pestañas, pueden aparecer vacíos o alterar el diseño en las páginas ocultas.
</Note>
```yaml
---
title: "My hidden page"
hidden: true
---
```

Los motores de búsqueda no pueden indexar las páginas con `hidden: true`. Consulta [Desactivar la indexación](/es/optimize/seo#disabling-indexing) para obtener más información.

<div id="remove-the-page-from-navigation">
### Quitar la página de la navegación
</div>

Si no incluyes una página en la propiedad `navigation` de tu `docs.json`, esa página quedará oculta. Este método funciona bien para páginas que no quieres que aparezcan en la navegación en absoluto.

<div id="hiding-a-group-of-pages">
<div id="hide-a-group-of-pages">
## Ocultar un grupo de páginas
</div>

Un grupo de páginas se oculta si la propiedad `hidden` se establece en `true` en tu archivo `docs.json`:
Para ocultar un grupo de páginas, establece la propiedad `hidden` en `true` para el grupo en tu archivo `docs.json`:

```json highlight={4}
"groups": [
Expand All @@ -43,7 +62,7 @@ Un grupo de páginas se oculta si la propiedad `hidden` se establece en `true` e
]
},
{
"group": "Guías",
"group": "Guides",
"pages": [
"guides/hidden-page.mdx",
"guides/hidden-groups.mdx"
Expand All @@ -52,13 +71,13 @@ Un grupo de páginas se oculta si la propiedad `hidden` se establece en `true` e
]
```

En este ejemplo, el grupo `Getting started` está oculto, mientras que el grupo `Guides` está visible.
En este ejemplo, el grupo `Getting started` está oculto y el grupo `Guides` está visible.

<div id="hiding-a-tab">
<div id="hide-a-tab">
### Ocultar una Tab
</div>

También puedes ocultar una Tab añadiendo la propiedad `hidden` a tu archivo `docs.json`:
Para ocultar una Tab, añade la propiedad `hidden` para la Tab en tu archivo `docs.json`:

```json highlight={4}
"tabs": [
Expand Down
Loading