chore: improve debug logs

Author: billyyyyy3320

src/client/pagination.ts

@@ -17,7 +17,7 @@ class Pagination {
   public _indexPage: string;
 
   constructor(pagination, pages, route) {
-    debug(pagination);
+    debug('pagination', pagination);
     const { pages: paginationPages } = pagination;
     const { path } = route;
 
@@ -97,7 +97,7 @@ class PaginationGateway {
 
   getPagination(pid, id, route) {
     debug('id', id);
-    debug('this.paginations', this.paginations);
+    debug('pid', pid);
     const pagnination = this.paginations.filter(
       p => p.id === id && p.pid === pid
     )[0];

src/node/handleOptions.ts

@@ -10,6 +10,7 @@ import {
   FrontmatterTempMap,
   resolvePaginationConfig,
   UpperFirstChar,
+  logObject,
 } from './util';
 import { ClassifierTypeEnum } from './interface/Classifier';
 
@@ -173,10 +174,14 @@ export function handleOptions(
     });
   }
 
-  return {
+  const processedData = {
     pageEnhancers,
     frontmatterClassificationPages,
     extraPages,
     paginations,
   };
+
+  logObject('Handle options', processedData, true);
+
+  return processedData;
 }

src/node/index.ts

@@ -2,7 +2,7 @@ import { path, logger, chalk } from '@vuepress/shared-utils';
 import { handleOptions } from './handleOptions';
 import { registerPaginations } from './pagination';
 import { BlogPluginOptions } from './interface/Options';
-import { logPages, resolvePaginationConfig } from './util';
+import { logPages, logTable, logObject, resolvePaginationConfig } from './util';
 import { ClassifierTypeEnum, DefaultLayoutEnum } from './interface/Classifier';
 import { VuePressContext, VuePressPage } from './interface/VuePress';
 
@@ -131,6 +131,10 @@ module.exports = (options: BlogPluginOptions, ctx: VuePressContext) => {
         }
       }
 
+      for (const { map } of frontmatterClassificationPages) {
+        logTable('frontmatterClassificationPages.map', map);
+      }
+
       /**
        * 2.2 Store frontmatterClassificationPages in current context.
        */
@@ -197,6 +201,7 @@ module.exports = (options: BlogPluginOptions, ctx: VuePressContext) => {
       ];
 
       logPages(`Automatically Added Index Pages`, allExtraPages);
+      logObject(`Pagination data sources`, paginations);
 
       await Promise.all(allExtraPages.map(async page => ctx.addPage(page)));
       await registerPaginations(paginations, ctx);

src/node/pagination.ts

@@ -6,7 +6,7 @@ import {
   GetPaginationPageTitle,
   SerializedPagination,
 } from './interface/Pagination';
-import { logPages } from './util';
+import { logPages, logObject } from './util';
 
 /**
  * Divided an interval of several lengths into several equal-length intervals.
@@ -62,6 +62,9 @@ export async function registerPaginations(
     );
 
     const intervallers = getIntervallers(pages.length, lengthPerPage);
+
+    logObject(`${id}'s page intervaller`, intervallers);
+
     const pagination: SerializedPagination = {
       pid,
       id,
@@ -76,29 +79,31 @@ export async function registerPaginations(
     recordPageFilters(pid, filter);
     recordPageSorters(pid, sorter);
 
-    const extraPages = pagination.pages
-      .slice(1) // The index page has been generated.
-      .map(({ path }, index) => {
-        return {
-          permalink: path,
-          frontmatter: {
-            layout,
-            title: (getPaginationPageTitle as GetPaginationPageTitle)(
-              index,
+    if (pagination.pages.length > 1) {
+      const extraPages = pagination.pages
+        .slice(1) // The index page has been generated.
+        .map(({ path }, index) => {
+          return {
+            permalink: path,
+            frontmatter: {
+              layout,
+              title: (getPaginationPageTitle as GetPaginationPageTitle)(
+                index,
+                id,
+                pid
+              ),
+            },
+            meta: {
+              pid,
               id,
-              pid
-            ),
-          },
-          meta: {
-            pid,
-            id,
-          },
-        };
-      });
+            },
+          };
+        });
 
-    logPages(`Automatically generated pagination pages`, extraPages);
+      logPages(`Automatically generated pagination pages`, extraPages);
 
-    await Promise.all(extraPages.map(page => ctx.addPage(page)));
+      await Promise.all(extraPages.map(page => ctx.addPage(page)));
+    }
 
     ctx.serializedPaginations.push(pagination);
   }

src/node/util.ts

@@ -31,12 +31,40 @@ export function curryFrontmatterHandler(scope, map, path) {
   };
 }
 
+function PluginBlogLog(title) {
+  const chalk = require('chalk'); // eslint-disable-line
+  console.log();
+  console.log(chalk.cyan(`[@vuepress/plugin-blog] ====== ${title} ======`));
+}
+
+export function logObject(title, o, spread = false) {
+  if (env.isDebug) {
+    PluginBlogLog(title);
+    if (spread) {
+      for (const key in o) {
+        console.log(key, o[key]);
+        console.log();
+      }
+    } else {
+      console.log(o);
+      console.log();
+    }
+  }
+}
+
+export function logTable(title, data) {
+  if (env.isDebug) {
+    PluginBlogLog(title);
+    console.table(data);
+    console.log();
+  }
+}
+
 export function logPages(title, pages) {
   if (env.isDebug) {
     const table = require('text-table'); // eslint-disable-line
-    const chalk = require('chalk'); // eslint-disable-line
-    console.log();
-    console.log(chalk.cyan(`[@vuepress/plugin-blog] ====== ${title} ======`));
+
+    PluginBlogLog(title);
     const data: any[] = [['permalink', 'meta', 'pid', 'id', 'frontmatter']];
     data.push(
       ...pages.map(({ path, permalink, meta, pid, id, frontmatter }) => [