El espacio de trabajo del editor se divide en dos pestañas: Home y Publishing.Home es su espacio de trabajo. Muestra los archivos de contenido de su repositorio, incluidas sus páginas privadas, aparezcan o no en su sitio publicado.Publishing es su sitio publicado. Muestra la navegación que ven sus visitantes, junto con la configuración de su sitio.Home oculta algunos archivos de forma predeterminada, entre ellos docs.json, los archivos y carpetas cuyo nombre empieza por un punto, los archivos sin extensión, los archivos Markdown en mayúsculas como README.md y los archivos .css, .js, .jsx, .mjs, .cjs y .pdf. Para ver todos los archivos, active Show all files o presione Cmd + Shift + . (macOS) o Ctrl + Shift + . (Windows).
Para añadir una página a su navegación, haga clic en el botón más del elemento de navegación donde la quiere. Escriba un nombre para su página. El editor añade la extensión .mdx por usted.
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. Para reutilizar un archivo multimedia, arrastre una imagen o un vídeo desde el árbol de navegación hasta una página.
Los archivos subidos se guardan en sus carpetas images/ y videos/ y se incluyen en el commit de su próxima publicación.
Los formatos admitidos son PNG, JPG, JPEG, GIF, WebP, SVG, MP4 y WebM.
Para mostrar imágenes distintas en modo claro y oscuro, pase el cursor sobre una imagen insertada y use Light/dark variants.
Escriba /embed y pegue una URL de YouTube, Loom o Vimeo para generar el iframe. Para cualquier otro caso, active Manual embed y escriba HTML personalizado.
Arrastre elementos en la vista Navigation para reordenarlos o anidarlos. El editor escribe sus cambios en docs.json cuando publica. Para saber qué hace cada elemento de navegación, incluidos groups, tabs, anchors, dropdowns, menus, products, versions y languages, consulte Navegación.
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 cambiar el título, el slug, la descripción o el layout de una página, abra su configuración desde el árbol de navegación. Consulte Páginas para obtener más información sobre cada ajuste.
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 el árbol de navegación.Eliminar una página elimina tanto el archivo como su entrada de navegación. A pesar de la etiqueta Move to trash, no hay una vista de papelera desde la que restaurar páginas. Si elimina una página por error, use el aviso de deshacer que aparece después de eliminarla. La eliminación se hace commit en su repositorio cuando publica, así que después de publicar solo puede restaurar la página desde el historial de su repositorio.Para quitar una página de su navegación publicada sin eliminar su archivo, seleccione Remove from publishing en el menú de opciones de la página en el árbol de navegación.Los viewers no pueden eliminar páginas. Para las páginas privadas, el menú muestra Delete page en su lugar, y la eliminación es inmediata porque las páginas privadas no se hacen commit en su repositorio.
El historial de versiones le permite revisar y restaurar versiones guardadas anteriores de una página. No está disponible para docs.json.Los viewers pueden revisar y comparar las versiones guardadas de las páginas privadas. Los editors y admins pueden restaurarlas.El editor registra una entrada nueva siempre que el contenido difiere de la última versión registrada. El historial de versiones está limitado a la branch actual. Solo está disponible el historial de la branch en la que trabaja.Para ver el historial de versiones, haga clic en More options en la esquina superior derecha de la página y luego en Version history.Si restaura una versión, se sobrescriben los cambios sin guardar que haya hecho en la página. Cuando restaura una página pública, solo se restaura en su branch actual. Cuando restaura una página privada, se restaura en todas las branches.
Las páginas privadas son borradores que viven en la sección Personal de la pestaña Home. Son privadas para usted, no se hacen commit en su repositorio y nunca aparecen en su sitio publicado.Para crear una página o carpeta privada, haga clic en el botón más de la cabecera de la sección Personal y luego seleccione New page o New folder.Arrastrar una página o carpeta privada a su workspace la pone a disposición de sus colaboradores de inmediato, aunque no se añade a la navegación de su sitio.
No puede mover contenido del workspace de vuelta a la sección Personal. Hacer pública una página privada es un cambio irreversible.
