diff --git a/editor/index.mdx b/editor/index.mdx index c61fa023d..1a9147bff 100644 --- a/editor/index.mdx +++ b/editor/index.mdx @@ -30,14 +30,14 @@ The editor loads by default when you open your [dashboard](https://app.mintlify. ## Editor layout - Screenshot of the editor with the Publishing tab selected. - Screenshot of the editor with the Publishing tab selected. + Screenshot of the editor with the Site tab selected. + Screenshot of the editor with the Site tab selected. * **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. + * **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 diff --git a/editor/keyboard-shortcuts.mdx b/editor/keyboard-shortcuts.mdx index 4d05cb5ff..d5b87b1c6 100644 --- a/editor/keyboard-shortcuts.mdx +++ b/editor/keyboard-shortcuts.mdx @@ -16,6 +16,7 @@ These shortcuts work regardless of which mode you're in. | **Toggle AI assistant** (when not editing text) | Cmd + I | Ctrl + I | | **Switch between visual and source mode** | Cmd + Shift + S | Ctrl + Shift + S | | **Show all files** (including dotfiles and non-content files) | Cmd + Shift + . | Ctrl + Shift + . | +| **Move current page** | Cmd + Shift + P | Ctrl + Shift + P | ## Visual mode diff --git a/editor/pages.mdx b/editor/pages.mdx index 0f74d15b6..63b82101d 100644 --- a/editor/pages.mdx +++ b/editor/pages.mdx @@ -5,18 +5,28 @@ description: "Create pages, edit content, add media, organize your navigation, r keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"] --- -## Home and Publishing +## Workspace and Site -The editor workspace is split into two tabs: **Home** and **Publishing**. +The editor sidebar is split into two tabs: **Workspace** and **Site**. -**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 Cmd + Shift + . (macOS) or Ctrl + Shift + . (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 Cmd + Shift + . (macOS) or Ctrl + Shift + . (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 plus button on the navigation element where you want it. Enter a name for your page. The editor adds the `.mdx` extension for you. @@ -42,11 +52,26 @@ Drag elements in the Navigation view to reorder or nest them. The editor writes 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: + +- **More options** in the top-right of an open page. +- The menu next to a page in the navigation tree. +- Right-clicking a page in the navigation tree. +- Pressing Cmd + Shift + P (macOS) or Ctrl + Shift + P (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. + +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. + ## Delete a page To delete a page, click **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. @@ -64,12 +89,12 @@ If you restore a version, it overwrites any unsaved changes you made to the page ## 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 plus button on the **Personal** section header, then select **New page** or **New folder**. +To create a private page or folder, click the 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. - 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. diff --git a/es/editor/index.mdx b/es/editor/index.mdx index 192766a69..5dbc6ba6f 100644 --- a/es/editor/index.mdx +++ b/es/editor/index.mdx @@ -38,14 +38,14 @@ El editor se carga de forma predeterminada cuando abre su [dashboard](https://ap - Captura de pantalla del editor con la pestaña Publishing seleccionada. - Captura de pantalla del editor con la pestaña Publishing seleccionada. + Captura de pantalla del editor con la pestaña Site seleccionada. + Captura de pantalla del editor con la pestaña Site seleccionada. * **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.
diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx index 21b1e6586..a9293e378 100644 --- a/es/editor/keyboard-shortcuts.mdx +++ b/es/editor/keyboard-shortcuts.mdx @@ -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) | Cmd + I | Ctrl + I | | **Cambiar entre el modo visual y el modo source** | Cmd + Shift + S | Ctrl + Shift + S | | **Mostrar todos los archivos** (incluidos los dotfiles y los archivos que no son de contenido) | Cmd + Shift + . | Ctrl + Shift + . | +| **Mover la página actual** | Cmd + Shift + P | Ctrl + Shift + P |
diff --git a/es/editor/pages.mdx b/es/editor/pages.mdx index a202244d2..c0fc06e4b 100644 --- a/es/editor/pages.mdx +++ b/es/editor/pages.mdx @@ -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"] --- -
+
-## Home y Publishing +## Workspace y Site
-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 Cmd + Shift + . (macOS) o Ctrl + Shift + . (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 Cmd + Shift + . (macOS) o Ctrl + Shift + . (Windows).
@@ -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. +
+ +## Añadir y quitar páginas de su navegación + +
+ +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. + +
+ +## Mover una página + +
+ +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: + +- **More options** en la esquina superior derecha de una página abierta. +- El menú junto a una página en el árbol de navegación. +- Haciendo clic derecho en una página del árbol de navegación. +- Presionando Cmd + Shift + P (macOS) o Ctrl + Shift + P (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. +
## Eliminar una página @@ -66,7 +99,7 @@ Para eliminar una página, haga clic en **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. @@ -92,12 +125,12 @@ Si restaura una versión, se sobrescriben los cambios sin guardar que haya hecho
-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 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 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**. - 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. diff --git a/fr/editor/index.mdx b/fr/editor/index.mdx index 570f05416..e014210d5 100644 --- a/fr/editor/index.mdx +++ b/fr/editor/index.mdx @@ -38,14 +38,14 @@ L'éditeur se charge par défaut lorsque vous ouvrez votre [dashboard](https://a
- Capture d'écran de l'éditeur avec l'onglet Publishing sélectionné. - Capture d'écran de l'éditeur avec l'onglet Publishing sélectionné. + Capture d'écran de l'éditeur avec l'onglet Site sélectionné. + Capture d'écran de l'éditeur avec l'onglet Site sélectionné. * **Barre supérieure** : Utilisez la barre supérieure pour choisir la branch sur laquelle vous travaillez, accéder à l'agent, prévisualiser et publier vos modifications. * **Barre latérale** : Utilisez la barre latérale pour sélectionner les pages à modifier, créer de nouvelles pages et gérer la structure de votre site. - * **Home** : L'arborescence de fichiers de votre projet. Les pages dans **Personal** vous sont privées. Les pages dans **Workspace** sont publiques pour votre organisation. - * **Publishing** : La structure de navigation de votre site. Organisez les pages telles que vous voulez qu'elles apparaissent sur votre site. + * **Workspace** : Contenu qui ne fait pas partie de votre site publié. **Personal** contient vos brouillons privés. **Shared with me** contient les pages que d'autres personnes ont partagées avec vous. + * **Site** : Les pages que voient vos visiteurs. **Navigation** est la structure ordonnée de votre site publié. **Hidden files** liste les fichiers du dépôt dont les pages ne figurent pas dans votre navigation.
diff --git a/fr/editor/keyboard-shortcuts.mdx b/fr/editor/keyboard-shortcuts.mdx index d2d411214..34cbf7f51 100644 --- a/fr/editor/keyboard-shortcuts.mdx +++ b/fr/editor/keyboard-shortcuts.mdx @@ -20,6 +20,7 @@ Ces raccourcis fonctionnent quel que soit le mode dans lequel vous vous trouvez. | **Afficher ou masquer l'assistant d'IA** (hors saisie de texte) | Cmd + I | Ctrl + I | | **Basculer entre le mode visuel et le mode source** | Cmd + Shift + S | Ctrl + Shift + S | | **Afficher tous les fichiers** (y compris les dotfiles et les fichiers hors contenu) | Cmd + Shift + . | Ctrl + Shift + . | +| **Déplacer la page en cours** | Cmd + Shift + P | Ctrl + Shift + P |
diff --git a/fr/editor/pages.mdx b/fr/editor/pages.mdx index 688089b75..8ff7b5fd2 100644 --- a/fr/editor/pages.mdx +++ b/fr/editor/pages.mdx @@ -5,19 +5,33 @@ description: "Créez et modifiez des pages, ajoutez des médias, organisez la na keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"] --- -
+
-## Home et Publishing +## Workspace et Site
-L'espace de travail de l'éditeur est divisé en deux onglets : **Home** et **Publishing**. +La barre latérale de l'éditeur est divisée en deux onglets : **Workspace** et **Site**. -**Home** est votre espace de travail. Il affiche les fichiers de contenu de votre dépôt, y compris vos pages privées, qu'elles apparaissent ou non sur votre site publié. +**Workspace** affiche le contenu qui ne fait pas partie de votre site publié. Il contient vos brouillons **Personal** et les pages que d'autres ont partagées dans **Shared with me**. -**Publishing** est votre site publié. Il affiche la navigation que voient vos visiteurs, ainsi que les paramètres de votre site. +**Site** affiche les pages que voient vos visiteurs. **Navigation** est la structure ordonnée définie par `docs.json`. **Hidden files** liste les fichiers du dépôt dont les pages ne figurent pas dans votre navigation. -Home masque certains fichiers par défaut, notamment `docs.json`, les fichiers et dossiers dont le nom commence par un point, les fichiers sans extension, les fichiers Markdown en majuscules comme `README.md`, ainsi que les fichiers `.css`, `.js`, `.jsx`, `.mjs`, `.cjs` et `.pdf`. Pour afficher tous les fichiers, activez [Show all files](/fr/editor/settings#appearance) ou appuyez sur Cmd + Shift + . (macOS) ou Ctrl + Shift + . (Windows). +Le changement d'onglet rouvre la dernière page que vous avez consultée dans cet onglet. **Share** n'apparaît dans la barre supérieure que sur **Workspace**. **Preview**, la liste déroulante des branches et **Publish** n'apparaissent que sur **Site**. + +Hidden files masque certains fichiers par défaut, notamment `docs.json`, les fichiers et dossiers dont le nom commence par un point, les fichiers sans extension, les fichiers Markdown en majuscules comme `README.md`, ainsi que les fichiers `.css`, `.js`, `.jsx`, `.mjs`, `.cjs` et `.pdf`. Pour afficher tous les fichiers, activez [Show all files](/fr/editor/settings#appearance) ou appuyez sur Cmd + Shift + . (macOS) ou Ctrl + Shift + . (Windows). + +
+ +## Ajouter et retirer des pages de votre navigation + +
+ +Faites glisser une page depuis **Hidden files** dans **Navigation** pour l'ajouter à cette position. Faites glisser un dossier pour l'ajouter en tant que group. Vous pouvez faire glisser une sélection multi-lignes et tous les éléments sélectionnés se déplacent dans l'ordre du document. + +Faites glisser une page ou un group depuis **Navigation** dans **Hidden files** pour la retirer de votre navigation sans supprimer le fichier. Vous pouvez aussi ouvrir le menu d'options de la page dans l'arborescence de navigation et sélectionner **Move to hidden files**. Une invite d'annulation apparaît après le déplacement. + +Pour promouvoir une page privée sur votre site, ouvrez son menu d'options et sélectionnez **Move to site**, ou faites-la glisser depuis **Personal** dans **Navigation**. La barre latérale bascule sur **Site** et met en surbrillance la nouvelle ligne. Promouvoir une page privée est un changement irréversible.
@@ -56,6 +70,25 @@ Faites glisser des éléments dans la vue Navigation pour les réordonner ou les Pour modifier le titre, le slug, la description ou le layout d'une page, ouvrez ses paramètres depuis l'arborescence de navigation. Consultez [Pages](/fr/organize/pages) pour plus d'informations sur chaque paramètre. +
+ +## Déplacer une page + +
+ +Pour déplacer une page vers un autre dossier, ouvrez son menu d'options et sélectionnez **Move to**. Un sélecteur de dossiers s'ouvre à côté du menu, affichant les dossiers de votre workspace dans le même ordre que l'arborescence de navigation. + +Vous pouvez ouvrir le menu d'options depuis : + +- **More options** en haut à droite d'une page ouverte. +- Le menu à côté d'une page dans l'arborescence de navigation. +- Un clic droit sur une page dans l'arborescence de navigation. +- Cmd + Shift + P (macOS) ou Ctrl + Shift + P (Windows) avec la page ouverte. + +Dans le sélecteur, recherchez pour filtrer les dossiers, développez les dossiers pour voir les destinations imbriquées, puis sélectionnez un dossier pour déplacer la page. Le dossier actuel est atténué et ne peut pas être sélectionné. + +Déplacer une page du site met à jour son chemin de fichier et sa position dans la navigation. Déplacer une page privée la réattache dans votre section **Personal**. Les editors et les admins peuvent déplacer les pages du site. Vous pouvez déplacer les pages privées dont vous êtes propriétaire. +
## Supprimer une page @@ -66,7 +99,7 @@ Pour supprimer une page, cliquez sur **More options** e La suppression d'une page supprime à la fois le fichier et son entrée de navigation. Malgré le libellé **Move to trash**, il n'existe pas de vue corbeille permettant de restaurer des pages. Si vous supprimez une page par erreur, utilisez l'invite d'annulation qui apparaît après la suppression. La suppression est commitée dans votre dépôt lorsque vous publiez : après la publication, vous ne pouvez restaurer la page qu'à partir de l'historique de votre dépôt. -Pour retirer une page de votre navigation publiée sans supprimer son fichier, sélectionnez **Remove from publishing** dans le menu d'options de la page dans l'arborescence de navigation. +Pour retirer une page de votre navigation publiée sans supprimer son fichier, sélectionnez **Move to hidden files** dans le menu d'options de la page. Les viewers ne peuvent pas supprimer de pages. Pour les pages privées, le menu affiche **Delete page** à la place, et la suppression est immédiate car les pages privées ne sont pas commitées dans votre dépôt. @@ -92,12 +125,12 @@ Si vous restaurez une version, cela écrase les modifications non enregistrées
-Les pages privées sont des brouillons qui se trouvent dans la section **Personal** de l'onglet **Home**. Elles vous sont privées, ne sont pas commitées dans votre dépôt et n'apparaissent jamais sur votre site publié. +Les pages privées sont des brouillons qui se trouvent dans la section **Personal** de l'onglet **Workspace**. Elles vous sont privées, ne sont pas commitées dans votre dépôt et n'apparaissent jamais sur votre site publié. -Pour créer une page ou un dossier privé, cliquez sur le bouton plus sur l'en-tête de la section **Personal**, puis sélectionnez **New page** ou **New folder**. +Pour créer une page ou un dossier privé, cliquez sur le bouton plus sur l'en-tête de la section **Personal**, puis sélectionnez **New page** ou **New folder**. Le bouton **New page** en bas de l'onglet **Workspace** crée également une page privée. -Faire glisser une page ou un dossier privé dans votre workspace le met immédiatement à la disposition de vos collaborateurs, sans pour autant l'ajouter à la navigation de votre site. +Pour promouvoir une page privée sur votre site, ouvrez son menu d'options et sélectionnez **Move to site**, ou faites-la glisser dans **Navigation** sur l'onglet **Site**. - Vous ne pouvez pas ramener du contenu du workspace vers la section **Personal**. Rendre publique une page privée est un changement irréversible. + Vous ne pouvez pas ramener une page vers la section **Personal** après l'avoir promue. Rendre publique une page privée est un changement irréversible. diff --git a/zh/editor/index.mdx b/zh/editor/index.mdx index aa4c8795a..4c55e443e 100644 --- a/zh/editor/index.mdx +++ b/zh/editor/index.mdx @@ -38,14 +38,14 @@ keywords: ["web editor", "git", "branches", "commits", "pull requests"]
- 编辑器的屏幕截图，其中选中了 Publishing 标签页。 - 编辑器的屏幕截图，其中选中了 Publishing 标签页。 + 编辑器的屏幕截图，其中选中了 Site 标签页。 + 编辑器的屏幕截图，其中选中了 Site 标签页。 * **顶部栏**：使用顶部栏选择你要工作的分支、使用智能体、预览和发布更改。 * **侧边栏**：使用侧边栏选择要编辑的页面、创建新页面并管理站点结构。 - * **Home**：项目的文件树。**Personal** 中的页面仅你自己可见。**Workspace** 中的页面对你的组织公开。 - * **Publishing**：站点的导航结构。按照你希望页面在站点上呈现的方式来组织它们。 + * **Workspace**：不属于已发布站点的内容。**Personal** 存放你的私有草稿。**Shared with me** 存放他人与你共享的页面。 + * **Site**：访客看到的页面。**Navigation** 是已发布站点的有序结构。**Hidden files** 列出仓库中页面未包含在导航中的文件。
diff --git a/zh/editor/keyboard-shortcuts.mdx b/zh/editor/keyboard-shortcuts.mdx index ca6037d12..ba4ed0645 100644 --- a/zh/editor/keyboard-shortcuts.mdx +++ b/zh/editor/keyboard-shortcuts.mdx @@ -20,6 +20,7 @@ keywords: ["editor", "keys", "keyboard", "shortcuts"] | **显示或隐藏 AI 助手**（未在编辑文本时） | Cmd + I | Ctrl + I | | **在可视化模式与 source 模式之间切换** | Cmd + Shift + S | Ctrl + Shift + S | | **显示全部文件**（包括 dotfile 和非内容文件） | Cmd + Shift + . | Ctrl + Shift + . | +| **移动当前页面** | Cmd + Shift + P | Ctrl + Shift + P |
diff --git a/zh/editor/pages.mdx b/zh/editor/pages.mdx index 4eeaa3664..6452c3289 100644 --- a/zh/editor/pages.mdx +++ b/zh/editor/pages.mdx @@ -5,19 +5,21 @@ description: "在编辑器中创建页面、编辑内容、添加媒体、组织 keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"] --- -
+
-## Home 与 Publishing +## Workspace 与 Site
-编辑器工作区分为两个标签页：**Home** 和 **Publishing**。 +编辑器侧边栏分为两个标签页：**Workspace** 和 **Site**。 -**Home** 是你的工作区，显示仓库中的内容文件，包括你的私有页面，无论它们是否出现在已发布的站点上。 +**Workspace** 显示不属于已发布站点的内容。它包含你的 **Personal** 草稿，以及他人 **Shared with me** 的页面。 -**Publishing** 是你已发布的站点，显示访问者看到的导航以及站点设置。 +**Site** 显示访问者看到的页面。**Navigation** 是由 `docs.json` 定义的有序结构。**Hidden files** 列出仓库中未包含在导航里的文件。 -Home 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文件和文件夹、没有扩展名的文件、像 `README.md` 这样的全大写 Markdown 文件，以及 `.css`、`.js`、`.jsx`、`.mjs`、`.cjs` 和 `.pdf` 文件。若要查看全部文件，请启用 [Show all files](/zh/editor/settings#appearance)，或按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）。 +切换标签页会重新打开你在该标签页上次查看的页面。**Share** 仅在 **Workspace** 的顶部栏中显示。**Preview**、分支下拉菜单和 **Publish** 仅在 **Site** 中显示。 + +Hidden files 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文件和文件夹、没有扩展名的文件、像 `README.md` 这样的全大写 Markdown 文件，以及 `.css`、`.js`、`.jsx`、`.mjs`、`.cjs` 和 `.pdf` 文件。若要查看全部文件，请启用 [Show all files](/zh/editor/settings#appearance)，或按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）。
@@ -56,6 +58,37 @@ Home 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文 若要修改页面的标题、slug、描述或 layout，请从导航树中打开该页面的设置。有关各项设置的更多信息，请参阅[页面](/zh/organize/pages)。 +
+ +## 在导航中添加和移除页面 + +
+ +把 **Hidden files** 中的页面拖到 **Navigation** 中，即可在拖放位置添加它。拖动文件夹会把它作为一个 group 添加。你可以拖动多行选择，所有被选中的项会按文档顺序一起移动。 + +把 **Navigation** 中的页面或 group 拖到 **Hidden files** 中，即可在不删除文件的情况下将其从导航中移除。你也可以在导航树中打开页面的选项菜单，然后选择 **Move to hidden files**。移动后会显示一个撤销提示。 + +若要把私有页面提升到你的站点，请打开其选项菜单并选择 **Move to site**，或者把它从 **Personal** 拖到 **Navigation**。侧边栏会切换到 **Site** 并高亮显示新添加的行。将私有页面提升为公开是不可逆的操作。 + +
+ +## 移动页面 + +
+ +若要将页面移动到其他文件夹，请打开其选项菜单并选择 **Move to**。菜单旁会打开一个文件夹选择器，按导航树相同的顺序显示你的 workspace 文件夹。 + +你可以从以下位置打开选项菜单： + +- 已打开页面右上角的 **More options**。 +- 导航树中页面旁的 菜单。 +- 在导航树中右键点击页面。 +- 在页面打开时按 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows）。 + +在选择器中，通过搜索筛选文件夹、展开文件夹以查看嵌套目标，然后选择一个文件夹来移动页面。当前文件夹会以浅色显示，无法被选中。 + +移动站点页面会更新其文件路径及其在导航中的位置。移动私有页面会在你的 **Personal** 区中重新归位。Editors 和 admins 可以移动站点页面。你可以移动你所拥有的私有页面。 +
## 删除页面 @@ -66,7 +99,7 @@ Home 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文 删除页面会同时移除文件及其导航条目。尽管菜单项名为 **Move to trash**，但并没有可用于恢复页面的回收站视图。如果误删了页面，请使用删除后出现的撤销提示。删除操作会在你发布时提交到你的仓库，因此发布之后只能从仓库的历史记录中恢复该页面。 -若要在不删除文件的情况下把页面从已发布的导航中移除，请在导航树中该页面的选项菜单里选择 **Remove from publishing**。 +若要在不删除文件的情况下把页面从已发布的导航中移除，请在页面的选项菜单里选择 **Move to hidden files**。 Viewers 无法删除页面。对于私有页面，菜单会显示 **Delete page**，并且删除会立即生效，因为私有页面不会提交到你的仓库。 @@ -92,12 +125,12 @@ Viewers 可以查看和比较私有页面的已保存版本。Editors 和 admins
-私有页面是位于 **Home** 标签页 **Personal** 分区中的草稿。它们仅你自己可见，不会提交到你的仓库，也永远不会出现在已发布的站点上。 +私有页面是位于 **Workspace** 标签页 **Personal** 分区中的草稿。它们仅你自己可见，不会提交到你的仓库，也永远不会出现在已发布的站点上。 -若要创建私有页面或文件夹，请点击 **Personal** 分区标题上的 加号按钮，然后选择 **New page** 或 **New folder**。 +若要创建私有页面或文件夹，请点击 **Personal** 分区标题上的 加号按钮，然后选择 **New page** 或 **New folder**。**Workspace** 标签页底部的 **New page** 按钮同样会创建一个私有页面。 -把私有页面或文件夹拖入 workspace 后，协作者会立即可以访问它，但它不会被添加到站点导航中。 +若要把私有页面提升到你的站点，请打开其选项菜单并选择 **Move to site**，或者把它拖到 **Site** 标签页的 **Navigation** 中。 - 你无法把 workspace 中的内容移回 **Personal** 分区。把私有页面变为公开是不可逆的操作。 + 在你把页面提升为公开之后，就无法再把它移回 **Personal** 分区。把私有页面变为公开是不可逆的操作。