Explicit paging

README.md

@@ -22,6 +22,9 @@ archive_generator:
   monthly: true
   daily: false
   order_by: -date
+  explicit_paging: false
+  overwrite_latest: false
+  verbose: false
 ```
 
 - **enabled**: The default value is **true**, set to **false** if you do not want to enable the plugin
@@ -30,6 +33,9 @@ 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`)
+- **overwrite_latest**: Set the latest page. (`latest/index.html` in place of `page/N/index.html`)
+- **verbose**: verbose output. (Output all generated routes)
 
 ## License
 

lib/generator.js

@@ -20,12 +20,25 @@ 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: (config.archive_generator.explicit_paging || config.archive_generator.overwrite_latest || false),
       data: options
-    }));
+    });
+
+    if ((config.archive_generator.overwrite_latest || false) && pages.length > 0) {
+      const lastPage = pages[pages.length - 1];
+      lastPage.path = lastPage.path.replace(/\/page\/\d+\/?$/, '/latest/');
+    }
+
+    if (config.archive_generator.verbose || false) {
+      pages.forEach(page => {
+        console.log(`Generated archive route: ${page.path}`);
+      });
+    }
+    result.push(...pages);
   }
 
   generate(archiveDir, allPosts);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-generator-archive",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Archive generator for Hexo.",
   "main": "index",
   "scripts": {
@@ -33,7 +33,7 @@
     "mocha": "^10.0.0"
   },
   "dependencies": {
-    "hexo-pagination": "3.0.0"
+    "hexo-pagination": "4.0.0"
   },
   "engines": {
     "node": ">=14"