update README

hexojs · Apr 19, 2024 · 140cbcb · 140cbcb
1 parent 66eb314
commit 140cbcb
Showing 1 changed file with 26 additions and 25 deletions.
diff --git a/README.md b/README.md
@@ -8,49 +8,50 @@ Pagination utilities for [Hexo] generator plugins.
 
 ## Installation
 
-``` bash
+```bash
 $ npm install hexo-pagination --save
 ```
 
 ## Usage
 
 ### pagination(base, posts, [options])
 
-Option | Description | Default
---- | --- | ---
-`perPage` | Posts displayed per page | 10
-`format` | URL format | page/%d/
-`layout` | Layout. This value can be a string or an array. | ['archive', 'index']
-`data` | Extra data |
+| Option           | Description                                     | Default                |
+| ---------------- | ----------------------------------------------- | ---------------------- |
+| `perPage`        | Posts displayed per page                        | `10`                   |
+| `format`         | URL format                                      | `page/%d/`             |
+| `layout`         | Layout. This value can be a string or an array. | `['archive', 'index']` |
+| `data`           | Extra data                                      | `{}`                   |
+| `explicitPaging` | Number the first page. e.g. `page/1/index.html` | `false`                |
 
 For example:
 
-``` js
-var pagination = require('hexo-pagination');
+```js
+var pagination = require("hexo-pagination");
 
-pagination('/tags/hexo', [], {
+pagination("/tags/hexo", [], {
   perPage: 10,
-  format: 'page/%d/',
-  layout: ['archive', 'index'],
+  format: "page/%d/",
+  layout: ["archive", "index"],
   data: {
-    tag: 'hexo'
-  }
+    tag: "hexo",
+  },
 });
 ```
 
 This function returns an array containing objects with 3 properties: `path`, `layout`, `data`.
 
-Data | Description
---- | --- 
-`base` | Base URL
-`total` | Total pages
-`current` | Current page number
-`current_url` | Path of the current page (which equals to `path`)
-`posts` | The slice of posts for the current page
-`prev` | Previous page number
-`prev_link` | The path to the previous page
-`next` | Next page number
-`next_link` | The path to the next page
+| Data          | Description                                       |
+| ------------- | ------------------------------------------------- |
+| `base`        | Base URL                                          |
+| `total`       | Total pages                                       |
+| `current`     | Current page number                               |
+| `current_url` | Path of the current page (which equals to `path`) |
+| `posts`       | The slice of posts for the current page           |
+| `prev`        | Previous page number                              |
+| `prev_link`   | The path to the previous page                     |
+| `next`        | Next page number                                  |
+| `next_link`   | The path to the next page                         |
 
 ## License