Saltar al contenido principal

​
Workspace y Site

La barra lateral del editor tiene dos pestañas: Workspace y Site. Workspace contiene páginas que no forman parte de su repositorio de Git ni de su sitio publicado. Las páginas del workspace se guardan automáticamente y no tienen paso de publicación.
  • Recents: Páginas del workspace que ha abierto recientemente.
  • Starred: Páginas del workspace que ha marcado con estrella. Para marcar una página, abra su menú de opciones y seleccione Star. Las estrellas son personales.
  • Personal: Sus páginas privadas.
  • Teamspace: Páginas compartidas con toda su organización. Consulte Teamspace.
  • Shared with me: Páginas que sus compañeros han compartido con usted directamente.
Site contiene su repositorio y las páginas que sus visitantes ven en su sitio publicado.
  • Navigation: Las páginas y groups de la navegación de su sitio, tal y como se definen en docs.json.
  • Files: Cada archivo de su repositorio que no está en su navegación, incluidas imágenes, vídeos, especificaciones de OpenAPI y docs.json.
Recents, starred, shared with me y teamspace solo aparecen cuando contienen algo. Arrastre el encabezado de una sección para reordenar las secciones de una pestaña. Haga clic en el encabezado de una sección para contraerla o expandirla. El editor guarda en su cuenta el orden de las secciones y su estado contraído. Al cambiar de pestaña se reabre la última página que vio en esa pestaña. La barra superior cambia con la pestaña. Share aparece solo en Workspace. El selector de branch, Preview y Publish aparecen solo en Site.

​
Crear una página

Para crear una página, haga clic en el botón más donde la quiere y luego seleccione New page.
  • Encabezado de la sección Navigation: Añade una página nueva al final de su navegación.
  • Un group u otro elemento de navegación: Añade una página nueva dentro de ese elemento.
  • Encabezado de la sección Files o una carpeta en Files: Crea un archivo que no está en su navegación.
El botón New page de la parte inferior de la pestaña Site también añade una página al final de su navegación.
Para añadir a su navegación una página que ya existe en su repositorio, haga clic en el botón más y seleccione Add existing page.
Los mismos menús crean elementos de navegación como groups, tabs, anchors, dropdowns, versions, languages y products. Para más información sobre cada elemento, consulte Navegación.

​
Editar la configuración de la página

Establezca el título, la descripción y el icono de una página directamente en la parte superior de la página. Pase el cursor por encima del título y haga clic en Add icon para elegir un icono o un emoji. Cuando hay una página con icono abierta, la pestaña de su navegador muestra ese icono. Para otros ajustes, abra el menú de opciones de la página en la barra lateral o haga clic en More options en la esquina superior derecha de la página y seleccione Page settings. El panel Page settings agrupa los ajustes en secciones:
  • URL: La ruta de la página y la URL de redirección. Cambiar la ruta mueve el archivo.
  • Navigation: Título en la barra lateral, etiqueta, modo y si la página está oculta.
  • SEO & sharing: Imagen de Open Graph y keywords.
Groups, tabs y otros elementos de navegación tienen sus propios paneles de configuración, como Group settings y Tab settings. Ábralos desde el menú de opciones del elemento. Consulte Páginas para más información sobre ajustes concretos.

​
Añadir archivos multimedia

Escriba /image o /video para subir un archivo o elegir uno que ya esté en su repositorio. También puede arrastrar archivos desde su equipo hasta la página, o arrastrar una imagen o un vídeo desde la sección Files hasta la página.
  • Los archivos subidos se guardan en sus carpetas images/, videos/ y files/ y se incluyen en el commit de su próxima publicación. Antes de insertar un archivo subido, puede editar su ruta.
  • Puede subir imágenes PNG, JPG, GIF, WebP, AVIF, ICO y BMP, vídeos MP4, WebM y MOV, y archivos PDF. Los archivos SVG no pueden subirse en el editor.
  • Cada archivo puede tener hasta 20 MB.
  • Haga clic en una imagen para seleccionarla. Arrastre la imagen para moverla, incluso dentro o fuera de componentes como frames, cards, tabs y callouts. Arrastre los controles de sus bordes para cambiar su tamaño. Presione Delete o Backspace para eliminarla.
  • Para servir una imagen distinta en modo oscuro, seleccione la imagen, haga clic en Edit Image y establezca Dark mode image.
  • Escriba /embed para añadir un embed. En la pestaña Video link, pegue una URL de YouTube, Loom o Vimeo, o un enlace directo a un archivo de vídeo. En la pestaña Embed code, pegue un iframe u otro fragmento de embed.
Para dar formato a las imágenes y usar el componente Frame, consulte Imágenes e incrustaciones.

​
Organizar la navegación

Arrastre elementos en Navigation para reordenarlos o anidarlos. El editor escribe sus cambios en docs.json cuando publica.
Algunos elementos no pueden anidarse dentro de otros. Por ejemplo, las tabs no pueden anidarse dentro de groups. El editor impide las combinaciones no válidas.
Para seleccionar varios elementos, haga Shift-clic para seleccionar un intervalo, o Cmd-clic (macOS) o Ctrl-clic (Windows) para añadir o quitar elementos individuales. Arrastre la selección o haga clic con el botón derecho sobre ella para mover, duplicar o eliminar todos los elementos seleccionados a la vez. Presione Esc para deshacer la selección. Para cambiar un group u otro elemento a un tipo distinto, abra su menú de opciones y seleccione Convert to. Los elementos de navegación global, como los anchors y las tabs que aparecen en todas las secciones de su sitio, no están en el árbol de la barra lateral. Para gestionarlos, haga clic en Site configuration en la parte inferior de la pestaña Site y luego vaya a Navigation.

​
Añadir y quitar páginas de su navegación

Arrastre una página desde Files a Navigation para añadirla en esa posición. Arrastre una carpeta para añadirla como group. También puede seleccionar Move to navigation desde el menú de opciones de un archivo. Para quitar una página o un group de su navegación sin eliminar sus archivos, arrástrelos desde Navigation a Files o seleccione Move to files desde su menú de opciones. Aparece un aviso de deshacer después del movimiento.

​
Files

Haga clic en un archivo en Files para abrirlo.
  • Las imágenes se abren en una vista previa. Haga clic en la imagen para ampliarla.
  • Los vídeos se reproducen en el editor.
  • docs.json se abre en el modo source.
  • Los archivos de texto y de código, como YAML, JSON y CSS, se abren en el editor de source.
  • El editor no puede previsualizar otros archivos, como fuentes y comprimidos.
Para subir archivos, arrástrelos desde su equipo hasta la sección Files.

​
Mover una página

Para mover una página a otra carpeta, abra su menú de opciones y seleccione Move to o presione Cmd + Shift + P (macOS) o Ctrl + Shift + P (Windows) con la página abierta. Puede abrir el menú de opciones de una página desde:
  • More options en la esquina superior derecha de una página abierta.
  • El menú junto a una página en la barra lateral.
  • Haciendo clic con el botón derecho sobre una página en la barra lateral.
En el selector, busque para filtrar carpetas, expanda carpetas para ver destinos anidados y seleccione una carpeta para mover la página. Mover una página del sitio mueve su archivo a la nueva carpeta. Los editors y admins pueden mover páginas del sitio. Puede mover páginas del workspace que gestiona en Personal y Teamspace, pero no páginas en Shared with me.

​
Eliminar una página

Para eliminar una página, haga clic en More options en la esquina superior derecha de la página y luego haga clic en Move to trash. También puede eliminar una página desde su menú de opciones en la barra lateral. Eliminar una página del sitio elimina tanto el archivo como su entrada de navegación. Aparece un aviso con Undo después de eliminarla. Para quitar una página de su navegación sin eliminar su archivo, seleccione Move to files en su lugar. Eliminar una página del workspace es permanente. Para las páginas del workspace, el menú More options muestra Delete page. Los editors y admins pueden eliminar páginas del sitio.

​
Historial de versiones

El historial de versiones le permite comparar una página con versiones guardadas anteriores y restaurar una. No está disponible para docs.json. El editor registra una versión nueva unos 10 segundos después de que deja de editar una página. Si edita de forma continua, el editor registra una versión al menos una vez por minuto. Los cambios que se sincronizan desde su repositorio de Git también crean versiones, que muestran Git sync como autor. El historial de versiones está limitado a la branch actual. Solo está disponible el historial de la branch actual.
  1. Haga clic en More options en la esquina superior derecha de la página.
  2. Haga clic en Version history.
  3. Seleccione una versión. El editor muestra en qué se diferencia la página actual de esa versión.
  4. Para restaurarla, haga clic en Restore this version.
Para salir de la comparación, haga clic en Exit comparison. Cualquiera puede comparar versiones. Los editors y admins pueden restaurar versiones de páginas del sitio. Para las páginas del workspace, necesita el rol Editor o Full Access en la página para restaurar una versión. Restaurar una versión reemplaza el contenido actual de la página. Cuando restaura una página del sitio, solo se restaura en su branch actual. Cuando restaura una página del workspace, se restaura en todas las branches.

​
Páginas privadas

Las páginas privadas son borradores que viven en la sección Personal de la pestaña Workspace. Son privadas para usted, no se hacen commit en su repositorio y nunca aparecen en su sitio publicado a menos que las mueva a su sitio. Para crear una página o carpeta privada, haga clic en el botón más del encabezado de la sección Personal y luego seleccione New page o New folder. El botón New page de la parte inferior de la pestaña Workspace también crea una página privada. Para establecer un icono o un emoji en una carpeta del workspace, abra su menú de opciones y seleccione Change icon. Elija un icono en la pestaña Icons o un emoji en la pestaña Emojis, o seleccione Remove para quitarlo.

​
Compartir una página privada

Para compartir una página privada, ábrala y haga clic en Share en la barra superior. Para compartir una carpeta, abra su menú de opciones en la barra lateral y seleccione Share. Busque compañeros y seleccione un rol para cada uno:
  • Full Access: Editar, mover a su sitio y compartir.
  • Editor: Crear y editar contenido.
  • Viewer: Solo ver contenido.
En el acceso general, seleccione Only people invited o Everyone at su organización. Solo las personas con Full Access pueden cambiar quién tiene acceso. Las páginas compartidas con usted aparecen en Shared with me. Para quitar una página de su barra lateral, abra su menú de opciones y seleccione Leave.

​
Teamspace

Las páginas de teamspace están disponibles para toda su organización. Al igual que las páginas privadas, no se hacen commit en su repositorio. El acceso sigue su rol. Los editors y admins pueden editar y gestionar las páginas de teamspace, y los viewers pueden leerlas. Como todo el mundo ya tiene acceso, no puede compartir páginas individuales del teamspace. La sección Teamspace solo aparece en la barra lateral cuando contiene páginas o carpetas que alguien de su organización ha añadido. Mintlify la oculta cuando está vacía o solo contiene la carpeta y la guía de bienvenida predeterminadas. Para crear una página o carpeta de teamspace, haga clic en el botón más del encabezado de la sección Teamspace y luego seleccione New page o New folder.

​
Mover una página a su sitio

Para publicar una página personal o de teamspace, abra su menú de opciones en la barra lateral y seleccione Move to site. La página se mueve a su navegación, y la barra lateral cambia a Site y la resalta. Mover una carpeta la añade a su navegación como group, con todas sus páginas y su icono. La opción Move to site mueve hasta 20 páginas a la vez.
No puede mover páginas entre Personal y Teamspace. Mover una página a su sitio es un cambio de un solo sentido. No puede mover una página desde Site de vuelta a Workspace.

Temas relacionados

Escribir y editar con el agenteCrear diseños de página personalizadosCrear páginas de API manuales