Configuración avanzada

Herramientas de IA

Preguntar antes de publicar

Para publicar de forma segura y asegurarte de que todos los comentarios se han resuelto, puedes activar la opción Preguntar antes de publicar. Para ello:

  • Abre Project Settings → Advanced.

  • Marca Ask before publishing.

  • Haz clic en Save changes en el menú superior.

Bloquear la página al editar

Para asegurarte de que solo un usuario edita la página a la vez, puedes activar la opción Bloquear la página al editar. Para ello:

  • Abre Project Settings → Advanced.

  • Marca Lock page when editing.

  • Haz clic en Save changes en el menú superior.

Cuando esta opción está activada y un usuario está editando, el resto de los usuarios verán un banner que les informa de que la página está bloqueada. Mientras se muestre este banner, no podrán modificar la página hasta que el usuario que edita guarde o descarte los cambios. Cuando la página se desbloquee, se actualizará automáticamente.

Exigir anotaciones al guardar

Obliga a los editores a anotar los cambios que se van a guardar. Esto te ayuda a mantener un historial limpio. Para ello:

  • Abre Project Settings → Advanced.

  • Marca Require annotating on saving.

  • Haz clic en Save changes en el menú superior.

Correo de resumen de la documentación

El resumen de la documentación es un correo periódico para los administradores y publicadores del proyecto que recoge lo que requiere tu atención: enlaces rotos, búsquedas que no devolvieron resultados y los comentarios de los lectores. También enumera las páginas editadas recientemente pero aún sin publicar, y los comentarios que nadie ha resuelto.

Cada sección incluye un botón que abre AI Agent con la solicitud ya redactada, de modo que reparar los enlaces o redactar las páginas que faltan puede empezar desde el propio correo. Nada en tu documentación cambia hasta que envías la solicitud y apruebas lo que se devuelve.

Para elegir con qué frecuencia llega:

  • Abre Project Settings → Advanced.

  • En Notifications, establece Docs digest email en Weekly, Every two weeks, Monthly o Never.

  • Haz clic en Save changes en el menú superior.

Un proyecto sin nada que informar queda excluido.

Otras configuraciones

⭐
Available in Pro Projects

Las configuraciones avanzadas que no ofrecemos a través de la interfaz se pueden modificar mediante Etiquetas HEAD personalizadas.

Las configuraciones disponibles son (con sus valores predeterminados):

{ warnings: { oldVersion: false // false|true: Show a banner when viewing an older version }, index: { categoryToggle: false // false|true: Set true to disable automatic category toggling on changing page }, search: { scope: "version", // "version"|"section": Set the scope of the search bar hideAiSearch: false // false|true: Hides AI search but keeps the vector search available through API }, tableOfContents: { hideH3: false, // false|true: Hides H3 from table of contents hideH4: false, // false|true: Hides H4 from table of contents. Has no effect if hideH3 is enabled. highlightActive: true // false|true: Highlights last scrolled to heading in table of contents }, code: { theme: "github-dark", // DEPRECATED - Use darkTheme and lightTheme darkTheme: 'github-dark', // Any theme from https://codemirror.net/demo/theme.html (must import CSS as well): Sets the dark theme for code blocks lightTheme: 'github-light', // Any theme from https://codemirror.net/demo/theme.html (must import CSS as well): Sets the light theme for code blocks githubTheme: "github", // Any theme from https://emgithub.com/: Sets the theme for GitHub Code blocks showLineNumbers: false // false|true: Shows a gutter with line numbers in code blocks }, seo: { titleFormats: { // Modifies the browser tab title + META title. Use %page%, %section%, %version% and %project% as placeholders. page: '%page% - %project%', documentation: '%section% - %project%', reference: '%section% - %project%', landingPage: '%project%', customPage: '%section%', '404': '404 - %project%' }, }, apiReference: { collapsedMaxHeight: 1024, // Height which if exceeded the expand button shows for tables/examples lineWrapCode: false, // false|true: Wrap lines in code blocks (request, response, playground) setExampleAsValue: false // false|true: For API playground, sets the example as value }, feedback: { disable: false // Disables feedback control in runtime } }

Aplicar configuraciones

Para cambiar una configuración, usa la función apply en window.settings:

<script> window.settings.apply({ index: { categoryToggle: true }, search: { scope: "section" } }); </script>


  Última actualización