feat(theme): add support frontmatter excerpt for blog post, close #218 (#224)

theme/src/node/prepare/prepareBlogData.ts

@@ -80,14 +80,19 @@ export async function preparedBlogData(
       data.encrypt = true
     }
 
-    if (page.contentRendered.includes(EXCERPT_SPLIT)) {
-      const contents = page.contentRendered.split(EXCERPT_SPLIT)
-      let excerpt = contents[0]
-      // 删除摘要中的标题
-      excerpt = excerpt.replace(HEADING_RE, '')
-      data.excerpt = excerpt
+    const fmExcerpt = page.frontmatter.excerpt
+    if (fmExcerpt !== false) {
+      if (typeof fmExcerpt === 'string') {
+        data.excerpt = fmExcerpt
+      }
+      else if (page.contentRendered.includes(EXCERPT_SPLIT)) {
+        const contents = page.contentRendered.split(EXCERPT_SPLIT)
+        let excerpt = contents[0]
+        // 删除摘要中的标题
+        excerpt = excerpt.replace(HEADING_RE, '')
+        data.excerpt = excerpt
+      }
     }
-
     return data
   })
 

theme/src/shared/frontmatter/post.ts

@@ -2,9 +2,19 @@ import type { BlogPostCover } from 'vuepress-theme-plume'
 import type { PlumeThemePageFrontmatter } from './page.js'
 
 export interface PlumeThemePostFrontmatter extends PlumeThemePageFrontmatter {
+  /**
+   * 创建时间
+   */
   createTime?: string
-  author?: string
+
+  /**
+   * 文章标签
+   */
   tags?: string[]
+
+  /**
+   * 是否置顶
+   */
   sticky?: boolean | number
   /**
    * @deprecated 使用 `draft` 代替
@@ -23,4 +33,9 @@ export interface PlumeThemePostFrontmatter extends PlumeThemePageFrontmatter {
    * 文章封面图
    */
   cover?: string | BlogPostCover
+
+  /**
+   * 是否展示文章摘要，传入 string 时为自定义摘要，此时 `<!-- more -->` 无效
+   */
+  excerpt?: boolean | string
 }