Explicit paging

README.md

@@ -22,6 +22,10 @@ archive_generator:
   monthly: true
   daily: false
   order_by: -date
+  explicit_paging: false
+  rename_last: false
+  localized_last: 'last'
+  verbose: false
 ```
 
 - **enabled**: The default value is **true**, set to **false** if you do not want to enable the plugin
@@ -30,6 +34,10 @@ archive_generator:
 - **monthly**: Generate monthly archive.
 - **daily**: Generate daily archive.
 - **order_by**: Posts order. (Order by date descending by default)
+- **explicit_paging**: Explicit paging. (Number the first page. e.g. `page/1/index.html`)
+- **rename_last**: Set the latest page. (`page/last/index.html` in place of `page/N/index.html`). If there is a single page it requires explicitPaging=true`.
+- **localized_last**: Localize the last page name. (`page/最後/index.html` in place of `page/last/index.html`).
+- **verbose**: verbose output. (Output all generated routes)
 
 ## License
 

lib/generator.js

@@ -11,6 +11,10 @@ module.exports = function(locals) {
   const paginationDir = config.pagination_dir || 'page';
   const allPosts = locals.posts.sort(config.archive_generator.order_by || '-date');
   const perPage = config.archive_generator.per_page;
+  const explicitPaging = config.archive_generator.explicit_paging || false;
+  const renameLast = config.archive_generator.rename_last || false;
+  const localizedLast = config.archive_generator.localized_last || 'last';
+  const verbose = config.archive_generator.verbose || false;
   const result = [];
 
   if (!allPosts.length) return;
@@ -20,12 +24,18 @@ module.exports = function(locals) {
   function generate(path, posts, options = {}) {
     options.archive = true;
 
-    result.push(...pagination(path, posts, {
+    const pages = pagination(path, posts, {
       perPage,
       layout: ['archive', 'index'],
       format: paginationDir + '/%d/',
+      explicitPaging: explicitPaging,
+      renameLast: renameLast,
+      localizedLast: localizedLast,
+      verbose: verbose,
       data: options
-    }));
+    });
+
+    result.push(...pages);
   }
 
   generate(archiveDir, allPosts);

package.json

@@ -33,7 +33,7 @@
     "mocha": "^10.0.0"
   },
   "dependencies": {
-    "hexo-pagination": "3.0.0"
+    "hexo-pagination": "4.0.0"
   },
   "engines": {
     "node": ">=14"