From 233ae3337fbe7574fd042a1d7fd6994916479a49 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:06:04 +0800
Subject: [PATCH 01/14] fix(cli): incorrect exec context

---
 cli/src/run.ts | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/cli/src/run.ts b/cli/src/run.ts
index 3c153672..f9ebfa01 100644
--- a/cli/src/run.ts
+++ b/cli/src/run.ts
@@ -1,3 +1,5 @@
+import process from 'node:process'
+import path from 'node:path'
 import { intro, outro, spinner } from '@clack/prompts'
 import { execaCommand } from 'execa'
 import colors from 'picocolors'
@@ -19,16 +21,17 @@ export async function run(mode: Mode, root?: string) {
 
   await generate(mode, data)
 
+  const cwd = path.join(process.cwd(), data.root)
   if (data.git) {
     progress.message(t('spinner.git'))
-    await execaCommand('git init')
+    await execaCommand('git init', { cwd })
   }
 
   const pm = data.packageManager
 
   if (data.install) {
     progress.message(t('spinner.install'))
-    await execaCommand(pm === 'yarn' ? 'yarn' : `${pm} install`)
+    await execaCommand(pm === 'yarn' ? 'yarn' : `${pm} install`, { cwd })
   }
 
   const cdCommand = mode === Mode.create ? colors.green(`cd ${data.root}`) : ''

From 38eb41a48d3cd916d8bd965fbd045fdaaf49a47b Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:06:55 +0800
Subject: [PATCH 02/14] perf(theme): breadcrumb ui

---
 .../client/components/VPDocBreadcrumbs.vue    | 31 +++++++++----------
 1 file changed, 14 insertions(+), 17 deletions(-)

diff --git a/theme/src/client/components/VPDocBreadcrumbs.vue b/theme/src/client/components/VPDocBreadcrumbs.vue
index 4b95a233..dfd5efbe 100644
--- a/theme/src/client/components/VPDocBreadcrumbs.vue
+++ b/theme/src/client/components/VPDocBreadcrumbs.vue
@@ -1,12 +1,10 @@
 <script setup lang="ts">
 import { computed } from 'vue'
-import { useRouteLocale } from 'vuepress/client'
 import VPLink from '@theme/VPLink.vue'
 import {
-  useBlogExtract,
-  useBlogNavTitle,
   useBlogPageData,
   useData,
+  useInternalLink,
   useSidebarData,
 } from '../composables/index.js'
 import type { ResolvedSidebarItem } from '../../shared/index.js'
@@ -18,9 +16,8 @@ interface Breadcrumb {
 }
 
 const { page } = useData<'post'>()
-const routeLocale = useRouteLocale()
 const { isBlogPost } = useBlogPageData()
-const { categoriesLink, blogLink } = useBlogExtract()
+const { home, blog, categories } = useInternalLink()
 const sidebar = useSidebarData()
 
 const hasBreadcrumb = computed(() => {
@@ -28,21 +25,19 @@ const hasBreadcrumb = computed(() => {
     return page.value.categoryList.length > 0
   return sidebar.value.length > 0
 })
-const homeTitle = useBlogNavTitle('home')
-const blogTile = useBlogNavTitle('blog')
 
 const breadcrumbList = computed<Breadcrumb[]>(() => {
   if (!hasBreadcrumb.value)
     return []
-  const list: Breadcrumb[] = [{ text: homeTitle.value, link: routeLocale.value }]
+  const list: Breadcrumb[] = [{ text: home.value.text, link: home.value.link }]
 
   if (isBlogPost.value) {
-    list.push({ text: blogTile.value, link: blogLink.value })
+    list.push({ text: blog.value.text, link: blog.value.link })
     const categoryList = page.value.categoryList ?? []
     for (const category of categoryList) {
       list.push({
         text: category.name,
-        link: `${categoriesLink.value}?id=${category.id}`,
+        link: `${categories.value.link}?id=${category.id}`,
       })
     }
   }
@@ -90,7 +85,7 @@ function resolveSidebar(
           {{ text }}
         </VPLink>
         <span v-if="index !== breadcrumbList.length - 1" class="vpi-chevron-right" />
-        <meta property="position" :content="index + 1">
+        <meta property="position" :content="`${index + 1}`">
       </li>
     </ol>
   </nav>
@@ -98,19 +93,19 @@ function resolveSidebar(
 
 <style scoped>
 .vp-breadcrumb {
-  padding-left: 1rem;
+  padding-left: 8px;
   margin-bottom: 2rem;
-  border-left: solid 4px var(--vp-c-brand-1);
+  border-left: solid 2px var(--vp-c-brand-1);
   transition: border-left var(--t-color);
 }
 
 .vp-breadcrumb ol {
   display: flex;
   flex-wrap: wrap;
-  gap: 8px;
+  gap: 4px;
   align-items: center;
   justify-content: flex-start;
-  font-size: 16px;
+  font-size: 14px;
   font-weight: 400;
 }
 
@@ -120,6 +115,7 @@ function resolveSidebar(
 }
 
 .vp-breadcrumb .breadcrumb {
+  font-weight: bold;
   color: var(--vp-c-brand-2);
   transition: color var(--t-color);
 }
@@ -133,7 +129,8 @@ function resolveSidebar(
 }
 
 .vp-breadcrumb .vpi-chevron-right {
-  margin-left: 8px;
-  color: var(--vp-c-text-3);
+  margin-left: 4px;
+  color: var(--vp-c-border);
+  transition: color var(--t-color);
 }
 </style>

From d9c43b57388cfae4a993a19b5fe6b6b813f4eab9 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:07:52 +0800
Subject: [PATCH 03/14] perf(theme): hidden code block copy button in mobile

---
 theme/src/client/styles/code.css | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/theme/src/client/styles/code.css b/theme/src/client/styles/code.css
index d0fe1d1f..ebf10ecc 100644
--- a/theme/src/client/styles/code.css
+++ b/theme/src/client/styles/code.css
@@ -311,6 +311,12 @@ html:not(.dark) .vp-code span {
   transform: translateX(calc(-100% - 1px));
 }
 
+@media (max-width: 419px) {
+  .vp-doc div[class*="language-"] > button.copy {
+    display: none;
+  }
+}
+
 /*
   Collapsed lines
   --------------------------------------------------------------------------

From d7885aae483c26fa6f769a3aa70ffc31aa936080 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:08:44 +0800
Subject: [PATCH 04/14] fix(theme): incorrect comments `margin-top`

---
 theme/src/client/styles/compat.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/theme/src/client/styles/compat.css b/theme/src/client/styles/compat.css
index b7f74b46..cb6f4b67 100644
--- a/theme/src/client/styles/compat.css
+++ b/theme/src/client/styles/compat.css
@@ -13,6 +13,6 @@
 }
 
 /* ------------------ Plugin Comment  ------------------ */
-#vp-comment {
+.vp-comment {
   margin-top: 80px;
 }

From c16cf37dd1724e78a37903a2f2a5c46b3286699a Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:09:35 +0800
Subject: [PATCH 05/14] perf(theme): optimize composables

---
 theme/src/client/composables/blog-extract.ts  | 36 ++++--------------
 theme/src/client/composables/index.ts         |  3 +-
 theme/src/client/composables/internal-link.ts | 38 +++++++++++++++++++
 theme/src/client/composables/locale.ts        | 10 -----
 .../src/client/composables/preset-locales.ts  |  9 +++++
 5 files changed, 57 insertions(+), 39 deletions(-)
 create mode 100644 theme/src/client/composables/internal-link.ts
 delete mode 100644 theme/src/client/composables/locale.ts
 create mode 100644 theme/src/client/composables/preset-locales.ts

diff --git a/theme/src/client/composables/blog-extract.ts b/theme/src/client/composables/blog-extract.ts
index 88c7b893..95ffe614 100644
--- a/theme/src/client/composables/blog-extract.ts
+++ b/theme/src/client/composables/blog-extract.ts
@@ -1,64 +1,44 @@
-import { useRouteLocale } from 'vuepress/client'
 import { computed } from 'vue'
-import type { PresetLocale } from '../../shared/index.js'
 import { useLocalePostList } from './blog-data.js'
 import { useTags } from './blog-tags.js'
 import { type BlogCategory, useBlogCategory } from './blog-category.js'
 import { useData } from './data.js'
-import { useLocaleLink } from './locale.js'
-
-declare const __PLUME_PRESET_LOCALE__: Record<string, PresetLocale>
-
-const presetLocales = __PLUME_PRESET_LOCALE__
-
-export function useBlogNavTitle(name: keyof PresetLocale) {
-  const locale = useRouteLocale()
-
-  return computed(() => presetLocales[locale.value]?.[name] || presetLocales['/'][name])
-}
+import { useInternalLink } from './internal-link.js'
 
 export function useBlogExtract() {
   const { theme } = useData()
-  const locale = useRouteLocale()
   const postList = useLocalePostList()
   const { tags: tagsList } = useTags()
   const { categories: categoryList } = useBlogCategory()
   const blog = computed(() => theme.value.blog || {})
+  const links = useInternalLink()
 
   const hasBlogExtract = computed(() =>
     blog.value.archives !== false
     || blog.value.tags !== false
     || blog.value.categories !== false,
   )
-  const blogLink = useLocaleLink(blog.value.link || 'blog/')
-  const tagsLink = useLocaleLink(blog.value.tagsLink || 'blog/tags/')
-  const archiveLink = useLocaleLink(blog.value.archivesLink || 'blog/archives/')
-  const categoriesLink = useLocaleLink(blog.value.categoriesLink || 'blog/categories/')
 
   const tags = computed(() => ({
-    link: tagsLink.value,
-    text: presetLocales[locale.value]?.tag || presetLocales['/'].tag,
+    link: links.tags.value.link,
+    text: links.tags.value.text,
     total: tagsList.value.length,
   }))
 
   const archives = computed(() => ({
-    link: archiveLink.value,
-    text: presetLocales[locale.value]?.archive || presetLocales['/'].archive,
+    link: links.archive.value.link,
+    text: links.archive.value.text,
     total: postList.value.length,
   }))
 
   const categories = computed(() => ({
-    link: categoriesLink.value,
-    text: presetLocales[locale.value]?.category || presetLocales['/'].category,
+    link: links.categories.value.link,
+    text: links.categories.value.text,
     total: getCategoriesTotal(categoryList.value),
   }))
 
   return {
     hasBlogExtract,
-    blogLink,
-    tagsLink,
-    archiveLink,
-    categoriesLink,
     tags,
     archives,
     categories,
diff --git a/theme/src/client/composables/index.ts b/theme/src/client/composables/index.ts
index 7610b76b..0ed537a5 100644
--- a/theme/src/client/composables/index.ts
+++ b/theme/src/client/composables/index.ts
@@ -20,6 +20,7 @@ export * from './contributors.js'
 
 export * from './home.js'
 
+export * from './internal-link.js'
 export * from './blog-data.js'
 export * from './blog-post-list.js'
 export * from './blog-extract.js'
@@ -32,8 +33,8 @@ export * from './page.js'
 export * from './encrypt-data.js'
 export * from './encrypt.js'
 
+export * from './preset-locales.js'
 export * from './link.js'
-export * from './locale.js'
 export * from './route-query.js'
 
 export * from './watermark.js'
diff --git a/theme/src/client/composables/internal-link.ts b/theme/src/client/composables/internal-link.ts
new file mode 100644
index 00000000..c3476100
--- /dev/null
+++ b/theme/src/client/composables/internal-link.ts
@@ -0,0 +1,38 @@
+import { computed } from 'vue'
+import { useRouteLocale } from 'vuepress/client'
+import type { PresetLocale } from '../../shared/index.js'
+import { useData } from './data.js'
+import { getPresetLocaleData } from './preset-locales.js'
+
+export interface InternalLink {
+  text: string
+  link: string
+}
+
+export function useInternalLink() {
+  const { theme } = useData()
+  const routeLocale = useRouteLocale()
+
+  function resolveLink(name: keyof PresetLocale, link: string): InternalLink {
+    return {
+      link: (routeLocale.value + link).replace(/\/+/g, '/'),
+      text: getPresetLocaleData(routeLocale.value, name),
+    }
+  }
+
+  const blogData = computed(() => theme.value.blog || {})
+
+  const home = computed(() => resolveLink('home', '/'))
+  const blog = computed(() => resolveLink('blog', blogData.value.link || 'blog/'))
+  const tags = computed(() => resolveLink('tag', blogData.value.tagsLink || 'blog/tags/'))
+  const archive = computed(() => resolveLink('archive', blogData.value.archivesLink || 'blog/archives/'))
+  const categories = computed(() => resolveLink('category', blogData.value.categoriesLink || 'blog/categories/'))
+
+  return {
+    home,
+    blog,
+    tags,
+    archive,
+    categories,
+  }
+}
diff --git a/theme/src/client/composables/locale.ts b/theme/src/client/composables/locale.ts
deleted file mode 100644
index 2a5bd9de..00000000
--- a/theme/src/client/composables/locale.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-import { useRouteLocale } from 'vuepress/client'
-import { computed } from 'vue'
-
-export function useLocaleLink(link: string) {
-  const prefix = useRouteLocale()
-
-  return computed(() => {
-    return (prefix.value + link).replace(/\/+/g, '/')
-  })
-}
diff --git a/theme/src/client/composables/preset-locales.ts b/theme/src/client/composables/preset-locales.ts
new file mode 100644
index 00000000..f14674fe
--- /dev/null
+++ b/theme/src/client/composables/preset-locales.ts
@@ -0,0 +1,9 @@
+import type { PresetLocale } from '../../shared/index.js'
+
+declare const __PLUME_PRESET_LOCALE__: Record<string, PresetLocale>
+
+export const presetLocales = __PLUME_PRESET_LOCALE__
+
+export function getPresetLocaleData(locale: string, name: keyof PresetLocale) {
+  return presetLocales[locale]?.[name] || presetLocales['/'][name]
+}

From cc9b5f8a40f502fa4d0fa7400e5807387445ee25 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:09:54 +0800
Subject: [PATCH 06/14] perf(theme): code demo ui

---
 theme/src/client/styles/md-enhance.css | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/theme/src/client/styles/md-enhance.css b/theme/src/client/styles/md-enhance.css
index 444deb1c..02617a8f 100644
--- a/theme/src/client/styles/md-enhance.css
+++ b/theme/src/client/styles/md-enhance.css
@@ -52,7 +52,7 @@
 
 @media (max-width: 419px) {
   .vp-doc .hint-container div[class*="language-"] {
-    margin: 0.85rem -0.75rem 0.85rem -1rem;
+    margin: 0.85rem -0.75rem;
   }
 
   .vp-doc .hint-container .vp-code-tabs-nav {
@@ -247,9 +247,10 @@
 }
 
 .vp-doc .vp-code-demo .vp-code-demo-code-wrapper {
-  margin-bottom: -0.9rem;
+  margin-bottom: -13px;
 }
 
+
 .vp-doc .vp-code-demo .vp-code-demo-toggle-button {
   margin: 0 12px 0 8px;
   background-color: var(--vp-c-gray-2);
@@ -275,7 +276,10 @@
 }
 
 .vp-doc .vp-code-demo .vp-code-demo-codes div[class*="language-"] {
+  margin-top: 0;
+  margin-bottom: 0;
   border-bottom: 2px dashed var(--vp-c-divider);
+  border-radius: 0;
   transition: border-bottom var(--t-color);
 }
 

From 3d3cb4324325940b862a0b4dc79dbddb02a1b416 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:10:38 +0800
Subject: [PATCH 07/14] feat(theme): add internal link

---
 theme/src/client/components/Blog/VPBlogArchives.vue  |  6 +++---
 .../src/client/components/Blog/VPBlogCategories.vue  |  6 +++---
 theme/src/client/components/Blog/VPBlogTags.vue      |  6 +++---
 theme/src/client/components/Blog/VPPostItem.vue      | 12 ++++++++----
 theme/src/client/components/VPDocMeta.vue            |  9 ++++++---
 5 files changed, 23 insertions(+), 16 deletions(-)

diff --git a/theme/src/client/components/Blog/VPBlogArchives.vue b/theme/src/client/components/Blog/VPBlogArchives.vue
index 8b11ef5d..f78058af 100644
--- a/theme/src/client/components/Blog/VPBlogArchives.vue
+++ b/theme/src/client/components/Blog/VPBlogArchives.vue
@@ -1,8 +1,8 @@
 <script lang="ts" setup>
 import VPShortPostList from '@theme/Blog/VPShortPostList.vue'
-import { useArchives, useBlogNavTitle } from '../../composables/index.js'
+import { useArchives, useInternalLink } from '../../composables/index.js'
 
-const title = useBlogNavTitle('archive')
+const { archive: archiveLink } = useInternalLink()
 const { archives } = useArchives()
 </script>
 
@@ -12,7 +12,7 @@ const { archives } = useArchives()
 
     <h2 class="archives-title">
       <span class="vpi-archive icon" />
-      <span>{{ title }}</span>
+      <span>{{ archiveLink.text }}</span>
     </h2>
     <div v-if="archives.length" class="archives">
       <template v-for="archive in archives" :key="archive.label">
diff --git a/theme/src/client/components/Blog/VPBlogCategories.vue b/theme/src/client/components/Blog/VPBlogCategories.vue
index beb9f568..44eb9bb0 100644
--- a/theme/src/client/components/Blog/VPBlogCategories.vue
+++ b/theme/src/client/components/Blog/VPBlogCategories.vue
@@ -1,8 +1,8 @@
 <script setup lang="ts">
 import VPCategories from '@theme/Blog/VPCategories.vue'
-import { useBlogCategory, useBlogNavTitle } from '../../composables/index.js'
+import { useBlogCategory, useInternalLink } from '../../composables/index.js'
 
-const title = useBlogNavTitle('category')
+const { categories: categoriesLink } = useInternalLink()
 const { categories } = useBlogCategory()
 </script>
 
@@ -12,7 +12,7 @@ const { categories } = useBlogCategory()
 
     <h2 class="categories-title">
       <span class="vpi-category icon" />
-      <span>{{ title }}</span>
+      <span>{{ categoriesLink.text }}</span>
     </h2>
 
     <slot name="blog-categories-content-before" />
diff --git a/theme/src/client/components/Blog/VPBlogTags.vue b/theme/src/client/components/Blog/VPBlogTags.vue
index ba7ae546..deab5fbf 100644
--- a/theme/src/client/components/Blog/VPBlogTags.vue
+++ b/theme/src/client/components/Blog/VPBlogTags.vue
@@ -1,9 +1,9 @@
 <script lang="ts" setup>
 import VPShortPostList from '@theme/Blog/VPShortPostList.vue'
-import { useBlogNavTitle, useTags } from '../../composables/index.js'
+import { useInternalLink, useTags } from '../../composables/index.js'
 
+const { tags: tagsLink } = useInternalLink()
 const { tags, currentTag, postList, handleTagClick } = useTags()
-const title = useBlogNavTitle('tag')
 </script>
 
 <template>
@@ -13,7 +13,7 @@ const title = useBlogNavTitle('tag')
     <div class="tags-nav">
       <h2 class="tags-title">
         <span class="vpi-tag icon" />
-        <span>{{ title }}</span>
+        <span>{{ tagsLink.text }}</span>
       </h2>
       <slot name="blog-tags-title-after" />
       <div class="tags">
diff --git a/theme/src/client/components/Blog/VPPostItem.vue b/theme/src/client/components/Blog/VPPostItem.vue
index 9b2f2d25..abb6285f 100644
--- a/theme/src/client/components/Blog/VPPostItem.vue
+++ b/theme/src/client/components/Blog/VPPostItem.vue
@@ -2,13 +2,14 @@
 import { computed } from 'vue'
 import VPLink from '@theme/VPLink.vue'
 import type { PlumeThemeBlogPostItem } from '../../../shared/index.js'
-import { useTagColors } from '../../composables/index.js'
+import { useInternalLink, useTagColors } from '../../composables/index.js'
 
 const props = defineProps<{
   post: PlumeThemeBlogPostItem
 }>()
 
 const colors = useTagColors()
+const { categories: categoriesLink, tags: tagsLink } = useInternalLink()
 
 const sticky = computed(() => {
   if (typeof props.post.sticky === 'boolean') {
@@ -53,19 +54,22 @@ const createTime = computed(() =>
       <div v-if="categoryList.length" class="category-list">
         <span class="icon vpi-folder" />
         <template v-for="(cate, i) in categoryList" :key="i">
-          <span>{{ cate.name }}</span>
+          <VPLink :href="`${categoriesLink.link}?id=${cate.id}`">
+            {{ cate.name }}
+          </VPLink>
           <span v-if="i !== categoryList.length - 1">/</span>
         </template>
       </div>
       <div v-if="tags.length" class="tag-list">
         <span class="icon vpi-tag" />
         <template v-for="tag in tags" :key="tag.name">
-          <span
+          <VPLink
             class="tag"
             :class="tag.className"
+            :href="`${tagsLink.link}?tag=${tag.name}`"
           >
             {{ tag.name }}
-          </span>
+          </VPLink>
         </template>
       </div>
       <div v-if="createTime" class="create-time">
diff --git a/theme/src/client/components/VPDocMeta.vue b/theme/src/client/components/VPDocMeta.vue
index db794b2c..82a66cd0 100644
--- a/theme/src/client/components/VPDocMeta.vue
+++ b/theme/src/client/components/VPDocMeta.vue
@@ -1,11 +1,13 @@
 <script lang="ts" setup>
 import { computed } from 'vue'
+import VPLink from '@theme/VPLink.vue'
 import { useReadingTimeLocale } from '@vuepress/plugin-reading-time/client'
-import { useData, useTagColors } from '../composables/index.js'
+import { useData, useInternalLink, useTagColors } from '../composables/index.js'
 
 const { page, frontmatter: matter } = useData<'post'>()
 const colors = useTagColors()
 const readingTime = useReadingTimeLocale()
+const { tags: tagsLink } = useInternalLink()
 
 const createTime = computed(() => {
   if (matter.value.createTime)
@@ -40,14 +42,15 @@ const hasMeta = computed(() => readingTime.value.time || tags.value.length || cr
     </p>
     <p v-if="tags.length > 0">
       <span class="vpi-tag icon" />
-      <span
+      <VPLink
         v-for="tag in tags"
         :key="tag.name"
         class="tag"
         :class="tag.className"
+        :href="`${tagsLink.link}?tag=${tag.name}`"
       >
         {{ tag.name }}
-      </span>
+      </VPLink>
     </p>
     <p v-if="createTime" class="create-time">
       <span class="vpi-clock icon" /><span>{{ createTime }}</span>

From 5f13a1ba4603c285a421d4619d68795a59d8c65b Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:11:19 +0800
Subject: [PATCH 08/14] feat(theme): add normalize page title markdown plugin

---
 theme/src/node/plugins/markdown-title.ts | 46 ++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 theme/src/node/plugins/markdown-title.ts

diff --git a/theme/src/node/plugins/markdown-title.ts b/theme/src/node/plugins/markdown-title.ts
new file mode 100644
index 00000000..e3eb2350
--- /dev/null
+++ b/theme/src/node/plugins/markdown-title.ts
@@ -0,0 +1,46 @@
+import type { Plugin } from 'vuepress/core'
+import type { MarkdownEnv } from 'vuepress/markdown'
+
+const REG_HEADING = /^#\s*?(\S.*)?\n/
+
+export function markdownTitlePlugin(): Plugin {
+  return {
+    name: '@vuepress-plume/plugin-markdown-title',
+
+    extendsMarkdown(md) {
+      const render = md.render
+      md.render = (source, env: MarkdownEnv) => {
+        if (!env.filePathRelative)
+          return render(source, env)
+
+        let { matter, content } = parseSource(source.trim())
+        let title = ''
+        content = content.trim().replace(REG_HEADING, (_, match) => {
+          title = match.trim()
+          return ''
+        })
+        source = `${matter}\n${content}`
+        const result = render(source, env)
+        if (title)
+          env.title = title
+        return result
+      }
+    },
+  }
+}
+
+function parseSource(source: string) {
+  const char = '---'
+
+  if (!source.startsWith(char)) {
+    return { matter: '', content: source }
+  }
+  else {
+    const end = source.indexOf(`\n${char}`)
+    const len = char.length + 1
+    return {
+      matter: source.slice(0, end + len),
+      content: source.slice(end + len),
+    }
+  }
+}

From 047e0527f5cbcfb8f2a38369e98265b625e5b381 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:11:47 +0800
Subject: [PATCH 09/14] perf(theme): optimize load theme config

---
 docs/.vuepress/theme.ts                     |  2 +-
 theme/src/node/autoFrontmatter/generator.ts | 16 ----
 theme/src/node/loadConfig/loader.ts         |  7 +-
 theme/src/node/plugins/getPlugins.ts        |  3 +-
 theme/src/node/prepare/index.ts             |  4 +-
 theme/src/node/theme.ts                     | 91 ++++++++-------------
 6 files changed, 42 insertions(+), 81 deletions(-)

diff --git a/docs/.vuepress/theme.ts b/docs/.vuepress/theme.ts
index 888bd636..ad061289 100644
--- a/docs/.vuepress/theme.ts
+++ b/docs/.vuepress/theme.ts
@@ -6,7 +6,7 @@ export const theme: Theme = plumeTheme({
   hostname: process.env.SITE_HOST || 'https://plume.pengzhanbo.cn',
   plugins: {
 
-    shiki: { twoslash: true },
+    shiki: { twoslash: true, lineNumbers: 10 },
 
     markdownEnhance: {
       demo: true,
diff --git a/theme/src/node/autoFrontmatter/generator.ts b/theme/src/node/autoFrontmatter/generator.ts
index 6c5fbebd..ef4d2bf4 100644
--- a/theme/src/node/autoFrontmatter/generator.ts
+++ b/theme/src/node/autoFrontmatter/generator.ts
@@ -26,8 +26,6 @@ export interface Generate {
 }
 
 let generate: Generate | null = null
-let generated = false
-const whenGenerated: (() => void)[] = []
 
 export function initAutoFrontmatter(
   localeOptions: PlumeThemeLocaleOptions,
@@ -64,16 +62,11 @@ export function initAutoFrontmatter(
 export async function generateAutoFrontmatter(app: App) {
   if (!generate)
     return
-  generated = false
   const markdownList = await readMarkdownList(app.dir.source(), generate.globFilter)
   await promiseParallel(
     markdownList.map(file => () => generator(file)),
     64,
   )
-
-  generated = true
-  whenGenerated.forEach(resolve => resolve())
-  whenGenerated.length = 0
 }
 
 export async function watchAutoFrontmatter(app: App, watchers: any[], enable?: () => boolean) {
@@ -132,12 +125,3 @@ async function generator(file: AutoFrontmatterMarkdownFile): Promise<void> {
     console.error(e)
   }
 }
-
-export function waitForAutoFrontmatter() {
-  return new Promise<void>((resolve) => {
-    if (generate && !generated)
-      whenGenerated.push(resolve)
-    else
-      resolve()
-  })
-}
diff --git a/theme/src/node/loadConfig/loader.ts b/theme/src/node/loadConfig/loader.ts
index c8697c8a..d698b46b 100644
--- a/theme/src/node/loadConfig/loader.ts
+++ b/theme/src/node/loadConfig/loader.ts
@@ -65,13 +65,12 @@ export async function initConfigLoader(
   loader.loaded = true
   loader.dependencies = [...dependencies]
   updateResolvedConfig(app, config)
-  runChangeEvents()
 
   loader.whenLoaded.forEach(fn => fn(loader!.resolvedConfig))
   loader.whenLoaded = []
 }
 
-export function watchConfigFile(app: App, watchers: any[]) {
+export function watchConfigFile(app: App, watchers: any[], onChange: ChangeEvent) {
   if (!loader || !loader.configFile)
     return
 
@@ -82,6 +81,8 @@ export function watchConfigFile(app: App, watchers: any[]) {
 
   addDependencies(watcher)
 
+  onConfigChange(onChange)
+
   watcher.on('change', async () => {
     if (loader) {
       loader.loaded = false
@@ -121,7 +122,7 @@ export function waitForConfigLoaded() {
   })
 }
 
-export function getResolvedThemeConfig() {
+export function getThemeConfig() {
   return loader!.resolvedConfig
 }
 
diff --git a/theme/src/node/plugins/getPlugins.ts b/theme/src/node/plugins/getPlugins.ts
index cb2cc0b3..0721f7e5 100644
--- a/theme/src/node/plugins/getPlugins.ts
+++ b/theme/src/node/plugins/getPlugins.ts
@@ -22,6 +22,7 @@ import {
   resolveSearchOptions,
 } from '../config/index.js'
 import { customContainerPlugins } from './containerPlugins.js'
+import { markdownTitlePlugin } from './markdown-title.js'
 
 export interface SetupPluginOptions {
   app: App
@@ -39,7 +40,7 @@ export function getPlugins({
   const isProd = !app.env.isDev
 
   const plugins: PluginConfig = [
-
+    markdownTitlePlugin(),
     fontsPlugin(),
     contentUpdatePlugin(),
     activeHeaderLinksPlugin({
diff --git a/theme/src/node/prepare/index.ts b/theme/src/node/prepare/index.ts
index 00a39ca7..6f4f27b7 100644
--- a/theme/src/node/prepare/index.ts
+++ b/theme/src/node/prepare/index.ts
@@ -1,6 +1,6 @@
 import type { App } from 'vuepress'
 import { watch } from 'chokidar'
-import { getResolvedThemeConfig } from '../loadConfig/index.js'
+import { getThemeConfig } from '../loadConfig/index.js'
 import { prepareArticleTagColors } from './prepareArticleTagColor.js'
 import { preparedBlogData } from './prepareBlogData.js'
 import { prepareEncrypt } from './prepareEncrypt.js'
@@ -10,7 +10,7 @@ import { prepareIcons } from './prepareIcons.js'
 export async function prepareData(
   app: App,
 ): Promise<void> {
-  const { localeOptions, encrypt } = getResolvedThemeConfig()
+  const { localeOptions, encrypt } = getThemeConfig()
   await Promise.all([
     prepareArticleTagColors(app),
     preparedBlogData(app, localeOptions, encrypt),
diff --git a/theme/src/node/theme.ts b/theme/src/node/theme.ts
index 5d5d1927..2dba7e69 100644
--- a/theme/src/node/theme.ts
+++ b/theme/src/node/theme.ts
@@ -4,38 +4,14 @@ import type { PlumeThemeOptions, PlumeThemePageData } from '../shared/index.js'
 import { getPlugins } from './plugins/index.js'
 import { extendsPageData, setupPage } from './setupPages.js'
 import { THEME_NAME, resolve, templates } from './utils/index.js'
-import {
-  extendsBundlerOptions,
-  resolveAlias,
-  resolvePageHead,
-  resolveProvideData,
-  resolveThemeOptions,
-  templateBuildRenderer,
-} from './config/index.js'
-import {
-  getResolvedThemeConfig,
-  initConfigLoader,
-  onConfigChange,
-  waitForConfigLoaded,
-  watchConfigFile,
-} from './loadConfig/index.js'
-import {
-  generateAutoFrontmatter,
-  initAutoFrontmatter,
-  waitForAutoFrontmatter,
-  watchAutoFrontmatter,
-} from './autoFrontmatter/index.js'
+import { extendsBundlerOptions, resolveAlias, resolvePageHead, resolveProvideData, resolveThemeOptions, templateBuildRenderer } from './config/index.js'
+import { getThemeConfig, initConfigLoader, waitForConfigLoaded, watchConfigFile } from './loadConfig/index.js'
+import { generateAutoFrontmatter, initAutoFrontmatter, watchAutoFrontmatter } from './autoFrontmatter/index.js'
 import { prepareData, watchPrepare } from './prepare/index.js'
 import { prepareThemeData } from './prepare/prepareThemeData.js'
 
 export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
-  const {
-    localeOptions,
-    pluginOptions,
-    hostname,
-    configFile,
-    cache,
-  } = resolveThemeOptions(options)
+  const { localeOptions, pluginOptions, hostname, configFile, cache } = resolveThemeOptions(options)
 
   return (app) => {
     initConfigLoader(app, localeOptions, {
@@ -48,14 +24,6 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
       },
     })
 
-    waitForConfigLoaded().then(async ({ autoFrontmatter }) => {
-      autoFrontmatter ??= pluginOptions.frontmatter
-      if (autoFrontmatter !== false) {
-        await sleep(100)
-        generateAutoFrontmatter(app)
-      }
-    })
-
     return {
       name: THEME_NAME,
 
@@ -69,42 +37,49 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
 
       plugins: getPlugins({ app, pluginOptions, hostname, cache }),
 
+      extendsBundlerOptions,
+
+      templateBuildRenderer,
+
+      extendsMarkdown: async (_, app) => {
+        const { autoFrontmatter } = await waitForConfigLoaded()
+        if ((autoFrontmatter ?? pluginOptions.frontmatter) !== false) {
+          await generateAutoFrontmatter(app)
+          // wait for autoFrontmatter generated
+          // i/o performance
+          await sleep(100)
+        }
+      },
+
+      extendsPage: async (page) => {
+        const { localeOptions } = getThemeConfig()
+        extendsPageData(page as Page<PlumeThemePageData>, localeOptions)
+        resolvePageHead(page, localeOptions)
+      },
+
       onInitialized: async (app) => {
-        const { localeOptions } = await waitForConfigLoaded()
+        const { localeOptions } = getThemeConfig()
         await setupPage(app, localeOptions)
       },
 
       onPrepared: async (app) => {
-        onConfigChange(async ({ localeOptions }) => {
-          await prepareThemeData(app, localeOptions)
-          await prepareData(app)
-        })
-        const { localeOptions } = await waitForConfigLoaded()
+        const { localeOptions } = getThemeConfig()
         await prepareThemeData(app, localeOptions)
         await prepareData(app)
       },
 
       onWatched: (app, watchers) => {
-        watchConfigFile(app, watchers)
-        watchPrepare(app, watchers)
+        watchConfigFile(app, watchers, async ({ localeOptions }) => {
+          await prepareThemeData(app, localeOptions)
+          await prepareData(app)
+        })
         watchAutoFrontmatter(app, watchers, () => {
-          const autoFrontmatter = getResolvedThemeConfig().autoFrontmatter ?? pluginOptions.frontmatter
+          const autoFrontmatter = getThemeConfig().autoFrontmatter
+            ?? pluginOptions.frontmatter
           return autoFrontmatter !== false
         })
+        watchPrepare(app, watchers)
       },
-
-      extendsPage: async (page) => {
-        const { localeOptions, autoFrontmatter } = await waitForConfigLoaded()
-        if ((autoFrontmatter ?? pluginOptions.frontmatter) !== false) {
-          await waitForAutoFrontmatter()
-        }
-        extendsPageData(page as Page<PlumeThemePageData>, localeOptions)
-        resolvePageHead(page, localeOptions)
-      },
-
-      extendsBundlerOptions,
-
-      templateBuildRenderer,
     }
   }
 }

From 0af13914968267db7152215914e1d9d5912fcacb Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:16:40 +0800
Subject: [PATCH 10/14] chore: update `tm-grammars` to latest

---
 plugins/plugin-md-power/package.json |  2 +-
 pnpm-lock.yaml                       | 16 ++++++----------
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/plugins/plugin-md-power/package.json b/plugins/plugin-md-power/package.json
index baf569eb..3cf40dfb 100644
--- a/plugins/plugin-md-power/package.json
+++ b/plugins/plugin-md-power/package.json
@@ -45,7 +45,7 @@
     "markdown-it-container": "^4.0.0",
     "nanoid": "^5.0.7",
     "shiki": "^1.14.1",
-    "tm-grammars": "^1.17.4",
+    "tm-grammars": "^1.17.8",
     "tm-themes": "^1.8.1",
     "vue": "^3.4.38"
   },
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index ba9256b9..5fb72cf9 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -166,8 +166,8 @@ importers:
         specifier: ^1.14.1
         version: 1.14.1
       tm-grammars:
-        specifier: ^1.17.4
-        version: 1.17.4
+        specifier: ^1.17.8
+        version: 1.17.8
       tm-themes:
         specifier: ^1.8.1
         version: 1.8.1
@@ -403,9 +403,6 @@ packages:
     peerDependencies:
       '@algolia/client-search': '>= 4.9.1 < 6'
       algoliasearch: '>= 4.9.1 < 6'
-    peerDependenciesMeta:
-      '@algolia/client-search':
-        optional: true
 
   '@algolia/cache-browser-local-storage@4.20.0':
     resolution: {integrity: sha512-uujahcBt4DxduBTvYdwO3sBfHuJvJokiC3BP1+O70fglmE1ShkH8lpXqZBac1rrU3FnNYSUs4pL9lBdTKeRPOQ==}
@@ -5369,8 +5366,8 @@ packages:
   tinyexec@0.2.0:
     resolution: {integrity: sha512-au8dwv4xKSDR+Fw52csDo3wcDztPdne2oM1o/7LFro4h6bdFmvyUAeAfX40pwDtzHgRFqz1XWaUqgKS2G83/ig==}
 
-  tm-grammars@1.17.4:
-    resolution: {integrity: sha512-FuZ+f/pwYcKy4Ci56r75d4mRLBsdLUJunIgF+1u5Oy0co9laQqZFH1rss+F6/vdx1vJljPubZj9clKxrwTKg0A==}
+  tm-grammars@1.17.8:
+    resolution: {integrity: sha512-Qw67JNutL9LCt8FFw5RfsogeQ40iSeqrTHDSp0ecnY/b+ZweK8izlw6y/ZMje2+I6DMtTiBOCgmXEf+2oH11jQ==}
 
   tm-themes@1.8.1:
     resolution: {integrity: sha512-jTUfDRn5TysYhkxxEWBQDo1C1n4yoHcnfNNqXkVxIMGQCgal/9poGuMBsfbnZCPEmFVcN2rtrUwaOJ8s2hVQXg==}
@@ -5907,9 +5904,8 @@ snapshots:
 
   '@algolia/autocomplete-shared@1.9.3(@algolia/client-search@4.20.0)(algoliasearch@4.20.0)':
     dependencies:
-      algoliasearch: 4.20.0
-    optionalDependencies:
       '@algolia/client-search': 4.20.0
+      algoliasearch: 4.20.0
 
   '@algolia/cache-browser-local-storage@4.20.0':
     dependencies:
@@ -11462,7 +11458,7 @@ snapshots:
 
   tinyexec@0.2.0: {}
 
-  tm-grammars@1.17.4: {}
+  tm-grammars@1.17.8: {}
 
   tm-themes@1.8.1: {}
 

From 4b2739bff0401e94a4122c2a058daa73edb10b0e Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 19:39:40 +0800
Subject: [PATCH 11/14] perf(theme): optimize auto frontmatter

---
 theme/src/node/autoFrontmatter/generator.ts |  5 +++--
 theme/src/node/theme.ts                     | 12 +++---------
 theme/src/shared/options/plugins.ts         |  6 ------
 3 files changed, 6 insertions(+), 17 deletions(-)

diff --git a/theme/src/node/autoFrontmatter/generator.ts b/theme/src/node/autoFrontmatter/generator.ts
index ef4d2bf4..b9969122 100644
--- a/theme/src/node/autoFrontmatter/generator.ts
+++ b/theme/src/node/autoFrontmatter/generator.ts
@@ -12,6 +12,7 @@ import type {
   AutoFrontmatterObject,
   PlumeThemeLocaleOptions,
 } from '../../shared/index.js'
+import { getThemeConfig } from '../loadConfig/index.js'
 import { readMarkdown, readMarkdownList } from './readFile.js'
 import { resolveOptions } from './resolveOptions.js'
 
@@ -69,7 +70,7 @@ export async function generateAutoFrontmatter(app: App) {
   )
 }
 
-export async function watchAutoFrontmatter(app: App, watchers: any[], enable?: () => boolean) {
+export async function watchAutoFrontmatter(app: App, watchers: any[]) {
   if (!generate)
     return
 
@@ -80,7 +81,7 @@ export async function watchAutoFrontmatter(app: App, watchers: any[], enable?: (
   })
 
   watcher.on('add', async (relativePath) => {
-    const enabled = enable ? enable() : true
+    const enabled = getThemeConfig().autoFrontmatter !== false
     if (!generate!.globFilter(relativePath) || !enabled)
       return
     const file = await readMarkdown(app.dir.source(), relativePath)
diff --git a/theme/src/node/theme.ts b/theme/src/node/theme.ts
index 2dba7e69..ab97fc6a 100644
--- a/theme/src/node/theme.ts
+++ b/theme/src/node/theme.ts
@@ -17,10 +17,8 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
     initConfigLoader(app, localeOptions, {
       configFile,
       onChange: ({ localeOptions, autoFrontmatter }) => {
-        autoFrontmatter ??= pluginOptions.frontmatter
-        if (autoFrontmatter !== false) {
+        if (autoFrontmatter !== false)
           initAutoFrontmatter(localeOptions, autoFrontmatter)
-        }
       },
     })
 
@@ -43,7 +41,7 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
 
       extendsMarkdown: async (_, app) => {
         const { autoFrontmatter } = await waitForConfigLoaded()
-        if ((autoFrontmatter ?? pluginOptions.frontmatter) !== false) {
+        if (autoFrontmatter !== false) {
           await generateAutoFrontmatter(app)
           // wait for autoFrontmatter generated
           // i/o performance
@@ -73,11 +71,7 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
           await prepareThemeData(app, localeOptions)
           await prepareData(app)
         })
-        watchAutoFrontmatter(app, watchers, () => {
-          const autoFrontmatter = getThemeConfig().autoFrontmatter
-            ?? pluginOptions.frontmatter
-          return autoFrontmatter !== false
-        })
+        watchAutoFrontmatter(app, watchers)
         watchPrepare(app, watchers)
       },
     }
diff --git a/theme/src/shared/options/plugins.ts b/theme/src/shared/options/plugins.ts
index a50abc2e..639a15d4 100644
--- a/theme/src/shared/options/plugins.ts
+++ b/theme/src/shared/options/plugins.ts
@@ -6,7 +6,6 @@ import type { MarkdownEnhancePluginOptions } from 'vuepress-plugin-md-enhance'
 import type { ReadingTimePluginOptions } from '@vuepress/plugin-reading-time'
 import type { MarkdownPowerPluginOptions } from 'vuepress-plugin-md-power'
 import type { WatermarkPluginOptions } from '@vuepress/plugin-watermark'
-import type { AutoFrontmatter } from '../auto-frontmatter.js'
 
 export interface PlumeThemePluginOptions {
   /**
@@ -62,11 +61,6 @@ export interface PlumeThemePluginOptions {
    */
   baiduTongji?: false | { key: string }
 
-  /**
-   * @deprecated 使用 `autoFrontmatter` 代替
-   */
-  frontmatter?: Omit<AutoFrontmatter, 'frontmatter'>
-
   /**
    * 阅读时间、字数统计
    */

From 220940b2a574761d69269d0c76c6db1a4d33af01 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 21:39:11 +0800
Subject: [PATCH 12/14] perf(theme): optimize `<LinkCard /> ui

---
 docs/notes/theme/guide/组件/卡片.md           |  5 +++
 docs/notes/theme/guide/组件/链接卡片.md       | 45 +++++++++++++++++++
 .../client/components/global/VPLinkCard.vue   |  5 ++-
 3 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/docs/notes/theme/guide/组件/卡片.md b/docs/notes/theme/guide/组件/卡片.md
index c07992ef..327bf06b 100644
--- a/docs/notes/theme/guide/组件/卡片.md
+++ b/docs/notes/theme/guide/组件/卡片.md
@@ -55,3 +55,8 @@ permalink: /guide/components/cark/
   </template>
   这里是卡片内容。
 </Card>
+
+:::info
+在插槽内也可以使用 markdown 语法，但需要注意的是，markdown 语法需要与 标签之间间隔一行。
+否则将被识别为普通文本。
+:::
diff --git a/docs/notes/theme/guide/组件/链接卡片.md b/docs/notes/theme/guide/组件/链接卡片.md
index 78e0c017..3a8679c0 100644
--- a/docs/notes/theme/guide/组件/链接卡片.md
+++ b/docs/notes/theme/guide/组件/链接卡片.md
@@ -39,3 +39,48 @@ permalink: /guide/components/link-card/
 
 <LinkCard title="卡片标题" href="/" description="这里是卡片内容" />
 <LinkCard icon="twemoji:astonished-face" title="卡片标题" href="/" />
+
+使用组件插槽，可以实现更丰富的表现。
+
+**输入：**
+
+```md :no-line-numbers
+<LinkCard title="卡片标题" href="/">
+
+  - 这里是卡片内容
+  - 这里是卡片内容
+
+</LinkCard>
+
+<LinkCard href="/">
+  <template #title>
+    <span style="color: red" >卡片标题</span>
+  </template>
+
+  - 这里是卡片内容
+  - 这里是卡片内容
+
+</LinkCard>
+```
+
+**输出：**
+<LinkCard title="卡片标题" href="/">
+
+- 这里是卡片内容
+- 这里是卡片内容
+
+</LinkCard>
+
+<LinkCard href="/">
+  <template #title>
+    <span style="color: red" >卡片标题</span>
+  </template>
+
+- 这里是卡片内容
+- 这里是卡片内容
+</LinkCard>
+
+:::info
+在插槽内也可以使用 markdown 语法，但需要注意的是，markdown 语法需要与 标签之间间隔一行。
+否则将被识别为普通文本。
+:::
diff --git a/theme/src/client/components/global/VPLinkCard.vue b/theme/src/client/components/global/VPLinkCard.vue
index 7a9a3ccf..b07a9e9c 100644
--- a/theme/src/client/components/global/VPLinkCard.vue
+++ b/theme/src/client/components/global/VPLinkCard.vue
@@ -52,11 +52,12 @@ defineProps<{
   display: flex;
   flex: 1;
   flex-direction: column;
+  gap: 16px;
   align-items: flex-start;
 }
 
-.vp-link-card .body > :last-child {
-  margin-bottom: 0;
+.vp-link-card .body > * {
+  margin: 0;
 }
 
 .vp-link-card .link {

From 2443f99f46542c19116f31ae51f80842843572e5 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 22:31:34 +0800
Subject: [PATCH 13/14] docs: update notes config

---
 docs/.vuepress/notes.ts                 | 165 ------------------------
 docs/.vuepress/notes/en/index.ts        |   7 +
 docs/.vuepress/notes/index.ts           |   2 +
 docs/.vuepress/notes/zh/index.ts        |  16 +++
 docs/.vuepress/notes/zh/plugins.ts      |  32 +++++
 docs/.vuepress/notes/zh/theme-config.ts |  46 +++++++
 docs/.vuepress/notes/zh/theme-guide.ts  | 147 +++++++++++++++++++++
 docs/.vuepress/notes/zh/tools.ts        |  17 +++
 docs/.vuepress/plume.config.ts          |   2 +-
 theme/src/node/theme.ts                 |   3 +-
 10 files changed, 270 insertions(+), 167 deletions(-)
 delete mode 100644 docs/.vuepress/notes.ts
 create mode 100644 docs/.vuepress/notes/en/index.ts
 create mode 100644 docs/.vuepress/notes/index.ts
 create mode 100644 docs/.vuepress/notes/zh/index.ts
 create mode 100644 docs/.vuepress/notes/zh/plugins.ts
 create mode 100644 docs/.vuepress/notes/zh/theme-config.ts
 create mode 100644 docs/.vuepress/notes/zh/theme-guide.ts
 create mode 100644 docs/.vuepress/notes/zh/tools.ts

diff --git a/docs/.vuepress/notes.ts b/docs/.vuepress/notes.ts
deleted file mode 100644
index c3a25f95..00000000
--- a/docs/.vuepress/notes.ts
+++ /dev/null
@@ -1,165 +0,0 @@
-import { defineNotesConfig } from 'vuepress-theme-plume'
-
-export const zhNotes = defineNotesConfig({
-  dir: 'notes',
-  link: '/',
-  notes: [
-    {
-      dir: 'theme/guide',
-      link: '/guide/',
-      sidebar: [
-        {
-          text: '快速开始',
-          collapsed: false,
-          icon: 'carbon:idea',
-          items: ['介绍', '安装与使用', '博客', '知识笔记', '编写文章', '国际化', '部署'],
-        },
-        {
-          text: '写作',
-          icon: 'fluent-mdl2:edit-create',
-          collapsed: false,
-          items: [
-            {
-              text: 'markdown',
-              icon: 'material-symbols:markdown-outline',
-              prefix: 'markdown',
-              collapsed: true,
-              items: ['基础', '扩展', '进阶'],
-            },
-            {
-              text: '代码块',
-              prefix: '代码',
-              icon: 'ph:code-bold',
-              collapsed: true,
-              items: ['介绍', '特性支持', '代码组', '导入代码', 'twoslash'],
-            },
-            {
-              text: '代码演示',
-              prefix: '代码演示',
-              icon: 'carbon:demo',
-              collapsed: true,
-              items: ['前端', 'rust', 'golang', 'kotlin', 'codepen', 'jsFiddle', 'codeSandbox', 'replit'],
-            },
-            {
-              text: '图表',
-              icon: 'mdi:chart-line',
-              prefix: '图表',
-              collapsed: true,
-              items: ['chart', 'echarts', 'mermaid', 'flowchart'],
-            },
-            {
-              text: '资源嵌入',
-              icon: 'dashicons:embed-video',
-              prefix: '嵌入',
-              collapsed: true,
-              items: ['pdf', 'bilibili', 'youtube'],
-            },
-          ],
-        },
-        {
-          text: '功能',
-          icon: 'lucide:box',
-          collapsed: false,
-          prefix: '功能',
-          items: ['图标', '代码复制', '内容搜索', '评论', '加密', '文章水印', '友情链接页', 'seo', 'sitemap'],
-        },
-        {
-          text: '组件',
-          prefix: '组件',
-          icon: 'uiw:component',
-          collapsed: false,
-          items: ['徽章', '图标', '隐秘文本', '卡片', '链接卡片', '图片卡片', '卡片容器', '首页布局容器', 'repoCard', 'npmBadge'],
-        },
-        {
-          text: '自定义',
-          icon: 'material-symbols:dashboard-customize-outline-rounded',
-          collapsed: false,
-          items: ['自定义首页', '自定义样式', '布局插槽', '组件覆写'],
-        },
-        {
-          text: 'API',
-          icon: 'mdi:api',
-          collapsed: false,
-          items: ['api-客户端', 'api-node'],
-        },
-      ],
-    },
-    {
-      dir: 'theme/config',
-      link: '/config/',
-      sidebar: [
-        {
-          text: '配置',
-          collapsed: false,
-          items: [
-            '配置说明',
-            '多语言配置',
-            '主题配置',
-            '导航栏配置',
-            'notes配置',
-            '侧边栏配置',
-          ],
-        },
-        {
-          text: 'frontmatter',
-          prefix: 'frontmatter',
-          collapsed: false,
-          items: ['basic', 'home', 'post', 'friend'],
-        },
-        {
-          text: '内置插件',
-          prefix: 'plugins',
-          collapsed: false,
-          items: ['', '代码高亮', '搜索', '阅读统计', 'markdown增强', 'markdownPower', '百度统计', '水印'],
-        },
-      ],
-    },
-    {
-      dir: 'plugins',
-      link: '/plugins/',
-      sidebar: [
-        {
-          text: '插件',
-          link: '/plugins/',
-          items: [
-            // 'caniuse',
-            // 'iconify',
-            'shiki',
-            'md-power',
-            'content-updated',
-            {
-              text: 'plugin-netlify-functions',
-              dir: 'netlify-functions',
-              link: '/plugins/plugin-netlify-functions/',
-              collapsed: true,
-              items: [
-                '介绍',
-                '使用',
-                '功能',
-                'api',
-                'functions',
-              ],
-            },
-          ],
-        },
-      ],
-    },
-    {
-      dir: 'tools',
-      link: '/tools/',
-      sidebar: [
-        {
-          text: '工具',
-          icon: 'tabler:tools',
-          items: ['custom-theme', 'home-hero-tint-plate', 'caniuse'],
-        },
-      ],
-    },
-  ],
-})
-
-export const enNotes = defineNotesConfig({
-  dir: 'en/notes',
-  link: '/',
-  notes: [],
-})
diff --git a/docs/.vuepress/notes/en/index.ts b/docs/.vuepress/notes/en/index.ts
new file mode 100644
index 00000000..72e649b7
--- /dev/null
+++ b/docs/.vuepress/notes/en/index.ts
@@ -0,0 +1,7 @@
+import { defineNotesConfig } from 'vuepress-theme-plume'
+
+export const enNotes = defineNotesConfig({
+  dir: 'en/notes',
+  link: '/',
+  notes: [],
+})
diff --git a/docs/.vuepress/notes/index.ts b/docs/.vuepress/notes/index.ts
new file mode 100644
index 00000000..ef42cf6b
--- /dev/null
+++ b/docs/.vuepress/notes/index.ts
@@ -0,0 +1,2 @@
+export * from './en/index.js'
+export * from './zh/index.js'
diff --git a/docs/.vuepress/notes/zh/index.ts b/docs/.vuepress/notes/zh/index.ts
new file mode 100644
index 00000000..fed5583d
--- /dev/null
+++ b/docs/.vuepress/notes/zh/index.ts
@@ -0,0 +1,16 @@
+import { defineNotesConfig } from 'vuepress-theme-plume'
+import { themeGuide } from './theme-guide'
+import { themeConfig } from './theme-config'
+import { plugins } from './plugins'
+import { tools } from './tools'
+
+export const zhNotes = defineNotesConfig({
+  dir: 'notes',
+  link: '/',
+  notes: [
+    themeGuide,
+    themeConfig,
+    plugins,
+    tools,
+  ],
+})
diff --git a/docs/.vuepress/notes/zh/plugins.ts b/docs/.vuepress/notes/zh/plugins.ts
new file mode 100644
index 00000000..87379775
--- /dev/null
+++ b/docs/.vuepress/notes/zh/plugins.ts
@@ -0,0 +1,32 @@
+import { defineNoteConfig } from 'vuepress-theme-plume'
+
+export const plugins = defineNoteConfig({
+  dir: 'plugins',
+  link: '/plugins/',
+  sidebar: [
+    {
+      text: '插件',
+      link: '/plugins/',
+      items: [
+        // 'caniuse',
+        // 'iconify',
+        'shiki',
+        'md-power',
+        'content-updated',
+        {
+          text: 'plugin-netlify-functions',
+          dir: 'netlify-functions',
+          link: '/plugins/plugin-netlify-functions/',
+          collapsed: true,
+          items: [
+            '介绍',
+            '使用',
+            '功能',
+            'api',
+            'functions',
+          ],
+        },
+      ],
+    },
+  ],
+})
diff --git a/docs/.vuepress/notes/zh/theme-config.ts b/docs/.vuepress/notes/zh/theme-config.ts
new file mode 100644
index 00000000..5eb18f45
--- /dev/null
+++ b/docs/.vuepress/notes/zh/theme-config.ts
@@ -0,0 +1,46 @@
+import { defineNoteConfig } from 'vuepress-theme-plume'
+
+export const themeConfig = defineNoteConfig({
+  dir: 'theme/config',
+  link: '/config/',
+  sidebar: [
+    {
+      text: '配置',
+      collapsed: false,
+      items: [
+        '配置说明',
+        '多语言配置',
+        '主题配置',
+        '导航栏配置',
+        'notes配置',
+        '侧边栏配置',
+      ],
+    },
+    {
+      text: 'frontmatter',
+      prefix: 'frontmatter',
+      collapsed: false,
+      items: [
+        'basic',
+        'home',
+        'post',
+        'friend',
+      ],
+    },
+    {
+      text: '内置插件',
+      prefix: 'plugins',
+      collapsed: false,
+      items: [
+        '',
+        '代码高亮',
+        '搜索',
+        '阅读统计',
+        'markdown增强',
+        'markdownPower',
+        '百度统计',
+        '水印',
+      ],
+    },
+  ],
+})
diff --git a/docs/.vuepress/notes/zh/theme-guide.ts b/docs/.vuepress/notes/zh/theme-guide.ts
new file mode 100644
index 00000000..beab6f91
--- /dev/null
+++ b/docs/.vuepress/notes/zh/theme-guide.ts
@@ -0,0 +1,147 @@
+import { defineNoteConfig } from 'vuepress-theme-plume'
+
+export const themeGuide = defineNoteConfig({
+  dir: 'theme/guide',
+  link: '/guide/',
+  sidebar: [
+    {
+      text: '快速开始',
+      collapsed: false,
+      icon: 'carbon:idea',
+      items: [
+        '介绍',
+        '安装与使用',
+        '博客',
+        '知识笔记',
+        '编写文章',
+        '国际化',
+        '部署',
+      ],
+    },
+    {
+      text: '写作',
+      icon: 'fluent-mdl2:edit-create',
+      collapsed: false,
+      items: [
+        {
+          text: 'markdown',
+          icon: 'material-symbols:markdown-outline',
+          prefix: 'markdown',
+          collapsed: true,
+          items: [
+            '基础',
+            '扩展',
+            '进阶',
+          ],
+        },
+        {
+          text: '代码块',
+          prefix: '代码',
+          icon: 'ph:code-bold',
+          collapsed: true,
+          items: [
+            '介绍',
+            '特性支持',
+            '代码组',
+            '导入代码',
+            'twoslash',
+          ],
+        },
+        {
+          text: '代码演示',
+          prefix: '代码演示',
+          icon: 'carbon:demo',
+          collapsed: true,
+          items: [
+            '前端',
+            'rust',
+            'golang',
+            'kotlin',
+            'codepen',
+            'jsFiddle',
+            'codeSandbox',
+            'replit',
+          ],
+        },
+        {
+          text: '图表',
+          icon: 'mdi:chart-line',
+          prefix: '图表',
+          collapsed: true,
+          items: [
+            'chart',
+            'echarts',
+            'mermaid',
+            'flowchart',
+          ],
+        },
+        {
+          text: '资源嵌入',
+          icon: 'dashicons:embed-video',
+          prefix: '嵌入',
+          collapsed: true,
+          items: [
+            'pdf',
+            'bilibili',
+            'youtube',
+          ],
+        },
+      ],
+    },
+    {
+      text: '功能',
+      icon: 'lucide:box',
+      collapsed: false,
+      prefix: '功能',
+      items: [
+        '图标',
+        '代码复制',
+        '内容搜索',
+        '评论',
+        '加密',
+        '文章水印',
+        '友情链接页',
+        'seo',
+        'sitemap',
+      ],
+    },
+    {
+      text: '组件',
+      prefix: '组件',
+      icon: 'uiw:component',
+      collapsed: false,
+      items: [
+        '徽章',
+        '图标',
+        '隐秘文本',
+        '卡片',
+        '链接卡片',
+        '图片卡片',
+        '卡片容器',
+        '首页布局容器',
+        'repoCard',
+        'npmBadge',
+      ],
+    },
+    {
+      text: '自定义',
+      icon: 'material-symbols:dashboard-customize-outline-rounded',
+      collapsed: false,
+      items: [
+        '自定义首页',
+        '自定义样式',
+        '布局插槽',
+        '组件覆写',
+      ],
+    },
+    {
+      text: 'API',
+      icon: 'mdi:api',
+      collapsed: false,
+      items: [
+        'api-客户端',
+        'api-node',
+      ],
+    },
+  ],
+})
diff --git a/docs/.vuepress/notes/zh/tools.ts b/docs/.vuepress/notes/zh/tools.ts
new file mode 100644
index 00000000..769c3d61
--- /dev/null
+++ b/docs/.vuepress/notes/zh/tools.ts
@@ -0,0 +1,17 @@
+import { defineNoteConfig } from 'vuepress-theme-plume'
+
+export const tools = defineNoteConfig({
+  dir: 'tools',
+  link: '/tools/',
+  sidebar: [
+    {
+      text: '工具',
+      icon: 'tabler:tools',
+      items: [
+        'custom-theme',
+        'home-hero-tint-plate',
+        'caniuse',
+      ],
+    },
+  ],
+})
diff --git a/docs/.vuepress/plume.config.ts b/docs/.vuepress/plume.config.ts
index 6464a896..c835f5e7 100644
--- a/docs/.vuepress/plume.config.ts
+++ b/docs/.vuepress/plume.config.ts
@@ -1,5 +1,5 @@
 import { defineThemeConfig } from 'vuepress-theme-plume'
-import { enNotes, zhNotes } from './notes.js'
+import { enNotes, zhNotes } from './notes/index.js'
 import { enNavbar, zhNavbar } from './navbar.js'
 
 export default defineThemeConfig({
diff --git a/theme/src/node/theme.ts b/theme/src/node/theme.ts
index ab97fc6a..14b0912c 100644
--- a/theme/src/node/theme.ts
+++ b/theme/src/node/theme.ts
@@ -40,8 +40,9 @@ export function plumeTheme(options: PlumeThemeOptions = {}): Theme {
       templateBuildRenderer,
 
       extendsMarkdown: async (_, app) => {
-        const { autoFrontmatter } = await waitForConfigLoaded()
+        const { autoFrontmatter, localeOptions } = await waitForConfigLoaded()
         if (autoFrontmatter !== false) {
+          initAutoFrontmatter(localeOptions, autoFrontmatter)
           await generateAutoFrontmatter(app)
           // wait for autoFrontmatter generated
           // i/o performance

From 03b645e7916db27488c34242a8b419bebb5743f9 Mon Sep 17 00:00:00 2001
From: pengzhanbo <volodymyr@foxmail.com>
Date: Fri, 30 Aug 2024 23:34:23 +0800
Subject: [PATCH 14/14] fix(theme): incorrect resolve page path when sidebar
 matched

---
 theme/src/client/composables/sidebar.ts  | 1 +
 theme/src/node/prepare/prepareSidebar.ts | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/theme/src/client/composables/sidebar.ts b/theme/src/client/composables/sidebar.ts
index f36323a3..92927d59 100644
--- a/theme/src/client/composables/sidebar.ts
+++ b/theme/src/client/composables/sidebar.ts
@@ -95,6 +95,7 @@ export function getSidebar(routePath: string, routeLocal: string): ResolvedSideb
     return resolveSidebarItems(_sidebar, routeLocal)
   }
   else if (isPlainObject(_sidebar)) {
+    routePath = decodeURIComponent(routePath)
     const dir
       = Object.keys(_sidebar)
         .sort((a, b) => b.split('/').length - a.split('/').length)
diff --git a/theme/src/node/prepare/prepareSidebar.ts b/theme/src/node/prepare/prepareSidebar.ts
index 69974f7f..4d2b7c62 100644
--- a/theme/src/node/prepare/prepareSidebar.ts
+++ b/theme/src/node/prepare/prepareSidebar.ts
@@ -93,8 +93,8 @@ function getAutoDirSidebar(
 
   while (nowIndex < maxIndex) {
     pages = pages.sort((prev, next) => {
-      const pi = prev.splitPath?.[nowIndex]?.match(/(\d+)\.(?=[^/]+$)/)?.[1]
-      const ni = next.splitPath?.[nowIndex]?.match(/(\d+)\.(?=[^/]+$)/)?.[1]
+      const pi = prev.splitPath?.[nowIndex]?.match(/(?:(\d+)\.)?(?=[^/]+$)/)?.[1]
+      const ni = next.splitPath?.[nowIndex]?.match(/(?:(\d+)\.)?(?=[^/]+$)/)?.[1]
       if (!pi || !ni)
         return 0
       return Number.parseFloat(pi) < Number.parseFloat(ni) ? -1 : 1