hexo-generator-archive-alphabet
Generate alphabetical archive for Hexo.
It will generate an /archive.html page which is sorted by alphabet.
Impressed by hexo-generator-archive.
NOTICE: You can only choose one of the two plugins, hexo-generator-archive or hexo-generator-archive-alphabet.
NOTICE: You should probably need to modify your theme's archive template to adapt this plugin. See Usage for more information.
A live site using this plugin: http://js-index.com/
And the GitHub repo for that site: https://github.com/xcatliu/js-index
For an i18n version of this plugin: https://github.com/xcatliu/hexo-generator-archive-alphabet-i18n
Installation
$ npm install hexo-generator-archive-alphabet --saveUsage
After using this plugin, every posts will come up with an additional property alphabet, which means the first letter of the title of the post.
There are several rules of alphabet, let's see some examples:
| Title | alphabet |
Explanation |
|---|---|---|
| Hello World | H | The normal one |
| banana | B |
alphabet will always be uppercase |
| 1 world | # | If first letter is number, then alphabet will be #
|
| ä½ å¥½ä¸å›½ | N | If first letter is unicode character, then alphabet will be the translated first letter |
| _tail | _ | If first letter is other character, then alphabet will be _
|
| .dotfile | _ | As above |
Tip: You can easily compare the alphabet, it will return a common sense result:
'#' < 'A' // true
'A' < 'B' // true
'Z' < '_' // trueYou should probably need to modify your theme's archive template to adapt this plugin.
Or you can choose a theme that support this plugin. Like https://github.com/xcatliu/hexo-theme-wiki-i18n
Here is an example archive template:
<!DOCTYPE html>
<html>
<body>
<div class="container">
<%
var lastAlphabet = '';
page.posts.forEach(post => {
if (typeof post.alphabet === 'undefined') post.alphabet = '_';
if (lastAlphabet !== post.alphabet) {
lastAlphabet = post.alphabet; %>
<h3 class="words-title"><%= lastAlphabet %></h3>
<% } %>
<a class="word" href="<%= url_for(post.path) %>">
<%= post.title %>
</a>
<% }) %>
</div>
</body>
</html>See ??? for more details.
Options
archive_generator: per_page: 10
- per_page: Posts displayed per page. (0 = disable pagination)
