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
28 changes: 25 additions & 3 deletions es/organize/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -382,6 +382,16 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</Expandable>
</ResponseField>

<ResponseField name="variables" type="object">
Variables globales para usar en toda tu documentación. Las variables se reemplazan en tiempo de compilación usando la sintaxis `{{variableName}}`.

<Expandable title="Variables">
<ResponseField name="variableName" type="string">
Un par clave-valor donde la clave es el nombre de la variable y el valor es el texto de reemplazo. Todas las variables referenciadas en tu contenido deben estar definidas o la compilación fallará. Los nombres de variables pueden contener caracteres alfanuméricos, guiones y puntos. Los valores se sanitizan para evitar ataques XSS.
</ResponseField>
</Expandable>
</ResponseField>

<div id="structure">
### Structure
</div>
Expand Down Expand Up @@ -1265,7 +1275,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"$schema": "https://mintlify.com/docs.json",
"theme": "maple",
"name": "Example Co.",
"description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
"description": "Example Co. is a company that provides example content and placeholder text.",
"colors": {
"primary": "#3B82F6",
"light": "#F8FAFC",
Expand Down Expand Up @@ -1395,6 +1405,10 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": [
"copy",
Expand All @@ -1420,7 +1434,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"$schema": "https://mintlify.com/docs.json",
"theme": "maple",
"name": "Example Co.",
"description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
"description": "Example Co. is a company that provides example content and placeholder text.",
"colors": {
"primary": "#3B82F6",
"light": "#F8FAFC",
Expand Down Expand Up @@ -1572,6 +1586,10 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": [
"copy",
Expand All @@ -1597,7 +1615,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"$schema": "https://mintlify.com/docs.json",
"theme": "maple",
"name": "Example Co.",
"description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.",
"description": "Example Co. is a company that provides example content and placeholder text.",
"colors": {
"primary": "#3B82F6",
"light": "#F8FAFC",
Expand Down Expand Up @@ -1761,6 +1779,10 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": ["copy", "view", "chatgpt", "claude"]
},
Expand Down
56 changes: 56 additions & 0 deletions es/what-is-mintlify.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: "¿Qué es Mintlify?"
description: "Mintlify es una plataforma de conocimiento para alojar información diseñada para personas y para IA."
keywords: ["visión general", "cómo funciona", "arquitectura"]
---

Mintlify aloja tu contenido como un sitio web. Tu contenido se almacena en un repositorio Git como archivos MDX, y Mintlify construye y despliega tu sitio automáticamente cuando haces push de un cambio.

<div id="the-three-parts-of-a-mintlify-project">
## Las tres partes de un proyecto de Mintlify
</div>

**Tu repositorio** es la fuente de la verdad para tu documentación. Contiene un archivo MDX para cada página y un archivo `docs.json` que configura la navegación, el tema y los ajustes de tu sitio. Puedes usar tu propio repositorio de GitHub o GitLab, o dejar que Mintlify cree uno para ti durante la configuración inicial.

**El Dashboard de Mintlify** se conecta a tu repositorio y te permite gestionar tu sitio. Úsalo para supervisar las implementaciones, configurar los ajustes, gestionar a tu equipo y editar contenido directamente en el navegador.

**Tu sitio**, impulsado por Mintlify. Mintlify construye tu sitio a partir de tu repositorio y lo implementa en una URL `.mintlify.app` de forma predeterminada. Cuando estés listo, puedes asignar un dominio personalizado a tu sitio.

```mermaid
flowchart LR
WE["Editor web"] --> Repo[("Repositorio Git")]
Local["Editor local"] --> Repo
Repo -- "Webhook" --> Build["Mintlify build"]
Build --> Site["Sitio activo"]
```

<div id="editing-content">
## Edición de contenido
</div>

Hay dos maneras de editar tu contenido, y puedes alternar entre ellas libremente.

* **Editor web**: Edita y publica páginas en tu navegador. El editor confirma automáticamente los cambios en tu repositorio de Git.
* **CLI y editor local**: Clona tu repositorio, ejecuta `mint dev` para previsualizar tu sitio de forma local y luego haz push de los cambios para desplegarlo.

Varios miembros del equipo pueden trabajar en cualquiera de los dos flujos al mismo tiempo, usando branches de Git para gestionar cambios en paralelo. Cualquiera que pueda hacer push a tu repositorio puede actualizar tu contenido.

<div id="ai-features">
## Funciones de IA
</div>

Las funciones de IA integradas ayudan a las personas y a la IA a encontrar y comprender tu contenido, y te ayudan a mantenerlo.

El **assistant** permite que tus usuarios hagan preguntas y obtengan respuestas citadas directamente de tu contenido.

El **agent** ayuda a tu equipo a crear y mantener contenido generando actualizaciones a partir de flujos de trabajo programados, solicitudes de extracción que se fusionan en tu repositorio de funcionalidades o hilos de Slack.

Consulta [documentación nativa con IA](/es/ai-native) para ver una descripción general de todas las funciones de IA.

<div id="next-steps">
## Próximos pasos
</div>

<Card title="Guía rápida" icon="rocket" horizontal href="/es/quickstart">
Publica tu primer sitio de documentación en cuestión de minutos.
</Card>
56 changes: 39 additions & 17 deletions fr/organize/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -382,6 +382,16 @@ Cette section présente la référence complète du fichier `docs.json`.
</Expandable>
</ResponseField>

<ResponseField name="variables" type="object">
Variables globales à utiliser dans toute votre documentation. Les variables sont remplacées lors du build à l’aide de la syntaxe `{{variableName}}`.

<Expandable title="Variables">
<ResponseField name="variableName" type="string">
Une paire clé-valeur où la clé est le nom de la variable et la valeur est le texte de remplacement. Toutes les variables référencées dans votre contenu doivent être définies, sinon le build échouera. Les noms de variables peuvent contenir des caractères alphanumériques, des tirets et des points. Les valeurs sont nettoyées afin de prévenir les attaques XSS.
</ResponseField>
</Expandable>
</ResponseField>

<div id="structure">
### Structure
</div>
Expand Down Expand Up @@ -1276,25 +1286,25 @@ Cette section présente la référence complète du fichier `docs.json`.
{
"dropdown": "Documentation",
"icon": "book",
"description": "How to use the Example Co. product",
"description": "Comment utiliser le produit Example Co.",
"groups": [
{
"group": "Getting started",
"group": "Démarrage",
"pages": [
"index",
"quickstart"
]
},
{
"group": "Customization",
"group": "Personnalisation",
"pages": [
"settings",
"users",
"features"
]
},
{
"group": "Billing",
"group": "Facturation",
"pages": [
"billing/overview",
"billing/payments",
Expand All @@ -1306,7 +1316,7 @@ Cette section présente la référence complète du fichier `docs.json`.
{
"dropdown": "Changelog",
"icon": "history",
"description": "Updates and changes",
"description": "Mises à jour et modifications",
"pages": [
"changelog"
]
Expand All @@ -1329,13 +1339,13 @@ Cette section présente la référence complète du fichier `docs.json`.
"href": "https://discord.gg/example"
},
{
"label": "Community",
"label": "Communauté",
"href": "https://example.com/community"
}
],
"primary": {
"type": "button",
"label": "Get Started",
"label": "Commencer",
"href": "https://example.com/start"
}
},
Expand All @@ -1348,35 +1358,35 @@ Cette section présente la référence complète du fichier `docs.json`.
},
"links": [
{
"header": "Resources",
"header": "Ressources",
"items": [
{
"label": "Customers",
"label": "Clients",
"href": "https://example.com/customers"
},
{
"label": "Enterprise",
"label": "Entreprise",
"href": "https://example.com/enterprise"
},
{
"label": "Request Preview",
"label": "Demander un aperçu",
"href": "https://example.com/preview"
}
]
},
{
"header": "Company",
"header": "Société",
"items": [
{
"label": "Careers",
"label": "Carrières",
"href": "https://example.com/careers"
},
{
"label": "Blog",
"href": "https://example.com/blog"
},
{
"label": "Privacy Policy",
"label": "Politique de confidentialité",
"href": "https://example.com/legal/privacy"
}
]
Expand All @@ -1395,6 +1405,10 @@ Cette section présente la référence complète du fichier `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": [
"copy",
Expand All @@ -1406,8 +1420,8 @@ Cette section présente la référence complète du fichier `docs.json`.
"errors": {
"404": {
"redirect": false,
"title": "I can't be found",
"description": "What ever **happened** to this _page_?"
"title": "Introuvable",
"description": "Que s'est-il **passé** avec cette _page_ ?"
}
}
}
Expand All @@ -1420,7 +1434,7 @@ Cette section présente la référence complète du fichier `docs.json`.
"$schema": "https://mintlify.com/docs.json",
"theme": "maple",
"name": "Example Co.",
"description": "Example Co. est une entreprise qui fournit du contenu d'exemple et du texte de substitution.",
"description": "Example Co. is a company that provides example content and placeholder text.",
"colors": {
"primary": "#3B82F6",
"light": "#F8FAFC",
Expand Down Expand Up @@ -1572,6 +1586,10 @@ Cette section présente la référence complète du fichier `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": [
"copy",
Expand Down Expand Up @@ -1761,6 +1779,10 @@ Cette section présente la référence complète du fichier `docs.json`.
"value": "example_cookie_value"
}
},
"variables": {
"version": "2.0.0",
"api-url": "https://api.example.com"
},
"contextual": {
"options": ["copy", "view", "chatgpt", "claude"]
},
Expand Down
56 changes: 56 additions & 0 deletions fr/what-is-mintlify.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: "Qu'est-ce que Mintlify ?"
description: "Mintlify est une plateforme de connaissances pour l’hébergement d’informations destinées aux humains et à l’IA."
keywords: ["vue d'ensemble", "comment ça marche", "architecture"]
---

Mintlify héberge votre contenu sous la forme d’un site web. Votre contenu se trouve dans un référentiel Git sous forme de fichiers MDX, et Mintlify génère et déploie automatiquement votre site lorsque vous effectuez un push.

<div id="the-three-parts-of-a-mintlify-project">
## Les trois parties d’un projet Mintlify
</div>

**Votre référentiel** est la source de vérité pour votre documentation. Il contient un fichier MDX pour chaque page et un fichier `docs.json` qui configure la navigation, le thème et les paramètres de votre site. Vous pouvez utiliser votre propre référentiel GitHub ou GitLab, ou laisser Mintlify en créer un pour vous lors de la configuration initiale.

**Le Tableau de bord Mintlify** se connecte à votre référentiel et vous permet de gérer votre site. Utilisez-le pour surveiller les déploiements, configurer les paramètres, gérer votre équipe et modifier le contenu directement dans le navigateur.

**Votre site**, propulsé par Mintlify. Mintlify génère votre site à partir de votre référentiel et le déploie par défaut sous une URL en `.mintlify.app`. Lorsque vous êtes prêt, vous pouvez associer un domaine personnalisé à votre site.

```mermaid
flowchart LR
WE["Éditeur web"] --> Repo[("Référentiel Git")]
Local["Éditeur local"] --> Repo
Repo -- "Webhook" --> Build["Mintlify build"]
Build --> Site["Site en ligne"]
```

<div id="editing-content">
## Modification du contenu
</div>

Il existe deux façons de modifier votre contenu, et vous pouvez passer librement de l’une à l’autre.

* **Éditeur web** : modifiez et publiez des pages dans votre navigateur. L’éditeur enregistre automatiquement les modifications dans votre référentiel Git via des commits.
* **CLI et éditeur local** : clonez votre référentiel, exécutez `mint dev` pour prévisualiser votre site en local, puis poussez les modifications pour déployer.

Plusieurs membres de l’équipe peuvent utiliser l’un ou l’autre de ces modes de travail en parallèle, en s’appuyant sur des branches Git pour gérer les modifications simultanées. Toute personne pouvant pousser vers votre référentiel peut mettre à jour votre contenu.

<div id="ai-features">
## Fonctionnalités d’IA
</div>

Les fonctionnalités d’IA intégrées aident les personnes et les systèmes d’IA à trouver et à comprendre votre contenu, et vous aident à le maintenir à jour.

L’**Assistant** permet à vos utilisateurs de poser des questions et d’obtenir des réponses sourcées à partir de votre contenu.

L’**agent** aide votre équipe à créer et à maintenir le contenu en générant des mises à jour à partir de workflows planifiés, de pull requests (demandes de fusion) fusionnées dans votre référentiel de fonctionnalités, ou de fils de discussion Slack.

Consultez la section [Documentation native à l’IA](/fr/ai-native) pour une vue d’ensemble de toutes les fonctionnalités d’IA.

<div id="next-steps">
## Prochaines étapes
</div>

<Card title="Démarrage rapide" icon="rocket" horizontal href="/fr/quickstart">
Déployez votre premier site de documentation en quelques minutes.
</Card>
Loading