Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions editor/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,14 +30,14 @@
## Editor layout

<Frame>
<img src="/images/editor/layout-light.png" alt="Screenshot of the editor with the Publishing tab selected." className="dark:hidden" />
<img src="/images/editor/layout-dark.png" alt="Screenshot of the editor with the Publishing tab selected." className="hidden dark:block" />
<img src="/images/editor/layout-light.png" alt="Screenshot of the editor with the Site tab selected." className="dark:hidden" />
<img src="/images/editor/layout-dark.png" alt="Screenshot of the editor with the Site tab selected." className="hidden dark:block" />
</Frame>

* **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
* **Sidebar**: Use the sidebar to select pages to edit, create new pages, and manage your site structure.
* **Home**: The file tree for your project. Pages in **Personal** are private to you. Pages in **Workspace** are public to your organization.
* **Publishing**: The navigation structure for your site. Organize pages as you want them to appear in your site.
* **Workspace**: Content that isn't part of your published site. **Personal** holds your private drafts. **Shared with me** holds pages others have shared with you.

Check warning on line 39 in editor/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/index.mdx#L39

Avoid first-person pronouns such as 'me'.
* **Site**: The pages your visitors see. **Navigation** is the ordered structure of your published site. **Hidden files** lists repository files whose pages aren't in your navigation.

## Visual and source mode

Expand Down
1 change: 1 addition & 0 deletions editor/keyboard-shortcuts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ These shortcuts work regardless of which mode you're in.
| **Toggle AI assistant** (when not editing text) | <kbd>Cmd</kbd> + <kbd>I</kbd> | <kbd>Ctrl</kbd> + <kbd>I</kbd> |
| **Switch between visual and source mode** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> |
| **Show all files** (including dotfiles and non-content files) | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> |
| **Move current page** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> |

## Visual mode

Expand Down
45 changes: 35 additions & 10 deletions editor/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,28 @@
keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---

## Home and Publishing
## Workspace and Site

Check warning on line 8 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L8

'Workspace and Site' should use sentence-style capitalization.

The editor workspace is split into two tabs: **Home** and **Publishing**.
The editor sidebar is split into two tabs: **Workspace** and **Site**.

Check warning on line 10 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L10

In general, use active voice instead of passive voice ('is split').

**Home** is your workspace. It shows the content files in your repository, including your private pages, whether or not they appear on your published site.
**Workspace** shows content that isn't part of your published site. It contains your **Personal** drafts and pages that others have **Shared with me**.

**Publishing** is your published site. It shows the navigation your visitors see, along with your site settings.
**Site** shows the pages your visitors see. **Navigation** is the ordered structure defined by `docs.json`. **Hidden files** lists repository files whose pages aren't in your navigation.

Switching tabs reopens the last page you viewed on that tab. **Share** appears on the top bar only on **Workspace**. **Preview**, the branch dropdown, and **Publish** appear only on **Site**.

{/* vale Mintlify.OxfordComma = NO */}
Home hides some files by default, including `docs.json`, files and folders whose names start with a dot, files with no extension, all-caps Markdown files like `README.md`, and `.css`, `.js`, `.jsx`, `.mjs`, `.cjs`, and `.pdf` files. To see all files, turn on [Show all files](/editor/settings) or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows).
Hidden files hides some files by default, including `docs.json`, files and folders whose names start with a dot, files with no extension, all-caps Markdown files like `README.md`, and `.css`, `.js`, `.jsx`, `.mjs`, `.cjs`, and `.pdf` files. To see all files, turn on [Show all files](/editor/settings) or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows).
{/* vale Mintlify.OxfordComma = YES */}

## Add and remove pages from your navigation

Drag a page from **Hidden files** into **Navigation** to add it at that position. Drag a folder to add it as a group. You can drag a multi-row selection and every selected item moves in document order.

Drag a page or group from **Navigation** into **Hidden files** to remove it from your navigation without deleting the file. You can also open the page's options menu in the navigation tree and select **Move to hidden files**. An undo toast appears after the move.

To promote a private page to your site, open its options menu and select **Move to site**, or drag it from **Personal** into **Navigation**. The sidebar switches to **Site** and highlights the new row. Promoting a private page is a one-way change.

## Create a page

To add a page to your navigation, click the <Icon icon="plus" /> plus button on the navigation element where you want it. Enter a name for your page. The editor adds the `.mdx` extension for you.
Expand All @@ -28,7 +38,7 @@
- Uploads save to your `images/` and `videos/` folders and commit with your next publish.
- Supported formats are PNG, JPG, JPEG, GIF, WebP, SVG, MP4, and WebM.
- To serve different images in light and dark mode, hover an inserted image and use **Light/dark variants**.
- Type <kbd>/embed</kbd> and paste a YouTube, Loom, or Vimeo URL to generate the iframe. For anything else, toggle **Manual embed** to write custom HTML.

Check warning on line 41 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L41

Avoid first-person pronouns such as 'me'.

For formatting images and using the Frame component, see [Images and embeds](/create/image-embeds).

Expand All @@ -42,11 +52,26 @@

To change a page's title, slug, description, or layout, open its settings from the navigation tree. See [Pages](/organize/pages) for more information on specific settings.

## Move a page

To move a page to a different folder, open its options menu and select **Move to**. A folder picker opens next to the menu, showing your workspace folders in the same order as the navigation tree.

You can open the options menu from:

- <Icon icon="ellipsis" /> **More options** in the top-right of an open page.
- The <Icon icon="ellipsis" /> menu next to a page in the navigation tree.
- Right-clicking a page in the navigation tree.
- Pressing <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows) with the page open.

In the picker, search to filter folders, expand folders to see nested destinations, and select a folder to move the page. The current folder is muted and can't be selected.

Check warning on line 66 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L66

In general, use active voice instead of passive voice ('is muted').

Check warning on line 66 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L66

In general, use active voice instead of passive voice ('be selected').

Moving a site page updates its file path and its position in the navigation. Moving a private page reparents it in your **Personal** section. Editors and admins can move site pages. You can move private pages you own.

Check warning on line 68 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L68

Did you really mean 'reparents'?

## Delete a page

To delete a page, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then click **Move to trash**. You can also delete a page from its options menu in the navigation tree. For private pages, the menu shows **Delete page**.

Deleting a page removes both the file and its navigation entry. To remove a page from your published navigation without deleting its file, select **Remove from publishing** in the page's options menu in the navigation tree.
Deleting a page removes both the file and its navigation entry. To remove a page from your published navigation without deleting its file, select **Move to hidden files** in the page's options menu.

Editors and admins can delete pages.

Expand All @@ -60,16 +85,16 @@

To view version history, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then click **Version history**.

If you restore a version, it overwrites any unsaved changes you made to the page. When you restore a public page, it is only restored on your current branch. When you restore a private page, it is restored on all branches.

Check warning on line 88 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L88

In general, use active voice instead of passive voice ('is restored').

## Private pages

Private pages are drafts that live in the **Personal** section of the **Home** tab. They are private to you, are not committed to your repository, and never appear on your published site.
Private pages are drafts that live in the **Personal** section of the **Workspace** tab. They are private to you, are not committed to your repository, and never appear on your published site.

To create a private page or folder, click the <Icon icon="plus" /> plus button on the **Personal** section header, then select **New page** or **New folder**.
To create a private page or folder, click the <Icon icon="plus" /> plus button on the **Personal** section header, then select **New page** or **New folder**. The **New page** button at the bottom of the **Workspace** tab also creates a private page.

Dragging a private page or folder into your workspace makes it available to your collaborators immediately, though it is not added to your site navigation.
To promote a private page to your site, open its options menu and select **Move to site**, or drag it into **Navigation** on the **Site** tab.

<Warning>
You can't move workspace content back to the **Personal** section. Making a private page public is a one-way change.
You can't move a page back to the **Personal** section after you promote it. Making a private page public is a one-way change.
</Warning>
8 changes: 4 additions & 4 deletions es/editor/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,14 @@ El editor se carga de forma predeterminada cuando abre su [dashboard](https://ap
</div>

<Frame>
<img src="/images/editor/layout-light.png" alt="Captura de pantalla del editor con la pestaña Publishing seleccionada." className="dark:hidden" />
<img src="/images/editor/layout-dark.png" alt="Captura de pantalla del editor con la pestaña Publishing seleccionada." className="hidden dark:block" />
<img src="/images/editor/layout-light.png" alt="Captura de pantalla del editor con la pestaña Site seleccionada." className="dark:hidden" />
<img src="/images/editor/layout-dark.png" alt="Captura de pantalla del editor con la pestaña Site seleccionada." className="hidden dark:block" />
</Frame>

* **Barra superior**: Use la barra superior para controlar en qué branch trabaja, acceder al agente, previsualizar y publicar cambios.
* **Barra lateral**: Use la barra lateral para seleccionar páginas que editar, crear páginas nuevas y gestionar la estructura de su sitio.
* **Home**: El árbol de archivos de su proyecto. Las páginas en **Personal** son privadas para usted. Las páginas en **Workspace** son públicas para su organización.
* **Publishing**: La estructura de navegación de su sitio. Organice las páginas como quiere que aparezcan en su sitio.
* **Workspace**: Contenido que no forma parte de su sitio publicado. **Personal** contiene sus borradores privados. **Shared with me** contiene páginas que otras personas han compartido con usted.
* **Site**: Las páginas que ven sus visitantes. **Navigation** es la estructura ordenada de su sitio publicado. **Hidden files** enumera los archivos del repositorio cuyas páginas no están en su navegación.

<div id="visual-and-source-mode">

Expand Down
1 change: 1 addition & 0 deletions es/editor/keyboard-shortcuts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Estos atajos funcionan sea cual sea el modo en el que esté.
| **Mostrar u ocultar el asistente de IA** (cuando no está editando texto) | <kbd>Cmd</kbd> + <kbd>I</kbd> | <kbd>Ctrl</kbd> + <kbd>I</kbd> |
| **Cambiar entre el modo visual y el modo source** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> |
| **Mostrar todos los archivos** (incluidos los dotfiles y los archivos que no son de contenido) | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> |
| **Mover la página actual** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> |

<div id="visual-mode">

Expand Down
55 changes: 44 additions & 11 deletions es/editor/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,21 @@ description: "Cree páginas, edite contenido, añada multimedia, organice la nav
keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
---

<div id="home-and-publishing">
<div id="workspace-and-site">

## Home y Publishing
## Workspace y Site

</div>

El espacio de trabajo del editor se divide en dos pestañas: **Home** y **Publishing**.
La barra lateral del editor se divide en dos pestañas: **Workspace** y **Site**.

**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.
**Workspace** muestra el contenido que no forma parte de su sitio publicado. Contiene sus borradores en **Personal** y las páginas que otras personas han compartido con usted en **Shared with me**.

**Publishing** es su sitio publicado. Muestra la navegación que ven sus visitantes, junto con la configuración de su sitio.
**Site** muestra las páginas que ven sus visitantes. **Navigation** es la estructura ordenada definida por `docs.json`. **Hidden files** enumera los archivos del repositorio cuyas páginas no están en su navegación.

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](/es/editor/settings#appearance) o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows).
Cambiar de pestaña vuelve a abrir la última página que consultó en esa pestaña. **Share** aparece en la barra superior solo en **Workspace**. **Preview**, el menú desplegable de branches y **Publish** aparecen solo en **Site**.

Hidden files 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](/es/editor/settings#appearance) o presione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows).

<div id="create-a-page">

Expand Down Expand Up @@ -56,6 +58,37 @@ Arrastre elementos en la vista Navigation para reordenarlos o anidarlos. El edit

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](/es/organize/pages) para obtener más información sobre cada ajuste.

<div id="add-and-remove-pages-from-your-navigation">

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

</div>

Arrastre una página desde **Hidden files** hasta **Navigation** para añadirla en esa posición. Arrastre una carpeta para añadirla como un grupo. Puede arrastrar una selección de varias filas y todos los elementos seleccionados se moverán en el orden del documento.

Arrastre una página o un grupo desde **Navigation** hasta **Hidden files** para quitarla de su navegación sin eliminar el archivo. También puede abrir el menú de opciones de la página en el árbol de navegación y seleccionar **Move to hidden files**. Aparece un aviso de deshacer después del movimiento.

Para promover una página privada a su sitio, abra su menú de opciones y seleccione **Move to site**, o arrástrela desde **Personal** hasta **Navigation**. La barra lateral cambia a **Site** y resalta la nueva fila. Promover una página privada es un cambio irreversible.

<div id="move-a-page">

## Mover una página

</div>

Para mover una página a otra carpeta, abra su menú de opciones y seleccione **Move to**. Se abre un selector de carpetas junto al menú, que muestra las carpetas de su workspace en el mismo orden que el árbol de navegación.

Puede abrir el menú de opciones desde:

- <Icon icon="ellipsis" /> **More options** en la esquina superior derecha de una página abierta.
- El menú <Icon icon="ellipsis" /> junto a una página en el árbol de navegación.
- Haciendo clic derecho en una página del árbol de navegación.
- Presionando <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows) con la página abierta.

En el selector, busque para filtrar carpetas, expanda carpetas para ver los destinos anidados y seleccione una carpeta para mover la página. La carpeta actual aparece atenuada y no se puede seleccionar.

Mover una página del sitio actualiza su ruta de archivo y su posición en la navegación. Mover una página privada la reubica dentro de su sección **Personal**. Los editors y admins pueden mover páginas del sitio. Puede mover las páginas privadas de las que es propietario.

<div id="delete-a-page">

## Eliminar una página
Expand All @@ -66,7 +99,7 @@ Para eliminar una página, haga clic en <Icon icon="ellipsis" /> **More options*

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.
Para quitar una página de su navegación publicada sin eliminar su archivo, seleccione **Move to hidden files** en el menú de opciones de la página.

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.

Expand All @@ -92,12 +125,12 @@ Si restaura una versión, se sobrescriben los cambios sin guardar que haya hecho

</div>

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

Para crear una página o carpeta privada, haga clic en el botón <Icon icon="plus" /> más de la cabecera de la sección **Personal** y luego seleccione **New page** o **New folder**.
Para crear una página o carpeta privada, haga clic en el botón <Icon icon="plus" /> más de la cabecera 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.

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.
Para promover una página privada a su sitio, abra su menú de opciones y seleccione **Move to site**, o arrástrela hasta **Navigation** en la pestaña **Site**.

<Warning>
No puede mover contenido del workspace de vuelta a la sección **Personal**. Hacer pública una página privada es un cambio irreversible.
No puede mover una página de vuelta a la sección **Personal** después de promoverla. Hacer pública una página privada es un cambio irreversible.
</Warning>
Loading