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
36 changes: 18 additions & 18 deletions es/organize/settings.mdx
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: "Configuración global"
description: "Configura la configuración del sitio con el archivo `docs.json`"
keywords: ["docs.json", "configuración", "personalización", "ajustes"]
description: "Configura la configuración del sitio completo con el archivo `docs.json`"
keywords: ["docs.json", "configuración", "personalización", "ajustes", "logo"]
---

import IconsOptional from "/snippets/es/icons-optional.mdx";

El archivo `docs.json` te permite convertir una colección de archivos Markdown en un sitio de documentación navegable y personalizado. Este archivo de configuración obligatorio controla el estilo, la navigation, las integrations y más. Piénsalo como el plano de tu documentación.
El archivo `docs.json` te permite convertir una colección de archivos Markdown en un sitio de documentación navegable y personalizado. Este archivo de configuración obligatorio controla el estilo, navigation, integrations y más. Piénsalo como el plano de tu documentación.

La configuración en `docs.json` se aplica globalmente a todas las páginas.
Los ajustes en `docs.json` se aplican globalmente a todas las páginas.

<div id="setting-up-your-docsjson">
## Configurar tu `docs.json`
Expand Down Expand Up @@ -46,7 +46,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
<ResponseField name="theme" required>
El tema de diseño de tu sitio.

Una de las siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`.
Una de las siguientes opciones: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`.

Consulta [Temas](es/themes) para obtener más información.
</ResponseField>
Expand All @@ -56,54 +56,54 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="colors" type="object" required>
Los colores que usa tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color principal, se usará para todos los elementos de color.
Los colores utilizados en tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color primario, se usará para todos los elementos relacionados con el color.

<Expandable title="Colors">
<ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
El color principal de tu documentación. Generalmente se usa para resaltar en modo claro, con algunas variaciones según el tema.
El color primario de tu documentación. Generalmente se usa para resaltar en el modo claro, con alguna variación según el tema.

Debe ser un código hexadecimal que comience con `#`.
</ResponseField>

<ResponseField name="light" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
El color utilizado para resaltar en modo oscuro.
El color utilizado para resaltar en el modo oscuro.

Debe ser un código hexadecimal que comience con `#`.
</ResponseField>

<ResponseField name="dark" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
El color utilizado para botones y estados hover en modo claro y oscuro, con algunas variaciones según el tema.
El color utilizado para botones y estados hover en los modos claro y oscuro, con alguna variación según el tema.

Debe ser un código hexadecimal que comience con `#`.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="description" type="string">
Descripción de tu sitio para SEO e indexación de IA.
Descripción de tu sitio para SEO e indexación por IA.
</ResponseField>

<ResponseField name="logo" type="string or object">
Tu logotipo para los modos claro y oscuro.
Configura tu logotipo para los modos claro y oscuro.

<Expandable title="Logo">
<ResponseField name="light" type="string" required>
Ruta al archivo de tu logotipo para el modo claro. Incluye la extensión del archivo. Ejemplo: `/logo.png`
Ruta a tu archivo de logotipo para el modo claro. Incluye la extensión del archivo. Ejemplo: `/logo.png`
</ResponseField>

<ResponseField name="dark" type="string" required>
Ruta al archivo de tu logotipo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/logo-dark.png`
Ruta a tu archivo de logotipo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/logo-dark.png`
</ResponseField>

<ResponseField name="href" type="string (uri)">
La URL a la que se redirige al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a tu página de inicio. Ejemplo: `https://mintlify.com`
La URL a la que redirigir al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a tu página de inicio. Ejemplo: `https://mintlify.com`
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="favicon" type="string or object">
Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon adecuados.
Puede ser un único archivo o archivos separados para los modos claro y oscuro. Ejemplo: `/favicon.png`
Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon apropiados.
Puede ser un archivo único o archivos separados para los modos claro y oscuro. Ejemplo: `/favicon.png`

<Expandable title="Favicon">
<ResponseField name="light" type="string" required>
Expand All @@ -117,11 +117,11 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="thumbnails" type="object">
Personalización de miniaturas para redes sociales y vistas previas de páginas.
Personalización de miniaturas para redes sociales y vistas previas de página.

<Expandable title="Thumbnails">
<ResponseField name="appearance" type="&#x22;light&#x22; | &#x22;dark&#x22;">
El tema visual de tus miniaturas. Si no se especifica, las miniaturas usan el esquema de color de tu sitio definido en el campo `colors`.
El tema visual de tus miniaturas. Si no se especifica, las miniaturas usan el esquema de colores de tu sitio definido por el campo `colors`.
</ResponseField>

<ResponseField name="background" type="string">
Expand Down
22 changes: 11 additions & 11 deletions fr/organize/settings.mdx
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: "Paramètres globaux"
description: "Configurez les paramètres à l’échelle du site avec le fichier `docs.json`"
keywords: ["docs.json", "paramètres", "personnalisation", "configuration"]
keywords: ["docs.json", "paramètres", "personnalisation", "configuration", "logo"]
---

import IconsOptional from "/snippets/fr/icons-optional.mdx";

Le fichier `docs.json` vous permet de transformer une collection de fichiers Markdown en un site de documentation personnalisable et facile à parcourir. Ce fichier de configuration requis contrôle le style, la navigation, les integrations, et bien plus encore. Considérez‑le comme le plan de votre documentation.
Le fichier `docs.json` vous permet de transformer une collection de fichiers Markdown en un site de documentation personnalisable et facile à parcourir. Ce fichier de configuration obligatoire contrôle le style, la navigation, les intégrations, et bien plus encore. Considérez‑le comme le plan de votre documentation.

Les paramètres de `docs.json` s’appliquent globalement à toutes les pages.
Les paramètres définis dans `docs.json` s’appliquent globalement à toutes les pages.

<div id="setting-up-your-docsjson">
## Configuration de votre `docs.json`
Expand Down Expand Up @@ -56,11 +56,11 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="colors" type="object" required>
Les couleurs utilisées dans votre documentation. Leur application varie selon les thèmes. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés.
Les couleurs utilisées dans votre documentation. Elles s’appliquent différemment selon les thèmes. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés.

<Expandable title="Colors">
<Expandable title="Couleurs">
<ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
La couleur principale de votre documentation. Généralement utilisée pour la mise en évidence en mode clair, avec quelques variations selon le thème.
La couleur principale de votre documentation. Généralement utilisée pour mettre en évidence en mode clair, avec quelques variations selon le thème.

Doit être un code hexadécimal commençant par `#`.
</ResponseField>
Expand All @@ -84,7 +84,7 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="logo" type="string or object">
Votre logo pour les modes clair et sombre.
Définissez votre logo pour les modes clair et sombre.

<Expandable title="Logo">
<ResponseField name="light" type="string" required>
Expand All @@ -96,13 +96,13 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="href" type="string (uri)">
L’URL vers laquelle rediriger lors d’un clic sur le logo. Si non fourni, le logo renverra vers votre page d’accueil. Exemple : `https://mintlify.com`
L’URL vers laquelle rediriger lors du clic sur le logo. Si elle n’est pas fournie, le logo renverra vers votre page d’accueil. Exemple : `https://mintlify.com`
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="favicon" type="string or object">
Chemin vers votre fichier favicon, y compris l’extension. Redimensionné automatiquement aux tailles appropriées.
Chemin vers votre fichier favicon, y compris l’extension. Redimensionné automatiquement aux tailles de favicon appropriées.
Peut être un fichier unique ou des fichiers distincts pour les modes clair et sombre. Exemple : `/favicon.png`

<Expandable title="Favicon">
Expand All @@ -119,9 +119,9 @@ Cette section présente la référence complète du fichier `docs.json`.
<ResponseField name="thumbnails" type="object">
Personnalisation des vignettes pour les réseaux sociaux et les aperçus de page.

<Expandable title="Thumbnails">
<Expandable title="Vignettes">
<ResponseField name="appearance" type="&#x22;light&#x22; | &#x22;dark&#x22;">
Le thème visuel de vos vignettes. S’il n’est pas spécifié, les vignettes utilisent la palette de couleurs de votre site définie par le champ `colors`.
Le thème visuel de vos vignettes. S’il n’est pas précisé, elles utilisent le jeu de couleurs de votre site défini par le champ `colors`.
</ResponseField>

<ResponseField name="background" type="string">
Expand Down
46 changes: 23 additions & 23 deletions zh/organize/settings.mdx
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: "全局设置"
description: "使用 `docs.json` 文件配置站点级设置"
keywords: ["docs.json", "设置", "自定义", "配置"]
description: "使用 `docs.json` 文件配置全站设置"
keywords: ["docs.json", "设置", "自定义", "配置", "logo"]
---

import IconsOptional from "/snippets/zh/icons-optional.mdx";

`docs.json` 文件可将一组 Markdown 文件构建为可浏览、可定制的文档站点。这个必需的配置文件用于控制样式、导航、integrations 等。你可以把它视为文档的蓝图
`docs.json` 文件可将一组 Markdown 文件构建为可导航、可定制的文档站点。这个必需的配置文件控制样式、导航、integrations 等等。可以把它看作你的文档蓝图

`docs.json` 中的设置会全局生效,适用于所有页面。

Expand Down Expand Up @@ -44,66 +44,66 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx";
</div>

<ResponseField name="theme" required>
你的网站布局主题
站点的布局主题

可选值之一:`mint`、`maple`、`palm`、`willow`、`linden`、`almond`、`aspen`。
可选项:`mint`、`maple`、`palm`、`willow`、`linden`、`almond`、`aspen`。

参见[主题](zh/themes)了解更多信息。
参见 [主题](zh/themes) 了解更多信息。
</ResponseField>

<ResponseField name="name" type="string" required>
你的项目、组织或产品名称
项目、组织或产品的名称
</ResponseField>

<ResponseField name="colors" type="object" required>
文档中使用的配色。不同主题的颜色应用方式有所不同。如果只提供主色,将用于所有颜色元素
文档中使用的配色。不同主题对颜色的应用方式不同。若仅提供主色,将用于所有相关颜色元素

<Expandable title="Colors">
<ResponseField name="primary" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" required>
文档的主色。通常在浅色模式下用于强调,具体效果因主题而异
文档的主色。通常在浅色模式下用于强调,具体随主题略有差异

必须是以 `#` 开头的十六进制色值。
必须为以 `#` 开头的十六进制色值。
</ResponseField>

<ResponseField name="light" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
在深色模式下用于强调的颜色
深色模式下用于强调的颜色

必须是以 `#` 开头的十六进制色值。
必须为以 `#` 开头的十六进制色值。
</ResponseField>

<ResponseField name="dark" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
在浅色和深色模式下用于按钮和悬停状态的颜色,具体效果因主题而异
在浅色与深色模式中用于按钮与悬停状态的颜色,具体随主题略有差异

必须是以 `#` 开头的十六进制色值。
必须为以 `#` 开头的十六进制色值。
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="description" type="string">
你的网站用于 SEO(搜索引擎优化)和 AI 索引编入的描述
用于 SEO(搜索引擎优化)和 AI 索引编入的站点说明
</ResponseField>

<ResponseField name="logo" type="string or object">
适用于浅色和深色模式的 Logo
为浅色与深色模式设置 logo

<Expandable title="Logo">
<ResponseField name="light" type="string" required>
指向浅色模式 Logo 文件的路径。需包含文件扩展名。示例:`/logo.png`
指向浅色模式 logo 文件的路径。需包含文件扩展名。示例:`/logo.png`
</ResponseField>

<ResponseField name="dark" type="string" required>
指向深色模式 Logo 文件的路径。需包含文件扩展名。示例:`/logo-dark.png`
指向深色模式 logo 文件的路径。需包含文件扩展名。示例:`/logo-dark.png`
</ResponseField>

<ResponseField name="href" type="string (uri)">
点击 Logo 时跳转的 URL。若未提供,Logo 将链接到你的主页。示例:`https://mintlify.com`
点击 logo 时跳转的 URL。若未提供,logo 将链接到主页。示例:`https://mintlify.com`
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="favicon" type="string or object">
指向 favicon 文件的路径,需包含文件扩展名。将自动调整为适配的 favicon 尺寸。
可以是单个文件,或分别提供浅色和深色模式的文件。示例:`/favicon.png`
指向 favicon 文件的路径,需包含文件扩展名。将自动调整为合适的 favicon 尺寸。
可为单个文件,或分别为浅色与深色模式提供文件。示例:`/favicon.png`

<Expandable title="Favicon">
<ResponseField name="light" type="string" required>
Expand All @@ -117,11 +117,11 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx";
</ResponseField>

<ResponseField name="thumbnails" type="object">
社交媒体与页面预览的缩略图定制
用于社交媒体与页面预览的缩略图设置

<Expandable title="Thumbnails">
<ResponseField name="appearance" type="&#x22;light&#x22; | &#x22;dark&#x22;">
缩略图的视觉主题。若未指定,缩略图将使用由 `colors` 字段定义的网站配色方案
缩略图的视觉主题。若未指定,则沿用由 `colors` 字段定义的站点配色方案
</ResponseField>

<ResponseField name="background" type="string">
Expand Down