diff --git a/docs/.vuepress/configs/navbar/en.ts b/docs/.vuepress/configs/navbar/en.ts index 581eb8fe..021a7f35 100644 --- a/docs/.vuepress/configs/navbar/en.ts +++ b/docs/.vuepress/configs/navbar/en.ts @@ -27,7 +27,7 @@ export const enNavbar = navbar([ prefix: '/reference/', children: [ { - text: 'VuePress', + text: 'Core', children: [ { text: 'CLI', @@ -48,6 +48,19 @@ export const enNavbar = navbar([ prefix: 'bundler/', children: ['vite', 'webpack'], }, + { + text: 'Ecosystem', + children: [ + { + text: 'Default Theme', + link: 'https://ecosystem.vuejs.press/themes/default/', + }, + { + text: 'Plugins', + link: 'https://ecosystem.vuejs.press/plugins/', + }, + ], + }, ], }, @@ -72,11 +85,11 @@ export const enNavbar = navbar([ text: 'Resources', children: [ { - text: 'Official Ecosystem', + text: 'Ecosystem', link: 'https://ecosystem.vuejs.press/', }, { - text: 'VuePress MarketPlace', + text: 'MarketPlace', link: 'https://marketplace.vuejs.press', }, { diff --git a/docs/.vuepress/configs/navbar/zh.ts b/docs/.vuepress/configs/navbar/zh.ts index 9c0a9cb1..78d9dded 100644 --- a/docs/.vuepress/configs/navbar/zh.ts +++ b/docs/.vuepress/configs/navbar/zh.ts @@ -27,7 +27,7 @@ export const zhNavbar = navbar([ prefix: '/zh/reference/', children: [ { - text: 'VuePress', + text: '核心', children: [ 'cli', 'config', @@ -44,6 +44,19 @@ export const zhNavbar = navbar([ prefix: 'bundler/', children: ['vite', 'webpack'], }, + { + text: '生态系统', + children: [ + { + text: '默认主题', + link: 'https://ecosystem.vuejs.press/zh/themes/default/', + }, + { + text: '插件', + link: 'https://ecosystem.vuejs.press/zh/plugins/', + }, + ], + }, ], }, { @@ -67,11 +80,11 @@ export const zhNavbar = navbar([ text: '其他资源', children: [ { - text: '官方生态系统', + text: '生态系统', link: 'https://ecosystem.vuejs.press/zh/', }, { - text: 'VuePress 市场', + text: '市场', link: 'https://marketplace.vuejs.press/zh/', }, { diff --git a/docs/.vuepress/configs/sidebar/en.ts b/docs/.vuepress/configs/sidebar/en.ts index 37b9a020..803f152f 100644 --- a/docs/.vuepress/configs/sidebar/en.ts +++ b/docs/.vuepress/configs/sidebar/en.ts @@ -5,19 +5,19 @@ export const enSidebar = sidebar({ { text: 'Guide', children: [ - '/guide/introduction.md', - '/guide/getting-started.md', - '/guide/configuration.md', - '/guide/page.md', - '/guide/markdown.md', - '/guide/assets.md', - '/guide/i18n.md', - '/guide/deployment.md', - '/guide/theme.md', - '/guide/plugin.md', - '/guide/bundler.md', - '/guide/migration.md', - '/guide/troubleshooting.md', + 'introduction', + 'getting-started', + 'configuration', + 'page', + 'markdown', + 'assets', + 'i18n', + 'deployment', + 'theme', + 'plugin', + 'bundler', + 'migration', + 'troubleshooting', ], }, ], @@ -43,7 +43,7 @@ export const enSidebar = sidebar({ ], '/reference/': [ { - text: 'VuePress Reference', + text: 'Core', icon: 'fa6-brands:vuejs', collapsible: true, children: [ @@ -58,21 +58,31 @@ export const enSidebar = sidebar({ ], }, { - text: 'Bundlers Reference', + text: 'Bundlers', icon: 'fa6-solid:boxes-packing', prefix: 'bundler/', collapsible: true, children: ['vite', 'webpack'], }, { - text: 'Official Ecosystem', - icon: 'fa6-solid:leaf', - link: 'https://ecosystem.vuejs.press/', - }, - { - text: 'VuePress MarketPlace', - icon: 'fa6-solid:cart-shopping', - link: 'https://marketplace.vuejs.press', + text: 'Ecosystem', + children: [ + { + text: 'Default Theme', + icon: 'fa6-solid:leaf', + link: 'https://ecosystem.vuejs.press/themes/default/', + }, + { + text: 'Plugins', + icon: 'fa6-solid:puzzle-piece', + link: 'https://ecosystem.vuejs.press/plugins/', + }, + { + text: 'VuePress MarketPlace', + icon: 'fa6-solid:cart-shopping', + link: 'https://marketplace.vuejs.press', + }, + ], }, ], }) diff --git a/docs/.vuepress/configs/sidebar/zh.ts b/docs/.vuepress/configs/sidebar/zh.ts index a6e30c90..30247bee 100644 --- a/docs/.vuepress/configs/sidebar/zh.ts +++ b/docs/.vuepress/configs/sidebar/zh.ts @@ -5,19 +5,19 @@ export const zhSidebar = sidebar({ { text: '指南', children: [ - '/zh/guide/introduction.md', - '/zh/guide/getting-started.md', - '/zh/guide/configuration.md', - '/zh/guide/page.md', - '/zh/guide/markdown.md', - '/zh/guide/assets.md', - '/zh/guide/i18n.md', - '/zh/guide/deployment.md', - '/zh/guide/theme.md', - '/zh/guide/plugin.md', - '/zh/guide/bundler.md', - '/zh/guide/migration.md', - '/zh/guide/troubleshooting.md', + 'introduction', + 'getting-started', + 'configuration', + 'page', + 'markdown', + 'assets', + 'i18n', + 'deployment', + 'theme', + 'plugin', + 'bundler', + 'migration', + 'troubleshooting', ], }, ], @@ -43,36 +43,47 @@ export const zhSidebar = sidebar({ ], '/zh/reference/': [ { - text: 'VuePress 参考', + text: '核心', icon: 'fa6-brands:vuejs', collapsible: true, children: [ - '/zh/reference/cli', - '/zh/reference/config', - '/zh/reference/frontmatter', - '/zh/reference/components', - '/zh/reference/plugin-api', - '/zh/reference/theme-api', - '/zh/reference/client-api', - '/zh/reference/node-api', + 'cli', + 'config', + 'frontmatter', + 'components', + 'plugin-api', + 'theme-api', + 'client-api', + 'node-api', ], }, { - text: '打包工具参考', + text: '打包工具', icon: 'fa6-solid:boxes-packing', prefix: 'bundler/', collapsible: true, children: ['vite', 'webpack'], }, { - text: '官方生态系统', + text: '生态系统', icon: 'fa6-solid:leaf', - link: 'https://ecosystem.vuejs.press/zh/', - }, - { - text: 'VuePress 市场', - icon: 'fa6-solid:cart-shopping', - link: 'https://marketplace.vuejs.press/zh/', + children: [ + { + text: '默认主题', + icon: 'fa6-solid:palette', + link: 'https://ecosystem.vuejs.press/zh/themes/default/', + }, + { + text: '插件', + icon: 'fa6-solid:puzzle-piece', + link: 'https://ecosystem.vuejs.press/zh/plugins/', + }, + { + text: '市场', + icon: 'fa6-solid:cart-shopping', + link: 'https://marketplace.vuejs.press/zh/', + }, + ], }, ], }) diff --git a/docs/.vuepress/public/images/guide/vuepress-architecture-overview.png b/docs/.vuepress/public/images/guide/vuepress-architecture-overview.png index 4e64bee9..572bf1a4 100644 Binary files a/docs/.vuepress/public/images/guide/vuepress-architecture-overview.png and b/docs/.vuepress/public/images/guide/vuepress-architecture-overview.png differ diff --git a/docs/.vuepress/theme.ts b/docs/.vuepress/theme.ts index bad2767a..8bcb07fe 100644 --- a/docs/.vuepress/theme.ts +++ b/docs/.vuepress/theme.ts @@ -6,7 +6,8 @@ export default hopeTheme({ iconAssets: 'iconify', logo: '/images/hero.png', - repo: 'vuepress/docs', + repo: 'vuepress/core', + docsRepo: 'vuepress/docs', docsDir: 'docs', locales: { diff --git a/docs/advanced/architecture.md b/docs/advanced/architecture.md index 85addc1f..b3dc304f 100644 --- a/docs/advanced/architecture.md +++ b/docs/advanced/architecture.md @@ -11,7 +11,7 @@ icon: fa6-solid:folder-tree The above figure shows a brief overview of the VuePress architecture: - Node App will generate temp files, including the pages, routes, etc. -- Bundler will handle Client App together with the temp files, just like a common Vue SPA. +- Bundler will handle Client App together with the temp files, just like a common Vue app. As a developer, you must be aware of that VuePress has two main parts: **Node App** and **Client App**, which is important when developing plugins and themes: diff --git a/docs/guide/markdown.md b/docs/guide/markdown.md index 359fb0c1..5d76f26a 100644 --- a/docs/guide/markdown.md +++ b/docs/guide/markdown.md @@ -71,13 +71,13 @@ Take our documentation source files as an example: ```vue