mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
eed7384340
* docs: fix editor button label, CLI groups flag, BYOK coverage, and draft PR setting * docs: mirror PR changes into es, fr, zh and fix overlong translated descriptions * docs: clarify branch publishing and draft PR review steps * Apply batched suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
140 lines
6.8 KiB
Plaintext
140 lines
6.8 KiB
Plaintext
---
|
|
title: "Configuración del editor para IA y publicación"
|
|
sidebarTitle: "Configuración"
|
|
description: "Configure la apariencia, las instrucciones de IA y los valores de publicación del editor para controlar su aspecto y cómo confirma y fusiona los cambios."
|
|
keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "appearance", "preferences"]
|
|
---
|
|
|
|
La [página de configuración](https://app.mintlify.com/settings/deployment/editor) del editor controla la apariencia, el comportamiento de publicación y el comportamiento del agente.
|
|
|
|
- **Appearance**: Preferencias personales sobre cómo se ve y se comporta el editor. Se aplican solo a usted.
|
|
- **Publishing**: Valores predeterminados de todo el deployment sobre cómo el editor confirma cambios y abre pull requests. Se aplican a todas las personas que publican. Cambiarlos requiere permiso para actualizar el deployment. Si los controles están deshabilitados para usted, contacte a un administrador.
|
|
- **Chat**: Instrucciones persistentes para el agente de IA del editor.
|
|
- **Danger zone**: Acciones que no se pueden deshacer.
|
|
|
|
<div id="appearance">
|
|
|
|
## Appearance
|
|
|
|
</div>
|
|
|
|
Los ajustes de apariencia son preferencias personales. Cambian el editor solo para usted y no afectan a sus compañeros de equipo ni a su sitio publicado.
|
|
|
|
- **Fit editor to full width**: Extiende el lienzo de edición de borde a borde en lugar de usar la columna predeterminada de 768px.
|
|
- **Show breadcrumbs**: Muestra la ubicación de la página en la navegación del sitio encima del lienzo de edición.
|
|
- **Open live preview in new tab**: Abre la página representada en una pestaña nueva del navegador al previsualizar, en lugar de la vista previa en panel dividido.
|
|
- **Show all files**: Muestra todos los archivos en la barra lateral, incluidos los dotfiles, el código, los PDF y otros archivos ocultos de forma predeterminada. También puede pulsar <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows) para alternarlo.
|
|
|
|
<div id="pr-instructions">
|
|
|
|
## Instrucciones de PR
|
|
|
|
</div>
|
|
|
|
Las instrucciones de PR guían a la IA cuando genera el título y la descripción de una pull request. Se aplican siempre que el editor abre una pull request en su nombre, incluidos los flujos **Create pull request** y **Merge and publish**.
|
|
|
|
Use las instrucciones de PR para estandarizar lo que ven los revisores, por ejemplo:
|
|
|
|
- Secciones obligatorias como **Summary** y **Changes**.
|
|
- Una plantilla de descripción que enlace con un sistema de seguimiento.
|
|
- Requisitos de tono o longitud para los títulos.
|
|
|
|
Ejemplo:
|
|
|
|
```text
|
|
Title: imperative mood, under 70 characters, no trailing period.
|
|
Description: include a "## Summary" section (one sentence) and a
|
|
"## Changes" section as a bulleted list. Link any referenced page
|
|
using its relative path.
|
|
```
|
|
|
|
Las instrucciones tienen un límite de 20.000 caracteres.
|
|
|
|
<div id="main-branch-autocommits">
|
|
|
|
## Autocommits en la branch main
|
|
|
|
</div>
|
|
|
|
Los autocommits en la branch main envían los cambios a su branch main automáticamente, poco después de que deje de escribir. Si activa este ajuste, el editor **oculta por completo las branches y el paso de publicación**.
|
|
|
|
<Warning>
|
|
Con los autocommits en la branch main activados, no hay estado pendiente ni posibilidad de revisar. Cada edición llega a su sitio publicado poco después de que deje de escribir.
|
|
</Warning>
|
|
|
|
<div id="create-draft-pull-requests-by-default">
|
|
|
|
## Crear pull requests como borrador de forma predeterminada
|
|
|
|
</div>
|
|
|
|
Cuando este ajuste está activado, las pull requests creadas desde el editor se abren como borradores. Los autores las marcan como listas para revisión cuando terminan de editar. Este ajuste está activado de forma predeterminada.
|
|
|
|
Desactívelo si quiere que las pull requests del editor se abran listas para revisión de inmediato.
|
|
|
|
<div id="pr-merge-method">
|
|
|
|
## Método de merge de PR
|
|
|
|
</div>
|
|
|
|
Elija cómo hace merge el editor de las pull requests cuando hace clic en **Merge and publish**:
|
|
|
|
- **Merge**: Crea un commit de merge que conserva el historial completo de la branch. Es la opción predeterminada.
|
|
- **Squash**: Combina todos los commits de la branch en un único commit en su deployment branch.
|
|
- **Rebase**: Reaplica cada commit de la branch sobre su deployment branch sin un commit de merge.
|
|
|
|
Si indica un método de merge explícito a través de la API o de la interfaz de su proveedor de Git, esa elección tiene prioridad.
|
|
|
|
<Tip>
|
|
Haga coincidir su método de merge con las reglas de protección de branch de su proveedor de Git. Si su deployment branch solo admite squash merges, elija **Squash** para evitar merges fallidos desde el editor.
|
|
</Tip>
|
|
|
|
<div id="ai-instructions">
|
|
|
|
## Instrucciones de IA
|
|
|
|
</div>
|
|
|
|
Las instrucciones de IA son directrices persistentes que el editor envía a la IA junto con su solicitud. Úselas para recoger reglas de estilo y tono que no quiere repetir cada vez, como la voz, la terminología o las convenciones de formato.
|
|
|
|
Sus instrucciones se aplican a:
|
|
|
|
- Las acciones de **Edit with AI** sobre una selección, como reescribir, ampliar o corregir.
|
|
- Las sesiones del agente iniciadas desde el editor.
|
|
|
|
Cada compañero mantiene sus propias instrucciones, vinculadas a su cuenta de usuario. Las instrucciones tienen un límite de 20.000 caracteres.
|
|
|
|
Añada instrucciones de IA cuando se dé cuenta de que repite las mismas directrices en los prompts, por ejemplo:
|
|
|
|
- Exigir la segunda persona o títulos en formato de frase.
|
|
- Preferir nombres de producto o terminología concretos.
|
|
- Prohibir el lenguaje de marketing o las frases de relleno.
|
|
- Exigir determinados componentes, como usar siempre `<Note>` para las llamadas de atención.
|
|
|
|
Mantenga las instrucciones breves y concretas. La IA las sigue en cada solicitud, así que las reglas vagas o contradictorias empeoran los resultados.
|
|
|
|
Ejemplo:
|
|
|
|
```text
|
|
- Use second person ("you") and active voice.
|
|
- Use sentence case for all headings.
|
|
- Refer to the product as "Acme"—never "Acme Inc." or "the platform".
|
|
- Wrap notes and warnings in <Note> or <Warning> components.
|
|
- Do not add introductory filler like "In this guide" or "Let's explore".
|
|
```
|
|
|
|
Deje el campo vacío para eliminar sus instrucciones.
|
|
|
|
<div id="reset-editor">
|
|
|
|
## Restablecer editor
|
|
|
|
</div>
|
|
|
|
**Reset editor** obliga al editor a descartar su estado local y sincronizarse con su repositorio de Git. Restablezca el editor si se queda desincronizado con su repositorio, por ejemplo si el árbol de archivos está vacío o muestra errores como `Unable to find docs.json`. Esto puede ocurrir aunque el archivo exista en su deployment branch y su sitio se compile con normalidad.
|
|
|
|
<Warning>
|
|
Si restablece el editor, descarta cualquier cambio sin publicar que no haya confirmado en Git. Si tiene ediciones pendientes que quiere conservar, publíquelas primero.
|
|
</Warning>
|