From 640c7cf8fe53aceb4bd1ba2c7f4f0ab759a38c33 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 18:38:40 +0000 Subject: [PATCH 1/2] docs: fill quality gaps flagged by recency audit --- agent/slack.mdx | 10 ++++++++++ automations/create.mdx | 18 +++++++++++++++++- automations/manage.mdx | 10 ++++++++++ cli/commands.mdx | 6 ++++++ cli/index.mdx | 2 ++ 5 files changed, 45 insertions(+), 1 deletion(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index 801e6e324..50d0aeb81 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -52,6 +52,16 @@ message in the thread. The agent retains your conversation history so you can continue where you left off with the new deployment. +### Disconnect the agent + +To remove the agent from your Slack workspace: + +1. Open your Mintlify dashboard and go to the Slack agent settings. +2. Click **Disconnect** to remove the workspace connection. +3. In Slack, open **Settings & administration** → **Manage apps**, find `mintlify`, and remove it from the workspace. + +Removing the app stops the agent from responding in any channel or thread. In-progress agent runs finish and post their results, but no new requests are accepted until you reinstall. + ## Use the agent in Slack Once connected, you can: diff --git a/automations/create.mdx b/automations/create.mdx index 29d2cb64a..518db0655 100644 --- a/automations/create.mdx +++ b/automations/create.mdx @@ -18,9 +18,25 @@ import GitlabAutomationSetup from '/snippets/gitlab-automation-setup.mdx'; The agent runs in an isolated sandbox with restricted internet access. It cannot install additional packages or tools at runtime. Prompts that reference unavailable tools may produce unexpected results or fail. +Inside the sandbox, the agent can: + +- Read files in your documentation repository and any connected context repositories. +- Use the shared and personal [integrations](/automations/integrations) you select as tools. +- Edit MDX files and open a pull request against your documentation repository. + +The sandbox cannot make arbitrary outbound network requests, install packages, or run shell commands beyond the tools Mintlify provides. + 1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. 2. Click **Create a custom automation**. -3. Configure the automation name, trigger, instructions, context repositories, integrations, and update mode. For details on each field, see [Configurations](/automations/manage#configurations). +3. Configure the automation: + - **Name**: A short, descriptive label shown in the dashboard and run history. + - **Trigger**: When the automation runs (content update, code change, custom schedule, or integration event). + - **Instructions**: The prompt the agent follows on each run. + - **Context repositories**: Extra repositories the agent can read for additional context. + - **Integrations**: Shared integrations the agent can call as tools during the run. + - **Update mode**: How the agent proposes changes—open a pull request, commit directly, or another mode. + + For full details on each field, see [Configurations](/automations/manage#configurations). 4. Click **Create automation**. ## Write effective instructions diff --git a/automations/manage.mdx b/automations/manage.mdx index 15672461b..eee6934a4 100644 --- a/automations/manage.mdx +++ b/automations/manage.mdx @@ -115,6 +115,16 @@ You can add target languages at any time by opening the automation's settings an When you re-enable a scheduled automation or change its schedule, Mintlify recalculates the next run time from the current time. Disabled automations do not retain a pending run time. +## Delete an automation + +Deleting an automation is permanent and removes its configuration and run history. Predefined automations cannot be deleted; disable them instead. + +1. Open the [Automations](https://app.mintlify.com/products/automations) page in your dashboard. +2. Click the settings button beside a custom automation. +3. Click **Delete**. + +You can also delete an automation from the terminal with [`mint automations delete`](/cli/commands#mint-automations-delete). + ## Run an automation manually You can trigger any enabled automation on demand without waiting for its next scheduled or event-based run. diff --git a/cli/commands.mdx b/cli/commands.mdx index 512119d4c..6879de4f0 100644 --- a/cli/commands.mdx +++ b/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "commands", "flags", "reference"] boost: 3 --- +To install or upgrade the CLI, see [Install the CLI](/cli/install). + ## Global flags These flags are available on all commands. @@ -247,6 +249,8 @@ The command scans `.mdx` and `.md` files for links and excludes files matching [ | `--check-redirects` | Also check that redirect destinations in `docs.json` resolve to valid paths. | | `--check-snippets` | Also check links inside `` components. | +The command exits with a non-zero status when it finds broken links, so you can gate CI on the result. + Pass `--files` to limit the check to specific pages. This is useful for validating a single page you just edited or scoping checks to a directory in CI. When `--files` is set with `--check-external`, only external URLs on the selected pages are fetched. ```bash @@ -277,6 +281,8 @@ Checks color contrast ratios and missing alt text on images and videos. | `--skip-contrast` | Skip color contrast checks. | | `--skip-alt-text` | Skip missing alt text checks. | +The command exits with a non-zero status when it finds accessibility issues, so you can gate CI on the result. + --- ## `mint validate` diff --git a/cli/index.mdx b/cli/index.mdx index 4666da9ad..f85e4bada 100644 --- a/cli/index.mdx +++ b/cli/index.mdx @@ -23,6 +23,8 @@ Use the [CLI](https://www.npmjs.com/package/mint) to preview your documentation The CLI runs on your machine and connects to your Mintlify deployment when you need live data. +The CLI installs from npm and requires Node.js v20.17.0 or newer. See [Install the CLI](/cli/install) for setup instructions. + ### Preview locally Run `mint dev` to preview your documentation at `localhost:3000`. As you write and update your content, changes appear in real time without deploying. Log in to enable search and the AI assistant in your local preview. From 829e469edd02471b5660b158d1a9e28ccd0a335d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 18:45:13 +0000 Subject: [PATCH 2/2] docs: translate quality-gap fixes to es/fr/zh and tighten descriptions --- automations/create.mdx | 2 +- es/agent/slack.mdx | 12 ++++++++++++ es/automations/create.mdx | 18 +++++++++++++++++- es/automations/manage.mdx | 12 ++++++++++++ es/cli/commands.mdx | 6 ++++++ es/cli/index.mdx | 2 ++ fr/agent/slack.mdx | 12 ++++++++++++ fr/automations/create.mdx | 18 +++++++++++++++++- fr/automations/manage.mdx | 14 +++++++++++++- fr/cli/commands.mdx | 6 ++++++ fr/cli/index.mdx | 2 ++ zh/agent/slack.mdx | 12 ++++++++++++ zh/automations/create.mdx | 18 +++++++++++++++++- zh/automations/manage.mdx | 12 ++++++++++++ zh/cli/commands.mdx | 6 ++++++ zh/cli/index.mdx | 2 ++ 16 files changed, 149 insertions(+), 5 deletions(-) diff --git a/automations/create.mdx b/automations/create.mdx index 518db0655..c290cec43 100644 --- a/automations/create.mdx +++ b/automations/create.mdx @@ -1,6 +1,6 @@ --- title: "Create a custom automation" -description: "Create a custom Mintlify automation that runs on a schedule, a push to a repository, or when an integration event occurs. Add context repositories and an agent prompt to the automation to customize its behavior." +description: "Create a custom Mintlify automation that runs on a schedule, repository push, or integration event, with context repositories and an agent prompt." keywords: ["automation", "automate", "cron", "agent", "custom automation"] --- diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 811d4a84e..3d589c7be 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -56,6 +56,18 @@ el mensaje de estado del agente en el hilo. El agente conserva tu historial de conversación para que puedas continuar donde lo dejaste con el nuevo despliegue. +
+ ### Desconectar el agente +
+ +Para eliminar el agente de tu espacio de trabajo de Slack: + +1. Abre tu dashboard de Mintlify y ve a la configuración del agente de Slack. +2. Haz clic en **Disconnect** para eliminar la conexión con el espacio de trabajo. +3. En Slack, abre **Settings & administration** → **Manage apps**, busca `mintlify` y elimínalo del espacio de trabajo. + +Al eliminar la app, el agente deja de responder en cualquier canal o hilo. Las ejecuciones del agente en curso finalizan y publican sus resultados, pero no se aceptan nuevas solicitudes hasta que lo reinstales. +
## Usar el agente en Slack
diff --git a/es/automations/create.mdx b/es/automations/create.mdx index 7a27c6871..58777a6d3 100644 --- a/es/automations/create.mdx +++ b/es/automations/create.mdx @@ -22,9 +22,25 @@ import GitlabAutomationSetup from '/snippets/es/gitlab-automation-setup.mdx'; El agente se ejecuta en un sandbox aislado con acceso restringido a internet. No puede instalar paquetes o herramientas adicionales en tiempo de ejecución. Los prompts que hagan referencia a herramientas no disponibles pueden producir resultados inesperados o fallar. +Dentro del sandbox, el agente puede: + +- Leer archivos en tu repositorio de documentación y en cualquier repositorio de contexto conectado. +- Usar las [integraciones](/es/automations/integrations) compartidas y personales que selecciones como herramientas. +- Editar archivos MDX y abrir una pull request en tu repositorio de documentación. + +El sandbox no puede realizar solicitudes de red salientes arbitrarias, instalar paquetes ni ejecutar comandos de shell más allá de las herramientas que proporciona Mintlify. + 1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. 2. Haz clic en **Create a custom automation**. -3. Configura el nombre de la automatización, el activador, las instrucciones, los repositorios de contexto, las integraciones y el modo de actualización. Para más detalles sobre cada campo, consulta [Configuraciones](/es/automations/manage#configurations). +3. Configura la automatización: + - **Nombre**: Una etiqueta corta y descriptiva que se muestra en el dashboard y en el historial de ejecuciones. + - **Activador**: Cuándo se ejecuta la automatización (actualización de contenido, cambio de código, programación personalizada o evento de integración). + - **Instrucciones**: El prompt que sigue el agente en cada ejecución. + - **Repositorios de contexto**: Repositorios adicionales que el agente puede leer para obtener más contexto. + - **Integraciones**: Integraciones compartidas que el agente puede invocar como herramientas durante la ejecución. + - **Modo de actualización**: Cómo propone cambios el agente: abrir una pull request, hacer commit directamente u otro modo. + + Para más detalles sobre cada campo, consulta [Configuraciones](/es/automations/manage#configurations). 4. Haz clic en **Create automation**.
diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 68d809a4c..75494659d 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -137,6 +137,18 @@ Puedes añadir idiomas de destino en cualquier momento abriendo la configuració Cuando vuelves a activar una automatización programada o cambias su programación, Mintlify recalcula el próximo tiempo de ejecución a partir de la hora actual. Las automatizaciones desactivadas no conservan un tiempo de ejecución pendiente. +
+## Eliminar una automatización +
+ +Eliminar una automatización es permanente y elimina su configuración y el historial de ejecuciones. Las automatizaciones predefinidas no se pueden eliminar; en su lugar, desactívalas. + +1. Abre la página [Automatizaciones](https://app.mintlify.com/products/automations) en tu dashboard. +2. Haz clic en el botón de configuración junto a una automatización personalizada. +3. Haz clic en **Delete**. + +También puedes eliminar una automatización desde la terminal con [`mint automations delete`](/es/cli/commands#mint-automations-delete). +
## Ejecutar una automatización manualmente
diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx index 5fafeade3..662f210c7 100644 --- a/es/cli/commands.mdx +++ b/es/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "comandos", "flags", "referencia"] boost: 3 --- +Para instalar o actualizar la CLI, consulta [Instalar la CLI](/es/cli/install). +
## Flags globales
@@ -277,6 +279,8 @@ El comando excluye los archivos que coinciden con los patrones de [.mintignore]( | `--check-redirects` | También verificar que los destinos de redirección en `docs.json` se resuelvan a rutas válidas. | | `--check-snippets` | También verificar enlaces dentro de componentes ``. | +El comando finaliza con un estado distinto de cero cuando encuentra enlaces rotos, para que puedas condicionar CI al resultado. + Usa `--files` para limitar la verificación a páginas específicas. Es útil para validar una sola página que acabas de editar o para acotar las verificaciones a un directorio en CI. Cuando se combina `--files` con `--check-external`, solo se comprueban las URLs externas de las páginas seleccionadas. ```bash @@ -309,6 +313,8 @@ Verifica las relaciones de contraste de color y la falta de texto alternativo en | `--skip-contrast` | Omitir las verificaciones de contraste de color. | | `--skip-alt-text` | Omitir las verificaciones de texto alternativo faltante. | +El comando finaliza con un estado distinto de cero cuando encuentra problemas de accesibilidad, para que puedas condicionar CI al resultado. + ---
diff --git a/es/cli/index.mdx b/es/cli/index.mdx index 7cc659020..94e60562b 100644 --- a/es/cli/index.mdx +++ b/es/cli/index.mdx @@ -23,6 +23,8 @@ Usa la [CLI](https://www.npmjs.com/package/mint) para previsualizar tu documenta La CLI se ejecuta en tu máquina y se conecta a tu despliegue de Mintlify cuando necesitas datos en vivo. +La CLI se instala desde npm y requiere Node.js v20.17.0 o superior. Consulta [Instalar la CLI](/es/cli/install) para las instrucciones de configuración. +
### Previsualización local
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 3203a39d1..c0db72820 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -57,6 +57,18 @@ conversation afin que vous puissiez reprendre là où vous en étiez avec le nou déploiement. +
+ ### Déconnecter l'agent +
+ +Pour retirer l'agent de votre espace de travail Slack : + +1. Ouvrez votre dashboard Mintlify et accédez aux paramètres de l'agent Slack. +2. Cliquez sur **Disconnect** pour supprimer la connexion à l'espace de travail. +3. Dans Slack, ouvrez **Settings & administration** → **Manage apps**, trouvez `mintlify` et supprimez-le de l'espace de travail. + +La suppression de l'application empêche l'agent de répondre dans tout canal ou fil. Les exécutions d'agent en cours se terminent et publient leurs résultats, mais aucune nouvelle demande n'est acceptée jusqu'à ce que vous réinstalliez l'application. +
## Utiliser l'agent dans Slack
diff --git a/fr/automations/create.mdx b/fr/automations/create.mdx index ed7fdb862..94bcdfc84 100644 --- a/fr/automations/create.mdx +++ b/fr/automations/create.mdx @@ -22,9 +22,25 @@ import GitlabAutomationSetup from '/snippets/fr/gitlab-automation-setup.mdx'; L'agent s'exécute dans un sandbox isolé avec un accès Internet restreint. Il ne peut pas installer de packages ou d'outils supplémentaires à l'exécution. Les prompts qui font référence à des outils indisponibles peuvent produire des résultats inattendus ou échouer. +Dans le sandbox, l'agent peut : + +- Lire les fichiers de votre dépôt de documentation et de tout dépôt de contexte connecté. +- Utiliser les [intégrations](/fr/automations/integrations) partagées et personnelles que vous sélectionnez comme outils. +- Modifier des fichiers MDX et ouvrir une pull request sur votre dépôt de documentation. + +Le sandbox ne peut pas effectuer de requêtes réseau sortantes arbitraires, installer des packages, ni exécuter des commandes shell au-delà des outils fournis par Mintlify. + 1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. 2. Cliquez sur **Create a custom automation**. -3. Configurez le nom de l'automatisation, le déclencheur, les instructions, les dépôts de contexte, les intégrations et le mode de mise à jour. Pour plus de détails sur chaque champ, consultez [Configurations](/fr/automations/manage#configurations). +3. Configurez l'automatisation : + - **Nom** : Une étiquette courte et descriptive affichée dans le dashboard et l'historique des exécutions. + - **Déclencheur** : Le moment où l'automatisation s'exécute (mise à jour de contenu, modification de code, calendrier personnalisé ou événement d'intégration). + - **Instructions** : Le prompt que l'agent suit à chaque exécution. + - **Dépôts de contexte** : Dépôts supplémentaires que l'agent peut lire pour obtenir plus de contexte. + - **Intégrations** : Intégrations partagées que l'agent peut appeler comme outils pendant l'exécution. + - **Mode de mise à jour** : Comment l'agent propose les modifications — ouvrir une pull request, committer directement, ou un autre mode. + + Pour plus de détails sur chaque champ, consultez [Configurations](/fr/automations/manage#configurations). 4. Cliquez sur **Create automation**.
diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index e242d1455..54b91fb19 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -1,6 +1,6 @@ --- title: "Gérer les automatisations" -description: "Activez, désactivez, déclenchez et supprimez des automatisations. Configurez les déclencheurs de dépôt, de calendrier et d'intégration, le contexte et l'automerge." +description: "Activez, désactivez, exécutez et supprimez des automatisations. Configurez les déclencheurs de dépôt, de calendrier et d'intégration, et l'automerge." keywords: ["cron", "push", "automerge", "context", "automation instructions", "trigger", "disable automation", "enable automation"] --- @@ -137,6 +137,18 @@ Vous pouvez ajouter des langues cibles à tout moment en ouvrant les paramètres Lorsque vous réactivez une automatisation planifiée ou modifiez son calendrier, Mintlify recalcule la prochaine heure d'exécution à partir de l'heure actuelle. Les automatisations désactivées ne conservent pas d'heure d'exécution en attente. +
+ ## Supprimer une automatisation +
+ +La suppression d'une automatisation est définitive et supprime sa configuration ainsi que l'historique de ses exécutions. Les automatisations prédéfinies ne peuvent pas être supprimées ; désactivez-les à la place. + +1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard. +2. Cliquez sur le bouton de paramètres à côté d'une automatisation personnalisée. +3. Cliquez sur **Delete**. + +Vous pouvez également supprimer une automatisation depuis le terminal avec [`mint automations delete`](/fr/cli/commands#mint-automations-delete). +
## Exécuter une automatisation manuellement
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx index 5881477c9..0bd445f13 100644 --- a/fr/cli/commands.mdx +++ b/fr/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "commandes", "flags", "référence"] boost: 3 --- +Pour installer ou mettre à jour la CLI, consultez [Installer la CLI](/fr/cli/install). +
## Flags globaux
@@ -277,6 +279,8 @@ La commande exclut les fichiers correspondant aux motifs [.mintignore](/fr/organ | `--check-redirects` | Vérifier également que les destinations de redirection dans `docs.json` se résolvent vers des chemins valides. | | `--check-snippets` | Vérifier également les liens à l'intérieur des composants ``. | +La commande se termine avec un statut non nul lorsqu'elle trouve des liens cassés, ce qui vous permet de conditionner la CI sur ce résultat. + Utilisez `--files` pour limiter la vérification à des pages spécifiques. C'est utile pour valider une seule page que vous venez de modifier ou pour restreindre les vérifications à un répertoire en CI. Lorsque `--files` est combiné avec `--check-external`, seules les URLs externes des pages sélectionnées sont vérifiées. ```bash @@ -309,6 +313,8 @@ Vérifie les rapports de contraste de couleur et les textes alternatifs manquant | `--skip-contrast` | Ignorer les vérifications de contraste de couleur. | | `--skip-alt-text` | Ignorer les vérifications de texte alternatif manquant. | +La commande se termine avec un statut non nul lorsqu'elle trouve des problèmes d'accessibilité, ce qui vous permet de conditionner la CI sur ce résultat. + ---
diff --git a/fr/cli/index.mdx b/fr/cli/index.mdx index 0ec593262..cdb2a8dcb 100644 --- a/fr/cli/index.mdx +++ b/fr/cli/index.mdx @@ -23,6 +23,8 @@ Utilisez la [CLI](https://www.npmjs.com/package/mint) pour prévisualiser votre La CLI s'exécute sur votre machine et se connecte à votre déploiement Mintlify lorsque vous avez besoin de données en direct. +La CLI s'installe depuis npm et nécessite Node.js v20.17.0 ou plus récent. Consultez [Installer la CLI](/fr/cli/install) pour les instructions d'installation. +
### Prévisualisation locale
diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index e01819111..948851a9f 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -45,6 +45,18 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " **Switch deployment** 按钮。Agent 会保留你的对话历史记录，以便你在新部署上从之前中断的地方继续。 +
+ ### 断开 agent 连接 +
+ +如需从你的 Slack 工作区移除 agent： + +1. 打开你的 Mintlify dashboard，进入 Slack agent 设置。 +2. 点击 **Disconnect** 以移除该工作区连接。 +3. 在 Slack 中，打开 **Settings & administration** → **Manage apps**，找到 `mintlify`，并将其从工作区中移除。 + +移除该应用后，agent 将不再在任何频道或线程中作出响应。正在进行中的 agent 运行会继续完成并发布结果，但在你重新安装之前不会接受新的请求。 +
## 在 Slack 中使用智能体
diff --git a/zh/automations/create.mdx b/zh/automations/create.mdx index e75f36d6b..486ef6b16 100644 --- a/zh/automations/create.mdx +++ b/zh/automations/create.mdx @@ -22,9 +22,25 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; agent 运行在受限互联网访问的隔离沙箱中。它无法在运行时安装额外的包或工具。引用不可用工具的提示词可能产生意外结果或失败。 +在沙箱中，agent 可以： + +- 读取你的文档仓库以及任何已连接的上下文仓库中的文件。 +- 使用你选定的共享和个人[集成](/zh/automations/integrations)作为工具。 +- 编辑 MDX 文件，并针对你的文档仓库开启 pull request。 + +沙箱无法发起任意的对外网络请求、安装软件包，或运行 Mintlify 提供的工具之外的 shell 命令。 + 1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 2. 点击 **Create a custom automation**。 -3. 配置自动化名称、触发器、指令、上下文仓库、集成和更新模式。有关各字段的详细说明，请参见[配置](/zh/automations/manage#configurations)。 +3. 配置自动化： + - **名称（Name）**：显示在控制台和运行历史中的简短、描述性标签。 + - **触发器（Trigger）**：自动化的运行时机（内容更新、代码变更、自定义计划或集成事件）。 + - **指令（Instructions）**：agent 在每次运行时遵循的提示词。 + - **上下文仓库（Context repositories）**：agent 可读取以获取额外上下文的附加仓库。 + - **集成（Integrations）**：agent 在运行期间可作为工具调用的共享集成。 + - **更新模式（Update mode）**：agent 提出更改的方式——开启 pull request、直接提交或其他模式。 + + 有关各字段的详细说明，请参见[配置](/zh/automations/manage#configurations)。 4. 点击 **Create automation**。
diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index 813ffa5ab..1f98af7df 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -137,6 +137,18 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; 当你重新启用一个计划自动化或更改其计划时，Mintlify 会从当前时间重新计算下次运行时间。已禁用的自动化不会保留待运行时间。 +
+ ## 删除自动化 +
+ +删除自动化是永久性的，会移除其配置和运行历史。预定义自动化无法删除；请改为将其禁用。 + +1. 在控制台中打开 [Automations](https://app.mintlify.com/products/automations) 页面。 +2. 点击自定义自动化旁边的 设置按钮。 +3. 点击 **Delete**。 + +你也可以在终端中使用 [`mint automations delete`](/zh/cli/commands#mint-automations-delete) 删除自动化。 +
## 手动运行自动化
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx index 96d0cc638..880229766 100644 --- a/zh/cli/commands.mdx +++ b/zh/cli/commands.mdx @@ -6,6 +6,8 @@ keywords: ["CLI", "mint", "命令", "选项", "参考"] boost: 3 --- +如需安装或升级 CLI，请参见[安装 CLI](/zh/cli/install)。 +
## 全局选项
@@ -277,6 +279,8 @@ mint broken-links [flags] | `--check-redirects` | 同时检查 `docs.json` 中的重定向目标是否解析为有效路径。 | | `--check-snippets` | 同时检查 `` 组件内的链接。 | +当命令发现断链时，会以非零状态退出，因此你可以据此在 CI 中进行门禁控制。 + 使用 `--files` 将检查限定为特定页面。适用于验证你刚编辑过的某个页面，或在 CI 中将检查范围缩小到某个目录。当 `--files` 与 `--check-external` 一起使用时，仅会检查所选页面上的外部 URL。 ```bash @@ -309,6 +313,8 @@ mint a11y [flags] | `--skip-contrast` | 跳过颜色对比度检查。 | | `--skip-alt-text` | 跳过缺失替代文本检查。 | +当命令发现无障碍性问题时，会以非零状态退出，因此你可以据此在 CI 中进行门禁控制。 + ---
diff --git a/zh/cli/index.mdx b/zh/cli/index.mdx index 4f97fd504..1172c2ad7 100644 --- a/zh/cli/index.mdx +++ b/zh/cli/index.mdx @@ -23,6 +23,8 @@ keywords: ["CLI", "mint", "本地开发", "预览"] CLI 在你的本地机器上运行，在需要实时数据时连接到你的 Mintlify 部署。 +CLI 通过 npm 安装，需要 Node.js v20.17.0 或更高版本。安装说明请参见[安装 CLI](/zh/cli/install)。 +
### 本地预览