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
858 changes: 429 additions & 429 deletions .gt/downloaded-versions.json

Large diffs are not rendered by default.

26 changes: 15 additions & 11 deletions es/installation.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
---
title: "Instalación de la CLI"
description: "Instala la CLI para previsualizar y desarrollar tu documentación de forma local"
description: "Usa la CLI para previsualizar y mantener tu documentación de forma local"
---

<img className="block dark:hidden my-0 pointer-events-none" src="/images/installation/local-development-light.png" alt="Gráfico decorativo que representa la CLI." />

<img className="hidden dark:block my-0 pointer-events-none" src="/images/installation/local-development-dark.png" alt="Gráfico decorativo que representa la CLI." />

<div id="installing-the-cli">
## Instalación de la CLI
Usa la CLI para previsualizar tu documentación de forma local mientras escribes y editas. Visualiza los cambios en tiempo real antes de implementar, prueba la apariencia y funcionalidad de tu sitio de documentación y detecta problemas como enlaces rotos o de accesibilidad.

La CLI también incluye utilidades para mantener tu documentación, con comandos para cambiar el nombre de archivos, validar especificaciones OpenAPI y migrar contenido entre formatos.

<div id="install-the-cli">
## Instalar la CLI
</div>

<Info>
**Requisito previo**: Instala [Node.js](https://nodejs.org/en) antes de continuar.
**Requisito previo**: La CLI requiere [Node.js](https://nodejs.org/en) v19 o superior.
</Info>

<Steps>
<Step title="Instala la CLI.">
<Step title="Instalar la CLI">
Ejecuta el siguiente comando para instalar la [CLI](https://www.npmjs.com/package/mint):

<CodeGroup>
Expand All @@ -30,8 +34,8 @@ description: "Instala la CLI para previsualizar y desarrollar tu documentación
</CodeGroup>
</Step>

<Step title="Vista previa local.">
Ve a tu directorio de documentación (donde se encuentra el archivo `docs.json`) y ejecuta el siguiente comando:
<Step title="Vista previa local">
Ve a tu directorio de documentación (donde se encuentra tu archivo `docs.json`) y ejecuta el siguiente comando:

```bash
mint dev
Expand All @@ -41,7 +45,7 @@ description: "Instala la CLI para previsualizar y desarrollar tu documentación
</Step>
</Steps>

Como alternativa, si no quieres instalar la CLI de forma global, puedes ejecutar un script único:
Como alternativa, si no deseas instalar la CLI globalmente, puedes ejecutar un script único:

```bash
npx mint dev
Expand Down Expand Up @@ -85,11 +89,11 @@ Si intentas ejecutar en un puerto que ya está en uso, se usará el siguiente pu
El puerto 3000 ya está en uso. Probando con el 3001.
```

<div id="previewing-as-a-specific-group">
## Vista previa como un grupo específico
<div id="preview-as-a-specific-group">
## Previsualizar como un grupo específico
</div>

Si usas autenticación parcial para restringir el acceso a tu documentación, puedes previsualizar como un grupo de autenticación específico usando la opción `--groups [groupname]`.
Si usas Autenticación parcial para restringir el acceso a tu documentación, puedes previsualizar como un grupo de autenticación específico usando la opción `--groups [groupname]`.

Por ejemplo, si tienes un grupo llamado `admin`, puedes previsualizar como miembro de ese grupo con el comando:

Expand Down
8 changes: 4 additions & 4 deletions es/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,10 @@ El flujo de trabajo basado en código se integra con tu entorno de desarrollo y
### Instalar la CLI
</div>

<Info>
**Requisito previo**: La CLI requiere [Node.js](https://nodejs.org/en) v19 o superior.
</Info>

Para trabajar localmente con tu documentación, instala la interfaz de línea de comandos (CLI), llamada [mint](https://www.npmjs.com/package/mint), ejecutando este comando en tu terminal:

<CodeGroup>
Expand All @@ -103,10 +107,6 @@ Para trabajar localmente con tu documentación, instala la interfaz de línea de
```
</CodeGroup>

<Info>
Necesitas tener Node.js instalado en tu equipo. Si tienes problemas con la instalación, consulta la guía de solución de problemas.
</Info>

<div id="edit-the-documentation">
### Edita la documentación
</div>
Expand Down
24 changes: 14 additions & 10 deletions fr/installation.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
---
title: "Installation de l’interface en ligne de commande (CLI)"
description: "Installez la CLI pour prévisualiser et développer votre documentation en local"
description: "Utilisez la CLI pour prévisualiser et maintenir votre documentation en local"
---

<img className="block dark:hidden my-0 pointer-events-none" src="/images/installation/local-development-light.png" alt="Graphique décoratif représentant la CLI." />

<img className="hidden dark:block my-0 pointer-events-none" src="/images/installation/local-development-dark.png" alt="Graphique décoratif représentant la CLI." />

<div id="installing-the-cli">
## Installation de l’interface en ligne de commande (CLI)
Utilisez la CLI pour prévisualiser votre documentation en local pendant que vous écrivez et modifiez. Affichez les changements en temps réel avant le déploiement, testez l’apparence et les fonctionnalités de votre site de documentation, et détectez des problèmes tels que des liens rompus ou des problèmes d’accessibilité.

La CLI propose également des utilitaires pour maintenir votre documentation, notamment des commandes pour renommer des fichiers, valider des spécifications OpenAPI et migrer du contenu entre différents formats.

<div id="install-the-cli">
## Installer l’interface en ligne de commande (CLI)
</div>

<Info>
**Prérequis** : installez [Node.js](https://nodejs.org/en) avant de continuer.
**Prérequis** : la CLI nécessite [Node.js](https://nodejs.org/en) v19 ou une version ultérieure.
</Info>

<Steps>
<Step title="Installer la CLI.">
<Step title="Installer la CLI">
Exécutez la commande suivante pour installer la [CLI](https://www.npmjs.com/package/mint) :

<CodeGroup>
Expand All @@ -30,8 +34,8 @@ description: "Installez la CLI pour prévisualiser et développer votre document
</CodeGroup>
</Step>

<Step title="Aperçu en local.">
Accédez à votre dossier de documentation (là où se trouve votre fichier `docs.json`) et exécutez la commande suivante :
<Step title="Prévisualiser en local">
Accédez à votre répertoire de documentation (là où se trouve votre fichier `docs.json`) et exécutez la commande suivante :

```bash
mint dev
Expand Down Expand Up @@ -85,13 +89,13 @@ Si vous essayez d’exécuter sur un port déjà utilisé, le prochain port disp
Le port 3000 est déjà utilisé. Tentative sur le port 3001 à la place.
```

<div id="previewing-as-a-specific-group">
<div id="preview-as-a-specific-group">
## Prévisualiser en tant que groupe spécifique
</div>

Si vous utilisez une authentification partielle pour restreindre l’accès à votre documentation, vous pouvez effectuer un aperçu en tant que groupe d’authentification spécifique à l’aide de l’option `--groups [groupname]`.
Si vous utilisez une authentification partielle pour restreindre l’accès à votre documentation, vous pouvez prévisualiser en tant que membre d’un groupe d’authentification spécifique en utilisant l’option `--groups [groupname]`.

Par exemple, si vous avez un groupe nommé `admin`, vous pouvez effectuer un aperçu en tant que membre de ce groupe avec la commande :
Par exemple, si vous avez un groupe nommé `admin`, vous pouvez prévisualiser en tant que membre de ce groupe avec la commande :

```bash
mint dev --groups admin
Expand Down
10 changes: 5 additions & 5 deletions fr/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,11 @@ Le flux de travail basé sur le code s’intègre à votre environnement de dév
### Installer la CLI
</div>

Pour travailler localement avec votre documentation, installez l’interface en ligne de commande (CLI), appelée [mint](https://www.npmjs.com/package/mint), en exécutant la commande suivante dans votre terminal :
<Info>
**Prérequis** : L’interface en ligne de commande (CLI) nécessite [Node.js](https://nodejs.org/en) v19 ou une version ultérieure.
</Info>

Pour travailler localement avec votre documentation, installez l’interface en ligne de commande (CLI), appelée [mint](https://www.npmjs.com/package/mint), en exécutant cette commande dans votre terminal :

<CodeGroup>
```bash npm
Expand All @@ -103,10 +107,6 @@ Pour travailler localement avec votre documentation, installez l’interface en
```
</CodeGroup>

<Info>
Vous devez avoir Node.js installé sur votre machine. Si vous rencontrez des problèmes d’installation, consultez le guide de dépannage.
</Info>

<div id="edit-the-documentation">
### Modifier la documentation
</div>
Expand Down
30 changes: 17 additions & 13 deletions zh/installation.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
---
title: "安装命令行界面(CLI"
description: "安装命令行界面(CLI),在本地预览并开发你的文档"
title: "CLI 安装"
description: "使用命令行界面(CLI)在本地预览并维护文档"
---

<img className="block dark:hidden my-0 pointer-events-none" src="/images/installation/local-development-light.png" alt="用于表示命令行界面(CLI的装饰性图形。" />
<img className="block dark:hidden my-0 pointer-events-none" src="/images/installation/local-development-light.png" alt="用于表示 CLI 的装饰性图形。" />

<img className="hidden dark:block my-0 pointer-events-none" src="/images/installation/local-development-dark.png" alt="用于表示命令行界面(CLI的装饰性图形。" />
<img className="hidden dark:block my-0 pointer-events-none" src="/images/installation/local-development-dark.png" alt="用于表示 CLI 的装饰性图形。" />

<div id="installing-the-cli">
使用命令行界面(CLI)在编写和编辑时本地预览文档。在部署前实时查看更改,测试文档站点的外观与功能,并及时发现断链或无障碍等问题。

CLI 还提供维护文档的实用工具,包括用于重命名文件、验证 OpenAPI 规范,以及在不同格式之间迁移内容的命令。

<div id="install-the-cli">
## 安装命令行界面(CLI)
</div>

<Info>
**先决条件**:继续之前,请先安装 [Node.js](https://nodejs.org/en)。
**先决条件**:CLI 需要 [Node.js](https://nodejs.org/en) v19 或更高版本
</Info>

<Steps>
<Step title="安装 CLI">
<Step title="安装 CLI">
运行以下命令安装 [CLI](https://www.npmjs.com/package/mint):

<CodeGroup>
Expand All @@ -30,18 +34,18 @@ description: "安装命令行界面(CLI),在本地预览并开发你的文
</CodeGroup>
</Step>

<Step title="本地预览">
<Step title="本地预览">
进入你的文档目录(`docs.json` 所在位置),并执行以下命令:

```bash
mint dev
```

你的文档将可在 `http://localhost:3000` 进行本地预览
你的文档将可在本地通过 `http://localhost:3000` 访问
</Step>
</Steps>

或者,如果你不想全局安装 CLI,可以运行一次性脚本
或者,如果你不想全局安装 CLI,也可以运行一次性脚本

```bash
npx mint dev
Expand Down Expand Up @@ -85,13 +89,13 @@ mint dev --port 3333
端口 3000 已被占用。正在尝试端口 3001。
```

<div id="previewing-as-a-specific-group">
## 以特定分组进行预览
<div id="preview-as-a-specific-group">
## 以特定分组预览
</div>

如果你使用部分认证来限制文档访问,可以通过 `--groups [groupname]` 标志以特定认证分组的身份进行预览。

例如,如果你有一个名为 `admin` 的分组,可以使用以下命令以该分组成员的身份进行预览
例如,如果你有一个名为 `admin` 的分组,可以使用以下命令以该分组成员身份进行预览

```bash
mint dev --groups admin
Expand Down
10 changes: 5 additions & 5 deletions zh/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,11 @@ Mintlify 提供两种用于创建和维护文档的工作流程:
### 安装命令行界面(CLI)
</div>

要在本地处理文档,请在终端运行以下命令,安装名为 [mint](https://www.npmjs.com/package/mint) 的命令行界面(CLI):
<Info>
**先决条件**:CLI 需要 [Node.js](https://nodejs.org/en) v19 或更高版本。
</Info>

要在本地处理你的文档,请在终端运行以下命令来安装名为 [mint](https://www.npmjs.com/package/mint) 的命令行界面(CLI):

<CodeGroup>
```bash npm
Expand All @@ -103,10 +107,6 @@ Mintlify 提供两种用于创建和维护文档的工作流程:
```
</CodeGroup>

<Info>
需要在本机已安装 Node.js。若遇到安装问题,请查看故障排查指南。
</Info>

<div id="edit-the-documentation">
### 编辑文档
</div>
Expand Down