feat: support configuring pagination globally (#20)

* feat: accept global pagination config

* refactor: remove lengthy definition

* chore: update example

* docs: update documentation

Author: billyyyyy3320

Diff for: docs/config/README.md

@@ -97,9 +97,10 @@ For more details about permalinks, please head to [Permalinks](https://v1.vuepre
 ### pagination
 
 - Type: `Pagination`
-- Default: `{ lengthPerPage: 10 }`
 - Required: `false`
 
+It can overwrite [globalPagination](./#globalpagination).
+
 Please head to [Pagination Config](../pagination/README.md#config) section to get all available options.
 
 ## frontmatters
@@ -173,7 +174,17 @@ Layout component name for scope page.
 ### pagination
 
 - Type: `Pagination`
-- Default: `{ lengthPerPage: 10 }`
+- Required: `false`
+
+It can overwrite [globalPagination](./#globalpagination).
+
+Please head to [Pagination Config](../pagination/README.md#config) section to get all available options.
+
+## globalPagination
+
+Pagination config for all directories and frontmatters. 
+
+- Type: `Pagination`
 - Required: `false`
 
 Please head to [Pagination Config](../pagination/README.md#config) section to get all available options.

Diff for: examples/blog/.vuepress/config.js

@@ -21,9 +21,6 @@ module.exports = {
           // layout: 'IndexArchive', defaults to `Layout.vue`
           itemLayout: 'Post',
           itemPermalink: '/archive/:year/:month/:day/:slug',
-          pagination: {
-            lengthPerPage: 5,
-          },
         },
       ],
       frontmatters: [
@@ -33,21 +30,18 @@ module.exports = {
           path: '/tag/',
           // layout: 'Tag', defaults to `FrontmatterKey`.
           frontmatter: { title: 'Tag' },
-          pagination: {
-            lengthPerPage: 3
-          }
         },
         {
           id: "location",
           keys: ['location'],
           path: '/location/',
           // layout: 'Location', defaults to `FrontmatterKey`.
           frontmatter: { title: 'Location' },
-          pagination: {
-            lengthPerPage: 5
-          },
         }
-      ]
+      ],
+      globalPagination: {
+        lengthPerPage: 5
+      }
     }],
   ],
 }

Diff for: src/node/handleOptions.ts

@@ -24,7 +24,7 @@ export function handleOptions(
   options: BlogPluginOptions,
   ctx: VuePressContext,
 ) {
-  let { directories = [], frontmatters = [] } = options
+  let { directories = [], frontmatters = [], globalPagination = {} as PaginationConfig } = options
 
   /**
    * Validate the existence of directory specified by directory classifier.
@@ -61,9 +61,7 @@ export function handleOptions(
       frontmatter,
       itemLayout = 'Post',
       itemPermalink = '/:year/:month/:day/:slug',
-      pagination = {
-        lengthPerPage: 10,
-      } as PaginationConfig,
+      pagination = {} as PaginationConfig,
     } = directory
 
     /**
@@ -115,6 +113,7 @@ export function handleOptions(
       },
       ...resolvePaginationConfig(
         ClassifierTypeEnum.Directory,
+        globalPagination,
         pagination,
         indexPath,
         ctx,
@@ -135,9 +134,7 @@ export function handleOptions(
       layout: indexLayout,
       scopeLayout,
       frontmatter,
-      pagination = {
-        lengthPerPage: 10,
-      } as PaginationConfig,
+      pagination = {} as PaginationConfig,
     } = frontmatterPage
 
     if (!indexPath) {

Diff for: src/node/index.ts

@@ -111,6 +111,7 @@ module.exports = (options: BlogPluginOptions, ctx: VuePressContext) => {
                 },
                 ...resolvePaginationConfig(
                   ClassifierTypeEnum.Frontmatter,
+                  options.globalPagination,
                   pagination,
                   indexPath,
                   ctx,
@@ -215,7 +216,7 @@ function mapToString(map, unstringedKeys: string[] | boolean = []) {
       keys === true || (Array.isArray(keys) && keys.includes(key))
         ? map[key]
         : JSON.stringify(map[key])
-    },\n`
+      },\n`
   }
   str += '}'
   return str

Diff for: src/node/interface/Options.ts

@@ -83,4 +83,5 @@ export interface FrontmatterClassifier {
 export interface BlogPluginOptions {
   directories: DirectoryClassifier[];
   frontmatters: FrontmatterClassifier[];
+  globalPagination: PaginationConfig
 }

Diff for: src/node/util.ts

@@ -40,13 +40,13 @@ export function logPages(title, pages) {
     data.push(
       ...pages.map(({ // @ts-ignore
         path, permalink, meta, pid, id, frontmatter }) => [
-        // @ts-ignore // @ts-ignore
-        permalink || path || '',
-        JSON.stringify(meta) || '',
-        pid || '',
-        id || '',
-        JSON.stringify(frontmatter) || '',
-      ]),
+          // @ts-ignore // @ts-ignore
+          permalink || path || '',
+          JSON.stringify(meta) || '',
+          pid || '',
+          id || '',
+          JSON.stringify(frontmatter) || '',
+        ]),
     )
     console.log(table(data))
     console.log()
@@ -55,8 +55,9 @@ export function logPages(title, pages) {
 
 export function resolvePaginationConfig(
   classifierType: ClassifierTypeEnum,
-  pagination = {} as PaginationConfig,
-  indexPath,
+  globalPagination: PaginationConfig,
+  pagination: PaginationConfig,
+  indexPath: string,
   ctx: VuePressContext,
   keys: string[] = [''], // ['js']
 ) {
@@ -86,6 +87,7 @@ export function resolvePaginationConfig(
         return prevTime - nextTime > 0 ? -1 : 1
       },
     },
+    globalPagination,
     pagination,
   )
 }