Crear y editar páginas

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 y shared with me 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.

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.

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.

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.

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.
• 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.

Arrastre elementos en Navigation para reordenarlos o anidarlos. El editor escribe sus cambios en docs.json cuando publica.

Para seleccionar varios elementos, haga Shift-clic para seleccionar un intervalo. 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 settings en la parte inferior de la pestaña Site y luego vaya a Navigation.

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.

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.
• Otros archivos, como fuentes y comprimidos, no se pueden previsualizar en el editor.

Para subir archivos, arrástrelos desde su equipo hasta la sección Files.

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. La carpeta actual está marcada como Current y no puede seleccionarse. Aparece un aviso con Revert después del movimiento.

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.

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.

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 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 actual.

1. Haga clic en More options en la esquina superior derecha de la página y luego en Version history.
2. Seleccione una versión. El editor muestra en qué se diferencia la página actual de esa versión.
3. Para restaurarla, haga clic en Restore this version y luego confirme.

Para salir de la comparación, haga clic en Exit comparison o presione Cmd + Shift + D (macOS) o Ctrl + Shift + D (Windows).

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 Publisher 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.

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.

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 elija un rol para cada uno:

• Publisher: Editar, revisar y publicar.
• Editor: Crear y editar contenido.
• Viewer: Solo ver contenido.

En el acceso general, elija Only people invited o Everyone at su organización. Solo los Publishers 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.

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.

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.

Para mover una página privada al teamspace, arrástrela desde Personal hasta Teamspace o abra su menú de opciones, seleccione Move to y elija Teamspace. Puede mover páginas, pero no carpetas.

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.