From 0ce025cd4be079e22e05d70d130cde874ad2eccd Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 5 Sep 2026 08:00:11 +0000 Subject: [PATCH 1/2] docs: update editor sidebar docs for Markdown-only default --- editor/keyboard-shortcuts.mdx | 2 +- editor/pages.mdx | 4 ++-- editor/settings.mdx | 2 +- es/editor/keyboard-shortcuts.mdx | 2 +- es/editor/pages.mdx | 4 ++-- es/editor/settings.mdx | 2 +- fr/editor/keyboard-shortcuts.mdx | 2 +- fr/editor/pages.mdx | 4 ++-- fr/editor/settings.mdx | 2 +- zh/editor/keyboard-shortcuts.mdx | 2 +- zh/editor/pages.mdx | 4 ++-- zh/editor/settings.mdx | 2 +- 12 files changed, 16 insertions(+), 16 deletions(-) diff --git a/editor/keyboard-shortcuts.mdx b/editor/keyboard-shortcuts.mdx index 4d05cb5ff1..1fc067d50f 100644 --- a/editor/keyboard-shortcuts.mdx +++ b/editor/keyboard-shortcuts.mdx @@ -15,7 +15,7 @@ These shortcuts work regardless of which mode you're in. | **Search files and content** | Cmd + K | Ctrl + K | | **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 + . | +| **Show all files** (including images, spec files, code, and dotfiles) | Cmd + Shift + . | Ctrl + Shift + . | ## Visual mode diff --git a/editor/pages.mdx b/editor/pages.mdx index 0f74d15b6b..70a2e2b7fc 100644 --- a/editor/pages.mdx +++ b/editor/pages.mdx @@ -14,7 +14,7 @@ The editor workspace is split into two tabs: **Home** and **Publishing**. **Publishing** is your published site. It shows the navigation your visitors see, along with your site settings. {/* 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). +Home lists only Markdown pages (`.md` and `.mdx` files) in the sidebar by default. Everything else is hidden, including images, videos, PDFs, code, spec and data files like `openapi.yaml`, `docs.json`, dotfiles, and all-caps Markdown files like `README.md`. To see all files, turn on [Show all files](/editor/settings) or press Cmd + Shift + . (macOS) or Ctrl + Shift + . (Windows). {/* vale Mintlify.OxfordComma = YES */} ## Create a page @@ -23,7 +23,7 @@ To add a page to your navigation, click the plus button on ## Add media -Type /image or /video to upload a file or pick one already in your repository. You can also drag files from your computer onto the page. To reuse media, drag an image or video from the navigation tree onto a page. +Type /image or /video to upload a file or pick one already in your repository. You can also drag files from your computer onto the page. To reuse media, pick an existing file from the /image or /video picker. You can also turn on [Show all files](/editor/settings) and drag an image or video from the sidebar onto a page. - 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. diff --git a/editor/settings.mdx b/editor/settings.mdx index 9fb40a9dd3..2228436aab 100644 --- a/editor/settings.mdx +++ b/editor/settings.mdx @@ -19,7 +19,7 @@ Appearance settings are personal preferences. They change the editor only for yo - **Fit editor to full width**: Stretch the editing canvas edge-to-edge instead of the default 768px column. - **Show breadcrumbs**: Show the page's location in the site navigation above the editing canvas. - **Open live preview in new tab**: Open the rendered page in a new browser tab when you preview, instead of the split-pane preview. -- **Show all files**: Show every file in the sidebar, including dotfiles, code, PDFs, and other files hidden by default. You can also press Cmd + Shift + . (macOS) or Ctrl + Shift + . (Windows) to toggle. +- **Show all files**: The sidebar lists Markdown pages by default. Turn this on to also show images, videos, spec and data files, code, PDFs, and dotfiles. You can also press Cmd + Shift + . (macOS) or Ctrl + Shift + . (Windows) to toggle. ## PR instructions diff --git a/es/editor/keyboard-shortcuts.mdx b/es/editor/keyboard-shortcuts.mdx index 21b1e65863..78e7f67ed3 100644 --- a/es/editor/keyboard-shortcuts.mdx +++ b/es/editor/keyboard-shortcuts.mdx @@ -19,7 +19,7 @@ Estos atajos funcionan sea cual sea el modo en el que esté. | **Buscar archivos y contenido** | Cmd + K | Ctrl + K | | **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 + . | +| **Mostrar todos los archivos** (incluidas las imágenes, los archivos de especificación, el código y los dotfiles) | Cmd + Shift + . | Ctrl + Shift + . |
diff --git a/es/editor/pages.mdx b/es/editor/pages.mdx index a202244d2a..59a4fec516 100644 --- a/es/editor/pages.mdx +++ b/es/editor/pages.mdx @@ -17,7 +17,7 @@ El espacio de trabajo del editor se divide en dos pestañas: **Home** y **Publis **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](/es/editor/settings#appearance) o presione Cmd + Shift + . (macOS) o Ctrl + Shift + . (Windows). +Home muestra de forma predeterminada solo las páginas Markdown (archivos `.md` y `.mdx`) en la barra lateral. Todo lo demás está oculto, incluidas las imágenes, los vídeos, los PDF, el código, los archivos de especificación y de datos como `openapi.yaml`, `docs.json`, los dotfiles y los archivos Markdown en mayúsculas como `README.md`. Para ver todos los archivos, active [Show all files](/es/editor/settings#appearance) o presione Cmd + Shift + . (macOS) o Ctrl + Shift + . (Windows).
@@ -33,7 +33,7 @@ Para añadir una página a su navegación, haga clic en el botón diff --git a/fr/editor/keyboard-shortcuts.mdx b/fr/editor/keyboard-shortcuts.mdx index d2d4112143..b8a833bfde 100644 --- a/fr/editor/keyboard-shortcuts.mdx +++ b/fr/editor/keyboard-shortcuts.mdx @@ -19,7 +19,7 @@ Ces raccourcis fonctionnent quel que soit le mode dans lequel vous vous trouvez. | **Rechercher des fichiers et du contenu** | Cmd + K | Ctrl + K | | **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 + . | +| **Afficher tous les fichiers** (y compris les images, les fichiers de spécification, le code et les dotfiles) | Cmd + Shift + . | Ctrl + Shift + . |
diff --git a/fr/editor/pages.mdx b/fr/editor/pages.mdx index 688089b750..e1c26d47e9 100644 --- a/fr/editor/pages.mdx +++ b/fr/editor/pages.mdx @@ -17,7 +17,7 @@ L'espace de travail de l'éditeur est divisé en deux onglets : **Home** et **Pu **Publishing** est votre site publié. Il affiche la navigation que voient vos visiteurs, ainsi que les paramètres de votre site. -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). +Home affiche par défaut uniquement les pages Markdown (fichiers `.md` et `.mdx`) dans la barre latérale. Tout le reste est masqué, y compris les images, les vidéos, les PDF, le code, les fichiers de spécification et de données comme `openapi.yaml`, `docs.json`, les dotfiles et les fichiers Markdown en majuscules comme `README.md`. Pour afficher tous les fichiers, activez [Show all files](/fr/editor/settings#appearance) ou appuyez sur Cmd + Shift + . (macOS) ou Ctrl + Shift + . (Windows).
@@ -33,7 +33,7 @@ Pour ajouter une page à votre navigation, cliquez sur le bouton diff --git a/zh/editor/keyboard-shortcuts.mdx b/zh/editor/keyboard-shortcuts.mdx index ca6037d123..869d485f29 100644 --- a/zh/editor/keyboard-shortcuts.mdx +++ b/zh/editor/keyboard-shortcuts.mdx @@ -19,7 +19,7 @@ keywords: ["editor", "keys", "keyboard", "shortcuts"] | **搜索文件和内容** | Cmd + K | Ctrl + K | | **显示或隐藏 AI 助手**（未在编辑文本时） | Cmd + I | Ctrl + I | | **在可视化模式与 source 模式之间切换** | Cmd + Shift + S | Ctrl + Shift + S | -| **显示全部文件**（包括 dotfile 和非内容文件） | Cmd + Shift + . | Ctrl + Shift + . | +| **显示全部文件**（包括图片、规范文件、代码和 dotfile） | Cmd + Shift + . | Ctrl + Shift + . |
diff --git a/zh/editor/pages.mdx b/zh/editor/pages.mdx index 4eeaa36640..bc8d4e3b33 100644 --- a/zh/editor/pages.mdx +++ b/zh/editor/pages.mdx @@ -17,7 +17,7 @@ keywords: ["editor", "content", "pages", "navigation", "version history", "media **Publishing** 是你已发布的站点，显示访问者看到的导航以及站点设置。 -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）。 +Home 默认只在侧边栏中列出 Markdown 页面（`.md` 和 `.mdx` 文件）。其他文件均被隐藏，包括图片、视频、PDF、代码、`openapi.yaml` 等规范和数据文件、`docs.json`、dotfile，以及像 `README.md` 这样的全大写 Markdown 文件。若要查看全部文件，请启用 [Show all files](/zh/editor/settings#appearance)，或按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）。
@@ -33,7 +33,7 @@ Home 默认会隐藏部分文件，包括 `docs.json`、名称以点开头的文
-输入 /image 或 /video 上传文件，或选择仓库中已有的文件。你也可以把文件从电脑拖放到页面上。若要复用媒体，请把图片或视频从导航树拖到页面上。 +输入 /image 或 /video 上传文件，或选择仓库中已有的文件。你也可以把文件从电脑拖放到页面上。若要复用媒体，请在 /image 或 /video 选择器中选取已有文件。你也可以启用 [Show all files](/zh/editor/settings#appearance)，然后把图片或视频从侧边栏拖到页面上。 - 上传的文件会保存到 `images/` 和 `videos/` 文件夹，并随下次发布一起提交。 - 支持的格式为 PNG、JPG、JPEG、GIF、WebP、SVG、MP4 和 WebM。 diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx index 2d8e34564d..334d11461a 100644 --- a/zh/editor/settings.mdx +++ b/zh/editor/settings.mdx @@ -23,7 +23,7 @@ keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull reque - **Fit editor to full width**：让编辑区域横向铺满，而不使用默认的 768px 栏宽。 - **Show breadcrumbs**：在编辑区域上方显示该页面在站点导航中的位置。 - **Open live preview in new tab**：预览时在新的浏览器标签页中打开渲染后的页面，而不使用分栏预览。 -- **Show all files**：在侧边栏中显示全部文件，包括 dotfile、代码、PDF，以及其他默认隐藏的文件。你也可以按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）进行切换。 +- **Show all files**：侧边栏默认只列出 Markdown 页面。启用此选项可同时显示图片、视频、规范和数据文件、代码、PDF 以及 dotfile。你也可以按 Cmd + Shift + .（macOS）或 Ctrl + Shift + .（Windows）进行切换。
From 59fb2d8e1ebea3ff0c00ad8d6932f2e28cf91fed Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 5 Sep 2026 08:02:06 +0000 Subject: [PATCH 2/2] docs: tighten media reuse sentence across languages --- editor/pages.mdx | 2 +- es/editor/pages.mdx | 2 +- fr/editor/pages.mdx | 2 +- zh/editor/pages.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/editor/pages.mdx b/editor/pages.mdx index 70a2e2b7fc..5d718abb6d 100644 --- a/editor/pages.mdx +++ b/editor/pages.mdx @@ -23,7 +23,7 @@ To add a page to your navigation, click the plus button on ## Add media -Type /image or /video to upload a file or pick one already in your repository. You can also drag files from your computer onto the page. To reuse media, pick an existing file from the /image or /video picker. You can also turn on [Show all files](/editor/settings) and drag an image or video from the sidebar onto a page. +Type /image or /video to upload a file or pick one already in your repository. You can also drag files from your computer onto the page. To reuse media, pick an existing file from the /image or /video picker, or turn on [Show all files](/editor/settings) and drag an image or video from the sidebar onto a page. - 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. diff --git a/es/editor/pages.mdx b/es/editor/pages.mdx index 59a4fec516..37e2a6d7d4 100644 --- a/es/editor/pages.mdx +++ b/es/editor/pages.mdx @@ -33,7 +33,7 @@ Para añadir una página a su navegación, haga clic en el botón -Saisissez /image ou /video pour téléverser un fichier ou en choisir un déjà présent dans votre dépôt. Vous pouvez aussi faire glisser des fichiers depuis votre ordinateur sur la page. Pour réutiliser un média, choisissez un fichier existant dans le sélecteur /image ou /video. Vous pouvez aussi activer [Show all files](/fr/editor/settings#appearance) et faire glisser une image ou une vidéo depuis la barre latérale sur une page. +Saisissez /image ou /video pour téléverser un fichier ou en choisir un déjà présent dans votre dépôt. Vous pouvez aussi faire glisser des fichiers depuis votre ordinateur sur la page. Pour réutiliser un média, choisissez un fichier existant dans le sélecteur /image ou /video, ou activez [Show all files](/fr/editor/settings#appearance) et faites glisser une image ou une vidéo depuis la barre latérale sur une page. - Les fichiers téléversés sont enregistrés dans vos dossiers `images/` et `videos/` et sont inclus dans le commit de votre prochaine publication. - Les formats pris en charge sont PNG, JPG, JPEG, GIF, WebP, SVG, MP4 et WebM. diff --git a/zh/editor/pages.mdx b/zh/editor/pages.mdx index bc8d4e3b33..0cce5da66c 100644 --- a/zh/editor/pages.mdx +++ b/zh/editor/pages.mdx @@ -33,7 +33,7 @@ Home 默认只在侧边栏中列出 Markdown 页面（`.md` 和 `.mdx` 文件）
-输入 /image 或 /video 上传文件，或选择仓库中已有的文件。你也可以把文件从电脑拖放到页面上。若要复用媒体，请在 /image 或 /video 选择器中选取已有文件。你也可以启用 [Show all files](/zh/editor/settings#appearance)，然后把图片或视频从侧边栏拖到页面上。 +输入 /image 或 /video 上传文件，或选择仓库中已有的文件。你也可以把文件从电脑拖放到页面上。若要复用媒体，请在 /image 或 /video 选择器中选取已有文件，或启用 [Show all files](/zh/editor/settings#appearance)，然后把图片或视频从侧边栏拖到页面上。 - 上传的文件会保存到 `images/` 和 `videos/` 文件夹，并随下次发布一起提交。 - 支持的格式为 PNG、JPG、JPEG、GIF、WebP、SVG、MP4 和 WebM。