diff --git a/.all-contributorsrc b/.all-contributorsrc
new file mode 100644
index 0000000000..e30e68f0c0
--- /dev/null
+++ b/.all-contributorsrc
@@ -0,0 +1,453 @@
+{
+ "projectName": "hexo-theme-next",
+ "projectOwner": "theme-next",
+ "repoType": "github",
+ "repoHost": "https://github.com",
+ "files": [
+ "README.md"
+ ],
+ "imageSize": 100,
+ "commit": true,
+ "contributors": [
+ {
+ "login": "ivan-nginx",
+ "name": "Ivan.Nginx",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/16944225?v=4",
+ "profile": "https://almostover.ru",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "ideas",
+ "blog",
+ "review",
+ "test",
+ "translation",
+ "design",
+ "infra",
+ "maintenance"
+ ]
+ },
+ {
+ "login": "sli1989",
+ "name": "Alex LEE",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/8521181?v=4",
+ "profile": "http://saili.science",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "tsanie",
+ "name": "Tsanie Lily",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/980449?v=4",
+ "profile": "https://tsanie.us",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "wafer-li",
+ "name": "Wafer Li",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/12459199?v=4",
+ "profile": "https://wafer.li",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "LEAFERx",
+ "name": "Lawrence Ye",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/20595509?v=4",
+ "profile": "https://leaferx.online",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "maple3142",
+ "name": "maple",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/9370547?v=4",
+ "profile": "https://blog.maple3142.net/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "Raincal",
+ "name": "Raincal",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/6279478?v=4",
+ "profile": "https://raincal.com",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test"
+ ]
+ },
+ {
+ "login": "geekrainy",
+ "name": "Rainy",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/7333266?v=4",
+ "profile": "https://rainylog.com",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test",
+ "translation"
+ ]
+ },
+ {
+ "login": "liolok",
+ "name": "李皓奇",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/34574198?v=4",
+ "profile": "https://liolok.github.io/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test"
+ ]
+ },
+ {
+ "login": "xCss",
+ "name": "Nine",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/10877162?v=4",
+ "profile": "http://ioliu.cn",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "test"
+ ]
+ },
+ {
+ "login": "jackey8616",
+ "name": "Clooooode",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/12930377?v=4",
+ "profile": "https://github.com/jackey8616",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "xu-song",
+ "name": "Xu Song",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/13825126?v=4",
+ "profile": "https://github.com/xu-song",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "HuntedCodes",
+ "name": "Jack Sullivan",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/10931391?v=4",
+ "profile": "https://github.com/HuntedCodes",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "dpyzo0o",
+ "name": "dpyzo0o",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/24768249?v=4",
+ "profile": "https://github.com/dpyzo0o",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "zhuzhuyule",
+ "name": "zhuzhuxia",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/11242146?v=4",
+ "profile": "http://zhuzhuyule.com",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "kuleyu",
+ "name": "kuleyu",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/25771340?v=4",
+ "profile": "https://kuleyu-hugo.netlify.com/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "jdhao",
+ "name": "jdhao",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/16662357?v=4",
+ "profile": "http://jdhao.github.io",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "Albert-Gao",
+ "name": "AlbertGao",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/18282328?v=4",
+ "profile": "http://www.albertgao.xyz",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "YoshinoriN",
+ "name": "YoshinoriN",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/11273093?v=4",
+ "profile": "https://yoshinorin.net/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "ZhaoQi99",
+ "name": "Qi Zhao",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/25344334?v=4",
+ "profile": "https://zhaoqi99.github.io/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "daya0576",
+ "name": "Henry Zhu",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/6239652?v=4",
+ "profile": "https://changchen.me/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "cxyfreedom",
+ "name": "CxyFreedom",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/8132652?v=4",
+ "profile": "https://github.com/cxyfreedom",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "KaitoHH",
+ "name": "KaitoHH",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/13927774?v=4",
+ "profile": "https://kaitohh.com/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "zhaojun1998",
+ "name": "赵俊",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/35387985?v=4",
+ "profile": "http://www.zhaojun.im",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "izyhang",
+ "name": "zyhang",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/13059924?v=4",
+ "profile": "https://github.com/izyhang",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "XiaolonY",
+ "name": "Xiaolong Yang",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/18529307?v=4",
+ "profile": "https://xiaolony.github.io",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "yzca",
+ "name": "花蛄",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/15226118?v=4",
+ "profile": "https://github.com/yzca",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "hengyunabc",
+ "name": "hengyunabc",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/1683936?v=4",
+ "profile": "http://hengyunabc.github.io/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "BlueFisher",
+ "name": "Fisher Chang",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/6104460?v=4",
+ "profile": "http://bluefisher.github.io",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "shenchsh",
+ "name": "Chanson Shen",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/4521477?v=4",
+ "profile": "http://chansonshen.com/",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "ywjno",
+ "name": "Thomas Yang",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/842383?v=4",
+ "profile": "http://ywjno.com",
+ "contributions": [
+ "bug",
+ "code",
+ "doc"
+ ]
+ },
+ {
+ "login": "legendarynacar",
+ "name": "Legendary Nacar",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/8149261?v=4",
+ "profile": "http://legendarynacar.github.io",
+ "contributions": [
+ "translation"
+ ]
+ },
+ {
+ "login": "Rikusen0335",
+ "name": "rikusen0335",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/19174234?v=4",
+ "profile": "https://github.com/Rikusen0335",
+ "contributions": [
+ "translation"
+ ]
+ },
+ {
+ "login": "JiangTJ",
+ "name": "Mr.J",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/15902347?v=4",
+ "profile": "https://www.dnocm.com",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "infra"
+ ]
+ },
+ {
+ "login": "1v9",
+ "name": "1v9",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/29083921?v=4",
+ "profile": "https://1v9.im",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "translation",
+ "review"
+ ]
+ },
+ {
+ "login": "stevenjoezhang",
+ "name": "Mimi",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/16272760?v=4",
+ "profile": "https://zhangshuqiao.org",
+ "contributions": [
+ "bug",
+ "code",
+ "doc",
+ "review",
+ "translation"
+ ]
+ },
+ {
+ "login": "zq-97",
+ "name": "张强",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/17429111?v=4",
+ "profile": "https://i-m.dev",
+ "contributions": [
+ "bug",
+ "code"
+ ]
+ }
+ ],
+ "contributorsPerLine": 6
+}
diff --git a/.bowerrc b/.bowerrc
new file mode 100644
index 0000000000..8013f263db
--- /dev/null
+++ b/.bowerrc
@@ -0,0 +1,3 @@
+{
+ "directory": "source/lib"
+}
diff --git a/.editorconfig b/.editorconfig
index 2305854a4d..f0627b937b 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -9,3 +9,6 @@ insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 2
+
+[*.py]
+indent_size = 4
diff --git a/.gitattributes b/.gitattributes
index 620b56b4a8..7ead58ec19 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1 +1,2 @@
source/lib/* linguist-vendored
+scripts/merge.js linguist-vendored
diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
index 4dd10e1ac7..93861acdd6 100644
--- a/.github/CODE_OF_CONDUCT.md
+++ b/.github/CODE_OF_CONDUCT.md
@@ -1,9 +1,6 @@
-
+
# 
e x T
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index e3d895caf1..8a679db43e 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -1,9 +1,6 @@
-
+
# 
e x T
@@ -14,8 +11,6 @@ First of all, thanks for taking your time to contribute and help make our projec
[How Can I Contribute?](#how-can-i-contribute)
* [Before Submitting An Issue](#before-submitting-an-issue)
- * [Read the docs](#read-the-docs)
- * [Quick debug instructions](quick-debug-instructions)
* [Reporting Bugs](#reporting-bugs)
* [Reporting Security Bugs](#reporting-security-bugs)
* [Suggesting Enhancements](#suggesting-enhancements)
@@ -29,30 +24,25 @@ First of all, thanks for taking your time to contribute and help make our projec
* [Labels Rules](#labels-rules)
* [Commit Messages Rules](#commit-messages-rules)
-## How Can I Contribute?
-
-### Before Submitting An Issue
+
-#### Read the docs
+## How Can I Contribute?
-If you just have a question, you'll get faster results by checking the [FAQs for a list of common questions and problems](https://theme-next.org/docs/faqs) or the [troubleshooting part of «NexT» Documentation Site](https://theme-next.org/docs/troubleshooting).
+Main Theme-Next repository was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [Theme-Next](https://github.com/theme-next) organization on GitHub. Most libraries under the `next/source/lib` directory was moved out to [external repos](https://github.com/theme-next) under NexT organization. Version 5 works fine at most cases, but for frequent users, you maybe need to [upgrade version 5 to 6](https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md) to get features and supports in new [Theme-Next](https://github.com/theme-next/hexo-theme-next) repository.
-Also, you can perform a [cursory search](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) to see if the problem has already been reported or solved. You don't want to duplicate effort. You might be able to find the cause of the problem and fix things yourself, or add comments to the existed issue.
+
-#### Quick debug instructions
+### Before Submitting An Issue
-Before submitting an Issue on GitHub, you can follow the steps below to debug:
+If you just have a question, you'll get faster results by checking the FAQs for a list of common questions and problems (Work in progress) or the [«NexT» Documentation Site](https://theme-next.org/docs/) (Work in progress).
-* Execute `hexo clean`, clear the browser cache and disable all CDN services (e.g. Cloudflare Rocket Loader)
-* Switch to another theme and check if the bug still exists (e.g. default theme landscape). In other words, prove that this is a NexT issue, not a issue from Hexo.
-* Upgrade theme NexT to the latest version.
-* Upgrade Hexo and Hexo plugins to the latest version.
-* Upgrade Node.js and `npm` to the latest version.
-* Uninstall all non-essential Hexo plugins, or reinstall all plugins using `npm install --save`.
+Also, you can perform a [cursory search](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) to see if the problem has already been reported or solved. You don't want to duplicate effort. You might be able to find the cause of the problem and fix things yourself, or add comments to the existed issue.
-If you get an error message from Hexo or your browser, please search in Google / Stackoverflow / GitHub Issues, or report it to us when submitting a new Issue.
+If you find a bug in the source code, most importantly, please check carefully if you can reproduce the problem [in the latest release version of Next](https://github.com/theme-next/hexo-theme-next/releases/latest). Then, you can help us by
+[Reporting Bugs](#reporting-bugs) or [Suggesting Enhancements](#suggesting-enhancements) to our [ Repository](https://github.com/theme-next/hexo-theme-next). Even better, you can
+[submit a Pull Request](#submitting-a-pull-request) with a fix.
-If you find a bug in the source code, most importantly, please check carefully if you can reproduce the problem [in the latest release version of Next](https://github.com/theme-next/hexo-theme-next/releases/latest). Then, you can help us by [Reporting Bugs](#reporting-bugs) or [Suggesting Enhancements](#suggesting-enhancements) to our [Repository](https://github.com/theme-next/hexo-theme-next). Even better, you can [submit a Pull Request](#submitting-a-pull-request) with a fix.
+
### Reporting Bugs
@@ -72,12 +62,16 @@ Following these guidelines helps maintainers and the community understand your r
* Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
* Explain which behavior you expected to see instead and why.
+
+
#### Reporting Security Bugs
If you find a security issue, please act responsibly and report it not in the public issue tracker, but directly to us, so we can fix it before it can be exploited. Please send the related information to security@theme-next.com (desirable with using PGP for e-mail encryption).
We will gladly special thanks to anyone who reports a vulnerability so that we can fix it. If you want to remain anonymous or pseudonymous instead, please let us know that; we will gladly respect your wishes.
+
+
### Suggesting Enhancements
Before creating enhancement suggestions, please check [this list](#before-submitting-an-issue) as you might find out that you don't need to create one. After you've determined the repository your enhancement suggestion is related to, create an issue on that repository and provide the information as many details as possible by filling in [the required template](ISSUE_TEMPLATE.md).
@@ -88,10 +82,30 @@ Following these guidelines helps maintainers and the community understand your s
* Describe the current behavior and explain which behavior you expected to see instead and Explain why this enhancement would be useful to most users.
* Provide specific examples to demonstrate the suggestion. Include links to files (screenshots or GIFs) or live demo.
+
+
### Submitting a Pull Request
Before creating a Pull Request (PR), please check [this list](#before-submitting-an-issue) as you might find out that you don't need to create one. After you've determined the repository your pull request is related to, create a pull request on that repository. The detailed document of creating a pull request can be found [here](https://help.github.com/articles/creating-a-pull-request/).
+1. On GitHub, navigate to the original page of the [hexo-theme-next](https://github.com/theme-next/hexo-theme-next). In the top-right corner of the page, click **Fork**.
+2. Under the repository name in your forked repository, click **Clone or download**. In the `Clone with SSH` section, copy the clone URL for the repository. Open Git Bash, and change the current working directory to the location where you want the cloned directory to be made. Type `git clone`, and then paste the URL you copied. Press **Enter**. Your local clone will be created.
+ ```bash
+ $ git clone git@github.com:username/hexo-theme-next.git
+ ```
+3. Navigate into your new cloned repository. Switch branches to the compare branch of the pull request where the original changes were made.
+ ```bash
+ $ cd hexo-theme-next
+ $ git checkout -b patchname
+ ```
+4. After you commit your changes to the head branch of the pull request you can push your changes up to the original pull request directly.
+ ```bash
+ $ git add .
+ $ git commit -m "add commit messamge"
+ $ git push origin patchname
+ ```
+5. Navigate to the original repository you created your fork from. To the right of the Branch menu, click **New pull request**. On the Compare page, confirm that the base fork is the repository you'd like to merge changes into. Use the base branch drop-down menu to select the branch of the upstream repository you'd like to merge changes into. Use the head fork drop-down menu to select your fork, then use the compare branch drop-down menu to select the branch you made your changes in. Click **Create pull request** and type a title and description for your pull request.
+
Following these guidelines helps maintainers and the community understand your pull request :pencil::
* Follow our [Coding Rules](#coding-rules) and [commit message conventions](#commit-messages-rules).
@@ -99,6 +113,8 @@ Following these guidelines helps maintainers and the community understand your p
* Fill in [the required template](PULL_REQUEST_TEMPLATE.md) as many details as possible.
* All features or bug fixes must be tested in all schemes. And provide specific examples to demonstrate the pull request. Include links to files (screenshots or GIFs) or live demo.
+
+
### Creating Releases
Releases are a great way to ship projects on GitHub to your users.
@@ -114,15 +130,23 @@ Releases are a great way to ship projects on GitHub to your users.
5. If you'd like to include binary files along with your release, such as compiled programs, drag and drop or select files manually in the binaries box.
6. If the release is unstable, select **This is a pre-release** to notify users that it's not ready for production. If you're ready to publicize your release, click **Publish release**. Otherwise, click **Save draft** to work on it later.
+
+
## Guides
+
+
### Coding Rules
This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md) to keep open and inclusive. By participating, you are expected to uphold this code.
+
+
### Coding Standards
-We use ESLint and Stylint for identifying and reporting on patterns in JavaScript and Stylus, with the goal of making code more consistent and avoiding bugs. These specifications should be followed when coding.
+To be continued.
+
+
### Labels Rules
@@ -130,51 +154,61 @@ We use "labels" in the issue tracker to help classify Pull requests and Issues.
If you are unsure what a label is about or which labels you should apply to a PR or issue, look no further!
-Issues related:
+Issues related: `types`+`contents`+`results`
- By types
+ - `Irrelevant`: An irrelevant issue for Next
+ - `Duplicate`: An issue which had been mentioned
- `Bug`: A detected bug that needs to be confirmed
+ - `Improvement Need`: An issue that needs improvement
- `Feature Request`: An issue that wants a new feature
+ - `High Priority`: A detected bug or misprint with high priority
+ - `Low Priority`: A detected bug or misprint with low priority
+ - `Non English`: Requires the attention of a multi-lingual maintainer
+ - `Discussion`: An issue that needs to be discussed
- `Question`: An issue about questions
+ - `Backlog`: An issue that is to be completed and later compensated
- `Meta`: Denoting a change of usage conditions
- - `Support`: An issue labeled as support requests
- - `Polls`: An issue that initiated a poll
+- By contents
+ - `Roadmap`: An issue about future development
+ - `Hexo`: An issue related to Hexo
+ - `Scheme [1] - Mist`: An issue related to Scheme Mist
+ - `Scheme [2] - Muse`: An issue related to Scheme Muse
+ - `Scheme [3] - Pisces`: An issue related to Scheme Pisces
+ - `Scheme [4] - Gemini`: An issue related to Scheme Gemini
+ - `3rd Party Service`: An issue related to 3rd party service
+ - `Docs`: Need to add instruction document
+ - `Configurations`: An issue related to configurations
+ - `CSS`: An issue related to CSS
+ - `Custom`: An issue related to custom things
- By results
- - `Duplicate`: An issue which had been mentioned
- - `Irrelevant`: An irrelevant issue for Next
- - `Invalid`: An issue that cannot be reproduced
- - `Expected Behavior`: An issue that corresponds to expected behavior
+ - `Wontfix`: An issue that will not to be fixed
- `Need More Info`: Need more information for solving the issue
+ - `Need Verify`: Need confirmation from the developers or user about the bug or solution
+ - `Can't Reproduce`: An issue that can’t be reproduced
- `Verified`: An issue that has been verified
+ - `Help Wanted`: An issue that needs help
+ - `Wait for Answer`: An issue that needs to be answered by the developers or user
+ - `Resolved Maybe`: An issue that has been resolved maybe
- `Solved`: An issue that has been solved
- - `Backlog`: An issue that is to be completed and later compensated
- `Stale`: This issue has been automatically marked as stale because lack of recent activity
Pull requests related:
- `Breaking Change`: A pull request that makes breaking change
+- `External Change`: A pull request that makes update for external change
- `Bug Fix`: A pull request that fixes the related bug
+- `Docs`: A pull request that Instruction document has been added
- `New Feature`: A pull request that provides a new feature
- `Feature`: A pull request that provides an option or addition to existing feature
+- `Improvement`: A pull request that improves NexT
- `i18n`: A pull request that makes new languages translation
-- `Work in Progress`: A pull request that is still working in progress
-- `Skip Release`: A pull request that should be excluded from release note
-
-Both:
-
-- `Roadmap`: An issue / pull request about future development
-- `Help Wanted`: An issue / pull request that needs help
-- `Discussion`: An issue / pull request that needs to be discussed
-- `Improvement`: An issue that needs improvement or a pull request that improves NexT
-- `Performance`: An issue / pull request that improves the performance
-- `Hexo`: An issue / pull request related to Hexo or Hexo plugins
-- `Template Engine`: An issue / pull request related to template engine
-- `CSS`: An issue / pull request related to CSS
-- `Fonts`: An issue / pull request related to fonts
-- `PJAX`: An issue / pull request related to PJAX
-- `3rd Party Plugin`: An issue / pull request related to 3rd party plugins & service
-- `Docs`: An issue / pull request related to instruction document
-- `Configurations`: An issue / pull request related to configurations
+- `Performance`: A pull request that improves the performance
+- `Discussion`: A pull request that needs to be discussed
+- `v6.x`: A pull request that bug fixes and some improvements, related to old NexT version 6
+- `v7.x`: A pull request that bug fixes and some improvements, related to old NexT version 7
+
+
### Commit Messages Rules
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
new file mode 100644
index 0000000000..8332ad0da8
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,84 @@
+
+
+### I agree and want to create new issue
+
+
+- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html).
+- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/).
+- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me.
+
+***
+
+### Expected behavior
+
+
+### Actual behavior
+
+
+### Steps to reproduce the behavior
+1. N/A
+2. N/A
+3. N/A
+
+* Link to demo site with this issue: N/A
+* Link(s) to source code or any usefull link(s): N/A
+
+### Node.js and NPM Information
+
+```
+
+```
+
+### Package dependencies Information
+
+```
+
+```
+
+### Hexo Information
+
+#### Hexo version
+
+```
+
+```
+
+#### Hexo Configuration
+
+```yml
+
+```
+
+### NexT Information
+
+**NexT Version:**
+
+
+- [ ] Latest Master branch
+- [ ] Latest Release version
+- [ ] Old version
+
+
+**NexT Scheme:**
+
+
+- [ ] All schemes
+- [ ] Muse
+- [ ] Mist
+- [ ] Pisces
+- [ ] Gemini
+
+
+#### NexT Configuration:
+
+```yml
+
+```
+
+### Other Information
diff --git a/.github/ISSUE_TEMPLATE/bug-report.md b/.github/ISSUE_TEMPLATE/bug-report.md
index 45be4043eb..d628069fdd 100644
--- a/.github/ISSUE_TEMPLATE/bug-report.md
+++ b/.github/ISSUE_TEMPLATE/bug-report.md
@@ -1,41 +1,41 @@
---
name: Bug Report
-about: Something isn't working as expected
+about: Create a report to help us improve.
title: ''
labels: Bug
assignees: ''
---
-Please follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.
-请按照此 Issue 模版提供相关信息,例如源码仓库、博客链接和屏幕截图,这将有助于我们进行调查。
+
-
+If you want to fast resolve your issue, WRITE IT IN ENGLISH, please. Not all contributors / collaborators know Chinese and Google translate can't always translate issues accurately. Thanks!
+-->
-- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.
-- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).
-- [ ] I have reviewed the latest Roadmap on GitHub and searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues), which does not help me.
+### I agree and want to create new issue
-***
+
+- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html).
+- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/).
+- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me.
-## Expected behavior
+***
+### Expected behavior
-## Actual behavior
-
-- Links to demo site with this issue: N/A
-- Links to repository or source code of the blog: N/A
+### Actual behavior
-## Steps to reproduce the behavior
+### Steps to reproduce the behavior
1. N/A
2. N/A
3. N/A
-
-## Environment Information
+* Link to demo site with this bug: N/A
+* Link(s) to source code or any usefull link(s): N/A
### Node.js and NPM Information
@@ -44,21 +44,49 @@ Please follow this Issue template to provide relevant information, such as sourc
```
### Package dependencies Information
-
+
+```
+
+```
+
+### Hexo Information
+
+#### Hexo version
+
```
```
-### Hexo Configuration
-
+#### Hexo Configuration
+
```yml
```
-### NexT Configuration
-
+### NexT Information
+
+**NexT Version:**
+
+
+- [ ] Latest Master branch
+- [ ] Latest Release version
+- [ ] Old version
+
+
+**NexT Scheme:**
+
+
+- [ ] All schemes
+- [ ] Muse
+- [ ] Mist
+- [ ] Pisces
+- [ ] Gemini
+
+
+#### NexT Configuration:
+
```yml
```
-## Other Information
+### Other Information
diff --git a/.github/ISSUE_TEMPLATE/custom-issue-template.md b/.github/ISSUE_TEMPLATE/custom-issue-template.md
new file mode 100644
index 0000000000..ff7061d3e1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/custom-issue-template.md
@@ -0,0 +1,92 @@
+---
+name: Custom Issue Template
+about: Describe this issue template's purpose here.
+title: ''
+labels: Custom
+assignees: ''
+
+---
+
+
+
+### I agree and want to create new issue
+
+
+- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html).
+- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/).
+- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me.
+
+***
+
+### Expected behavior
+
+
+### Actual behavior
+
+
+### Steps to reproduce the behavior
+1. N/A
+2. N/A
+3. N/A
+
+* Link to demo site with this issue: N/A
+* Link(s) to source code or any usefull link(s): N/A
+
+### Node.js and NPM Information
+
+```
+
+```
+
+### Package dependencies Information
+
+```
+
+```
+
+### Hexo Information
+
+#### Hexo version
+
+```
+
+```
+
+#### Hexo Configuration
+
+```yml
+
+```
+
+### NexT Information
+
+**NexT Version:**
+
+
+- [ ] Latest Master branch
+- [ ] Latest Release version
+- [ ] Old version
+
+
+**NexT Scheme:**
+
+
+- [ ] All schemes
+- [ ] Muse
+- [ ] Mist
+- [ ] Pisces
+- [ ] Gemini
+
+
+#### NexT Configuration:
+
+```yml
+
+```
+
+### Other Information
diff --git a/.github/ISSUE_TEMPLATE/feature-request.md b/.github/ISSUE_TEMPLATE/feature-request.md
index 23713cf891..83d740d0bb 100644
--- a/.github/ISSUE_TEMPLATE/feature-request.md
+++ b/.github/ISSUE_TEMPLATE/feature-request.md
@@ -1,37 +1,47 @@
---
name: Feature Request
-about: Suggest an idea for this project
+about: Suggest an idea for this project.
title: ''
labels: Feature Request
assignees: ''
---
-Please follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.
-请按照此 Issue 模版提供相关信息,例如源码仓库、博客链接和屏幕截图,这将有助于我们进行调查。
+
-
+If you want to fast resolve your issue, WRITE IT IN ENGLISH, please. Not all contributors / collaborators know Chinese and Google translate can't always translate issues accurately. Thanks!
+-->
-- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.
-- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).
-- [ ] I have reviewed the latest Roadmap on GitHub and searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues), which does not help me.
+### I agree and want to create new issue
-***
+
+- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html).
+- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/).
+- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me.
-## Expected behavior
+***
+### Expected behavior
-## Actual behavior
-
-- Links to demo site with this feature: N/A
-- Links to repository or source code of the blog: N/A
+### Actual behavior
-## Steps to reproduce the behavior
+### Steps to reproduce the behavior
1. N/A
2. N/A
3. N/A
-## Other Information
+* Link to demo site with this feature: N/A
+* Link(s) to source code or any usefull link(s): N/A
+
+**NexT Scheme:**
+
+
+- [ ] All schemes
+- [ ] Muse
+- [ ] Mist
+- [ ] Pisces
+- [ ] Gemini
diff --git a/.github/ISSUE_TEMPLATE/non-english.md b/.github/ISSUE_TEMPLATE/non-english.md
new file mode 100644
index 0000000000..f07d698606
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/non-english.md
@@ -0,0 +1,92 @@
+---
+name: Non English
+about: Issue in Chinese or any other language.
+title: ''
+labels: Non English
+assignees: ''
+
+---
+
+
+
+### I agree and want to create new issue
+
+
+- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html).
+- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/).
+- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me.
+
+***
+
+### Expected behavior
+
+
+### Actual behavior
+
+
+### Steps to reproduce the behavior
+1. N/A
+2. N/A
+3. N/A
+
+* Link to demo site with this issue: N/A
+* Link(s) to source code or any usefull link(s): N/A
+
+### Node.js and NPM Information
+
+```
+
+```
+
+### Package dependencies Information
+
+```
+
+```
+
+### Hexo Information
+
+#### Hexo version
+
+```
+
+```
+
+#### Hexo Configuration
+
+```yml
+
+```
+
+### NexT Information
+
+**NexT Version:**
+
+
+- [ ] Latest Master branch
+- [ ] Latest Release version
+- [ ] Old version
+
+
+**NexT Scheme:**
+
+
+- [ ] All schemes
+- [ ] Muse
+- [ ] Mist
+- [ ] Pisces
+- [ ] Gemini
+
+
+#### NexT Configuration:
+
+```yml
+
+```
+
+### Other Information
diff --git a/.github/ISSUE_TEMPLATE/other.md b/.github/ISSUE_TEMPLATE/other.md
deleted file mode 100644
index 81a5ed4eeb..0000000000
--- a/.github/ISSUE_TEMPLATE/other.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-name: Other
-about: Not a question, feature request or bug report
-title: ''
-labels: ''
-assignees: ''
-
----
-
-Please follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.
-请按照此 Issue 模版提供相关信息,例如源码仓库、博客链接和屏幕截图,这将有助于我们进行调查。
-
-## Issue Checklist
-
-
-- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.
-- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).
-- [ ] I have reviewed the latest Roadmap on GitHub and searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues), which does not help me.
-
-***
-
-## Other Information
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md
deleted file mode 100644
index aaf0f0941f..0000000000
--- a/.github/ISSUE_TEMPLATE/question.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-name: Question
-about: I have a question for NexT (e.g. Customize)
-title: ''
-labels: Custom
-assignees: ''
-
----
-
-Please follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.
-请按照此 Issue 模版提供相关信息,例如源码仓库、博客链接和屏幕截图,这将有助于我们进行调查。
-
-## Issue Checklist
-
-
-- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.
-- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).
-- [ ] I have reviewed the latest Roadmap on GitHub and searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues), which does not help me.
-
-***
-
-## Expected behavior
-
-
-## Actual behavior
-
-
-- Links to demo site with this issue: N/A
-- Links to repository or source code of the blog: N/A
-
-
-## Steps to reproduce the behavior
-1. N/A
-2. N/A
-3. N/A
-
-
-## Environment Information
-
-### Node.js and NPM Information
-
-```
-
-```
-
-### Package dependencies Information
-
-```
-
-```
-
-### Hexo Configuration
-
-```yml
-
-```
-
-### NexT Configuration
-
-```yml
-
-```
-
-## Other Information
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index f1982e055f..fa358539a9 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,15 +1,14 @@
-## PR Checklist
-
+## PR Checklist
+**Please check if your PR fulfills the following requirements:**
+
-- [ ] The commit message follows [guidelines for NexT](https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md).
+- [ ] The commit message follows [our guidelines](https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md).
- [ ] Tests for the changes was maked (for bug fixes / features).
- [ ] Muse | Mist have been tested.
- [ ] Pisces | Gemini have been tested.
@@ -17,24 +16,24 @@
## PR Type
-
+**What kind of change does this PR introduce?**
- [ ] Bugfix.
- [ ] Feature.
- [ ] Code style update (formatting, local variables).
- [ ] Refactoring (no functional changes, no api changes).
-- [ ] Build & CI related changes.
-- [ ] Documentation.
-- [ ] Translation.
+- [ ] Build related changes.
+- [ ] CI related changes.
+- [ ] Documentation content changes.
- [ ] Other... Please describe:
## What is the current behavior?
-
+
Issue resolved: N/A
## What is the new behavior?
-
+
- Screenshots with this changes: N/A
- Link to demo site with this changes: N/A
@@ -42,5 +41,9 @@ Issue resolved: N/A
### How to use?
In NexT `_config.yml`:
```yml
-
+...
```
+
+## Does this PR introduce a breaking change?
+- [ ] Yes.
+- [ ] No.
diff --git a/.github/auto_assign.yml b/.github/auto_assign.yml
new file mode 100644
index 0000000000..78c6deff86
--- /dev/null
+++ b/.github/auto_assign.yml
@@ -0,0 +1,22 @@
+# Configuration for Auto Assign - https://github.com/kentaro-m/auto-assign
+
+# Set to true to add reviewers to pull requests
+addReviewers: true
+
+# Set to true to add assignees to pull requests
+addAssignees: false
+
+# A list of reviewers to be added to pull requests (GitHub user name)
+reviewers:
+ - ivan-nginx
+ - maple3142
+ - sli1989
+ - stevenjoezhang
+
+# A number of reviewers added to the pull request
+# Set 0 to add all the reviewers (default: 0)
+numberOfReviewers: 0
+
+# A list of keywords to be skipped the process that add reviewers if pull requests include it
+skipKeywords:
+ - wip
diff --git a/.github/config.yml b/.github/config.yml
index 5476d81010..7d5d0ecaad 100644
--- a/.github/config.yml
+++ b/.github/config.yml
@@ -38,6 +38,17 @@ requestInfoUserstoExclude:
- tsanie
- wafer-li
+# =============================================================================================== #
+# Configuration for sentiment-bot - https://github.com/behaviorbot/sentiment-bot
+
+# *Required* toxicity threshold between 0 and .99 with the higher numbers being the most toxic
+# Anything higher than this threshold will be marked as toxic and commented on
+sentimentBotToxicityThreshold: .6
+
+# *Required* Comment to reply with
+sentimentBotReplyComment: >
+ Please be sure to review the [code of conduct](https://github.com/theme-next/hexo-theme-next/blob/master/.github/code-of-conduct.md) and be respectful of other users. cc/ @theme-next/next
+
# =============================================================================================== #
lockThreads:
toxicityThreshold: .7
@@ -45,3 +56,8 @@ lockThreads:
setTimeInHours: 72
replyComment: >
This thread is being locked due to exceeding the toxicity minimums. cc/ @theme-next/next
+
+# =============================================================================================== #
+# Configuration for todo-bot - https://github.com/JasonEtco/todo
+todo:
+ label: '🗒 To-Do'
diff --git a/.github/eslint-disable-bot.yml b/.github/eslint-disable-bot.yml
new file mode 100644
index 0000000000..9899fef6b3
--- /dev/null
+++ b/.github/eslint-disable-bot.yml
@@ -0,0 +1,8 @@
+# Configuration for ESLint Disable Watcher - https://github.com/koddsson/eslint-disable-probot
+
+# Change this to set the number of comments the watcher should comment on a given PR.
+commentLimit: 10
+# The message the bot will post on any lines containing a eslint disable comment.
+commentMessage: Please don't disable eslint rules :pray:
+# A optional regular expression that will match against the branch name and not comment on it if it matches.
+skipBranchMatching: null
diff --git a/.github/issue-close-app.yml b/.github/issue-close-app.yml
deleted file mode 100644
index daa3e1e585..0000000000
--- a/.github/issue-close-app.yml
+++ /dev/null
@@ -1,16 +0,0 @@
-# Comment that will be sent if an issue is judged to be closed.
-comment: "This issue has been closed because it does not meet our Issue template. Please read our [guidelines for contributing](https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md#how-can-i-contribute)."
-issueConfigs:
-# There can be several configs for different kind of issues.
-- content:
- - "Issue Checklist"
-# Optional configuration:
-#
-# whether the keywords are case-insensitive
-# default value is false, which means keywords are case-sensitive
-caseInsensitive: true
-# the label that will be added when the bot close an issue
-# The bot will only add a label if this property is set.
-label: "Invalid"
-# The issue is judged to be legal if it includes all keywords from any of these two configs.
-# Or it will be closed by the app.
diff --git a/.github/issue_label_bot.yaml b/.github/issue_label_bot.yaml
deleted file mode 100644
index a0d4c944b0..0000000000
--- a/.github/issue_label_bot.yaml
+++ /dev/null
@@ -1,4 +0,0 @@
-label-alias:
- bug: 'Bug'
- feature_request: 'Feature Request'
- question: 'Question'
diff --git a/.github/lock.yml b/.github/lock.yml
index b2564db4be..a6826f8de7 100644
--- a/.github/lock.yml
+++ b/.github/lock.yml
@@ -8,10 +8,11 @@ daysUntilLock: 365
skipCreatedBefore: false
# Issues and pull requests with these labels will be ignored. Set to `[]` to disable
-exemptLabels: []
+exemptLabels:
+ - backlog
# Label to add before locking, such as `outdated`. Set to `false` to disable
-lockLabel: false
+lockLabel: 🔒 Locked
# Comment to post before locking. Set to `false` to disable
lockComment: >
diff --git a/.github/release-drafter.yml b/.github/release-drafter.yml
index a70af9c631..ec410af79a 100644
--- a/.github/release-drafter.yml
+++ b/.github/release-drafter.yml
@@ -6,20 +6,20 @@ categories:
- title: '💥 Breaking Changes'
label: '💥 Breaking Change'
+ - title: '🌀 External Changes'
+ label: '🌀 External Change'
+
- title: '🌟 New Features'
label: '🌟 New Feature'
- title: '⭐ Features'
label: '⭐ Feature'
- - title: '🐞 Bug Fixes'
- label: '🐞 Bug Fix'
-
- title: '🛠 Improvements'
label: '🛠 Improvement'
- - title: '🌀 External Changes'
- label: '🔌 3rd Party Plugin'
+ - title: '🐞 Bug Fixes'
+ label: '🐞 Bug Fix'
- title: '📖 Documentation'
label: '📖 Docs'
@@ -35,6 +35,3 @@ template: |
***
For full changes, see the [comparison between $PREVIOUS_TAG and v$NEXT_MINOR_VERSION](https://github.com/theme-next/hexo-theme-next/compare/$PREVIOUS_TAG...v$NEXT_MINOR_VERSION)
-
-exclude-labels:
- - 'Skip Release'
diff --git a/.github/stale.yml b/.github/stale.yml
index 3af279e057..7cd44811e8 100644
--- a/.github/stale.yml
+++ b/.github/stale.yml
@@ -6,11 +6,14 @@ daysUntilStale: 30
daysUntilClose: 7
# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
exemptLabels:
- - Bug
- - Feature Request
- - Discussion
- - Help Wanted
- - Question
+ - bug
+ - feature request
+ - improvement need
+ - wait for answer
+ - need verify
+ - question
+ - backlog
+ - docs
# Label to use when marking as stale
staleLabel: stale
# Comment to post when marking as stale. Set to `false` to disable
diff --git a/.github/topissuebot.yml b/.github/topissuebot.yml
new file mode 100644
index 0000000000..81dbe6b35b
--- /dev/null
+++ b/.github/topissuebot.yml
@@ -0,0 +1,5 @@
+# Configuration for top-issue-bot - https://github.com/adamzolyak/gh-vote-bot
+
+labelName: '👍 Top Issue!'
+labelColor: '006b75'
+numberOfIssuesToLabel: 10
diff --git a/.github/weekly-digest.yml b/.github/weekly-digest.yml
new file mode 100644
index 0000000000..a2a6f797f9
--- /dev/null
+++ b/.github/weekly-digest.yml
@@ -0,0 +1,8 @@
+# Configuration for weekly-digest - https://github.com/apps/weekly-digest
+
+publishDay: sun
+canPublishIssues: true
+canPublishPullRequests: true
+canPublishContributors: true
+canPublishStargazers: true
+canPublishCommits: true
diff --git a/.gitignore b/.gitignore
index 996e5167b9..05a391d162 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,6 +10,10 @@ node_modules/
source/lib/*
# Track internal libraries & Ignore unused verdors files
+source/lib/font-awesome/less/
+source/lib/font-awesome/scss/
!source/lib/font-awesome/
-!source/lib/anime.min.js
+
+!source/lib/jquery/
+
!source/lib/velocity/
diff --git a/.stylintrc b/.stylintrc
index 724a26c60e..38e6ac14e2 100644
--- a/.stylintrc
+++ b/.stylintrc
@@ -35,7 +35,7 @@
"truncate": true
},
"semicolons": "always",
- "sortOrder": "alphabetical",
+ "sortOrder": "grouped",
"stackedProperties": false,
"trailingWhitespace": "never",
"universal": false,
diff --git a/.travis.yml b/.travis.yml
index cdad71cd80..9591f0b233 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,8 +1,18 @@
language: node_js
-
-node_js: node
+#node_js: node
+node_js: lts/*
cache:
- npm: true
+ directories:
+ - node_modules
install: npm install
+
+before_script:
+ - npm install -g gulp
+
+addons:
+ browserstack:
+ username: "ivannginx1"
+ access_key:
+ secure: "NutOhdgtUdBUXMPZhy8X1F1Jq+tan1LeNOV0FArBt15SNlxtNArqhiyTi4XnG9MPruX4306aGF2RBrKso+OiGNRdGtRGngH613Q0GWNtlC/boMqnI7fHqLIyCs6S12y2uA8PK4Ifxg9bZ0VtCTYYbMy+p1KvBM//L12vmtfdnby8z5Qvex3tB3dLoPOR50CKkINHJVDLm+iVRFrdz4/83oDsulZSRRGIaxu5taDWPIcp3fYZtre2Nc+RXcsyFDyjN7U0Hvr5tKBbloJxXEQEBv2xLkMOtp85nmCPD06s1Il8Wus1ux3raVsfUyaW5FpNX37Jeb5e00RQUM1wgU5m75H6qiGwDvQswbugJG0i/a2nNfsgVmbrSZdMnkHcx2Uxmrw4ejyEP5NSrJSBi05Ck1fQ4UsZ4Qkdf1fd04SI0LpLWt43eoNO/7rHKsQoP4LCX9gxKUuC075NEBLODyJ529RYfA6dKKwwH6o0ZbOgASmCoAWaM65g4+FHRnJcKL/Kj9ZWklQtRa7/ynlHaA65jefFS2lB8Ut6d3rXDDBih9mIrwV1uUaEH96xgAN42bgU/vY6FGzNkDOYZqj4YfsepDM0wbOsslFie7JZq7iFjsYvrXqLvYUMk37AZwQ2Sb6uH4tIT4Qw/4oZfDzA1En3/8HdZJ28nKW/lzjwMSqheIY="
diff --git a/README.md b/README.md
index 5ace3fb9e1..863eb0f91e 100644
--- a/README.md
+++ b/README.md
@@ -1,80 +1,75 @@
-
- Language:
- 🇺🇸
-
🇨🇳
-
🇷🇺
-
+
# 
e x T
+«NexT» is a high quality elegant Hexo theme. It is crafted from scratch with love.
+
- «NexT» is a high quality elegant Hexo theme. It is crafted from scratch with love.
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
## Live Preview
-
- 💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
-
-
- More «NexT» examples here.
-
+* :heart_decoration: Muse scheme: [LEAFERx](https://leaferx.online) | [Alex LEE](http://saili.science) | [Miaia](https://11.tt)
+* :six_pointed_star: Mist scheme: [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com)
+* :pisces: Pisces scheme: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Jiaxi He](http://jiaxi.io)
+* :gemini: Gemini scheme: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me)
+
+More «NexT» examples [here](https://github.com/iissnan/hexo-theme-next/issues/119).
## Installation
-The simplest way to install is to clone the entire repository:
+Simplest way to install is by cloning the entire repository:
-```sh
-$ cd hexo
-$ git clone https://github.com/theme-next/hexo-theme-next themes/next
-```
+ ```sh
+ $ cd hexo
+ $ git clone https://github.com/theme-next/hexo-theme-next themes/next
+ ```
Or you can see [detailed installation instructions][docs-installation-url] if you want any other variant.
## Plugins
-NexT supports a large number of third-party plugins, which can be easily configured.
+In NexT config now you can find dependencies on each module which was moved to external repositories which can be found by [main organization link](https://github.com/theme-next).
-For example, if you want to enable `pjax` on your site, just set `pjax` to `true` in NexT config file:
+For example, if you want to use `fancybox` in your site, go to NexT config and see:
```yml
-# Easily enable fast Ajax navigation on your website.
-# Dependencies: https://github.com/theme-next/theme-next-pjax
-pjax: true
+# Fancybox
+# Dependencies: https://github.com/theme-next/theme-next-fancybox
+fancybox: false
```
-Then visit the «Dependencies» link to get the installation instructions of this module.
+Then turn on `fancybox` and go to «Dependencies» link with installation instructions of this module.
-### Configure CDN
+### Exceptions
-If you want to specify a CDN link for any plugins, you need to set / update the CDN link.
+If you use cdn for any plugins, you need to replace your cdn link.
-For example, if you want to use `mediumzoom` and load the plugin via CDN, go to NexT config and see:
+For example, if you want to use `fancybox` and you configured a cdn link, go to NexT config and see:
```yml
vendors:
# ...
# Some contents...
# ...
- mediumzoom: # Set or update mediumzoom CDN URL.
+ fancybox: # Set or update fancybox cdn url.
+ fancybox_css: # Set or update fancybox cdn url.
```
+Instead of defining [main organization link](https://github.com/theme-next) for updates.
+
## Update
-NexT releases new versions every month. You can update to latest master branch by the following command:
+You can update to latest master branch by the following command:
```sh
$ cd themes/next
@@ -84,71 +79,95 @@ $ git pull
And if you see any error message during update (something like **«Commit your changes or stash them before you can merge»**), recommended to learn [Hexo data files][docs-data-files-url] feature.\
However, you can bypass update errors by using the `Commit`, `Stash` or `Reset` commands for local changes. See [here](https://stackoverflow.com/a/15745424/5861495) how to do it.
-**If you want to update from v5.1.x to the latest version, read [this][docs-update-5-1-x-url].**
+**If you want to update from v5.1.x to v6.0.x, read [here][docs-update-5-1-x-url].**
-## Feedback
+## Known Bugs
-* Visit the [Awesome NexT][awesome-next-url] list to share plugins and tutorials with other users.
-* Join our [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] chats.
-* [Add or improve translation][i18n-url] in few seconds.
-* Report a bug in [GitHub Issues][issues-bug-url].
-* Request a new feature on [GitHub][issues-feat-url].
-* Vote for [popular feature requests][feat-req-vote-url].
+For those who also encounter **«[Error: Cannot find module 'hexo-util'](https://github.com/iissnan/hexo-theme-next/issues/1490)»**, please check your NPM version.
+
+* `> 3`: Still not work? Please remove `node_modules` directory and reinstall using `npm install`.
+* `< 3`: Please add `hexo-util` explicitly via `npm install --save-dev hexo-util` to you site package deps.
## Contributing
-We welcome you to join the development of NexT. Please see [contributing document][contributing-document-url]. 🤗
+Contribution is welcome, feel free to open an issue and fork. Waiting for your pull request.
-Also, we welcome Issue or PR to our [official-plugins][official-plugins-url].
+## Feedback
-## Contributors
+* Ask a question on [Stack Overflow][stack-url].
+* Report a bug in [GitHub Issues][issues-bug-url].
+* Request a new feature on [GitHub][issues-feat-url].
+* Vote for [popular feature requests][feat-req-vote-url].
+* Join to our [Gitter][gitter-url] / [Riot][riot-url] / [Telegram][t-chat-url] chats.
+* Follow us with [Telegram Channel][t-news-url] for latest news.
+
+## Third party applications
-[![][contributors-image]][contributors-url]
+* :triangular_flag_on_post: HexoEditor
## Thanks
- «NexT» send special thanks to these great services that sponsor our core infrastructure:
-
-
-
-
-
-
-
+«NexT» send special thanks to these great services that sponsor our core infrastructure:
+
+
+
+ 
+
GitHub allows us to host the Git repository, Netlify allows us to distribute the documentation.
-
-
-
-
-
+
+
+
+
Crowdin allows us to translate conveniently the documentation.
-
-
-
-
-
-
-
- Codacy allows us to monitor code quality, Travis CI allows us to run the test suite.
-[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md
-[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/DATA-FILES.md
-[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md
+
+ 
+
+ Codacy allows us to run the test suite, BrowserStack allows us to test in real browsers.
+
-[t-news-url]: https://t.me/theme_next_news
-[t-chat-url]: https://t.me/theme_next
-[gitter-url]: https://gitter.im/theme-next
-[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
-[i18n-url]: https://i18n.theme-next.org
+[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg
+[browser-url]: https://www.browserstack.com
-[awesome-next-url]: https://github.com/theme-next/awesome-next
+[stack-url]: https://stackoverflow.com/questions/tagged/theme-next
[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md
[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md
-[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22
+[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22+sort%3Areactions-%2B1-desc
+
+[gitter-url]: https://gitter.im/theme-next
+[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
+[t-chat-url]: https://t.me/theme_next
+[t-news-url]: https://t.me/theme_next_news
+
+
+
+
+
+[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip
+[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest
+
+[tags-url]: https://github.com/theme-next/hexo-theme-next/tags
+[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master
+
+[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md
+[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/DATA-FILES.md
+[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md
+
+## Contributors
-[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md
-[official-plugins-url]: https://github.com/theme-next
-[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890
-[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors
+Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
+
+
+| [
Ivan.Nginx](https://almostover.ru)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Aivan-nginx "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=ivan-nginx "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=ivan-nginx "Documentation") [🤔](#ideas-ivan-nginx "Ideas, Planning, & Feedback") [📝](#blog-ivan-nginx "Blogposts") [👀](#review-ivan-nginx "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=ivan-nginx "Tests") [🌍](#translation-ivan-nginx "Translation") [🎨](#design-ivan-nginx "Design") [🚇](#infra-ivan-nginx "Infrastructure (Hosting, Build-Tools, etc)") [🚧](#maintenance-ivan-nginx "Maintenance") | [
Alex LEE](http://saili.science)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Asli1989 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=sli1989 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=sli1989 "Documentation") [👀](#review-sli1989 "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=sli1989 "Tests") [🌍](#translation-sli1989 "Translation") | [
Tsanie Lily](https://tsanie.us)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Atsanie "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=tsanie "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=tsanie "Documentation") [👀](#review-tsanie "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=tsanie "Tests") [🌍](#translation-tsanie "Translation") | [
Wafer Li](https://wafer.li)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Awafer-li "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=wafer-li "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=wafer-li "Documentation") [👀](#review-wafer-li "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=wafer-li "Tests") [🌍](#translation-wafer-li "Translation") | [
Lawrence Ye](https://leaferx.online)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3ALEAFERx "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=LEAFERx "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=LEAFERx "Documentation") [👀](#review-LEAFERx "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=LEAFERx "Tests") [🌍](#translation-LEAFERx "Translation") | [
maple](https://blog.maple3142.net/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Amaple3142 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=maple3142 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=maple3142 "Documentation") [👀](#review-maple3142 "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=maple3142 "Tests") [🌍](#translation-maple3142 "Translation") |
+| :---: | :---: | :---: | :---: | :---: | :---: |
+| [
Raincal](https://raincal.com)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3ARaincal "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=Raincal "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=Raincal "Documentation") [👀](#review-Raincal "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=Raincal "Tests") | [
Rainy](https://rainylog.com)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ageekrainy "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=geekrainy "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=geekrainy "Documentation") [👀](#review-geekrainy "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=geekrainy "Tests") [🌍](#translation-geekrainy "Translation") | [
李皓奇](https://liolok.github.io/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Aliolok "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=liolok "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=liolok "Documentation") [👀](#review-liolok "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=liolok "Tests") | [
Nine](http://ioliu.cn)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AxCss "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=xCss "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=xCss "Documentation") [👀](#review-xCss "Reviewed Pull Requests") [⚠️](https://github.com/theme-next/hexo-theme-next/commits?author=xCss "Tests") | [
Clooooode](https://github.com/jackey8616)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ajackey8616 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=jackey8616 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=jackey8616 "Documentation") | [
Xu Song](https://github.com/xu-song)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Axu-song "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=xu-song "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=xu-song "Documentation") |
+| [
Jack Sullivan](https://github.com/HuntedCodes)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AHuntedCodes "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=HuntedCodes "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=HuntedCodes "Documentation") | [
dpyzo0o](https://github.com/dpyzo0o)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Adpyzo0o "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=dpyzo0o "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=dpyzo0o "Documentation") | [
zhuzhuxia](http://zhuzhuyule.com)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Azhuzhuyule "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=zhuzhuyule "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=zhuzhuyule "Documentation") | [
kuleyu](https://kuleyu-hugo.netlify.com/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Akuleyu "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=kuleyu "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=kuleyu "Documentation") | [
jdhao](http://jdhao.github.io)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ajdhao "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=jdhao "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=jdhao "Documentation") | [
AlbertGao](http://www.albertgao.xyz)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AAlbert-Gao "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=Albert-Gao "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=Albert-Gao "Documentation") |
+| [
YoshinoriN](https://yoshinorin.net/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AYoshinoriN "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=YoshinoriN "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=YoshinoriN "Documentation") | [
Qi Zhao](https://zhaoqi99.github.io/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AZhaoQi99 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=ZhaoQi99 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=ZhaoQi99 "Documentation") | [
Henry Zhu](https://changchen.me/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Adaya0576 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=daya0576 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=daya0576 "Documentation") | [
CxyFreedom](https://github.com/cxyfreedom)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Acxyfreedom "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=cxyfreedom "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=cxyfreedom "Documentation") | [
KaitoHH](https://kaitohh.com/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AKaitoHH "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=KaitoHH "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=KaitoHH "Documentation") | [
赵俊](http://www.zhaojun.im)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Azhaojun1998 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=zhaojun1998 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=zhaojun1998 "Documentation") |
+| [
zyhang](https://github.com/izyhang)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Aizyhang "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=izyhang "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=izyhang "Documentation") | [
Xiaolong Yang](https://xiaolony.github.io)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AXiaolonY "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=XiaolonY "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=XiaolonY "Documentation") | [
花蛄](https://github.com/yzca)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ayzca "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=yzca "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=yzca "Documentation") | [
hengyunabc](http://hengyunabc.github.io/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ahengyunabc "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=hengyunabc "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=hengyunabc "Documentation") | [
Fisher Chang](http://bluefisher.github.io)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3ABlueFisher "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=BlueFisher "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=BlueFisher "Documentation") | [
Chanson Shen](http://chansonshen.com/)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Ashenchsh "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=shenchsh "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=shenchsh "Documentation") |
+| [
Thomas Yang](http://ywjno.com)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Aywjno "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=ywjno "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=ywjno "Documentation") | [
Legendary Nacar](http://legendarynacar.github.io)
[🌍](#translation-legendarynacar "Translation") | [
rikusen0335](https://github.com/Rikusen0335)
[🌍](#translation-Rikusen0335 "Translation") | [
Mr.J](https://www.dnocm.com)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3AJiangTJ "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=JiangTJ "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=JiangTJ "Documentation") [🚇](#infra-JiangTJ "Infrastructure (Hosting, Build-Tools, etc)") | [
1v9](https://1v9.im)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3A1v9 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=1v9 "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=1v9 "Documentation") [🌍](#translation-1v9 "Translation") [👀](#review-1v9 "Reviewed Pull Requests") | [
Mimi](https://zhangshuqiao.org)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Astevenjoezhang "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=stevenjoezhang "Code") [📖](https://github.com/theme-next/hexo-theme-next/commits?author=stevenjoezhang "Documentation") [👀](#review-stevenjoezhang "Reviewed Pull Requests") [🌍](#translation-stevenjoezhang "Translation") |
+| [
张强](https://i-m.dev)
[🐛](https://github.com/theme-next/hexo-theme-next/issues?q=author%3Azq-97 "Bug reports") [💻](https://github.com/theme-next/hexo-theme-next/commits?author=zq-97 "Code") |
+
+
+This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!
diff --git a/_config.yml b/_config.yml
index 84fbc30635..12008fcdab 100644
--- a/_config.yml
+++ b/_config.yml
@@ -5,33 +5,28 @@
# If false, merge configs from `_data/next.yml` into default configuration (rewrite).
# If true, will fully override default configuration by options from `_data/next.yml` (override). Only for NexT settings.
-# And if true, all config from default NexT `_config.yml` have to be copied into `next.yml`. Use if you know what you are doing.
+# And if true, all config from default NexT `_config.yml` must be copied into `next.yml`. Use if you know what you are doing.
# Useful if you want to comment some options from NexT `_config.yml` by `next.yml` without editing default config.
override: false
-# Console reminder if new version released.
-reminder: false
-
# Allow to cache content generation. Introduced in NexT v6.0.0.
cache:
enable: true
-# Remove unnecessary files after hexo generate.
-minify: false
-
-# Define custom file paths.
-# Create your custom files in site directory `source/_data` and uncomment needed files below.
-custom_file_path:
+# Redefine custom file paths. Introduced in NexT v6.0.2. If commented, will be used default custom file paths.
+# For example, you want to put your custom styles file outside theme directory in root `source/_data`, set `styles: source/_data/styles.styl`
+#custom_file_path:
+ # Default paths: layout/_custom/*
#head: source/_data/head.swig
#header: source/_data/header.swig
#sidebar: source/_data/sidebar.swig
- #postMeta: source/_data/post-meta.swig
- #postBodyEnd: source/_data/post-body-end.swig
- #footer: source/_data/footer.swig
- #bodyEnd: source/_data/body-end.swig
- #variable: source/_data/variables.styl
- #mixin: source/_data/mixins.styl
- #style: source/_data/styles.styl
+
+ # Default path: source/css/_variables/custom.styl
+ #variables: source/_data/variables.styl
+ # Default path: source/css/_mixins/custom.styl
+ #mixins: source/_data/mixins.styl
+ # Default path: source/css/_custom/custom.styl
+ #styles: source/_data/styles.styl
# ---------------------------------------------------------------
@@ -47,8 +42,10 @@ favicon:
#android_manifest: /images/manifest.json
#ms_browserconfig: /images/browserconfig.xml
-# Show multilingual switcher in footer.
-language_switcher: false
+# Set rss to false to disable feed link.
+# Leave rss as blank to use site's feed link, and install dependencies hexo-generator-feed by `npm install hexo-generator-feed --save`.
+# Set rss to specific value if you have burned your feed already.
+rss:
footer:
# Specify the date when the site was setup. If not defined, current year will be used.
@@ -56,74 +53,118 @@ footer:
# Icon between year and copyright info.
icon:
- # Icon name in Font Awesome. See: https://fontawesome.com/icons
- name: fa fa-heart
+ # Icon name in fontawesome, see: https://fontawesome.com/v4.7.0/icons/
+ # `heart` is recommended with animation in red (#ff0000).
+ name: user
# If you want to animate the icon, set it to true.
animated: false
# Change the color of icon, using Hex Code.
- color: "#ff0000"
+ color: "#808080"
- # If not defined, `author` from Hexo `_config.yml` will be used.
+ # If not defined, `author` from Hexo main config will be used.
copyright:
- # Powered by Hexo & NexT
- powered: true
+ powered:
+ # Hexo link (Powered by Hexo).
+ enable: true
+ # Version info of Hexo after Hexo link (vX.X.X).
+ version: true
+
+ theme:
+ # Theme & scheme info link (Theme - NexT.scheme).
+ enable: true
+ # Version info of NexT after scheme info (vX.X.X).
+ version: true
- # Beian ICP and gongan information for Chinese users. See: http://www.beian.miit.gov.cn, http://www.beian.gov.cn
+ # Beian icp information for Chinese users. In China, every legal website should have a beian icp in website footer.
+ # http://www.beian.miit.gov.cn
beian:
enable: false
icp:
- # The digit in the num of gongan beian.
- gongan_id:
- # The full num of gongan beian.
- gongan_num:
- # The icon for gongan beian. See: http://www.beian.gov.cn/portal/download
- gongan_icon_url:
+
+ # Any custom text can be defined here.
+ #custom_text: Hosted by Coding Pages
# Creative Commons 4.0 International License.
# See: https://creativecommons.org/share-your-work/licensing-types-examples
# Available values of license: by | by-nc | by-nc-nd | by-nc-sa | by-nd | by-sa | zero
-# You can set a language value if you prefer a translated version of CC license, e.g. deed.zh
-# CC licenses are available in 39 languages, you can find the specific and correct abbreviation you need on https://creativecommons.org
+# You can set a language value if you prefer a translated version of CC license.
+# CC licenses are available in 39 languages, where you can find the specific and correct abbreviation you need.
+# Valid values of language: deed.zh, deed.fr, deed.de, etc.
creative_commons:
license: by-nc-sa
sidebar: false
post: false
language:
+# `Follow me on GitHub` banner in the top-right corner.
+github_banner:
+ enable: false
+ permalink: https://github.com/yourname
+ title: Follow me on GitHub
+
# ---------------------------------------------------------------
-# Scheme Settings
+# SEO Settings
# ---------------------------------------------------------------
-# Schemes
-scheme: Muse
-#scheme: Mist
-#scheme: Pisces
-#scheme: Gemini
+# Disable Baidu transformation on mobile devices.
+disable_baidu_transformation: false
+
+# Set a canonical link tag in your hexo, you could use it for your SEO of blog.
+# See: https://support.google.com/webmasters/answer/139066
+# Tips: Before you open this tag, remember set up your URL in hexo _config.yml (e.g. url: http://yourdomain.com)
+canonical: true
+
+# Change headers hierarchy on site-subtitle (will be main site description) and on all post / page titles for better SEO-optimization.
+seo: false
-# Dark Mode
-darkmode: false
+# If true, will add site-subtitle to index page, added in main hexo config.
+# subtitle: Subtitle
+index_with_subtitle: false
+
+# Automatically add external URL with BASE64 encrypt & decrypt.
+exturl: false
+
+# Google Webmaster tools verification.
+# See: https://www.google.com/webmasters
+#google_site_verification:
+
+# Bing Webmaster tools verification.
+# See: https://www.bing.com/webmaster
+#bing_site_verification:
+
+# Yandex Webmaster tools verification.
+# See: https://webmaster.yandex.ru
+#yandex_site_verification:
+
+# Baidu Webmaster tools verification.
+# See: https://ziyuan.baidu.com/site
+#baidu_site_verification:
+
+# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO.
+baidu_push: false
# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------
+# When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash from link value (/archives -> archives).
# Usage: `Key: /link/ || icon`
# Key is the name of menu item. If the translation for this item is available, the translated text will be loaded, otherwise the Key name will be used. Key is case-senstive.
-# Value before `||` delimiter is the target link, value after `||` delimiter is the name of Font Awesome icon.
-# When running the site in a subdirectory (e.g. yoursite.com/blog), remove the leading slash from link value (/archives -> archives).
+# Value before `||` delimiter is the target link.
+# Value after `||` delimiter is the name of FontAwesome icon. If icon (with or without delimiter) is not specified, question icon will be loaded.
# External url should start with http:// or https://
menu:
- home: / || fa fa-home
- #about: /about/ || fa fa-user
- #tags: /tags/ || fa fa-tags
- #categories: /categories/ || fa fa-th
- archives: /archives/ || fa fa-archive
- #schedule: /schedule/ || fa fa-calendar
- #sitemap: /sitemap.xml || fa fa-sitemap
- #commonweal: /404/ || fa fa-heartbeat
+ home: / || home
+ #about: /about/ || user
+ #tags: /tags/ || tags
+ #categories: /categories/ || th
+ archives: /archives/ || archive
+ #schedule: /schedule/ || calendar
+ #sitemap: /sitemap.xml || sitemap
+ #commonweal: /404/ || heartbeat
# Enable / Disable menu icons / item badges.
menu_settings:
@@ -132,42 +173,20 @@ menu_settings:
# ---------------------------------------------------------------
-# Sidebar Settings
-# See: https://theme-next.org/docs/theme-settings/sidebar
+# Scheme Settings
# ---------------------------------------------------------------
-sidebar:
- # Sidebar Position.
- position: left
- #position: right
-
- # Manual define the sidebar width. If commented, will be default for:
- # Muse | Mist: 320
- # Pisces | Gemini: 240
- #width: 300
-
- # Sidebar Display (only for Muse | Mist), available values:
- # - post expand on posts automatically. Default.
- # - always expand for all pages automatically.
- # - hide expand only when click on the sidebar toggle icon.
- # - remove totally remove sidebar including sidebar toggle.
- display: post
+# Schemes
+scheme: Muse
+#scheme: Mist
+#scheme: Pisces
+#scheme: Gemini
- # Sidebar padding in pixels.
- padding: 18
- # Sidebar offset from top menubar in pixels (only for Pisces | Gemini).
- offset: 12
- # Enable sidebar on narrow view (only for Muse | Mist).
- onmobile: false
-# Sidebar Avatar
-avatar:
- # Replace the default image and set the url here.
- url: #/images/avatar.gif
- # If true, the avatar will be dispalyed in circle.
- rounded: false
- # If true, the avatar will be rotated with the cursor.
- rotated: false
+# ---------------------------------------------------------------
+# Sidebar Settings
+# See: https://theme-next.org/docs/theme-settings/sidebar
+# ---------------------------------------------------------------
# Posts / Categories / Tags in sidebar.
site_state: true
@@ -175,18 +194,20 @@ site_state: true
# Social Links
# Usage: `Key: permalink || icon`
# Key is the link label showing to end users.
-# Value before `||` delimiter is the target permalink, value after `||` delimiter is the name of Font Awesome icon.
+# Value before `||` delimiter is the target permalink.
+# Value after `||` delimiter is the name of FontAwesome icon. If icon (with or without delimiter) is not specified, globe icon will be loaded.
social:
- #GitHub: https://github.com/yourname || fab fa-github
- #E-Mail: mailto:yourname@gmail.com || fa fa-envelope
- #Weibo: https://weibo.com/yourname || fab fa-weibo
- #Google: https://plus.google.com/yourname || fab fa-google
- #Twitter: https://twitter.com/yourname || fab fa-twitter
- #FB Page: https://www.facebook.com/yourname || fab fa-facebook
- #StackOverflow: https://stackoverflow.com/yourname || fab fa-stack-overflow
- #YouTube: https://youtube.com/yourname || fab fa-youtube
- #Instagram: https://instagram.com/yourname || fab fa-instagram
- #Skype: skype:yourname?call|chat || fab fa-skype
+ #GitHub: https://github.com/yourname || github
+ #E-Mail: mailto:yourname@gmail.com || envelope
+ #Weibo: https://weibo.com/yourname || weibo
+ #Google: https://plus.google.com/yourname || google
+ #Twitter: https://twitter.com/yourname || twitter
+ #FB Page: https://www.facebook.com/yourname || facebook
+ #VK Group: https://vk.com/yourname || vk
+ #StackOverflow: https://stackoverflow.com/yourname || stack-overflow
+ #YouTube: https://youtube.com/yourname || youtube
+ #Instagram: https://instagram.com/yourname || instagram
+ #Skype: skype:yourname?call|chat || skype
social_icons:
enable: true
@@ -194,17 +215,27 @@ social_icons:
transition: false
# Blog rolls
-links_settings:
- icon: fa fa-link
- title: Links
- # Available values: block | inline
- layout: block
-
+links_icon: link
+links_title: Links
+links_layout: block
+#links_layout: inline
links:
- #Title: http://yoursite.com
+ #Title: http://example.com
-# Table of Contents in the Sidebar
-# Front-matter variable (unsupport wrap expand_all).
+# Sidebar Avatar
+avatar:
+ # In theme directory (source/images): /images/avatar.gif
+ # In site directory (source/uploads): /uploads/avatar.gif
+ # You can also use other linking images.
+ url: #/images/avatar.gif
+ # If true, the avatar would be dispalyed in circle.
+ rounded: false
+ # The value of opacity should be choose from 0 to 1 to set the opacity of the avatar.
+ opacity: 1
+ # If true, the avatar would be rotated with the cursor.
+ rotated: false
+
+# Table Of Contents in the Sidebar
toc:
enable: true
# Automatically add list number to toc.
@@ -213,17 +244,48 @@ toc:
wrap: false
# If true, all level of TOC in a post will be displayed, rather than the activated part of it.
expand_all: false
- # Maximum heading depth of generated toc.
+ # Maximum heading depth of generated toc. You can set it in one post through `toc_max_depth` in Front-matter.
max_depth: 6
+sidebar:
+ # Sidebar Position, available values: left | right (only for Pisces | Gemini).
+ position: left
+ #position: right
+
+ # Manual define the sidebar width. If commented, will be default for:
+ # Muse | Mist: 320
+ # Pisces | Gemini: 240
+ #width: 300
+
+ # Sidebar Display, available values (only for Muse | Mist):
+ # - post expand on posts automatically. Default.
+ # - always expand for all pages automatically.
+ # - hide expand only when click on the sidebar toggle icon.
+ # - remove totally remove sidebar including sidebar toggle.
+ display: post
+
+ # Sidebar offset from top menubar in pixels (only for Pisces | Gemini).
+ offset: 12
+ # Enable sidebar on narrow view (only for Muse | Mist).
+ onmobile: false
+ # Click any blank part of the page to close sidebar (only for Muse | Mist).
+ dimmer: false
+
+back2top:
+ enable: true
+ # Back to top in sidebar.
+ sidebar: false
+ # Scroll percent label in b2t button.
+ scrollpercent: false
+
# A button to open designated chat widget in sidebar.
# Firstly, you need enable the chat service you want to activate its sidebar button.
chat:
enable: false
#service: chatra
#service: tidio
- icon: fa fa-comment # Icon name in Font Awesome, set false to disable icon.
- text: Chat # Button text, change it as you wish.
+ icon: comment # icon in Font Awesome 4, set false to disable icon
+ text: Chat # button text, change it as you wish
# ---------------------------------------------------------------
@@ -231,11 +293,29 @@ chat:
# See: https://theme-next.org/docs/theme-settings/posts
# ---------------------------------------------------------------
+# Set the text alignment in the posts.
+text_align:
+ # Available values: start | end | left | right | center | justify | justify-all | match-parent
+ desktop: justify
+ mobile: justify
+
+# Automatically scroll page to section which is under mark.
+scroll_to_more: true
+
+# Automatically saving scroll position on each post / page in cookies.
+save_scroll: false
+
# Automatically excerpt description in homepage as preamble text.
excerpt_description: true
+# Automatically Excerpt (Not recommend).
+# Use in the post to control excerpt accurately.
+auto_excerpt:
+ enable: false
+ length: 150
+
# Read more button
-# If true, the read more button will be displayed in excerpt section.
+# If true, the read more button would be displayed in excerpt section.
read_more_btn: true
# Post meta display settings
@@ -253,37 +333,47 @@ symbols_count_time:
separated_meta: true
item_text_post: true
item_text_total: false
+ awl: 4
+ wpm: 275
+
+codeblock:
+ # Manual define the border radius in codeblock, leave it blank for the default value: 1
+ border_radius:
+ # Add copy button on codeblock
+ copy_button:
+ enable: false
+ # Show text copy result
+ show_result: false
+ # Style: only 'flat' is currently available, leave it blank if you prefer default theme
+ style:
-# Use icon instead of the symbol # to indicate the tag at the bottom of the post
+# Use icon instead of the symblo # to indicate the tag at the bottom of the post
tag_icon: false
+# Wechat Subscriber
+wechat_subscriber:
+ enable: false
+ #qcode: /path/to/your/wechatqcode e.g. /uploads/wechat-qcode.jpg
+ #description: e.g. subscribe to my blog by scanning my public wechat account
+
# Reward (Donate)
-# Front-matter variable (unsupport animation).
reward_settings:
- # If true, reward will be displayed in every article by default.
+ # If true, reward would be displayed in every article by default.
+ # You can show or hide reward in a specific article throuth `reward: true | false` in Front-matter.
enable: false
animation: false
- #comment: Donate comment here.
+ #comment: Donate comment here
reward:
#wechatpay: /images/wechatpay.png
#alipay: /images/alipay.png
- #paypal: /images/paypal.png
#bitcoin: /images/bitcoin.png
-# Subscribe through Telegram Channel, Twitter, etc.
-# Usage: `Key: permalink || icon` (Font Awesome)
-follow_me:
- #Twitter: https://twitter.com/username || fab fa-twitter
- #Telegram: https://t.me/channel_name || fab fa-telegram
- #WeChat: /images/wechat_channel.jpg || fab fa-weixin
- #RSS: /atom.xml || fa fa-rss
-
# Related popular posts
# Dependencies: https://github.com/tea3/hexo-related-popular-posts
related_posts:
enable: false
- title: # Custom header, leave empty to use the default one
+ title: # custom header, leave empty to use the default one
display_in_home: false
params:
maxCount: 5
@@ -296,265 +386,182 @@ related_posts:
# Dependencies: https://github.com/hexojs/hexo-deployer-git
post_edit:
enable: false
- url: https://github.com/user-name/repo-name/tree/branch-name/subdirectory-name # Link for view source
- #url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name # Link for fork & edit
-
-# Show previous post and next post in post footer if exists
-# Available values: left | right | false
-post_navigation: left
-
-
-# ---------------------------------------------------------------
-# Custom Page Settings
-# See: https://theme-next.org/docs/theme-settings/custom-pages
-# ---------------------------------------------------------------
-
-# TagCloud settings for tags page.
-tagcloud:
- # All values below are same as default, change them by yourself.
- min: 12 # Minimun font size in px
- max: 30 # Maxium font size in px
- start: "#ccc" # Start color (hex, rgba, hsla or color keywords)
- end: "#111" # End color (hex, rgba, hsla or color keywords)
- amount: 200 # Amount of tags, change it if you have more than 200 tags
-
-# Google Calendar
-# Share your recent schedule to others via calendar page.
-calendar:
- calendar_id: # Your Google account E-Mail
- api_key:
- orderBy: startTime
- offsetMax: 24 # Time Range
- offsetMin: 4 # Time Range
- showDeleted: false
- singleEvents: true
- maxResults: 250
+ url: https://github.com/user-name/repo-name/tree/branch-name/subdirectory-name # Link for view source.
+ #url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name # Link for fork & edit.
# ---------------------------------------------------------------
# Misc Theme Settings
# ---------------------------------------------------------------
-# Set the text alignment in posts / pages.
-text_align:
- # Available values: start | end | left | right | center | justify | justify-all | match-parent
- desktop: justify
- mobile: justify
-
# Reduce padding / margin indents on devices with narrow width.
mobile_layout_economy: false
# Android Chrome header panel color ($brand-bg / $headband-bg => $black-deep).
android_chrome_color: "#222"
-# Custom Logo (Do not support scheme Mist)
-custom_logo: #/uploads/custom-logo.jpg
+# Hide sticky headers and color the menu bar on Safari (iOS / macOS).
+safari_rainbow: false
-codeblock:
- # Code Highlight theme
- # Available values: normal | night | night eighties | night blue | night bright | solarized | solarized dark | galactic
- # See: https://github.com/chriskempson/tomorrow-theme
- highlight_theme: normal
- # Add copy button on codeblock
- copy_button:
- enable: false
- # Show text copy result.
- show_result: false
- # Available values: default | flat | mac
- style:
-
-back2top:
- enable: true
- # Back to top in sidebar.
- sidebar: false
- # Scroll percent label in b2t button.
- scrollpercent: false
+# Optimize the display of scrollbars on webkit based browsers.
+custom_scrollbar: false
-# Reading progress bar
-reading_progress:
+# Custom Logo
+# Do not support Scheme Mist currently.
+custom_logo:
enable: false
- # Available values: top | bottom
- position: top
- color: "#37c6c0"
- height: 3px
+ image: #/uploads/custom-logo.jpg
-# Bookmark Support
-bookmark:
- enable: false
- # Customize the color of the bookmark.
- color: "#222"
- # If auto, save the reading progress when closing the page or clicking the bookmark-icon.
- # If manual, only save it by clicking the bookmark-icon.
- save: auto
+# Code Highlight theme
+# Available values: normal | night | night eighties | night blue | night bright
+# https://github.com/chriskempson/tomorrow-theme
+highlight_theme: normal
-# `Follow me on GitHub` banner in the top-right corner.
-github_banner:
+# Enable "cheers" for archive page.
+cheers: true
+
+# TagCloud settings for tags page.
+tagcloud:
+ # If true, font size, font color and amount of tags can be customized
enable: false
- permalink: https://github.com/yourname
- title: Follow me on GitHub
+ # All values below are same as default, change them by yourself
+ min: 12 # min font size in px
+ max: 30 # max font size in px
+ start: "#ccc" # start color (hex, rgba, hsla or color keywords)
+ end: "#111" # end color (hex, rgba, hsla or color keywords)
+ amount: 200 # amount of tags, change it if you have more than 200 tags
# ---------------------------------------------------------------
-# Font Settings
-# See: https://theme-next.org/docs/theme-settings/#Fonts-Customization
-# ---------------------------------------------------------------
+# Font Settings. Introduced in NexT v5.0.1.
# Find fonts on Google Fonts (https://www.google.com/fonts)
# All fonts set here will have the following styles:
-# light | light italic | normal | normal italic | bold | bold italic
+# light, light italic, normal, normal italic, bold, bold italic
# Be aware that setting too much fonts will cause site running slowly
# ---------------------------------------------------------------
-# To avoid space between header and sidebar in scheme Pisces / Gemini, Web Safe fonts are recommended for `global` (and `title`):
+# To avoid space between header and sidebar in scheme Pisces / Gemini, Web Safe fonts are recommended for `global` (and `logo`):
# Arial | Tahoma | Helvetica | Times New Roman | Courier New | Verdana | Georgia | Palatino | Garamond | Comic Sans MS | Trebuchet MS
# ---------------------------------------------------------------
font:
enable: false
- # Uri of fonts host, e.g. https://fonts.googleapis.com (Default).
+ # Uri of fonts host, e.g. //fonts.googleapis.com (Default).
host:
# Font options:
# `external: true` will load this font family from `host` above.
# `family: Times New Roman`. Without any quotes.
- # `size: x.x`. Use `em` as unit. Default: 1 (16px)
+ # `size: xx`. Use `px` as unit.
- # Global font settings used for all elements inside .
+ # Global font settings used for all elements in .
global:
external: true
family: Lato
size:
- # Font settings for site title (.site-title).
- title:
+ # Font settings for Headlines (H1, H2, H3, H4, H5, H6).
+ # Fallback to `global` font settings.
+ headings:
external: true
family:
size:
- # Font settings for headlines ( to ).
- headings:
+ # Font settings for posts.
+ # Fallback to `global` font settings.
+ posts:
external: true
family:
- size:
- # Font settings for posts (.post-body).
- posts:
+ # Font settings for Logo.
+ # Fallback to `global` font settings.
+ logo:
external: true
family:
+ size:
# Font settings for and code blocks.
codes:
external: true
family:
+ size:
# ---------------------------------------------------------------
-# SEO Settings
-# ---------------------------------------------------------------
-
-# Disable Baidu transformation on mobile devices.
-disable_baidu_transformation: false
-
-# If true, site-subtitle will be added to index page.
-# Remember to set up your site-subtitle in Hexo `_config.yml` (e.g. subtitle: Subtitle)
-index_with_subtitle: false
-
-# Automatically add external URL with Base64 encrypt & decrypt.
-exturl: false
-
-# Google Webmaster tools verification.
-# See: https://www.google.com/webmasters
-google_site_verification:
-
-# Bing Webmaster tools verification.
-# See: https://www.bing.com/webmaster
-bing_site_verification:
-
-# Yandex Webmaster tools verification.
-# See: https://webmaster.yandex.ru
-yandex_site_verification:
-
-# Baidu Webmaster tools verification.
-# See: https://ziyuan.baidu.com/site
-baidu_site_verification:
-
-# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO.
-baidu_push: false
-
-
-# ---------------------------------------------------------------
-# Third Party Plugins & Services Settings
+# Third Party Services Settings
# See: https://theme-next.org/docs/third-party-services/
-# More plugins: https://github.com/theme-next/awesome-next
# You may need to install dependencies or set CDN URLs in `vendors`
# There are two different CDN providers by default:
# - jsDelivr (cdn.jsdelivr.net), works everywhere even in China
# - CDNJS (cdnjs.cloudflare.com), provided by cloudflare
# ---------------------------------------------------------------
-# Math Formulas Render Support
+# Math Equations Render Support
math:
+ enable: false
+
# Default (true) will load mathjax / katex script on demand.
# That is it only render those page which has `mathjax: true` in Front-matter.
# If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
per_page: true
- # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
+ engine: mathjax
+ #engine: katex
+
+ # hexo-renderer-pandoc (or hexo-renderer-kramed) needed to full MathJax support.
mathjax:
- enable: false
+ cdn: //cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML
+
# See: https://mhchem.github.io/MathJax-mhchem/
- mhchem: false
+ #mhchem: //cdn.jsdelivr.net/npm/mathjax-mhchem@3
+ #mhchem: //cdnjs.cloudflare.com/ajax/libs/mathjax-mhchem/3.3.0
- # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
+ # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) needed to full Katex support.
katex:
- enable: false
- # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
- copy_tex: false
-
-# Easily enable fast Ajax navigation on your website.
-# Dependencies: https://github.com/theme-next/theme-next-pjax
-pjax: false
+ cdn: //cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css
-# FancyBox is a tool that offers a nice and elegant way to add zooming functionality for images.
-# For more information: https://fancyapps.com/fancybox
-fancybox: false
-
-# A JavaScript library for zooming images like Medium.
-# Do not enable both `fancybox` and `mediumzoom`.
-# For more information: https://github.com/francoischalifour/medium-zoom
-mediumzoom: false
-
-# Vanilla JavaScript plugin for lazyloading images.
-# For more information: https://github.com/ApoorvSaxena/lozad.js
-lazyload: false
+ copy_tex:
+ # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
+ enable: false
+ copy_tex_js: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.js
+ copy_tex_css: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.css
# Pangu Support
+# Dependencies: https://github.com/theme-next/theme-next-pangu
# For more information: https://github.com/vinta/pangu.js
pangu: false
# Quicklink Support
-# Do not enable both `pjax` and `quicklink`.
-# For more information: https://github.com/GoogleChromeLabs/quicklink
-# Front-matter (unsupport home archive).
+# Dependencies: https://github.com/theme-next/theme-next-quicklink
+# Visit https://github.com/GoogleChromeLabs/quicklink for details
quicklink:
enable: false
- # Home page and archive page can be controlled through home and archive options below.
- # This configuration item is independent of `enable`.
- home: false
- archive: false
+ # Quicklink (quicklink.umd.js script) is loaded on demand
+ # Add `quicklink: true` in Front-matter of the page or post you need
+ # Home page and archive page can be controlled through home and archive options below
+ home: true
+ archive: true
- # Default (true) will initialize quicklink after the load event fires.
+ # Default (true) will initialize quicklink after the load event fires
delay: true
- # Custom a time in milliseconds by which the browser must execute prefetching.
+ # Custom a time in milliseconds by which the browser must execute prefetching
timeout: 3000
- # Default (true) will enable fetch() or falls back to XHR.
+ # Default (true) will enable fetch() or falls back to XHR
priority: true
- # For more flexibility you can add some patterns (RegExp, Function, or Array) to ignores.
+ # For more flexibility you can add some patterns (RegExp, Function, or Array) to ignores
# See: https://github.com/GoogleChromeLabs/quicklink#custom-ignore-patterns
+ # Leave ignores as empty if you don't understand what it means
+ # Example:
+ # ignores:
+ # - /\/api\/?/
+ # - uri => uri.includes('.xml')
+ # - (uri, el) => el.hasAttribute('noopener')
ignores:
-<<<<<<< HEAD
# Bookmark Support
# Dependencies: https://github.com/theme-next/theme-next-bookmark
bookmark:
@@ -640,52 +647,31 @@ live2d:
aboutPageUrl: 'https://github.com/edsion1107/theme-next-live2d' # 关于页地址,'{URL 网址}'
screenshotCaptureName: 'live2d.png' # 看板娘截图文件名,例如 'live2d.png'
-=======
->>>>>>> ca19a9d82dba6521ee7b9cb2befda51c6a1bd063
# ---------------------------------------------------------------
-# Comments Settings
-# See: https://theme-next.org/docs/third-party-services/comments
+# Comments and Widgets
+# See: https://theme-next.org/docs/third-party-services/comments-and-widgets
# ---------------------------------------------------------------
-# Multiple Comment System Support
-comments:
- # Available values: tabs | buttons
- style: tabs
- # Choose a comment system to be displayed by default.
- # Available values: changyan | disqus | disqusjs | gitalk | livere | valine
- active:
- # Setting `true` means remembering the comment system selected by the visitor.
- storage: true
- # Lazyload all comment systems.
- lazyload: false
- # Modify texts or order for any navs, here are some examples.
- nav:
- #disqus:
- # text: Load Disqus
- # order: -1
- #gitalk:
- # order: -2
-
# Disqus
disqus:
enable: false
shortname:
count: true
- #post_meta_order: 0
+ lazyload: false
# DisqusJS
-# Alternative Disqus - Render comment component using Disqus API.
+# Alternative Disqus - Render comment component using Disqus API
# Demo: https://suka.js.org/DisqusJS/
-# For more information: https://github.com/SukkaW/DisqusJS
disqusjs:
enable: false
- # API Endpoint of Disqus API (https://disqus.com/api/).
- # Leave api empty if you are able to connect to Disqus API. Otherwise you need a reverse proxy for it.
+ # API Endpoint of Disqus API (https://disqus.com/api/)
+ # leave api empty if you are able to connect to Disqus API
+ # otherwise you need a reverse proxy for Disqus API
# For example:
# api: https://disqus.skk.moe/disqus/
api:
- apikey: # Register new application from https://disqus.com/api/applications/
+ apikey: # register new application from https://disqus.com/api/applications/
shortname: # See: https://disqus.com/admin/settings/general/
# Changyan
@@ -693,62 +679,101 @@ changyan:
enable: false
appid:
appkey:
- #post_meta_order: 0
# Valine
-# For more information: https://valine.js.org, https://github.com/xCss/Valine
+# You can get your appid and appkey from https://leancloud.cn
+# More info available at https://valine.js.org
valine:
- enable: false
- appid: # Your leancloud application appid
- appkey: # Your leancloud application appkey
- notify: false # Mail notifier
+ enable: false # When enable is set to be true, leancloud_visitors is recommended to be closed for the re-initialization problem within different leancloud adk version.
+ appid: # your leancloud application appid
+ appkey: # your leancloud application appkey
+ notify: false # mail notifier, See: https://github.com/xCss/Valine/wiki
verify: false # Verification code
- placeholder: Just go go # Comment box placeholder
- avatar: mm # Gravatar style
- guest_info: nick,mail,link # Custom comment header
- pageSize: 10 # Pagination size
- language: # Language, available values: en, zh-cn
- visitor: false # Article reading statistic
- comment_count: true # If false, comment count will only be displayed in post page, not in home page
- recordIP: false # Whether to record the commenter IP
- serverURLs: # When the custom domain name is enabled, fill it in here (it will be detected automatically by default, no need to fill in)
- #post_meta_order: 0
+ placeholder: Just go go # comment box placeholder
+ avatar: mm # gravatar style
+ guest_info: nick,mail,link # custom comment header
+ pageSize: 10 # pagination size
+ language: # language, available values: en, zh-cn
+ visitor: false # leancloud-counter-security is not supported for now. When visitor is set to be true, appid and appkey are recommended to be the same as leancloud_visitors' for counter compatibility. Article reading statistic https://valine.js.org/visitor.html
+ comment_count: true # if false, comment count will only be displayed in post page, not in home page
# LiveRe comments system
# You can get your uid from https://livere.com/insight/myCode (General web site)
-livere_uid: #
+#livere_uid: your uid
# Gitalk
-# For more information: https://gitalk.github.io, https://github.com/gitalk/gitalk
+# Demo: https://gitalk.github.io
gitalk:
enable: false
- github_id: # GitHub repo owner
- repo: # Repository name to store issues
- client_id: # GitHub Application Client ID
- client_secret: # GitHub Application Client Secret
- admin_user: # GitHub repo owner and collaborators, only these guys can initialize gitHub issues
+ github_id: # Github repo owner
+ repo: # Repository name to store issues
+ client_id: # Github Application Client ID
+ client_secret: # Github Application Client Secret
+ admin_user: # GitHub repo owner and collaborators, only these guys can initialize github issues
distraction_free_mode: true # Facebook-like distraction free mode
# Gitalk's display language depends on user's browser or system environment
# If you want everyone visiting your site to see a uniform language, you can set a force language value
- # Available values: en | es-ES | fr | ru | zh-CN | zh-TW
+ # Available values: en, es-ES, fr, ru, zh-CN, zh-TW
language:
# ---------------------------------------------------------------
-# Post Widgets & Content Sharing Services
-# See: https://theme-next.org/docs/third-party-services/post-widgets
+# Content Sharing Services
+# See: https://theme-next.org/docs/third-party-services/content-sharing-services
# ---------------------------------------------------------------
-# Star rating support to each article.
-# To get your ID visit https://widgetpack.com
-rating:
- enable: false
- id: #
- color: fc6423
+# Baidu Share
+# Available values: button | slide
+# Warning: Baidu Share does not support https.
+#baidushare:
+## type: button
-# AddThis Share. See: https://www.addthis.com
+# AddThis Share, See: https://www.addthis.com
# Go to https://www.addthis.com/dashboard to customize your tools.
-add_this_id:
+#add_this_id:
+
+# Likely Share
+# See: https://ilyabirman.net/projects/likely/
+# Likely supports four looks, nine social networks, any button text
+# You are free to modify the text value and order of any network
+likely:
+ enable: false
+ look: normal # available values: normal, light, small, big
+ networks:
+ twitter: Tweet
+ facebook: Share
+ linkedin: Link
+ gplus: Plus
+ vkontakte: Share
+ odnoklassniki: Class
+ telegram: Send
+ whatsapp: Send
+ pinterest: Pin
+
+# NeedMoreShare2
+# Dependencies: https://github.com/theme-next/theme-next-needmoreshare2
+# iconStyle: default | box
+# boxForm: horizontal | vertical
+# position: top / middle / bottom + Left / Center / Right
+# networks:
+# Weibo,Wechat,Douban,QQZone,Twitter,Facebook,Linkedin,Mailto,Reddit,Delicious,StumbleUpon,Pinterest,
+# GooglePlus,Tumblr,GoogleBookmarks,Newsvine,Evernote,Friendfeed,Vkontakte,Odnoklassniki,Mailru
+needmoreshare2:
+ enable: false
+ postbottom:
+ enable: false
+ options:
+ iconStyle: box
+ boxForm: horizontal
+ position: bottomCenter
+ networks: Weibo,Wechat,Douban,QQZone,Twitter,Facebook
+ float:
+ enable: false
+ options:
+ iconStyle: box
+ boxForm: horizontal
+ position: middleRight
+ networks: Weibo,Wechat,Douban,QQZone,Twitter,Facebook
# ---------------------------------------------------------------
@@ -756,56 +781,99 @@ add_this_id:
# See: https://theme-next.org/docs/third-party-services/statistics-and-analytics
# ---------------------------------------------------------------
-# Google Analytics
-google_analytics:
- tracking_id: #
- # By default, NexT will load an external gtag.js script on your site.
- # If you only need the pageview feature, set the following option to true to get a better performance.
- only_pageview: false
+# Baidu Analytics ID
+#baidu_analytics:
-# Baidu Analytics
-baidu_analytics: #
+# Growingio Analytics ID
+# Copyright 2015-2018 GrowingIO, Inc. More info available at https://www.growingio.com
+#growingio_analytics: #your projectId
-# Growingio Analytics
-growingio_analytics: #
+# Google Analytics
+#google_analytics:
+# tracking_id:
+# localhost_ignored: true
# CNZZ count
-cnzz_siteid:
+#cnzz_siteid:
-# Show number of visitors of each article.
+# Application Insights
+# See: https://azure.microsoft.com/en-us/services/application-insights
+#application_insights:
+
+# Post widgets & FB/VK comments settings.
+# ---------------------------------------------------------------
+# Facebook SDK Support
+facebook_sdk:
+ enable: false
+ app_id: #
+ fb_admin: #
+ like_button: #true
+ webmaster: #true
+
+# Facebook comments plugin
+# This plugin depends on Facebook SDK.
+# If facebook_sdk.enable is false, Facebook comments plugin is unavailable.
+facebook_comments_plugin:
+ enable: false
+ num_of_posts: 10 # min posts num is 1
+ width: 100% # default width is 550px
+ scheme: light # default scheme is light (light or dark)
+
+# VKontakte API Support
+# To get your AppID visit https://vk.com/editapp?act=create
+vkontakte_api:
+ enable: false
+ app_id: #
+ like: true
+ comments: true
+ num_of_posts: 10
+
+# Star rating support to each article.
+# To get your ID visit https://widgetpack.com
+rating:
+ enable: false
+ id: #
+ color: fc6423
+# ---------------------------------------------------------------
+
+# Show number of visitors to each article.
# You can visit https://leancloud.cn to get AppID and AppKey.
-# AppID and AppKey are recommended to be the same as valine's for counter compatibility.
-# Do not enable both `valine.visitor` and `leancloud_visitors`.
leancloud_visitors:
enable: false
- app_id: #
- app_key: #
- # Required for apps from CN region
- server_url: #
+ app_id: #
+ app_key: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
# If you don't care about security in leancloud counter and just want to use it directly
# (without hexo-leancloud-counter-security plugin), set `security` to `false`.
security: true
+ betterPerformance: false
# Another tool to show number of visitors to each article.
# Visit https://console.firebase.google.com/u/0/ to get apiKey and projectId.
# Visit https://firebase.google.com/docs/firestore/ to get more information about firestore.
firestore:
enable: false
- collection: articles # Required, a string collection name to access firestore database
- apiKey: # Required
- projectId: # Required
+ collection: articles #required, a string collection name to access firestore database
+ apiKey: #required
+ projectId: #required
+ bluebird: false #enable this if you want to include bluebird 3.5.1(core version) Promise polyfill
# Show Views / Visitors of the website / page with busuanzi.
# Get more information on http://ibruce.info/2015/04/04/busuanzi
busuanzi_count:
enable: false
total_visitors: true
- total_visitors_icon: fa fa-user
+ total_visitors_icon: user
total_views: true
- total_views_icon: fa fa-eye
+ total_views_icon: eye
post_views: true
- post_views_icon: fa fa-eye
+ post_views_icon: eye
+
+# Tencent analytics ID
+#tencent_analytics:
+
+# Tencent MTA ID
+#tencent_mta:
# ---------------------------------------------------------------
@@ -814,7 +882,8 @@ busuanzi_count:
# ---------------------------------------------------------------
# Algolia Search
-# For more information: https://www.algolia.com
+# See: https://theme-next.org/docs/third-party-services/search-services#Algolia-Search
+# Dependencies: https://github.com/theme-next/theme-next-algolia-instant-search
algolia_search:
enable: false
hits:
@@ -824,7 +893,7 @@ algolia_search:
hits_empty: "We didn't find any results for the search: ${query}"
hits_stats: "${hits} results found in ${time} ms"
-# Local Search
+# Local search
# Dependencies: https://github.com/theme-next/hexo-generator-searchdb
local_search:
enable: false
@@ -835,11 +904,9 @@ local_search:
top_n_per_article: 1
# Unescape html strings to the readable one.
unescape: false
- # Preload the search data when the page loads.
- preload: false
# Swiftype Search API Key
-swiftype_key:
+#swiftype_key:
# ---------------------------------------------------------------
@@ -853,15 +920,15 @@ swiftype_key:
chatra:
enable: false
async: true
- id: # Visit Dashboard to get your ChatraID
- #embed: # Unfinished experimental feature for developers. See: https://chatra.io/help/api/#injectto
+ id: # visit Dashboard to get your ChatraID
+ #embed: # unfinished experimental feature for developers, See: https://chatra.io/help/api/#injectto
# Tidio Support
# See: https://www.tidiochat.com
# Dashboard: https://www.tidiochat.com/panel/dashboard
tidio:
enable: false
- key: # Public Key, get it from dashboard. See: https://www.tidiochat.com/panel/settings/developer
+ key: # Public Key, get it from Dashboard, See: https://www.tidiochat.com/panel/settings/developer
# ---------------------------------------------------------------
@@ -878,30 +945,39 @@ note:
# - disabled disable all CSS styles import of note tag.
style: simple
icons: false
+ border_radius: 3
# Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
# Offset also applied to label tag variables. This option can work with disabled note tag.
light_bg_offset: 0
# Tabs tag
tabs:
+ enable: true
transition:
tabs: false
labels: true
+ border_radius: 0
-# PDF tag
-# NexT will try to load pdf files natively, if failed, pdf.js will be used.
-# So, you have to install the dependency of pdf.js if you want to use pdf tag and make it available to all browsers.
+# PDF tag, requires two plugins: pdfObject and pdf.js
+# pdfObject will try to load pdf files natively, if failed, pdf.js will be used.
+# The following `cdn` setting is only for pdfObject, because cdn for pdf.js might be blocked by CORS policy.
+# So, you must install the dependency of pdf.js if you want to use pdf tag and make it available to all browsers.
# See: https://github.com/theme-next/theme-next-pdf
pdf:
enable: false
# Default height
height: 500px
+ pdfobject:
+ cdn: //cdn.jsdelivr.net/npm/pdfobject@2/pdfobject.min.js
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/pdfobject/2.1.1/pdfobject.min.js
# Mermaid tag
mermaid:
enable: false
# Available themes: default | dark | forest | neutral
theme: forest
+ cdn: //cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/mermaid/8.0.0/mermaid.min.js
# ---------------------------------------------------------------
@@ -909,18 +985,17 @@ mermaid:
# ---------------------------------------------------------------
# Use velocity to animate everything.
-# For more information: http://velocityjs.org
motion:
enable: true
async: false
transition:
# Transition variants:
- # fadeIn | flipXIn | flipYIn | flipBounceXIn | flipBounceYIn
- # swoopIn | whirlIn | shrinkIn | expandIn
- # bounceIn | bounceUpIn | bounceDownIn | bounceLeftIn | bounceRightIn
- # slideUpIn | slideDownIn | slideLeftIn | slideRightIn
- # slideUpBigIn | slideDownBigIn | slideLeftBigIn | slideRightBigIn
- # perspectiveUpIn | perspectiveDownIn | perspectiveLeftIn | perspectiveRightIn
+ # fadeIn | fadeOut | flipXIn | flipXOut | flipYIn | flipYOut | flipBounceXIn | flipBounceXOut | flipBounceYIn | flipBounceYOut
+ # swoopIn | swoopOut | whirlIn | whirlOut | shrinkIn | shrinkOut | expandIn | expandOut
+ # bounceIn | bounceOut | bounceUpIn | bounceUpOut | bounceDownIn | bounceDownOut | bounceLeftIn | bounceLeftOut | bounceRightIn | bounceRightOut
+ # slideUpIn | slideUpOut | slideDownIn | slideDownOut | slideLeftIn | slideLeftOut | slideRightIn | slideRightOut
+ # slideUpBigIn | slideUpBigOut | slideDownBigIn | slideDownBigOut | slideLeftBigIn | slideLeftBigOut | slideRightBigIn | slideRightBigOut
+ # perspectiveUpIn | perspectiveUpOut | perspectiveDownIn | perspectiveDownOut | perspectiveLeftIn | perspectiveLeftOut | perspectiveRightIn | perspectiveRightOut
post_block: fadeIn
post_header: slideDownIn
post_body: slideDownIn
@@ -928,32 +1003,58 @@ motion:
# Only for Pisces | Gemini.
sidebar: slideUpIn
+# Fancybox. There is support for old version 2 and new version 3.
+# Choose only one variant, do not need to install both.
+# To install 2.x: https://github.com/theme-next/theme-next-fancybox
+# To install 3.x: https://github.com/theme-next/theme-next-fancybox3
+fancybox: false
+
+# Polyfill to remove click delays on browsers with touch UIs.
+# Dependencies: https://github.com/theme-next/theme-next-fastclick
+fastclick: false
+
+# Vanilla JavaScript plugin for lazyloading images.
+# Dependencies: https://github.com/theme-next/theme-next-jquery-lazyload
+lazyload: false
+
# Progress bar in the top during page loading.
# Dependencies: https://github.com/theme-next/theme-next-pace
-# For more information: https://github.com/HubSpot/pace
-pace:
+pace: false
+# Themes list:
+# pace-theme-big-counter | pace-theme-bounce | pace-theme-barber-shop | pace-theme-center-atom
+# pace-theme-center-circle | pace-theme-center-radar | pace-theme-center-simple | pace-theme-corner-indicator
+# pace-theme-fill-left | pace-theme-flash | pace-theme-loading-bar | pace-theme-mac-osx | pace-theme-minimal
+pace_theme: pace-theme-minimal
+
+# Canvas-nest
+# Dependencies: https://github.com/theme-next/theme-next-canvas-nest
+canvas_nest:
enable: false
- # Themes list:
- # big-counter | bounce | barber-shop | center-atom | center-circle | center-radar | center-simple
- # corner-indicator | fill-left | flat-top | flash | loading-bar | mac-osx | material | minimal
- theme: minimal
+ onmobile: true # display on mobile or not
+ color: "0,0,255" # RGB values, use ',' to separate
+ opacity: 0.5 # the opacity of line: 0~1
+ zIndex: -1 # z-index property of the background
+ count: 99 # the number of lines
# JavaScript 3D library.
# Dependencies: https://github.com/theme-next/theme-next-three
-three:
- enable: false
- three_waves: false
- canvas_lines: false
- canvas_sphere: false
+# three_waves
+three_waves: false
+# canvas_lines
+canvas_lines: false
+# canvas_sphere
+canvas_sphere: false
# Canvas-ribbon
# Dependencies: https://github.com/theme-next/theme-next-canvas-ribbon
-# For more information: https://github.com/zproo/canvas-ribbon
+# size: The width of the ribbon.
+# alpha: The transparency of the ribbon.
+# zIndex: The display level of the ribbon.
canvas_ribbon:
enable: false
- size: 300 # The width of the ribbon
- alpha: 0.6 # The transparency of the ribbon
- zIndex: -1 # The display level of the ribbon
+ size: 300
+ alpha: 0.6
+ zIndex: -1
#! ---------------------------------------------------------------
@@ -963,93 +1064,47 @@ canvas_ribbon:
#! ---------------------------------------------------------------
# Script Vendors. Set a CDN address for the vendor you want to customize.
+# For example
+# jquery: https://ajax.googleapis.com/ajax/libs/jquery/2.2.0/jquery.min.js
# Be aware that you would better use the same version as internal ones to avoid potential problems.
-# Remember to use the https protocol of CDN files when you enable https on your site.
+# Please use the https protocol of CDN files when you enable https on your site.
vendors:
- # Internal path prefix.
+ # Internal path prefix. Please do not edit it.
_internal: lib
- # Internal version: 3.1.0
- # anime: //cdn.jsdelivr.net/npm/animejs@3.1.0/lib/anime.min.js
- anime:
-
- # Internal version: 5.13.0
- # fontawesome: //cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css
- # fontawesome: //cdnjs.cloudflare.com/ajax/libs/font-awesome/5.13.0/css/all.min.css
- fontawesome:
-
- # MathJax
- # mathjax: //cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
- mathjax:
-
- # KaTeX
- # katex: //cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css
- # katex: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.11.1/katex.min.css
- # copy_tex_js: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.js
- # copy_tex_css: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.css
- katex:
- copy_tex_js:
- copy_tex_css:
-
- # Internal version: 0.2.8
- # pjax: //cdn.jsdelivr.net/gh/theme-next/theme-next-pjax@0/pjax.min.js
- pjax:
-
- # FancyBox
+ # Internal version: 3.4.1
+ # Example:
# jquery: //cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js
+ # jquery: //cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js
+ jquery:
+
+ # Internal version: 2.1.5 & 3.5.7
+ # See: https://fancyapps.com/fancybox
+ # Example:
# fancybox: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.js
+ # fancybox: //cdnjs.cloudflare.com/ajax/libs/fancybox/3.5.6/jquery.fancybox.min.js
# fancybox_css: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.css
- jquery:
+ # fancybox_css: //cdnjs.cloudflare.com/ajax/libs/fancybox/3.5.6/jquery.fancybox.min.css
fancybox:
fancybox_css:
- # Medium-zoom
- # mediumzoom: //cdn.jsdelivr.net/npm/medium-zoom@1/dist/medium-zoom.min.js
- mediumzoom:
-
- # Lazyload
- # lazyload: //cdn.jsdelivr.net/npm/lozad@1/dist/lozad.min.js
- # lazyload: //cdnjs.cloudflare.com/ajax/libs/lozad.js/1.14.0/lozad.min.js
+ # Internal version: 1.0.6
+ # See: https://github.com/ftlabs/fastclick
+ # Example:
+ # fastclick: //cdn.jsdelivr.net/npm/fastclick@1/lib/fastclick.min.js
+ # fastclick: //cdnjs.cloudflare.com/ajax/libs/fastclick/1.0.6/fastclick.min.js
+ fastclick:
+
+ # Internal version: 1.9.7
+ # See: https://github.com/tuupola/jquery_lazyload
+ # Example:
+ # lazyload: //cdn.jsdelivr.net/npm/jquery-lazyload@1/jquery.lazyload.min.js
+ # lazyload: //cdnjs.cloudflare.com/ajax/libs/jquery_lazyload/1.9.7/jquery.lazyload.min.js
lazyload:
- # Pangu
- # pangu: //cdn.jsdelivr.net/npm/pangu@4/dist/browser/pangu.min.js
- # pangu: //cdnjs.cloudflare.com/ajax/libs/pangu/4.0.7/pangu.min.js
- pangu:
-
- # Quicklink
- # quicklink: //cdn.jsdelivr.net/npm/quicklink@1/dist/quicklink.umd.js
- quicklink:
-
- # DisqusJS
- # disqusjs_js: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js
- # disqusjs_css: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css
- disqusjs_js:
- disqusjs_css:
-
- # Valine
- # valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js
- # valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.10/Valine.min.js
- valine:
-
- # Gitalk
- # gitalk_js: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js
- # gitalk_css: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.css
- gitalk_js:
- gitalk_css:
-
- # Algolia Search
- # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
- # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
- algolia_search:
- instant_search:
-
- # Mermaid
- # mermaid: //cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js
- # mermaid: //cdnjs.cloudflare.com/ajax/libs/mermaid/8.4.8/mermaid.min.js
- mermaid:
-
# Internal version: 1.2.1
+ # See: http://velocityjs.org
+ # Example:
# velocity: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.min.js
# velocity: //cdnjs.cloudflare.com/ajax/libs/velocity/1.2.1/velocity.min.js
# velocity_ui: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.ui.min.js
@@ -1057,7 +1112,24 @@ vendors:
velocity:
velocity_ui:
+ # Internal version: 4.7.0
+ # See: https://fontawesome.com
+ # Example:
+ # fontawesome: //cdn.jsdelivr.net/npm/font-awesome@4/css/font-awesome.min.css
+ # fontawesome: //cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css
+ fontawesome:
+
+ # Internal version: 2.10.4
+ # See: https://www.algolia.com
+ # Example:
+ # algolia_instant_js: //cdn.jsdelivr.net/npm/instantsearch.js@2/dist/instantsearch.js
+ # algolia_instant_css: //cdn.jsdelivr.net/npm/instantsearch.js@2/dist/instantsearch.min.css
+ algolia_instant_js:
+ algolia_instant_css:
+
# Internal version: 1.0.2
+ # See: https://github.com/HubSpot/pace
+ # Example:
# pace: //cdn.jsdelivr.net/npm/pace-js@1/pace.min.js
# pace: //cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/pace.min.js
# pace_css: //cdn.jsdelivr.net/npm/pace-js@1/themes/blue/pace-theme-minimal.css
@@ -1066,6 +1138,16 @@ vendors:
pace_css:
# Internal version: 1.0.0
+ # See: https://github.com/theme-next/theme-next-canvas-nest
+ # Example:
+ # canvas_nest: //cdn.jsdelivr.net/gh/theme-next/theme-next-canvas-nest@1/canvas-nest.min.js
+ # canvas_nest_nomobile: //cdn.jsdelivr.net/gh/theme-next/theme-next-canvas-nest@1/canvas-nest-nomobile.min.js
+ canvas_nest:
+ canvas_nest_nomobile:
+
+ # Internal version: 1.0.0
+ # See: https://github.com/theme-next/theme-next-three
+ # Example:
# three: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three.min.js
# three_waves: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three-waves.min.js
# canvas_lines: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/canvas_lines.min.js
@@ -1076,9 +1158,77 @@ vendors:
canvas_sphere:
# Internal version: 1.0.0
+ # See: https://github.com/zproo/canvas-ribbon
+ # Example:
# canvas_ribbon: //cdn.jsdelivr.net/gh/theme-next/theme-next-canvas-ribbon@1/canvas-ribbon.js
canvas_ribbon:
+ # Internal version: 4.0.7
+ # See: https://github.com/vinta/pangu.js
+ # Example:
+ # pangu: //cdn.jsdelivr.net/npm/pangu@4/dist/browser/pangu.min.js
+ # pangu: //cdnjs.cloudflare.com/ajax/libs/pangu/4.0.7/pangu.min.js
+ pangu:
+
+ # Internal version: 1.0.0
+ # See: https://github.com/GoogleChromeLabs/quicklink
+ # Example:
+ # quicklink: //cdn.jsdelivr.net/npm/quicklink@1/dist/quicklink.umd.js
+ quicklink:
+
+ # Internal version: 1.0.0
+ # See: https://github.com/revir/need-more-share2
+ # Example:
+ # needmoreshare2_js: //cdn.jsdelivr.net/gh/theme-next/theme-next-needmoreshare2@1/needsharebutton.min.js
+ # needmoreshare2_css: //cdn.jsdelivr.net/gh/theme-next/theme-next-needmoreshare2@1/needsharebutton.min.css
+ needmoreshare2_js:
+ needmoreshare2_css:
+
+ # Internal version: 1.0.0
+ # See: https://github.com/theme-next/theme-next-bookmark
+ # Example:
+ # bookmark: //cdn.jsdelivr.net/gh/theme-next/theme-next-bookmark@1/bookmark.min.js
+ bookmark:
+
+ # Internal version: 1.2.0
+ # See: https://github.com/theme-next/theme-next-reading-progress
+ # Example:
+ # reading_progress: //cdn.jsdelivr.net/gh/theme-next/theme-next-reading-progress@1.2.0/reading_progress.min.js
+ reading_progress:
+
+ # valine
+ # See: https://github.com/xCss/Valine
+ # Example:
+ # valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js
+ # valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.4/Valine.min.js
+ valine:
+
+ # gitalk & js-md5
+ # See: https://github.com/gitalk/gitalk, https://github.com/emn178/js-md5
+ # Example:
+ # gitalk_js: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js
+ # gitalk_css: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.css
+ # md5: //cdn.jsdelivr.net/npm/js-md5@0/src/md5.min.js
+ gitalk_js:
+ gitalk_css:
+ md5:
+
+ # likely
+ # See: https://github.com/ilyabirman/Likely
+ # Example:
+ # likely_js: //cdn.jsdelivr.net/npm/ilyabirman-likely@2/release/likely.js
+ # likely_css: //cdn.jsdelivr.net/npm/ilyabirman-likely@2/release/likely.css
+ likely_js:
+ likely_css:
+
+ # DisqusJS
+ # See: https://github.com/SukkaW/DisqusJS
+ # Example:
+ # disqusjs_js: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js
+ # disqusjs_css: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css
+ disqusjs_js:
+ disqusjs_css:
+
# Assets
css: css
js: js
diff --git a/bower.json b/bower.json
new file mode 100644
index 0000000000..a434fc5ce4
--- /dev/null
+++ b/bower.json
@@ -0,0 +1,30 @@
+{
+ "name": "theme-next",
+ "version": "7.2.0",
+ "homepage": "https://theme-next.org",
+ "authors": [
+ "NexT (https://theme-next.org)"
+ ],
+ "description": "Elegant theme for Hexo",
+ "repository": "https://github.com/theme-next/hexo-theme-next",
+ "keywords": [
+ "hexo",
+ "theme",
+ "next"
+ ],
+ "license": "AGPL",
+ "ignore": [
+ "**/.*",
+ "node_modules",
+ "bower_components",
+ "source/lib",
+ "test",
+ "tests",
+ "screenshots"
+ ],
+ "dependencies": {
+ "font-awesome": "fontawesome#*",
+ "jquery": "https://code.jquery.com/jquery-3.4.1.min.js",
+ "velocity": "~1.2.1"
+ }
+}
diff --git a/docs/ALGOLIA-SEARCH.md b/docs/ALGOLIA-SEARCH.md
index bdc8ab682b..998d8dcece 100644
--- a/docs/ALGOLIA-SEARCH.md
+++ b/docs/ALGOLIA-SEARCH.md
@@ -1,16 +1,29 @@
Algolia Search
+
NexT provides Algolia search plugin for index your hexo website content. To use this feature, make sure that the version of NexT you are using is after the v5.1.0 release. What you should note here is that only turn on `enable` of `algolia_search` in `next/_config.yml` cannot let you use the algolia search correctly, you need to install corresponding [Hexo Algolia](https://github.com/oncletom/hexo-algolia) plugin to seach your website with Algolia. Follow the steps described below to complete the installation of Algolia search.
1. Register at [Algolia](https://www.algolia.com/), you can log in directly using GitHub or Google Account. Upon Customer’s initial sign-up for an Account, Customer will have a free, fourteen (14) day evaluation period (the “Evaluation Period”) for the Algolia Services commencing on the Effective Date, subject to the limitations on Algolia’s website. After that, Algolia offers a free, branded version for up to 10k records and 100k operations per month.
1. If a tutorial pops up, you can skip it. Go straight to create an `Index` which will be used later.
- 
+ 
+
+1. Algolia requires users to upload their search index data either manually or via provided APIs. Install and configure [Hexo Algolia](https://github.com/oncletom/hexo-algolia) in your Hexo directory. This plugin will index your site and upload selected data to Algolia.
+
+ ```
+ $ cd hexo
+ $ npm install --save hexo-algolia
+ ```
1. Go to the `API Keys` page and find your credentials. You will need the `Application ID` and the `Search-only API key` in the following sections. The `Admin API key` need to keep confidential. Never store your Admin API Key as apiKey in the` _config.yml` file: it would give full control of your Algolia index to others and you don't want to face the consequences.
- 
+ 
+
+1. In the `API Keys` page, click the `ALL API KEYS` and the `edit` option in the created APIKEY to activate a pop-up box where you can setup authorizations and restrictions with a great level of precision. Check `Add records`, `Delete records`, `List indices`, `Delete index` features in ACL permissions that will be allowed for the given API key. And then click the `Update` button.
+
+ 
+ 
1. In your site's `_config.yml`, add the following configuration and replace the `applicationID` & `apiKey` & `indexName` with corresponding fields obtained at Algolia.
@@ -22,29 +35,35 @@ NexT provides Algolia search plugin for index your hexo website content. To use
chunkSize: 5000
```
-1. In the `API Keys` page, click the `All API Keys` button to switch to the corresponding tab. Then click the `New API Key` button to activate a pop-up box where you can setup authorizations and restrictions with a great level of precision. Enter `addObject`, `deleteObject`, `listIndexes`, `deleteIndex` features in ACL permissions that will be allowed for the given API key. And then click the `Create` button. Copy this newly created key to the clipboard, we call it a `High-privilege API key`.
-
- 
- 
-
-1. Algolia requires users to upload their search index data either manually or via provided APIs. Install and configure [Hexo Algolia](https://github.com/oncletom/hexo-algolia) in your Hexo directory. This plugin will index your site and upload selected data to Algolia.
-
- ```
- $ cd hexo
- $ npm install hexo-algolia
- ```
-
1. Run the following command to upload index data, keep a weather eye out the output of the command.
```
- $ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Git Bash
- # set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Windows command line
+ $ export HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # Use Git Bash
+ # set HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # Use Windows command line
$ hexo clean
$ hexo algolia
```

+1. Change dir to NexT directory, and install module to `source/lib` directory.
+
+ ```
+ $ cd themes/next
+ $ git clone https://github.com/theme-next/theme-next-algolia-instant-search source/lib/algolia-instant-search
+ ```
+
+ If you want to use the CDN instead of clone this repo, then need to **set vendors** in NexT `_config.yml` file:
+ ```yml
+ vendors:
+ ...
+ # Internal version: 1
+ # https://www.algolia.com
+ algolia_instant_js: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.js
+ algolia_instant_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.min.css
+ ...
+ ```
+
1. In `next/_config.yml`, turn on `enable` of `algolia_search`. At the same time, you need to **turn off other search plugins** like Local Search. You can also adjust the text in `labels` according to your needs.
```yml
@@ -59,20 +78,6 @@ NexT provides Algolia search plugin for index your hexo website content. To use
hits_stats: "${hits} results found in ${time} ms"
```
-1. If you want to use a different version from CDN, please follow the instructions below.
-
- You need to **set vendors** in NexT `_config.yml` file:
- ```yml
- vendors:
- ...
- # Algolia Search
- # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
- # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
- algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
- instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
- ...
- ```
-
Known Issues
1. The latest version of the [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) plugin removes the content indexing feature, given Algolia's free account limitation.
diff --git a/docs/AUTHORS.md b/docs/AUTHORS.md
index 078740aacb..f54eef7bb1 100644
--- a/docs/AUTHORS.md
+++ b/docs/AUTHORS.md
@@ -84,4 +84,4 @@ And best contributors from initially repository:
It lives on as an open source project with many contributors, a self updating list is [here](https://github.com/theme-next/hexo-theme-next/graphs/contributors).
-P.S. If you did some useful pulls/commits in original repository and you are not in the list, let us know and you will be added here.
+P.S. If you was do some useful pulls/commits in original repository and you are not in list, let me know and you will be added here.
diff --git a/docs/DATA-FILES.md b/docs/DATA-FILES.md
index 1760c77e51..bdf8ab0025 100644
--- a/docs/DATA-FILES.md
+++ b/docs/DATA-FILES.md
@@ -2,22 +2,24 @@
Currently, it is not smooth to update NexT theme from pulling or downloading new releases. It is quite often running into conflict status when updating NexT theme via `git pull`, or need to merge configurations manually when upgrading to new releases.
-At present, NexT encourages users to store some options in site's `/_config.yml` and other options in theme's `/themes/next/_config.yml`. This approach is applicable, but has some drawbacks:
+ At present, NexT encourages users to store some options in site's `_config.yml` and other options in theme's `_config.yml`. This approach is applicable, but has some drawbacks:
1. Configurations are splitted into two pieces
2. Users may be confused which place should be for options
-In order to resolve this issue, NexT provides the following two solutions.
+In order to resolve this issue, NexT will take advantage of Hexo [Data files](https://hexo.io/docs/data-files.html). Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature.
+
+If you prefer Hexo 2.x, you can still use the old approach for configurations. NexT is still compatible with Hexo 2.x (but errors are possible).
Option 1: Hexo-Way
-With this way, all your configurations locate in main Hexo config file (`/_config.yml`), you don't need to touch `/themes/next/_config.yml` or create any new files. But you must preserve double spaces indents within `theme_config` option.
+With this way, all your configurations locate in main hexo config file (`hexo/_config.yml`), you don't need to touch `next/_config.yml` or create any new files. But you must preserve double spaces indents within `theme_config` option.
-If there are any new options in new releases, you just need to copy those options from `/themes/next/_config.yml`, paste into `/_config.yml` and set their values to whatever you want.
+If there are any new options in new releases, you just need to copy those options from `next/_config.yml`, paste into `hexo/_config.yml` and set their values to whatever you want.
### Usage
-1. Please confirm that the `/source/_data/next.yml` file does not exist (delete it if exists).
-2. Copy needed NexT theme options from theme's `/themes/next/_config.yml` into `/_config.yml`, then\
+1. Check for no exists `hexo/source/_data/next.yml` file (delete it if exists).
+2. Copy needed NexT theme options from theme's `next/_config.yml` into `hexo/_config.yml`, then\
2.1. Move all this settings to the right with two spaces (in Visual Studio Code: select all strings, CTRL + ]).\
2.2. Add `theme_config:` parameter above all this settings.
@@ -28,17 +30,15 @@ If there are any new options in new releases, you just need to copy those option
Option 2: NexT-Way
-With this way, you can put all your configurations into one place (`/source/_data/next.yml`), you don't need to touch `/themes/next/_config.yml`.
+With this way, you can put all your configurations into one place (`source/_data/next.yml`), you don't need to touch `next/_config.yml`.
But option may not accurately procces all hexo external libraries with their additional options (for example, `hexo-server` module options may be readed only in default hexo config).
-If there are any new options in new releases, you just need to copy those options from `/themes/next/_config.yml`, paste into `/source/_data/next.yml` and set their values to whatever you want.
-
-This method relies on Hexo [Data files](https://hexo.io/docs/data-files.html). Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature.
+If there are any new options in new releases, you just need to copy those options from `next/_config.yml`, paste into `_data/next.yml` and set their values to whatever you want.
### Usage
1. Please ensure you are using Hexo 3 (or above).
-2. Create an file named `next.yml` in site's `/source/_data` directory (create `_data` directory if it does not exist).
+2. Create an file named `next.yml` in site's `hexo/source/_data` directory (create `_data` directory if it did not exists).
And after that steps there are 2 variants, need to choose only one of them and resume next steps.
@@ -46,15 +46,15 @@ This method relies on Hexo [Data files](https://hexo.io/docs/data-files.html). B
1. Check your `override` option in default NexT config, it must set on `false`.\
In `next.yml` it must not be defined or set on `false` too.
- 2. Copy needed options from both site's `/_config.yml` and theme's `/themes/next/_config.yml` into `/source/_data/next.yml`.
+ 2. Copy needed options from both site's `_config.yml` and theme's `_config.yml` into `hexo/source/_data/next.yml`.
* **Variant 2: `override: true`**:
1. In `next.yml` set `override` option on `true`.
- 2. Copy **all** NexT theme options from theme's `/themes/next/_config.yml` into `/source/_data/next.yml`.
+ 2. Copy **all** NexT theme options from theme's `next/_config.yml` into `hexo/source/_data/next.yml`.
-3. Then, in main site's `/_config.yml` need to define `theme: next` option (and if needed, `source_dir: source`).
-4. Use standard parameters to start server, generate or deploy (`hexo clean && hexo g -d && hexo s`).
+3. Then, in main site's `hexo/_config.yml` need to define `theme: next` option (and if needed, `source_dir: source`).
+4. Use standart parameters to start server, generate or deploy (`hexo clean && hexo g -d && hexo s`).
### Useful links
diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md
index 769d62ab47..3f229994dd 100644
--- a/docs/INSTALLATION.md
+++ b/docs/INSTALLATION.md
@@ -2,17 +2,16 @@
Step 1 → Go to Hexo dir
-Change dir to **Hexo root** directory. There must be `node_modules`, `source`, `themes` and other directories:
-
-```sh
-$ cd hexo
-$ ls
-_config.yml node_modules package.json public scaffolds source themes
-```
+Change dir to **hexo root** directory. There must be `node_modules`, `source`, `themes` and other directories:
+ ```sh
+ $ cd hexo
+ $ ls
+ _config.yml node_modules package.json public scaffolds source themes
+ ```
Step 2 → Get NexT
-Download theme from GitHub.
+
Download theme from GitHub.
There are 3 options to do it, need to choose only one of them.
### Option 1: Download [latest release version][releases-latest-url]
@@ -101,7 +100,7 @@ There are 3 options to do it, need to choose only one of them.
Step 3 → Set it up
-Set theme in main **Hexo root config** `_config.yml` file:
+Set theme in main **hexo root config** `_config.yml` file:
```yml
theme: next
diff --git a/docs/LEANCLOUD-COUNTER-SECURITY.md b/docs/LEANCLOUD-COUNTER-SECURITY.md
index b5d741cf73..9a6c8a0dd7 100644
--- a/docs/LEANCLOUD-COUNTER-SECURITY.md
+++ b/docs/LEANCLOUD-COUNTER-SECURITY.md
@@ -1,13 +1,11 @@
-Fix LeanCloud Counter Plugin Security Vulnerability
-
Before you make the config, please upgrade your NexT version to v6.0.6 or greater.
Please note the difference between **site config file** and **theme config file**
---
-# Sign up to LeanCloud and create an app
-- Go to LeanCloud website [leancloud.app](https://leancloud.app) and sign up to LeanCloud. Then login.
+# Sign up to Leancloud and create an app
+- Go to Leancloud website [leancloud.cn](leancloud.cn) and sign up to Leancloud. Then login.
- Click `1` to enter the console:

@@ -21,7 +19,7 @@ Please note the difference between **site config file** and **theme config file*

# Create Counter class and enable plugin in NexT
-- Click `1` (app name) to enter the app manage page:
+- Click `1`(app name) to enter the app manage page:

@@ -37,19 +35,18 @@ Please note the difference between **site config file** and **theme config file*

-- Paste `App ID` and `App Key` to **theme config file** `_config.yml` like this:
+- Paste `App ID` and `App Key` to **theme config file**`_config.yml` like this:
```yml
leancloud_visitors:
enable: true
- app_id: #
- app_key: #
- # Required for apps from CN region
- server_url: #
+ app_id: <>
+ app_key: <>
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
+ betterPerformance: false
```
-- Set domain whitelist: Click `1`, then type your domain into `2` (**protocol, domain and port should be exactly the same**):
+- Set domain whitelist: Click`1`, then type your domain into `2`(**protocol, domain and port should be exactly the same**):

@@ -58,14 +55,14 @@ Please note the difference between **site config file** and **theme config file*

-- Click `1`:
+- Click`1`:

- In the pop up window, click `1` to choose type `Hook`, then choose`beforeUpdate` in `2`, choose `Counter` in `3`. Paste code below into `4`, then click `5` to save it:
```javascript
var query = new AV.Query("Counter");
- if (request.object.updatedKeys.includes('time')) {
+ if (request.object.updatedKeys.indexOf('time') !== -1) {
return query.get(request.object.id).then(function (obj) {
if (obj.get("time") > request.object.get("time")) {
throw new AV.Cloud.Error('Invalid update!');
@@ -90,55 +87,57 @@ Please note the difference between **site config file** and **theme config file*

# Set access control for your database
-- Open **theme config file** `_config.yml`, set `leancloud_visitors: security` to `true`:
+- Open **theme config file**`_config.yml`, set `leancloud_visitors: security` to `true`:
```yml
leancloud_visitors:
enable: true
- app_id: #
- app_key: #
- # Required for apps from CN region
- server_url: #
+ app_id: <>
+ app_key: <>
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
+ betterPerformance: false
```
+ **Explaination for `betterPerformance`:**
+ Because the Leancloud developer's plan has limits in requst thread amount and running time, counter number may be very slow to load in some times. If set `betterPerformance` to true, counter number will be displayed quickly by assuming the request is accepted normally.
+
- Open cmd then switch to **root path of site**, type commands to install `hexo-leancloud-counter-security` plugin:
```
- npm install hexo-leancloud-counter-security
+ npm install hexo-leancloud-counter-security --save
```
-- Open **site config file** `_config.yml`, add those config:
+- Open **site config file**`_config.yml`, add those config:
```yml
leancloud_counter_security:
enable_sync: true
- app_id:
- app_key:
+ app_id: <>
+ app_key: <
username:
password:
```
- Type command:
```
- hexo lc-counter register
+ hexo lc-counter register <> <>
```
or
```
- hexo lc-counter r
+ hexo lc-counter r <> <>
```
- Change `` and `` to your own username and password (no need to be the same as leancloud account). They will be used in the hexo deploying.
+ Change `<>` and `<>` to your own username and password (no need to be the same as leancloud account). They will be used in the hexo deploying.
- - Open **site config file** `_config.yml`, change `` and ``to those you set above:
+ - Open **site config file**`_config.yml`, change `<>` and `<>`to those you set above:
```yml
leancloud_counter_security:
enable_sync: true
- app_id:
- app_key:
- username: # will be asked while deploying if be left blank
- password: # recommend to leave it blank for security, will be asked while deploying if be left blank
+ app_id: <>
+ app_key: <
+ username: <> # will be asked while deploying if be left blank
+ password: <> # recommend to leave it blank for security, will be asked while deploying if be left blank
```
-- Add the deployer in the `deploy` of **site config file** `_config.yml`:
+- Add the deployer in the `deploy` of **site config file**`_config.yml`:
```yml
deploy:
- type: git
@@ -147,7 +146,7 @@ Please note the difference between **site config file** and **theme config file*
- type: leancloud_counter_security_sync
```
-- Return to the LeanCloud console. Click `1 -> 2`, check if there is a record added in the `_User` (the img below is using username "admin" for example):
+- Return to the Leancloud console. Click `1 -> 2`, check if there is a record added in the _User (the img below is using username "admin" for example):

@@ -155,11 +154,11 @@ Please note the difference between **site config file** and **theme config file*

-- Click `1` (add_fields), then choose `2`: Do as below "create" setting(choose the user you create):
+- Click `1`(add_fields), then choose `2`:Do as below "create" setting(choose the user you create):

-- click `1` (create), then choose `2`, type the username in `3`, then click `4 -> 5`:
+- click `1`(create), then choose `2`, type the username in `3`, then click `4 -> 5`:

@@ -167,7 +166,7 @@ Please note the difference between **site config file** and **theme config file*

-- Click `1` (delete), then choose `2`:
+- Click `1`(delete), then choose `2`:

diff --git a/docs/MATH.md b/docs/MATH.md
index 776a584e67..b39478c1fd 100644
--- a/docs/MATH.md
+++ b/docs/MATH.md
@@ -2,32 +2,40 @@
NexT provides two render engines for displaying Math Equations.
-If you choose to use this feature, you don't need to manually import any JS or CSS. You just need to choose a render engine and turn on `enable` for it (located in `next/_config.yml`).
+If you choose to use this feature, you don't need to manually import any JS or CSS. You just need to turn on `enable` of `math` and choose a render `engine` for it (located in `next/_config.yml`):
-Notice: only turning on `enable` **cannot let you see the displayed equations correctly**, you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations. The corresponding Hexo Renderer per engine will be provided below.
+```yml
+math:
+ enable: true
+ ...
+ engine: mathjax
+```
+
+Notice: only turning on `enable` of `math` **cannot let you see the displayed equations correctly**, you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations. The corresponding Hexo Renderer per engine will be provided below.
Provided Render Engine
-For now, NexT provides two Render Engines: [MathJax](https://www.mathjax.org/) and [Katex](https://khan.github.io/KaTeX/).
+For now, NexT provides two Render Engines: [MathJax](https://www.mathjax.org/) and [Katex](https://khan.github.io/KaTeX/) (default is MathJax).
-### MathJax
+### MathJax (default)
-If you use MathJax to render Math Equations, you need to use one of them: [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) or [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) (Not recommended) as the renderer for Markdown.
+If you use MathJax to render Math Equations, you need to use **only one of them**: [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) or [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed).
-Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and install **one of the renderer above**:
+Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and install one of the renderer above:
```sh
-npm uninstall hexo-renderer-marked
-npm install hexo-renderer-pandoc # or hexo-renderer-kramed
+npm un hexo-renderer-marked --save
+npm i hexo-renderer-pandoc --save # or hexo-renderer-kramed
```
-Secondly, in `next/_config.yml`, turn on `enable` of `mathjax`.
+Secondly, in `next/_config.yml`, turn on `enable` of `math` and choose `mathjax` as `engine`.
```yml
math:
+ enable: true
...
- mathjax:
- enable: true
+ engine: mathjax
+ #engine: katex
```
Finally, run standard Hexo generate, deploy process or start the server:
@@ -46,9 +54,9 @@ In general, to make the automatic equation numbering work, you have to wrap your
For simple equations, use the following form to give a tag,
```latex
-$$\begin{equation}\label{eq1}
+$$\begin{equation}
e=mc^2
-\end{equation}$$
+\end{equation}\label{eq1}$$
```
Then, you can refer to this equation in your text easily by using something like
@@ -60,13 +68,13 @@ the famous matter-energy equation $\eqref{eq1}$ proposed by Einstein ...
For multi-line equations, inside the `equation` environment, you can use the `aligned` environment to split it into multiple lines:
```latex
-$$\begin{equation}\label{eq2}
+$$\begin{equation}
\begin{aligned}
a &= b + c \\
&= d + e + f + g \\
&= h + i
\end{aligned}
-\end{equation}$$
+\end{equation}\label{eq2}$$
```
We can use `align` environment to align multiple equations. Each of these equations will get its own numbers.
@@ -95,7 +103,7 @@ Sometimes, you want to use more “exotic” style to refer your equation. You c
$$x+1\over\sqrt{1-x^2} \tag{i}\label{eq_tag}$$
```
-For more information, you can visit the [official MathJax documentation on equation numbering](https://docs.mathjax.org/en/latest/input/tex/eqnumbers.html). You can also visit this [post](https://theme-next.org/docs/third-party-services/math-equations) for more details.
+For more information, you can visit the [official MathJax documentation on equation numbering](http://docs.mathjax.org/en/latest/tex.html#automatic-equation-numbering). You can also visit this [post](https://jdhao.github.io/2018/01/25/hexo-mathjax-equation-number/) for more details.
### Katex
@@ -108,18 +116,19 @@ If you use Katex to render Math Equations, you need to use **only one of those r
Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and **install one of selected above**.
```sh
-npm uninstall hexo-renderer-marked
-npm install hexo-renderer-markdown-it-plus
+npm un hexo-renderer-marked --save
+npm i hexo-renderer-markdown-it-plus --save
# or hexo-renderer-markdown-it
```
-Secondly, in `next/_config.yml`, turn on `enable` option of `katex`.
+Secondly, in `next/_config.yml`, turn on `enable` option of `math` and choose `katex` as render `engine`.
```yml
math:
+ enable: true
...
- katex:
- enable: true
+ #engine: mathjax
+ engine: katex
```
Finally, run the standard Hexo generate, deploy process or start the server:
@@ -134,7 +143,7 @@ hexo clean && hexo g -d
If you use `hexo-renderer-markdown-it`,you also need to add `markdown-it-katex` as its plugin:
```
-npm install markdown-it-katex
+npm i markdown-it-katex --save
```
And then in `hexo/_config.yml` you need to add `markdown-it-katex` as a plugin for `hexo-renderer-markdown-it`:
@@ -164,9 +173,9 @@ markdown:
Then in corresponding TOC item it will show the related LaTex code 3 times ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359018694)).
6. If you use math in your post's title, it will not be rendered ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359142879)).
-We currently use Katex 0.11.1, some of those bugs might be caused by the outdated version of Katex we use.
+We currently use Katex 0.7.1, some of those bugs might be caused by the outdated version of Katex we use.
-But, as what is described in the beginning, the render of Math Equations relies on Hexo Renderer. Currently, Katex-related renderers only support Katex version until 0.11.1.
+But, as what is described in the beginning, the render of Math Equations relies on Hexo Renderer. Currently, Katex-related renderers only support Katex version until 0.7.1.
We will continuously monitor the updates of corresponding renderers, if there is a renderer which supports newer version of Katex, we will update the Katex we use.
@@ -184,27 +193,41 @@ Currently, all NexT config use **2 spaces indents**.
If your content of config is put just directly after the config name, then a space is needed between the colon and the config content (i.e. `enable: true`)
```yml
-# Math Formulas Render Support
+# Math Equations Render Support
math:
- # Default (true) will load mathjax / katex script on demand.
- # That is it only render those page which has `mathjax: true` in Front-matter.
- # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
+ enable: false
+
+ # Default(true) will load mathjax/katex script on demand
+ # That is it only render those page who has 'mathjax: true' in Front-matter.
+ # If you set it to false, it will load mathjax/katex srcipt EVERY PAGE.
per_page: true
- # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
+ engine: mathjax
+ #engine: katex
+
+ # hexo-renderer-pandoc (or hexo-renderer-kramed) needed to full MathJax support.
mathjax:
- enable: true
- # See: https://mhchem.github.io/MathJax-mhchem/
- mhchem: false
+ # For newMathJax CDN (cdnjs.cloudflare.com) with fallback to oldMathJax (cdn.mathjax.org).
+ cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+ # For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com).
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML
- # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
+ # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin)
+ # needed to full Katex support.
katex:
- enable: false
- # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
- copy_tex: false
+ # Use Katex 0.7.1 as default
+ cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css
+ # If you want to try the latest version of Katex, use one below instead
+ #cdn: //cdn.jsdelivr.net/katex/latest/katex.min.css
```
-### `per_page`
+### enable
+
+`true` or `false`, default is `false`.
+
+`true` to turn on render of Math Equations, `false` to turn off it.
+
+### per_page
`true` or `false`, default is `true`.
@@ -243,3 +266,21 @@ title: 'Not Render Math Either'
```
When you set it to `false`, the math will be rendered on **EVERY PAGE**.
+
+### cdn
+
+Both MathJax and Katex provide a config `cdn`, if you don't know what is `cdn`, **do not touch it**.
+
+Firstly, both MathJax and Katex use the [jsDelivr](https://www.jsdelivr.com/) as the default CDN.
+
+The reason that jsDelivr is chosen is because it is fast everywhere, and jsDelivr has the valid ICP license issued by the Chinese government, it can be accessed in China pretty well.
+
+And we also provide other optional CDNs, including the famous [CDNJS](https://cdnjs.com/).
+
+For MathJax, we are currently using version 2.7.1.
+
+For Katex, due to the problem described above, we are now using version 0.7.1.
+
+If you want to try the other CDNs not included in the optional list, you must use the corresponding version.
+
+Particularly, if you are a Chinese blogger or most of your visits come from China, please note that **the CDNJS is blocked in some parts of China**, don't use it as your CDN.
diff --git a/docs/UPDATE-FROM-5.1.X.md b/docs/UPDATE-FROM-5.1.X.md
index 72201a771e..93ae14ec04 100644
--- a/docs/UPDATE-FROM-5.1.X.md
+++ b/docs/UPDATE-FROM-5.1.X.md
@@ -1,29 +1,19 @@
Update from NexT v5.1.x
-NexT version 5 works fine with Hexo 3, but for frequent users, you maybe need to upgrade version 5 to 7 to get features and supports in new [Theme-Next](https://github.com/theme-next/hexo-theme-next) repository.
-
-There are no hard breaking changes between 5.1.x and the latest version. It's change major version to 7 because:
+There are no hard breaking changes between 5.1.x and 6.0.x versions. It's change major version to 6 because:
1. Main repo was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [theme-next](https://github.com/theme-next) organization.
2. Most libraries under the `next/source/lib` directory was moved out to [external repos under NexT organization](https://github.com/theme-next).
-3. 3rd-party plugin [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) was replaced by [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) because `hexo-symbols-count-time` no have any external Node.js dependencies, no have [language filter](https://github.com/willin/hexo-wordcount/issues/7) which causes better performance on speed at site generation.
+3. 3rd-party plugin [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) was replaced by [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) because `hexo-symbols-count-time` no have any external nodejs dependencies, no have [language filter](https://github.com/willin/hexo-wordcount/issues/7) which causes better performance on speed at site generation.
-So, we suggest to update from version 5 to version 7 in this way:
+So, i suggest to update from version 5 to version 6 in this way:
1. You don't touch old `next` dir and just do some copies of NexT files:\
- 1.1. `_config.yml` or `next.yml` (if you used [data-files](DATA-FILES.md)).\
+ 1.1. `config.yml` or `next.yml` (if you used [data-files](DATA-FILES.md)).\
1.2. Custom CSS styles what placed in `next/source/css/_custom/*` and `next/source/css/_variables/*` directories.\
1.3. Custom layout styles what placed in `next/layout/_custom/*`.\
1.4. Any another possible custom additions which can be finded by compare tools between repos.
-2. Clone new repo to any another directory instead of `next`. For example, in `next-reloaded` directory: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. So, you don't touch your old NexT 5.1.x directory and can work with new `next-reloaded` dir.
+2. Clone new v6.x repo to any another directory instead of `next`. For example, in `next-reloaded` directory: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. So, you don't touch your old NexT 5.1.x directory and can work with new `next-reloaded` dir.
3. Go to Hexo main config and set theme parameter: `theme: next-reloaded`. So, your `next-reloaded` directory must loading with your generation. If you may see any bugs or you simply not like this version, you anytime can switch for 5.1.x version back.
-4. Update language configuration (For Chinese)
-
- Since v6.0.3, `zh-Hans` has been renamed to `zh-CN`: https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3
-
- Users upgrading to v6.0.3 and later need to explicitly modify the `language` configuration in the Hexo main config file `_config.yml`, otherwise the language display is incorrect.
-5. Update Hexo and Hexo plugin
-
- If after completing the above steps, an error occurs when executing `hexo s` or` hexo g`, it means that there may be a conflict between the old version of Hexo / Hexo plugin and the new version of the theme NexT. We recommend upgrading Hexo to versions 4.0 and higher and upgrading Hexo plugins to the latest version. You can run `npm outdated` to see all the upgradeable plugins.
And how to enable 3rd-party libraries see [here](https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md#plugins).
diff --git a/docs/ru/DATA-FILES.md b/docs/ru/DATA-FILES.md
index c8c9cc3cfd..a1788d74a3 100644
--- a/docs/ru/DATA-FILES.md
+++ b/docs/ru/DATA-FILES.md
@@ -2,22 +2,24 @@
Обновление темы NexT через пулы проходит не слишком гладко. Часто происходит конфликтная ситуация при обновлении по команде `git pull`, хотя её и можно обойти, если смерджить настройки в файле конфигурации вручную.
-На данный момент, пользователи хранят одни настройки в корневом `_config.yml` (Hexo), а другие настройки в конфиге темы `_config.yml` (NexT). И всё вроде бы ничего, но имеются некоторые недостатки:
+ На данный момент, пользователи хранят одни настройки в корневом `_config.yml` (Hexo), а другие настройки в конфиге темы `_config.yml` (NexT). И всё вроде бы ничего, но имеются некоторые недостатки:
1. Конфигурация разделяется на две части.
2. Пользователи могут запутаться, в каком файле какие должны быть настройки.
-Во избежании проблемы, NexT предлагает два варианта.
+Во избежании проблемы, NexT использует преимущество Hexo [дата-файлов](https://hexo.io/docs/data-files.html). И т.к. дата-файлы были представлены в Hexo 3, необходимо обновиться до Hexo 3.0 (или выше) для использования этой возможности.
+
+Если же Вы предпочитаете Hexo 2.x, то можно использовать старый способ для конфигураций. NexT всё ещё совместим с Hexo 2.x (но возможны ошибки).
Способ 1: Hexo-Путь
-Используя этот способ, вся конфигурация будет раположена в корневом конфиге hexo (`/_config.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`) или создавать какие-либо новые файлы. Но в этом случае необходимо сохранять двойные отступы внутри `theme_config` параметра.
+Используя этот способ, вся конфигурация будет раположена в корневом конфиге hexo (`hexo/_config.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`next/_config.yml`) или создавать какие-либо новые файлы. Но в этом случае необходимо сохранять двойные отступы внутри `theme_config` параметра.
-Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` в редактируемый `/_config.yml` и настроить по своему усмотрению.
+Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` в редактируемый `hexo/_config.yml` и настроить по своему усмотрению.
### Использование
-1. Проверяем на существование `/source/_data/next.yml` файл (удаляем, если существует).
-2. Копируем необходимые опции из конфига темы NexT `/themes/next/_config.yml` в `/_config.yml`, затем\
+1. Проверяем на существование `hexo/source/_data/next.yml` файл (удаляем, если существует).
+2. Копируем необходимые опции из конфига темы NexT `next/_config.yml` в `hexo/_config.yml`, затем\
2.1. Сдвигаем все опции вправо на 2 пробела (в Visual Studio Code: выделяем все строки, CTRL + ]).\
2.2. Добавляем `theme_config:` параметр перед всеми этими настройками.
@@ -28,17 +30,15 @@
Способ 2: NexT-Путь
-Используя этот способ, вся конфигурация будет храниться в одном файле (`/source/_data/next.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`).
+Используя этот способ, вся конфигурация будет храниться в одном файле (`source/_data/next.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`next/_config.yml`).
Но с этим способом могут не корректно обрабатываться все внешние библиотеки hexo при использовании их дополнительных опций (например, опции модуля `hexo-server` могут быть считаны только из стандартного конфига hexo).
-Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `/themes/next/_config.yml` во внешний `_data/next.yml` и настроить по своему усмотрению.
-
-Этот метод опирается на Hexo [дата-файлов](https://hexo.io/docs/data-files.html). И т.к. дата-файлы были представлены в Hexo 3, необходимо обновиться до Hexo 3.0 (или выше) для использования этой возможности.
+Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` во внешний `_data/next.yml` и настроить по своему усмотрению.
### Использование
1. Убеждаемся, что Hexo версии 3 (или выше).
-2. Создаём файл под именем `next.yml` в корневой директории сайта — `/source/_data` (создаём директорию `_data`, если отсутствует).
+2. Создаём файл под именем `next.yml` в корневой директории сайта — `hexo/source/_data` (создаём директорию `_data`, если отсутствует).
И после этих шагов есть 2 варианта, нужно выбрать только 1 из них и продолжить следующие шаги.
@@ -46,14 +46,14 @@
1. Проверяем опцию `override` в стандартном конфиге NexT'а, должно быть установлено в `false`.\
В файле `next.yml` эта опция не должна быть вписана вовсе или вписана и установлена в `false`.
- 2. Копируем настройки из конфига темы NexT (`_config.yml`) и из корневого конфига сайта (`_config.yml`) в файл `/source/_data/next.yml`.
+ 2. Копируем настройки из конфига темы NexT (`_config.yml`) и из корневого конфига сайта (`_config.yml`) в файл `hexo/source/_data/next.yml`.
* **Вариант 2: `override: true`**:
1. В файле `next.yml` ставим опцию `override` в `true`.
- 2. Копируем **все** опции из оригинального конфига NexT'а `/themes/next/_config.yml` в `/source/_data/next.yml`.
+ 2. Копируем **все** опции из оригинального конфига NexT'а `next/_config.yml` в `hexo/source/_data/next.yml`.
-3. Затем, в корневом конфиге сайта `/_config.yml` необходимо установить опцию `theme: next` (и если требуется, `source_dir: source`).
+3. Затем, в корневом конфиге сайта `hexo/_config.yml` необходимо установить опцию `theme: next` (и если требуется, `source_dir: source`).
4. Используем станадартные параметры для запускаь генерации или развёртывания (`hexo clean && hexo g -d && hexo s`).
### Полезные ссылки
diff --git a/docs/ru/INSTALLATION.md b/docs/ru/INSTALLATION.md
index 53845272ba..5cf98afd83 100644
--- a/docs/ru/INSTALLATION.md
+++ b/docs/ru/INSTALLATION.md
@@ -3,16 +3,15 @@
Шаг 1 → Идём в директорию Hexo
Меняем каталог на **корневой hexo**. Там должны находиться `node_modules`, `source`, `themes` и другие папки:
-
-```sh
-$ cd hexo
-$ ls
-_config.yml node_modules package.json public scaffolds source themes
-```
+ ```sh
+ $ cd hexo
+ $ ls
+ _config.yml node_modules package.json public scaffolds source themes
+ ```
Шаг 2 → Скачиваем NexT
-Скачиваем тему с GitHub.
+
Скачиваем тему с GitHub.
Имеются 3 способа как зделать это, нужно выбрать только 1 из них.
### Способ 1: Скачиваем [последнюю версию релиза][releases-latest-url]
diff --git a/docs/ru/README.md b/docs/ru/README.md
index b027dadff9..942dcf684a 100644
--- a/docs/ru/README.md
+++ b/docs/ru/README.md
@@ -1,66 +1,58 @@
-
+
# 
e x T
+«NexT» — элегантная высококачественная тема под Hexo. Сделана с нуля, с любовью.
+
- «NexT» — элегантная высококачественная тема под Hexo. Сделана с нуля, с любовью.
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
## Демо
-
- 💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
-
-
- Больше примеров «NexT» здесь.
-
+* :heart_decoration: Muse тема: [LEAFERx](https://leaferx.online) | [Alex LEE](http://saili.science) | [Miaia](https://11.tt)
+* :six_pointed_star: Mist тема: [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com)
+* :pisces: Pisces тема: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Jiaxi He](http://jiaxi.io)
+* :gemini: Gemini тема: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me)
+
+Больше примеров «NexT» [здесь](https://github.com/iissnan/hexo-theme-next/issues/119).
## Установка
Простейший вариант установки — склонировать весь репозиторий:
-```sh
-$ cd hexo
-$ git clone https://github.com/theme-next/hexo-theme-next themes/next
-```
+ ```sh
+ $ cd hexo
+ $ git clone https://github.com/theme-next/hexo-theme-next themes/next
+ ```
Или предлагаю почитать [детальные инструкции по установке][docs-installation-url], если вариант выше не устраивает.
## Плагины
-В конфиге NexT'а теперь можно найти зависимости на каждый модуль, который был вынесен во внешние репозитории, которые могут быть найдены по [ссылке основной организации][official-plugins-url].
+В конфиге NexT'а теперь можно найти зависимости на каждый модуль, который был вынесен во внешние репозитории, которые могут быть найдены по [ссылке основной организации](https://github.com/theme-next).
-Например, Вы хотите использовать `pjax` для своего сайта. Открываем конфиг NexT'а и находим:
+Например, Вы хотите использовать `fancybox` для своего сайта. Открываем конфиг NexT'а и находим:
```yml
-# Easily enable fast Ajax navigation on your website.
-# Dependencies: https://github.com/theme-next/theme-next-pjax
-pjax: true
+# Fancybox
+# Dependencies: https://github.com/theme-next/theme-next-fancybox
+fancybox: false
```
-Затем включаем параметр `pjax` и переходим по ссылке «Dependencies» с дальнейшеми инструкциями по установке этого модуля.
+Затем включаем параметр `fancybox` и переходим по ссылке «Dependencies» с дальнейшеми инструкциями по установке этого модуля.
## Обновление
-NexT выпускает новые версии каждый месяц. Можно обновить до последней мастер-ветки следующей командой:
+Можно обновить до последней мастер-ветки следующей командой:
```sh
$ cd themes/next
@@ -70,64 +62,78 @@ $ git pull
А если всплывают ошибки во время обновления (что-то наподобии **«Commit your changes or stash them before you can merge»**), рекомендуется ознакомиться с особенностью хранения [дата-файлов в Hexo][docs-data-files-url].\
Как бы то ни было, можно обойти ошибки при обновлении если «Закомитить», «Стэшнуть» или «Откатить» локальные изменения. Смотрим [здесь](https://stackoverflow.com/a/15745424/5861495) как это сделать.
-**Если нужно обновиться с версии v5.1.x на последней версиями, читаем [здесь][docs-update-5-1-x-url].**
+**Если нужно обновиться с версии v5.1.x на v6.0.x, читаем [здесь][docs-update-5-1-x-url].**
+
+## Известные баги
+
+Для тех, кто столкнулся с ошибкой **«[Error: Cannot find module 'hexo-util'](https://github.com/iissnan/hexo-theme-next/issues/1490)»**, следует проверить версию NPM.
+
+* `> 3`: Всё равно не работает? Удалите директорию `node_modules` и переустановите с помощью `npm install`.
+* `< 3`: Добавьте `hexo-util` принудительно командой `npm install --save-dev hexo-util` к основным пакетам с Hexo.
+
+## Содействие
+
+Приветсвуется любое содействие, не стесняйтесь сообщать «Баги», брать «Форки» и вливать «Пулы».
## Обратная связь
-* Посетите [Awesome NexT][awesome-next-url] список.
-* Вступить в наши [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] чаты.
-* [Добавить или улучшить перевод][i18n-url] за несколько секунд.
+* Задать вопрос на [Stack Overflow][stack-url].
* Сообщить об ошибке в разделе [GitHub Issues][issues-bug-url].
* Запросить новую возможность на [GitHub][issues-feat-url].
* Голосовать за [популярные запросы возможностей][feat-req-vote-url].
+* Вступить в наши [Gitter][gitter-url] / [Riot][riot-url] / [Telegram][t-chat-url] чаты.
+* Подписаться на новости через [канал Telegram'а][t-news-url].
-## Содействие
+## Сторонние приложения
-[![][contributors-image]][contributors-url]
-
-Приветсвуется любое содействие, не стесняйтесь сообщать «Баги», брать «Форки» и вливать «Пулы».
+* :triangular_flag_on_post: HexoEditor
## Благодарности
- «NexT» выражает особую благодарность этим замечательным сервисам, которые спонсируют нашу основную инфраструктуру:
-
-
-
-
-
-
+«NexT» выражает особую благодарность этим замечательным сервисам, которые спонсируют нашу основную инфраструктуру:
+
+
+
+ 
+
GitHub позволяет нам хостить Git-репозиторий, Netlify позволяет нам деплоить документацию.
-
-
-
-
+
+
+
+
Crowdin позволяет нам удобно переводить документацию.
-
-
-
-
-
-
- Codacy позволяет нам контролировать качество кода, Travis CI позволяет нам запускать набор тестов.
-[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md
-[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md
-[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/UPDATE-FROM-5.1.X.md
+
+ 
+
+ Codacy позволяет нам запускать набор тестов, BrowserStack позволяет нам тестировать в реальных браузерах.
+
-[t-news-url]: https://t.me/theme_next_news
-[t-chat-url]: https://t.me/theme_next
-[gitter-url]: https://gitter.im/theme-next
-[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
-[i18n-url]: https://i18n.theme-next.org
+[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg
+[browser-url]: https://www.browserstack.com
-[awesome-next-url]: https://github.com/theme-next/awesome-next
+[stack-url]: https://stackoverflow.com/questions/tagged/theme-next
[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md
[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md
-[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22
+[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22+sort%3Areactions-%2B1-desc
-[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md
-[official-plugins-url]: https://github.com/theme-next
-[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890
-[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors
+[gitter-url]: https://gitter.im/theme-next
+[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
+[t-chat-url]: https://t.me/theme_next
+[t-news-url]: https://t.me/theme_next_news
+
+
+
+
+
+[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip
+[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest
+
+[tags-url]: https://github.com/theme-next/hexo-theme-next/tags
+[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master
+
+[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md
+[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md
+[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/UPDATE-FROM-5.1.X.md
diff --git a/docs/ru/UPDATE-FROM-5.1.X.md b/docs/ru/UPDATE-FROM-5.1.X.md
index 9c4019d175..4993026510 100644
--- a/docs/ru/UPDATE-FROM-5.1.X.md
+++ b/docs/ru/UPDATE-FROM-5.1.X.md
@@ -1,18 +1,19 @@
Обновление из-под NexT v5.1.x
-Между версией 5.1.x и последней версиями нет жёстких изменений. Версия сменилась на мажорную 7 по следующим причинам:
+Между версиями 5.1.x и 6.0.x нет жёстких изменений. Версия сменилась на мажорную 6 по следующим причинам:
+
1. Основной репозиторий перебазировался из профиля [iissnan'а](https://github.com/iissnan/hexo-theme-next) в [theme-next](https://github.com/theme-next) организацию.
2. Большинство библиотек в `next/source/lib` директории были вынесены в [отдельные репозитории под организацией NexT](https://github.com/theme-next).
-3. 3rd-party плагин [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) был заменён на [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) т.к. `hexo-symbols-count-time` не имеет никаких сторонних Node.js зависимостей, не имеет [языкового фильтра](https://github.com/willin/hexo-wordcount/issues/7) что обеспечивает улучшенную производительность при генерации сайта.
+3. 3rd-party плагин [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) был заменён на [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) т.к. `hexo-symbols-count-time` не имеет никаких сторонних nodejs зависимостей, не имеет [языкового фильтра](https://github.com/willin/hexo-wordcount/issues/7) что обеспечивает улучшенную производительность при генерации сайта.
-Поэтому, я предлагаю обновиться с версии 5 на версию 7 следующим способом:
+Поэтому, я предлагаю обновиться с версии 5 на версию 6 следующим способом:
1. Вы не трогаете старую директорию `next`, а всего-лишь делаете резервные копии файлов NexT:\
1.1. `config.yml` или `next.yml` (если Вы использовали [дата-файлы](DATA-FILES.md)).\
1.2. Пользовательских CSS-стилей, которые расположены в `next/source/css/_custom/*` и `next/source/css/_variables/*` директориях.\
1.3. Пользовательских layout-стилей, которые расположены в `next/layout/_custom/*`.\
1.4. Любые другие всевозможные пользовательские изменения, которые могут быть найдены любым инструментом для сравнения файлов.
-2. Склонировать новый репозиторий в любую другую директорию, отличную от `next`. Например, в директорию `next-reloaded`: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. Итак, нет необходимости трогать старую NexT 5.1.x директорию и можно работать с новой `next-reloaded`.
+2. Склонировать новый v6.x репозиторий в любую другую директорию, отличную от `next`. Например, в директорию `next-reloaded`: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. Итак, нет необходимости трогать старую NexT 5.1.x директорию и можно работать с новой `next-reloaded`.
3. Открываем главную Hexo-конфигурацию и устанавливаем параметр темы: `theme: next-reloaded`. Так Ваша директория `next-reloaded` должна грузиться при генерации. Если Вы будете наблюдать какие-либо баги или Вам попросту не нравится эта новая версия, в любой момент Вы можете использовать старую 5.1.x.
А как активировать 3rd-party библиотеки, смотрим здесь [здесь](https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md#%D0%9F%D0%BB%D0%B0%D0%B3%D0%B8%D0%BD%D1%8B).
diff --git a/docs/zh-CN/ALGOLIA-SEARCH.md b/docs/zh-CN/ALGOLIA-SEARCH.md
index 660584af33..8aab587cab 100644
--- a/docs/zh-CN/ALGOLIA-SEARCH.md
+++ b/docs/zh-CN/ALGOLIA-SEARCH.md
@@ -4,44 +4,63 @@ NexT 内部提供 Algolia 的搜索功能,要使用此功能请确保所使用
1. 前往 [Algolia 注册页面](https://www.algolia.com/),注册一个新账户。 可以使用 GitHub 或者 Google 账户直接登录,注册后的 14 天内拥有所有功能(包括收费类别的)。之后若未续费会自动降级为免费账户,免费账户 总共有 10,000 条记录,每月有 100,000 的可以操作数。注册完成后,创建一个新的 Index,这个 Index 将在后面使用。
- 
+ 
-1. 在 `API Keys` 页面找到需要使用的一些配置的值,包括 `Application ID` 和 `Search-Only API Key`。注意,`Admin API Key` 需要保密保存,不要外泄。
+1. Index 创建完成后,此时这个 Index 里未包含任何数据。接下来需要安装 [Hexo Algolia](https://github.com/oncletom/hexo-algolia) 扩展,这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录,执行命令安装:
- 
+ ```
+ $ cd hexo
+ $ npm install --save hexo-algolia
+ ```
+
+1. 在 `API Keys` 页面找到需要使用的一些配置的值,包括 `ApplicationID` 和 `Search-Only API Key`。注意,`Admin API Key` 需要保密保存,不要外泄。
+
+ 
+
+1. 在 `API Keys` 页面,点击 `ALL API KEYS` 找到新建 INDEX 对应的 key,**编辑权限**,在弹出框中找到 ACL ,**勾选 Add records、 Delete records、List indices、Delete index 权限**,点击 `update` 更新。
+
+ 
+ 
1. 编辑 `站点配置文件`,新增以下配置,除了 `chunkSize` 字段,替换成在 Algolia 获取到的值:
```yml
algolia:
- applicationID: 'Application ID'
- apiKey: 'Search-Only API Key'
+ applicationID: 'applicationID'
+ apiKey: 'apiKey'
indexName: 'indexName'
chunkSize: 5000
```
-1. 在 `API Keys` 页面,点击 `All API Keys` 切换到对应的页面中。接着点击 `New API Key` 按钮,来**编辑权限**。在弹出框中找到 ACL ,**输入 addObject、 deleteObject、listIndexes、deleteIndex 权限**,然后点击最下方的 `Create` 按钮。将这个新创建的 API Key 复制到剪贴板,我们称之为 `High-privilege API key`。
-
- 
- 
-
-1. 在 Index 和 API Key 创建完成后,此时这个 Index 里未包含任何数据。接下来需要安装 [Hexo Algolia](https://github.com/oncletom/hexo-algolia) 扩展,这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录,执行命令安装:
+1. 当配置完成,在站点根目录下执行一下命令来更新上传 Index。请注意观察命令的输出。
```
- $ cd hexo
- $ npm install hexo-algolia
+ $ export HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Git Bash
+ # set HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Windows CMD 命令行
+ $ hexo clean
+ $ hexo algolia
```
-1. 当配置完成,在站点根目录下执行以下命令来更新上传 Index。请注意观察命令的输出。
+ 
+
+1. 切换到 NexT 目录,并安装 algolia-instant-search 到 `source/lib` 目录。
```
- $ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Git Bash
- # set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Windows CMD 命令行
- $ hexo clean
- $ hexo algolia
+ $ cd themes/next
+ $ git clone https://github.com/theme-next/theme-next-algolia-instant-search source/lib/algolia-instant-search
```
- 
+ 如果你想直接使用 CDN 设置 Algolia Search,则需要在`主题配置文件`中添加 vendors 字段:
+
+ ```yml
+ vendors:
+ ...
+ # Internal version: 1
+ # https://www.algolia.com
+ algolia_instant_js: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.js
+ algolia_instant_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.min.css
+ ...
+ ```
1. 更改`主题配置文件`,找到 Algolia Search 配置部分,将 `enable` 改为 `true`。同时你需要**关闭**其他搜索插件,如 Local Search 等。你也可以根据需要调整 `labels` 中的文本:
@@ -57,21 +76,6 @@ NexT 内部提供 Algolia 的搜索功能,要使用此功能请确保所使用
hits_stats: "${hits} results found in ${time} ms"
```
-1. 如果你需要通过 CDN 使用其它版本的 algolia-instant-search ,请根据以下步骤操作。
-
- 你需要在`主题配置文件`中的 vendors 字段进行设置:
-
- ```yml
- vendors:
- ...
- # Algolia Search
- # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
- # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
- algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
- instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
- ...
- ```
-
已知的问题
1. 考虑到 Algolia 免费账户的限制,目前 [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) 插件最新版本去掉了正文索引功能。
diff --git a/docs/zh-CN/CODE_OF_CONDUCT.md b/docs/zh-CN/CODE_OF_CONDUCT.md
index 5c6fd2c394..ecc7376490 100644
--- a/docs/zh-CN/CODE_OF_CONDUCT.md
+++ b/docs/zh-CN/CODE_OF_CONDUCT.md
@@ -1,9 +1,6 @@
-
+
# 
e x T
@@ -13,24 +10,27 @@
## 目录
-- [我们的保证](#我们的保证)
-- [我们的责任](#我们的责任)
-- [我们的标准](#我们的标准)
-- [使用范围](#使用范围)
-- [强制执行](#强制执行)
-- [联系项目维护者](#联系项目维护者)
-- [来源](#来源)
+- [我们的保证](#our-pledge)
+- [我们的责任](#our-responsibilities)
+- [我们的标准](#our-standards)
+- [使用范围](#scope)
+- [强制执行](#enforcement)
+- [联系项目维护者](#contacting-maintainers)
+- [来源](#attribution)
+
## 我们的保证
作为此项目的贡献者和维护者,我们承诺尊重所有做出贡献的用户,这些贡献包括了报告问题、发布功能请求、更新文档、提交合并请求以及其他活动。
为了促进一个开放透明且友好的环境,我们作为贡献者和维护者保证:无论年龄、种族、民族、性别认同和表达(方式)、体型、身体健全与否、经验水平、国籍、个人表现、宗教或性别取向,参与者在我们项目和社区中都免于骚扰。
+
## 我们的责任
项目维护者有责任为「可接受的行为」标准做出诠释,有权利及责任去删除、编辑、拒绝与本行为标准有所违背的评论(comments)、提交(commits)、代码、wiki 编辑、问题(issues)和其他贡献,以及项目维护者可暂时或永久性的禁止任何他们认为有不适当、威胁、冒犯、有害行为的贡献者。
+
## 我们的标准
作为 GitHub 上的一个项目,本项目受到 [GitHub 社区准则](https://help.github.com/articles/github-community-guidelines/)的约束。 此外,作为 npm 托管的项目,[npm 公司的行为准则](https://www.npmjs.com/policies/conduct)也涵盖了本项目。
@@ -51,18 +51,20 @@
* 未经许可地发布他人的个人资料,例如住址或是电子地址
* 其他可以被合理地认定为不恰当或者违反职业操守的行为
+
## 使用范围
当一个人代表该项目或是其社区时,本行为标准适用于其项目社区和公共社区。
根据某人在本社区范围以外发生的违规情况,项目维护者可以认为其不受欢迎,并采取适当措施来保证所有成员的安全性和舒适性。
+
## 强制执行
如果您看到违反行为准则的行为,请按以下步骤操作:
1. 让这个人知道他所做的并不合适,并要求他停止或编辑他们的提交信息。该人应立即停止行为并纠正问题。
-2. 如果该人没有纠正其行为,或者您不方便与其沟通,请[联系项目维护者](#联系项目维护者)。上报时,请尽可能多的提供详细信息,链接,截图,上下文或可用于更好地理解和解决情况的其他信息。
+2. 如果该人没有纠正其行为,或者您不方便与其沟通,请[联系项目维护者](#contacting-maintainers)。上报时,请尽可能多的提供详细信息,链接,截图,上下文或可用于更好地理解和解决情况的其他信息。
3. 收到上报信息后,项目维护者会查看问题,并采取进一步的措施。
一旦项目维护者参与其中,他们将遵循以下一系列步骤,并尽力保护项目成员的利益。任何维护团队认为有必要且适合的所有投诉都将进行审查及调查,并做出相对应的回应。项目小组有对事件回报者有保密的义务。具体执行的方针近一步细节可能会单独公布。
@@ -78,6 +80,7 @@
没有切实地遵守或是执行本行为标准的项目维护人员,可能会因项目领导人或是其他成员的决定,暂时或是永久地取消其参与资格。
+
## 联系项目维护者
您可以通过以下任何方法与维护人员联系
@@ -90,6 +93,7 @@
* [Riot](https://riot.im/app/#/room/#NexT:matrix.org)
* [Telegram](https://t.me/joinchat/GUNHXA-vZkgSMuimL1VmMw)
+
## 来源
本行为标准改编自[Contributor Covenant](https://www.contributor-covenant.org/) 和 [WeAllJS Code of Conduct](https://wealljs.org/code-of-conduct)。
diff --git a/docs/zh-CN/CONTRIBUTING.md b/docs/zh-CN/CONTRIBUTING.md
index adaf572e5e..40a2b72589 100644
--- a/docs/zh-CN/CONTRIBUTING.md
+++ b/docs/zh-CN/CONTRIBUTING.md
@@ -1,9 +1,6 @@
-
+
# 
e x T
@@ -11,52 +8,41 @@
## 目录
-[如何为 NexT 做贡献](#如何为-next-做贡献)
+[如何为 NexT 做贡献](#how-can-i-contribute)
- * [你需要了解的](#你需要了解的)
- * [阅读文档](#阅读文档)
- * [快速调试指南](#快速调试指南)
- * [反馈 Bug](#反馈-bug)
- * [提交漏洞](#提交漏洞)
- * [提交功能需求](#提交功能需求)
- * [提交合并请求](#提交合并请求)
- * [发布版本](#发布版本)
+ * [你需要了解的](#before-submitting-an-issue)
+ * [反馈 Bug](#reporting-bugs)
+ * [提交漏洞](#reporting-security-bugs)
+ * [提交功能需求](#suggesting-enhancements)
+ * [提交合并请求](#submitting-a-pull-request)
+ * [发布版本](#creating-releases)
-[规范](#规范)
+[规范](#guides)
- * [行为规范](#行为规范)
- * [编码规范](#编码规范)
- * [标签规范](#标签规范)
- * [提交信息规范](#提交信息规范)
+ * [行为规范](#coding-rules)
+ * [编码规范](#coding-standards)
+ * [标签规范](#labels-rules)
+ * [提交信息规范](#commit-messages-rules)
-## 如何为 NexT 做贡献
-
-### 你需要了解的
+
-#### 阅读文档
-
-如果你在使用过程中遇到了问题,你可以查阅 [FAQs](https://theme-next.org/docs/faqs) 或者 [NexT 帮助文档](https://theme-next.org/docs/troubleshooting)。
+## 如何为 NexT 做贡献
-另外,你也可以通过 [这里](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) 进行大致检索,有些问题已经得到解答,你可以自行解决。对于没有解决的 Issue,你也可以继续提问。
+目前 NexT 主题已经从 [iissnan](https://github.com/iissnan/hexo-theme-next) 的个人仓库移动到了 [Theme-Next](https://github.com/theme-next) 组织仓库中,并升级到 V6 版本。在 V6+ 版本中,`next/source/lib` 目录下的第三方依赖库将独立放置在 [Theme-Next](https://github.com/theme-next) 组织仓库中。在大多数情况下,NexT V5 版本仍然能够正常运行,但是如果你想获得更多的功能和帮助,还是建议您 [升级到 NexT V6+ 版本](https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md),并移步 [Theme-Next](https://github.com/theme-next/hexo-theme-next) 仓库。
-#### 快速调试指南
+
-在 GitHub 上提交 Issue 前,请先通过以下方法 debug:
+### 你需要了解的
-* 执行`hexo clean`,清除浏览器缓存,并禁用 CDN 服务(例如 Cloudflare Rocket Loader);
-* 切换到其它主题并检查 bug 是否仍然存在(例如使用默认主题 landscape)。换言之,证明这是 NexT 主题而非来自 Hexo 的 bug;
-* 将 NexT 主题升级到最新版;
-* 将 Hexo 和 Hexo 插件升级到最新版;
-* 将 Node.js 和 `npm` 升级到最新版;
-* 卸载不必要的 Hexo 插件,或重新通过 `npm install --save` 安装插件。
+如果你在使用过程中遇到了问题,你可以查阅 FAQs(建设中) 或者 [NexT 帮助文档](https://theme-next.org/docs/)(建设中)。另外,你也可以通过 [这里](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) 进行大致检索,有些问题已经得到解答,你可以自行解决。对于没有解决的 Issue,你也可以继续提问。
-如果你得到了来自 Hexo 或浏览器控制台的报错信息,请在 Google / Stackoverflow / GitHub Issue 中搜寻,或在提交 Issue 时报告给我们。
+如果你在使用过程中发现了 Bug,请再次确认 Bug 在 [最新发布版本](https://github.com/theme-next/hexo-theme-next/releases/latest) 中是否重现。如果 Bug 重现,欢迎你到我们的 [主题仓库](https://github.com/theme-next/hexo-theme-next) 中 [反馈 Bug ](#reporting-bugs) 或者 [提交功能需求](#suggesting-enhancements),也更期待您 [提交合并请求](#submitting-a-pull-request)。
-如果你在使用过程中发现了 Bug,请再次确认 Bug 在 [最新发布版本](https://github.com/theme-next/hexo-theme-next/releases/latest) 中是否重现。如果 Bug 重现,欢迎你到我们的 [主题仓库](https://github.com/theme-next/hexo-theme-next) 中 [反馈 Bug](#reporting-bugs) 或者 [提交功能需求](#提交功能需求),也更期待您 [提交合并请求](#提交合并请求)。
+
### 反馈 Bug
-反馈 Bug 前,请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。
+反馈 Bug 前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。
请认真遵守如下指南,这样我们才能更好地理解问题,重现问题和解决问题。
@@ -72,15 +58,19 @@
* 详细描述通过上述重现过程出现的问题。
* 详细描述你期待的结果。
+
+
#### 提交漏洞
如果你发现安全问题,请以负责任的方式行事,即不要在公共 Issue 中提交而是直接向我们反馈,这样我们就可以在漏洞被利用之前对其进行修复。请将相关信息发送到 security@theme-next.com(可接受 PGP 加密邮件)。
我们很乐意对任何提交漏洞的人予以特别感谢以便我们修复它。如果你想保持匿名性或使用笔名替代,请告诉我们。我们将充分尊重你的意愿。
+
+
### 提交功能需求
-提交功能需求前,请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。
+提交功能需求前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。
请认真遵守如下指南,这样我们才能更好地理解和开发功能需求:pencil::
@@ -88,17 +78,39 @@
* 详细描述目前所具有的功能和你所期待的功能,并解释为什么需要该功能。
* 提供功能需求的样例,如图像文件、在线演示网址等等。
+
+
### 提交合并请求
-提交合并请求前,请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容,避免提交重复的合并请求。确定相关仓库后,创建合并请求。更多详细操作过程可以查看 [帮助文档](https://help.github.com/articles/creating-a-pull-request/)。
+提交合并请求前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的合并请求。确定相关仓库后,创建合并请求。更多详细操作过程可以查看 [帮助文档](https://help.github.com/articles/creating-a-pull-request/)。
+
+1. 进入 [hexo-theme-next](https://github.com/theme-next/hexo-theme-next) 主页面,点击`Fork`。
+2. 进入到已经`Fork`的个人仓库(`https://github.com/username/hexo-theme-next`),点击 **Clone or download** 并复制该仓库地址。选择本地文件夹,并打开 Git Bash ,输入如下命令并回车,即可完成仓库克隆。
+ ```bash
+ $ git clone git@github.com:username/hexo-theme-next.git
+ ```
+3. 进入 `hexo-theme-next` 本地文件夹,并创建分支。
+ ```bash
+ $ cd hexo-theme-next
+ $ git checkout -b patchname
+ ```
+4. 本地修改并测试,推送分支。
+ ```bash
+ $ git add .
+ $ git commit -m "add commit messamge"
+ $ git push origin patchname
+ ```
+5. 进入 `fork` 后的仓库,切换到新提交的 `patchname` 分支,点击 `patchname` 分支右侧的 **New pull request** 。在 PR 对比页面,正确选择你需要发起合并请求的分支,然后点击 **Create pull request** ,建立一个新的合并申请并描述变动。
请认真遵守如下指南,这样我们才能更好地理解你的合并请求:
-* 创建合并请求时,请遵守 [编码规范](#编码规范) 和 [提交信息规范](#提交信息规范)。
+* 创建合并请求时,请遵守 [编码规范](#coding-rules) 和 [提交信息规范](#commit-messages-rules)。
* 在标题中清晰准确地描述你的合并请求,不要加入 Issue 编号。
* 按照 [模板](../../.github/PULL_REQUEST_TEMPLATE.md) 尽可能的详细填写相关信息。
* 合并请求需要在所有主题样式中测试通过,并提供所表现功能的样例,如图像文件、在线演示网址等等。
+
+
### 发布版本
版本发布是将项目发布给用户的一种很好的方式。
@@ -114,15 +126,23 @@
5. 如果您希望随版本一起发布二进制文件(如编译的程序),请在上传二进制文件对话框中手动拖放或选择文件。
6. 如果版本不稳定,请选择 **This is a pre-release**,以通知用户它尚未完全准备好。如果您准备公布您的版本,请点击 **Publish release**。否则,请单击 **Save draft** 以稍后处理。
+
+
## 规范
+
+
### 行为规范
为了保证本项目的顺利运作,所有参与人都需要遵守 [行为规范](CODE_OF_CONDUCT.md)。
+
+
### 编码规范
-我们使用 ESLint 和 Stylint 来识别和报告 JavaScript 和 Stylus 中的模式,目的是使代码更加一致并避免错误。编码时应遵循这些规范。
+未完待续。
+
+
### 标签规范
@@ -130,51 +150,61 @@
如果您不确定某个标签的含义,或者不知道将哪些标签应用于 PR 或 issue,千万别错过这个。
-Issue 的标签:
+Issues 的标签:使用`类型`+`内容`+`结果`的组合
- 类型
+ - `Irrelevant`: 与 NexT 主题无关的 Issue
+ - `Duplicate`: 重复提及的 Issue
- `Bug`: 检测到需要进行确认的 Bug
+ - `Improvement Need`: 需要改进的 Issue
- `Feature Request`: 提出了新功能请求的 Issue
+ - `High Priority`: 检测到具有高优先级的 Bug 或笔误的 Issue
+ - `Low Priority`: 检测到具有低优先级的 Bug 或笔误的 Issue
+ - `Non English`: 需要多语言维护者参与的 Issue
+ - `Discussion`: 需要进行讨论的 Issue
- `Question`: 提出疑问的 Issue
+ - `Backlog`: 待解决的 Issue
- `Meta`: 表明使用条款变更的 Issue
- - `Support`: 被标记为支持请求的 Issue
- - `Polls`: 发起投票的 Issue
+- 内容
+ - `Roadmap`: 与 NexT 主题发展相关的 Issue
+ - `Hexo`: 与 Hexo 相关的 Issue
+ - `Scheme [1] - Mist`: 与 Mist 主题相关的 Issue
+ - `Scheme [2] - Muse`: 与 Muse 主题相关的 Issue
+ - `Scheme [3] - Pisces`: 与 Pisces 主题相关的 Issue
+ - `Scheme [4] - Gemini`: 与 Gemini 主题相关的 Issue
+ - `3rd Party Service`: 与第三方服务相关的 Issue
+ - `Docs`: 需要添加文档说明的 Issue
+ - `Configurations`: 与 NexT 主题设置相关的 Issue
+ - `CSS`: 与 NexT 主题 CSS 文件相关的 Issue
+ - `Custom`: 与 NexT 主题个性化相关的 Issue
- 结果
- - `Duplicate`: 重复提及的 Issue
- - `Irrelevant`: 与 NexT 主题无关的 Issue
- - `Invalid`: 无法复现的 Issue
- - `Expected Behavior`: 与预期行为相符的 Issue
+ - `Wontfix`: 不能或不被修复的 Issue
- `Need More Info`: 需要更多信息的 Issue
+ - `Need Verify`: 需要开发人员或用户确认 Bug 或解决方法的 Issue
+ - `Can't Reproduce`: 无法复现的 Issue
- `Verified`: 已经被确认的 Issue
+ - `Help Wanted`: 需要帮助的 Issue
+ - `Wait for Answer`: 需要开发人员或用户回复的 Issue
+ - `Resolved Maybe`: 可能已经解决的 Issue
- `Solved`: 已经解决的 Issue
- - `Backlog`: 待解决的 Issue
- `Stale`: 由于长期无人回应被封存的 Issue
-Pull Request 的标签:
-
-- `Breaking Change`: 产生重大变动的 Pull Request
-- `Bug Fix`: 修复相关 Bug 的 Pull Request
-- `New Feature`: 添加了新功能的 Pull Request
-- `Feature`: 为现有功能提供选项或加成的 Pull Request
-- `i18n`: 更新了翻译的 Pull Request
-- `Work in Progress`: 仍在进行改动和完善的 Pull Request
-- `Skip Release`: 无需在 Release Note 中展现的 Pull Request
-
-两者兼有:
-
-- `Roadmap`: 与 NexT 主题发展相关的 Issue 或者 Pull Request
-- `Help Wanted`: 需要帮助的 Issue 或者 Pull Request
-- `Discussion`: 需要进行讨论的 Issue 或者 Pull Request
-- `Improvement`: 需要改进的 Issue 或者改进了 NexT 主题的 Pull Request
-- `Performance`: 提出性能问题的 Issue 或者提高了 NexT 主题性能的 Pull Request
-- `Hexo`: 与 Hexo 和 Hexo 插件相关的 Issue 或者 Pull Request
-- `Template Engine`: 与模版引擎相关的 Issue 或者 Pull Request
-- `CSS`: 与 NexT 主题 CSS 文件相关的 Issue 或者 Pull Request
-- `Fonts`: 与 NexT 主题字体相关的 Issue 或者 Pull Request
-- `PJAX`: 与 PJAX 相关的 Issue 或者 Pull Request
-- `3rd Party Plugin`: 与第三方插件和服务相关的 Issue 或者 Pull Request
-- `Docs`: 与文档说明相关的 Issue 或者 Pull Request
-- `Configurations`: 与 NexT 主题设置相关的 Issue 或者 Pull Request
+Pull requests 的标签:
+
+- `Breaking Change`: 产生重大变动的 Pull request
+- `External Change`: 针对外部变动进行更新的 Pull request
+- `Bug Fix`: 修复相关 Bug 的 Pull request
+- `Docs`: 添加了文档说明的 Pull request
+- `New Feature`: 添加了新功能的 Pull request
+- `Feature`: 为现有功能提供选项或加成的 Pull request
+- `Improvement`: 改进了 NexT 主题的 Pull request
+- `i18n`: 更新了翻译的 Pull request
+- `Performance`: 提高了 NexT 主题性能的 Pull request
+- `Discussion`: 需要进行讨论的 Pull request
+- `v6.x`: 与 NexT v6.x 旧版相关的用于修复和改进的 Pull request
+- `v7.x`: 与 NexT v7.x 旧版相关的用于修复和改进的 Pull request
+
+
### 提交信息规范
diff --git a/docs/zh-CN/DATA-FILES.md b/docs/zh-CN/DATA-FILES.md
index 0194f0b386..624931bb61 100644
--- a/docs/zh-CN/DATA-FILES.md
+++ b/docs/zh-CN/DATA-FILES.md
@@ -2,22 +2,24 @@
目前,通过 pull 或下载新的 release 版本来更新 NexT 主题的体验并不平滑。当用户使用 `git pull` 更新 NexT 主题时经常需要解决冲突问题,而在手动下载 release 版本时也经常需要手动合并配置。
-现在来说,NexT 推荐用户存储部分配置在 Hexo 站点配置文件(`/_config.yml`),而另一部分在主题配置文件(`/themes/next/_config.yml`)。这一方式固然可用,但也有一些缺点:
+现在来说,NexT 推荐用户存储部分配置在站点的 `_config.yml` 中,而另一部分在主题的 `_config.yml` 中。这一方式固然可用,但也有一些缺点:
1. 配置项被分裂为两部分;
2. 用户难以弄清何处存放配置选项。
-为了解决这一问题,NexT 提供了以下两种方案。
+为了解决这一问题,NexT 将利用 Hexo 的[数据文件](https://hexo.io/docs/data-files.html)特性。因为数据文件是在 Hexo 3 中被引入,所以你需要更新至 Hexo 3.0 以后的版本来使用这一特性。
+
+如果你仍然希望使用 Hexo 2.x,你依旧可以按老的方式进行配置。NexT 仍然兼容 Hexo 2.x(但可能会出现错误)。
选择 1:Hexo 方式
-使用这一方式,你的全部配置都将置于 Hexo 站点配置文件(`/_config.yml`),并且不需要修改 `/themes/next/_config.yml`,或者创建什么其他的文件。但是所有用到的主题选项必须放置在 `theme_config` 后,并全部增加两个空格的缩进。
+使用这一方式,你的全部配置都将置于 hexo 主要配置文件中(`hexo/_config.yml`),并且不需要修改 `next/_config.yml`,或者创建什么其他的文件。但是所有的主题选项必须放置在 `theme_config` 后,并全部增加两个空格的缩进。
-如果在新的 release 中新增了选项,那么你只需要从 `/themes/next/_config.yml` 中将他们复制到 `/_config.yml` 中并将它们的值设置为你想要的。
+如果在新的 release 中出现了任何新的选项,那么你只需要从 `next/_config.yml` 中将他们复制到 `hexo/_config.yml` 中并设置它们的值为你想要的选项。
### 用法
-1. 请确认不存在 `/source/_data/next.yml` 文件(如果已存在,请删除)
-2. 从主题的 `/themes/next/_config.yml` 文件中复制你需要的 NexT 配置项到 `/_config.yml` 中,然后\
+1. 请确认不存在 `hexo/source/_data/next.yml` 文件(如果已存在,请删除)
+2. 从主题的 `next/_config.yml` 文件中复制你需要的 NexT 配置项到 `hexo/_config.yml` 中,然后\
2.1. 所有这些配置项右移两个空格(在 Visual Studio Code 中:选中这些文字,CTRL + ])。\
2.2. 在这些参数最上方添加一行 `theme_config:`。
@@ -28,17 +30,15 @@
选择 2: NexT 方式
-使用这一方式,你现在可以将你的全部配置置于同一位置(`/source/_data/next.yml`),并且不需要修改 `/themes/next/_config.yml`。
+使用这一方式,你现在可以将你的全部配置置于同一位置(`source/_data/next.yml`),并且不需要修改 `next/_config.yml`。
但是可能无法让所有 Hexo 外部库都准确处理它们的附加选项(举个例子,`hexo-server` 模块只会从 Hexo 默认配置文件中读取选项)。
-如果在新的 release 中出现了任何新的选项,那么你只需要从 `/themes/next/_config.yml` 中将他们复制到 `/source/_data/next.yml` 中并设置它们的值为你想要的选项。
-
-这一方法依赖于 Hexo 的[数据文件](https://hexo.io/docs/data-files.html)特性。因为数据文件是在 Hexo 3 中被引入,所以你需要更新至 Hexo 3.0 以后的版本来使用这一特性。
+如果在新的 release 中出现了任何新的选项,那么你只需要从 `next/_config.yml` 中将他们复制到 `source/_data/next.yml` 中并设置它们的值为你想要的选项。
### 用法
1. 请确认你的 Hexo 版本为 3.0 或更高。
-2. 在你站点的 `/source/_data` 目录创建一个 `next.yml` 文件(如果 `_data` 目录不存在,请创建之)。
+2. 在你站点的 `hexo/source/_data` 目录创建一个 `next.yml` 文件(如果 `_data` 目录不存在,请创建之)。
以上步骤之后有 两种选择,请任选其一然后继续后面的步骤。
@@ -46,14 +46,14 @@
1. 检查默认 NexT 配置中的 `override` 选项,必须设置为 `false`。\
在 `next.yml` 文件中,也要设置为 `false`,或者不定义此选项。
- 2. 从站点配置文件(`/_config.yml`)与主题配置文件(`/themes/next/_config.yml`)中复制你需要的选项到 `/source/_data/next.yml` 中。
+ 2. 从站点的 `_config.yml` 与主题的 `_config.yml` 中复制你需要的选项到 `hexo/source/_data/next.yml` 中。
* **选择 2:`override: true`**:
1. 在 `next.yml` 中设置 `override` 选项为 `true`。
- 2. 从 `/themes/next/_config.yml` 配置文件中复制**所有**的 NexT 主题选项到 `/source/_data/next.yml` 中。
+ 2. 从 `next/_config.yml` 配置文件中复制**所有**的 NexT 主题选项到 `hexo/source/_data/next.yml` 中。
-3. 然后,在站点的 `/_config.yml` 中需要定义 `theme: next` 选项(如果需要的话,`source_dir: source`)。
+3. 然后,在站点的 `hexo/_config.yml`中需要定义 `theme: next` 选项(如果需要的话,`source_dir: source`)。
4. 使用标准参数来启动服务器,生成或部署(`hexo clean && hexo g -d && hexo s`)。
### 相关链接
diff --git a/docs/zh-CN/INSTALLATION.md b/docs/zh-CN/INSTALLATION.md
index adecb987ad..7ea4b88085 100644
--- a/docs/zh-CN/INSTALLATION.md
+++ b/docs/zh-CN/INSTALLATION.md
@@ -2,17 +2,16 @@
步骤 1 → 进入 Hexo 目录
-进入 **Hexo 根**目录。这一目录中应当有 `node_modules`、`source`、`themes` 等若干子目录:
-
-```sh
-$ cd hexo
-$ ls
-_config.yml node_modules package.json public scaffolds source themes
-```
+进入 **hexo 根**目录。这一目录中应当有 `node_modules`、`source`、`themes` 等若干子目录:
+ ```sh
+ $ cd hexo
+ $ ls
+ _config.yml node_modules package.json public scaffolds source themes
+ ```
步骤 2 → 获取 NexT
-从 GitHub 下载主题。
+
从 GitHub 下载主题。
为了下载这一主题,共有 3 种选项可选。你需要选择其中唯一一个方式。
### 选项 1:下载[最新 release 版本][releases-latest-url]
@@ -101,7 +100,7 @@ _config.yml node_modules package.json public scaffolds source themes
步骤 3 → 完成配置
-在 **Hexo 站点配置文件**(`/_config.yml`)中设置你的主题:
+在 **hexo 根配置**文件 `_config.yml` 中设置你的主题:
```yml
theme: next
diff --git a/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md b/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md
index c955c0d9fb..39fee3462f 100644
--- a/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md
+++ b/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md
@@ -1,82 +1,74 @@
-修复 LeanCloud 统计插件安全漏洞
-
-在配置前,请升级 NexT 至 **v6.0.6** 以上。
+在配置前,请升级NexT至**v6.0.6**以上。
在配置过程中请注意**博客配置文件**和**主题配置文件**的区别。
---
-# 注册 LeanCloud 并创建应用
-- 首先,前往 LeanCloud 官网 [leancloud.cn](https://leancloud.cn) 进行注册,并登录。
-
- 请注意,目前华东节点和华北节点创建应用需要先在账号设置完成实名认证,并且官方表明“[在国内市场将只服务于可验证的商业客户](https://leancloudblog.com/domain-incident/)”;美国节点暂无上述要求,并且账号系统与华东节点和华北节点是独立的,如需使用请前往 LeanCloud 国际版官网 [leancloud.app](https://leancloud.app) 注册登录。
-
-- 然后点击图示 `1` 处,进入控制台:
+# 注册Leancloud并创建应用
+- 首先,前往Leancloud官网[leancloud.cn](leancloud.cn)进行注册,并登陆。
+- 然后点击图示`1`处,进入控制台:

-- 接着,点击图示 `1` 处,创建应用:
+- 接着,点击图示`1`处,创建应用:

-- 在弹出窗口 `1` 处输入应用名称(可随意输入,可更改,为演示方便取名为test),并选择 `2` 处“开发版”,然后点击 `3` 处创建:
+- 在弹出窗口`1`处输入应用名称(可随意输入,可更改,为演示方便取名为test),并选择`2`处“开发版”,然后点击`3`处创建:

到这里应用创建完成。
-# 建立 Counter 类并在 NexT 中启用插件
-- 点击 `1` 处应用名称进入应用管理界面:
+# 建立Counter类并在NexT中启用插件
+- 点击`1`处应用名称进入应用管理界面:

-- 如图,点击侧边栏 `1` 处创建 Class:
+- 如图,点击侧边栏`1`处创建Class:

-- 在弹出窗口 `1` 处填入 `Counter`,勾选 `2` 处无限制,并点击 `3` 处创建 Class:
+- 在弹出窗口`1`处填入`Counter`,勾选`2`处无限制,并点击`3`处创建Class:

-- 此时类已创建完成。接下来点击图示 `1` 处进入设置,然后点击 `2` 处进入应用 Key:
+- 此时类已创建完成。接下来点击图示`1`处进入设置,然后点击`2`处进入应用Key:

-- 粘贴 `App ID` 和 `App Key` 到 **NexT主题配置文件** `_config.yml` 对应位置。此时配置文件应如下:
- ```yml
- leancloud_visitors:
- enable: true
- app_id: #
- app_key: #
- # Required for apps from CN region
- server_url: #
- # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
- security: true
- ```
+- 粘贴`App ID`和`App Key`到**NexT主题配置文件**`_config.yml`对应位置。此时配置文件应如下:
+```yml
+leancloud_visitors:
+ enable: true
+ security: true
+ app_id: <>
+ app_key: <>
+```
-- 设置Web安全域名确保域名调用安全。点击 `1` 处进入安全中心,然后在 `2` 处填写自己博客对应的域名(**注意协议、域名和端口号需严格一致**):
+- 设置Web安全域名确保域名调用安全。点击`1`处进入安全中心,然后在`2`处填写自己博客对应的域名(**注意协议、域名和端口号需严格一致**):

-到这里内容均与 Doublemine 的[为NexT主题添加文章阅读量统计功能](https://notes.wanghao.work/2015-10-21-%E4%B8%BANexT%E4%B8%BB%E9%A2%98%E6%B7%BB%E5%8A%A0%E6%96%87%E7%AB%A0%E9%98%85%E8%AF%BB%E9%87%8F%E7%BB%9F%E8%AE%A1%E5%8A%9F%E8%83%BD.html#%E9%85%8D%E7%BD%AELeanCloud)这篇文章相同,只不过截图为新版的Leancloud的界面。
+到这里内容均与Doublemine的[为NexT主题添加文章阅读量统计功能](https://notes.wanghao.work/2015-10-21-%E4%B8%BANexT%E4%B8%BB%E9%A2%98%E6%B7%BB%E5%8A%A0%E6%96%87%E7%AB%A0%E9%98%85%E8%AF%BB%E9%87%8F%E7%BB%9F%E8%AE%A1%E5%8A%9F%E8%83%BD.html#%E9%85%8D%E7%BD%AELeanCloud)这篇文章相同,只不过截图为新版的Leancloud的界面。
# 部署云引擎以保证访客数量不被随意篡改
-- 点击左侧 `1` 处云引擎,然后点击 `2` 处部署,再点击 `3` 处在线编辑:
+- 点击左侧`1`处云引擎,然后点击`2`处部署,再点击`3`处在线编辑:

-- 点击 `1` 处创建函数:
+- 点击`1`处创建函数:

-- 在弹出窗口选择 `1` 处 `Hook` 类型,然后 `2` 处选择 `beforeUpdate`,`3` 处选择刚才建立的 `Counter` 类。在 `4` 中粘贴下方代码后,点 `5` 处保存。
+- 在弹出窗口选择`1`处`Hook`类型,然后`2`处选择`beforeUpdate`,`3`处选择刚才建立的`Counter`类。在`4`中粘贴下方代码后,点`5`处保存。
```javascript
var query = new AV.Query("Counter");
- if (request.object.updatedKeys.includes('time')) {
+ if (request.object.updatedKeys.indexOf('time') !== -1) {
return query.get(request.object.id).then(function (obj) {
if (obj.get("time") > request.object.get("time")) {
throw new AV.Cloud.Error('Invalid update!');
- }
+ }
return request.object.save();
});
}
@@ -86,89 +78,92 @@

-- 点击保存后应出现类似红框处函数。此时点击 `1` 处部署:
+- 点击保存后应出现类似红框处函数。此时点击`1`处部署:

-- 在弹出窗口点击 `1` 处部署:
+- 在弹出窗口点击`1`处部署:

-- 等待出现红框处的成功部署信息后,点击 `1` 处关闭:
+- 等待出现红框处的成功部署信息后,点击`1`处关闭:

+
至此云引擎已成功部署,任何非法的访客数量更改请求都将失败。
# 进一步设置权限
-- 打开**NexT主题配置文件** `_config.yml`,将 `leancloud_visitors` 下的 `security` 设置为 `true`(如没有则新增):
+- 打开**NexT主题配置文件**`_config.yml`,将leancloud_visitors下的security设置为true(如没有则新增):
```yml
leancloud_visitors:
enable: true
- app_id: #
- app_key: #
- # Required for apps from CN region
- server_url: #
+ app_id: <>
+ app_key: <>
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
+ betterPerformance: false
```
-- 打开 cmd 并切换至**博客根目录**,键入以下命令以安装 `hexo-leancloud-counter-security` 插件:
+ **对`betterPerformance`选项的说明:**
+ 由于Leancloud免费版的云引擎存在请求线程数和运行时间限制以及休眠机制,很多时候访客数量加载会很慢。如果设置`betterPerformance`为`true`,则网页则会在提交请求之前直接显示访客人数为查询到的人数+1,以增加用户体验。
+
+- 打开cmd并切换至**博客根目录**,键入以下命令以安装`hexo-leancloud-counter-security`插件:
```
- npm install hexo-leancloud-counter-security
+ npm install hexo-leancloud-counter-security --save
```
-- 打开**博客配置文件** `_config.yml`,新增以下配置:
+- 打开**博客配置文件**`_config.yml`,新增以下配置:
```yml
leancloud_counter_security:
enable_sync: true
- app_id:
- app_key:
+ app_id: <>
+ app_key: <
username:
password:
```
- 在相同目录键入以下命令:
```
- hexo lc-counter register
+ hexo lc-counter register <> <>
```
或
```
- hexo lc-counter r
+ hexo lc-counter r <> <>
```
- 将 `` 和 `` 替换为你自己的用户名和密码(不必与 LeanCloud 的账号相同)。此用户名和密码将在 Hexo 部署时使用。
+ 将`<>`和`<>`替换为你自己的用户名和密码(不必与leancloud的账号相同)。此用户名和密码将在hexo部署时使用。
- - 打开**博客配置文件** `_config.yml`,将 `` 和 `` 替换为你刚刚设置的用户名和密码:
+ - 打开**博客配置文件**`_config.yml`,将`<>`和`<>`替换为你刚刚设置的用户名和密码:
```yml
leancloud_counter_security:
enable_sync: true
- app_id:
- app_key:
- username: #如留空则将在部署时询问
- password: #建议留空以保证安全性,如留空则将在部署时询问
+ app_id: <>
+ app_key: <
+ username: <> #如留空则将在部署时询问
+ password: <> #建议留空以保证安全性,如留空则将在部署时询问
```
-- 在**博客配置文件** `_config.yml` 的 `deploy` 下添加项:
+- 在**博客配置文件**`_config.yml`的`deploy`下添加项:
```yml
deploy:
# other deployer
- type: leancloud_counter_security_sync
```
-- 返回 LeanCloud 控制台的应用内。依次点击 `1` `2`,检查 `_User` 表中是否出现一条记录(图示以用户名为 `admin` 为例):
+- 返回Leancloud控制台的应用内。依次点击`1` `2`,检查_User表中是否出现一条记录(图示以用户名为admin为例):

-- 点击 `1` 处进入 `Counter` 表,依次点击 `2` `3`,打开权限设置:
+- 点击`1`处进入Counter表,依次点击`2` `3`,打开权限设置:

-- 点击 `1` `add_field` 后选择 `2` 指定用户, 并将下两栏留空: 此处应与下条 `create` 设置相同(选择你所创建的用户):
+- 点击`1`add_fields后选择`2`指定用户, 并将下两栏留空:此处应与下条create设置相同(选择你所创建的用户):

-- 点击 `1` `create` 后选择 `2` 指定用户, 在 `3` 处键入用户名,点击 `4` 处后点击 `5` 处添加:
+- 点击`1`create后选择`2`指定用户, 在`3`处键入用户名,点击`4`处后点击`5`处添加:

@@ -176,15 +171,15 @@

-- 点击 `1` `delete` 后选择 `2` 指定用户, 并将下两栏留空:
+- 点击`1`delete后选择`2`指定用户, 并将下两栏留空:

至此权限已设置完成,数据库记录只能在本地增删。
-每次运行 `hexo d` 部署的时候,插件都会扫描本地 `source/_posts` 下的文章并与数据库对比,然后在数据库创建没有录入数据库的文章记录。
+每次运行`hexo d`部署的时候,插件都会扫描本地`source/_posts`下的文章并与数据库对比,然后在数据库创建没有录入数据库的文章记录。
-如果在**博客配置文件**中留空 `username` 或 `password` ,则在部署过程中程序会要求输入。
+如果在**博客配置文件**中留空username或password,则在部署过程中程序会要求输入。
---
diff --git a/docs/zh-CN/MATH.md b/docs/zh-CN/MATH.md
index 3a45672bc3..ae7c31359c 100644
--- a/docs/zh-CN/MATH.md
+++ b/docs/zh-CN/MATH.md
@@ -1,32 +1,43 @@
数学公式
NexT 内部提供数学公式渲染的引擎,这样你就不需要自己手动在模板中引入 JS 或者 CSS;
-只需要选择对应的渲染引擎,并在 `next/_config.yml` 中将其 `enable` 选项改为 `true` 即可。
+只需要将 `next/_config.yml` 中 `math` 的 `enable` 选项改为 `true`,并选择对应的渲染引擎即可:
-需要注意的是,仅仅将 `enable` 打开**并不能让你看到数学公式**,你还需要**使用对应的 Hexo 渲染器(Renderer)** 才能真正在博客页面中显示出数学公式。引擎对应使用的 Hexo 渲染器会在引擎相关的部分介绍。
+
+```yml
+math:
+ enable: true
+ ...
+ engine: mathjax
+```
+
+
+需要注意的是,仅仅将 `math` 的 `enable` 打开**并不能让你看到数学公式**,你还需要**使用对应的 Hexo 渲染器(Renderer)** 才能真正在博客页面中显示出数学公式。引擎对应使用的 Hexo 渲染器会在引擎相关的部分介绍。
提供的渲染引擎
-目前,NexT 提供两种数学公式渲染引擎,分别为 [MathJax](https://www.mathjax.org/) 和 [Katex](https://khan.github.io/KaTeX/)。
+目前,NexT 提供两种数学公式渲染引擎,分别为 [MathJax](https://www.mathjax.org/) 和 [Katex](https://khan.github.io/KaTeX/),默认为 MathJax。
-### MathJax
+### MathJax(默认)
-如果你选择使用 MathJax 进行数学公式渲染,你需要使用 [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) 或者 [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) (不推荐)作为 Hexo 的 Markdown 渲染器。
+如果你选择使用 MathJax 进行数学公式渲染,你需要使用 [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) 或者 [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) 这两个渲染器的其中一个。
首先,卸载原有的渲染器 `hexo-renderer-marked`,并安装这两种渲染器的**其中一个**:
```sh
-npm uninstall hexo-renderer-marked
-npm install hexo-renderer-pandoc # 或者 hexo-renderer-kramed
+npm un hexo-renderer-marked --save
+npm i hexo-renderer-pandoc --save # 或者 hexo-renderer-kramed
```
-然后在 `next/_config.yml` 中将 `mathjax` 的 `enable` 打开。
+
+然后在 `next/_config.yml` 中将 `math` 的 `enable` 打开,并选择 `mathjax` 作为渲染引擎。
```yml
math:
+ enable: true
...
- mathjax:
- enable: true
+ engine: mathjax
+ #engine: katex
```
执行 Hexo 生成,部署,或者启动服务器:
@@ -40,14 +51,15 @@ hexo clean && hexo g -d
在新版本的 NexT 主题中,我们加入了公式自动编号和引用功能。下面简要介绍一下如何使用这项功能。
-为了使用这项功能,一般来说,你必须把所使用的 LaTeX 公式放在 `equation` 环境里面,采用旧的方法(也就是说,仅仅把公式的每一边用两个 $ 符号包含起来)是无效的。如何引用公式?你只需要在书写公式的时候给公式一个 `\label{}` 标记(tag),然后在正文中,可以使用 `\ref{}` 或者 `\eqref{}` 命令来引用对应的公式。使用 `\eqref{}` 是推荐的方式,因为如果你使用 `\ref{}`,公式在文中的引用编号将没有圆括号包围。下面介绍几种常见的公式编号例子。
+为了使用这项功能,一般来说,你必须把所使用的 LaTeX 公式放在 `equation` 环境里面,采用旧的方法(也就是说,仅仅把公式的每一边用两个 $ 符号包含起来)是无效的。如何引用公式?你只需要在书写公式的时候给公式一个 `\
+label{}` 标记(tag),然后在正文中,可以使用 `\ref{}` 或者 `\eqref{}` 命令来引用对应的公式。使用 `\eqref{}` 是推荐的方式,因为如果你使用 `\ref{}`,公式在文中的引用编号将没有圆括号包围。下面介绍几种常见的公式编号例子。
对于简单的公式,使用下面的方式给公式一个标记,
```latex
-$$\begin{equation}\label{eq1}
+$$\begin{equation}
e=mc^2
-\end{equation}$$
+\end{equation}\label{eq1}$$
```
然后,在正文中,你可以轻松引用上述公式,一个简单的例子如下:
@@ -59,13 +71,13 @@ e=mc^2
对于多行公式,在 `equation` 环境中,你可以使用 `aligned` 环境把公式分成多行,
```latex
-$$\begin{equation}\label{eq2}
+$$\begin{equation}
\begin{aligned}
a &= b + c \\
&= d + e + f + g \\
&= h + i
\end{aligned}
-\end{equation}$$
+\end{equation}\label{eq2}$$
```
要对齐多个公式,我们需要使用 `align` 环境。align 环境中的每个公式都有自己的编号:
@@ -94,7 +106,7 @@ $$\begin{align}
$$x+1\over\sqrt{1-x^2} \tag{i}\label{eq_tag}$$
```
-如果你想要了解更多信息,请访问 [MathJax 关于公式编号的官方文档](https://docs.mathjax.org/en/latest/input/tex/eqnumbers.html)。同时,你也可以阅读 [这篇文档](https://theme-next.org/docs/third-party-services/math-equations) 来获取更多细节信息。
+如果你想要了解更多信息,请访问 [MathJax 关于公式编号的官方文档](http://docs.mathjax.org/en/latest/tex.html#automatic-equation-numbering)。同时,你也可以访问[这篇博客](https://jdhao.github.io/2018/01/25/hexo-mathjax-equation-number/) 来获取更多细节信息。
### Katex
@@ -107,18 +119,20 @@ Katex 渲染引擎相对于 MathJax 来说**大大提高了速度**,而且在
首先,卸载原有的渲染器 `hexo-renderer-marked`,并安装这两种渲染器的**其中一个**:
```sh
-npm uninstall hexo-renderer-marked
-npm install hexo-renderer-markdown-it-plus
+npm un hexo-renderer-marked --save
+npm i hexo-renderer-markdown-it-plus --save
# 或者 hexo-renderer-markdown-it
```
-然后在 `next/_config.yml` 中将 `katex` 的 `enable` 打开。
+
+然后在 `next/_config.yml` 中将 `math` 的 `enable` 打开,并选择 `katex` 作为渲染引擎。
```yml
math:
+ enable: true
...
- katex:
- enable: true
+ #engine: mathjax
+ engine: katex
```
执行 Hexo 生成,部署,或者启动服务器:
@@ -133,7 +147,7 @@ hexo clean && hexo g -d
如果你使用 `hexo-renderer-markdown-it`,你还需要为其加上 `markdown-it-katex` 作为插件:
```
-npm install markdown-it-katex
+npm i markdown-it-katex --save
```
然后在 `hexo/_config.yml` 中将 `markdown-it-katex` 作为插件写入 `hexo-renderer-markdown-it` 的配置中:
@@ -162,9 +176,10 @@ markdown:
那么文章目录中的这个标题会出现 3 次未渲染的公式代码([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359018694))
6. 如果你在文章 Title 中使用公式,那么公式将不会被渲染。([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359142879))
-我们目前使用的 Katex 版本为 0.11.1,这里面可能有某些问题是因为 Katex 版本老旧导致的;
-但是,就像上面所说的,数学公式的渲染必须依靠渲染器来支持,目前的 Katex 相关的渲染器仅支持到 Katex 0.11.1;
+我们目前使用的 Katex 版本为 0.7.1,这里面可能有某些问题是因为 Katex 版本老旧导致的;
+
+但是,就像上面所说的,数学公式的渲染必须依靠渲染器来支持,目前的 Katex 相关的渲染器仅支持到 Katex 0.7.1;
我们会持续关注相关渲染器的更新,如果有渲染器支持更高版本的 Katex,我们会及时更新我们的 Katex 版本。
@@ -182,27 +197,42 @@ markdown:
如果配置的内容接在冒号后面,那么内容和冒号之间必须有一个空格(例如`enable: true`)
```yml
-# Math Formulas Render Support
+
+# Math Equations Render Support
math:
- # Default (true) will load mathjax / katex script on demand.
- # That is it only render those page which has `mathjax: true` in Front-matter.
- # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
+ enable: false
+
+ # Default(true) will load mathjax/katex script on demand
+ # That is it only render those page who has 'mathjax: true' in Front-matter.
+ # If you set it to false, it will load mathjax/katex srcipt EVERY PAGE.
per_page: true
- # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
+ engine: mathjax
+ #engine: katex
+
+ # hexo-renderer-pandoc (or hexo-renderer-kramed) needed to full MathJax support.
mathjax:
- enable: true
- # See: https://mhchem.github.io/MathJax-mhchem/
- mhchem: false
+ # Use 2.7.1 as default, jsdelivr as default CDN, works everywhere even in China
+ cdn: //cdn.jsdelivr.net/npm/mathjax@2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+ # For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com).
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML
- # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
+ # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin)
+ # needed to full Katex support.
katex:
- enable: false
- # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
- copy_tex: false
+ # Use 0.7.1 as default, jsdelivr as default CDN, works everywhere even in China
+ cdn: //cdn.jsdelivr.net/npm/katex@0.7.1/dist/katex.min.css
+ # CDNJS, provided by cloudflare, maybe the best CDN, but not works in China
+ #cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css
```
-### `per_page`
+### enable
+
+`true` 或者 `false`,默认为 `false`。
+
+`true` 是打开数学公式渲染,`false` 则是关闭。
+
+### per_page
`true` 或者 `false`,默认为 `true`。
@@ -241,3 +271,21 @@ title: 'Not Render Math Either'
```
当你将它设置为 `false` 时,它就会在每个页面都加载 MathJax 或者 Katex 来进行数学公式渲染。
+
+### cdn
+
+MathJax 和 Katex 都提供了 `cdn` 的配置,如果你不知道什么是 `cdn` ,**请不要修改这个配置**。
+
+首先,MathJax 和 Katex 都使用了 [jsDelivr](https://www.jsdelivr.com/) 作为默认 CDN;
+
+之所以选择 jsDelivr 是因为它在全球各地都有比较不错的速度,而且具有中国官方颁布的 ICP 证书,在中国也能比较好地访问。
+
+同时,我们也提供了其他的 CDN 备选方案,包括著名的 [CDNJS](https://cdnjs.com/)。
+
+对于 MathJax 来说,我们目前采用的版本为 2.7.1。
+
+对于 Katex,由于上面提到的版本问题,我们目前采用的版本为 0.7.1。
+
+如果你想尝试我们提供的备选方案以外的 CDN,请注意使用对应的版本。
+
+特别的,对于中国的博客主,或者您的博客访问大部分来源于中国,由于 CDNJS 在部分中国地区被墙,请不要使用 CDNJS 作为 CDN。
diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md
index e2a6daf611..38bd840765 100644
--- a/docs/zh-CN/README.md
+++ b/docs/zh-CN/README.md
@@ -1,80 +1,75 @@
-
+
# 
e x T
+«NexT» 是一款风格优雅的高质量 Hexo 主题,自点点滴滴中用爱雕琢而成。
+
- «NexT» 是一款风格优雅的高质量 Hexo 主题,自点点滴滴中用爱雕琢而成。
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
## 即时预览
-
- 💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
-
-
- 更多 «NexT» 的例子参见这里。
-
+* :heart_decoration: Muse 主题: [LEAFERx](https://leaferx.online) | [Alex LEE](http://saili.science) | [Miaia](https://11.tt)
+* :six_pointed_star: Mist 主题: [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com)
+* :pisces: Pisces 主题: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Jiaxi He](http://jiaxi.io)
+* :gemini: Gemini 主题: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me)
+
+更多 «NexT» 的例子参见[这里](https://github.com/iissnan/hexo-theme-next/issues/119)。
## 安装
最简单的安装方式是直接克隆整个仓库:
-```sh
-$ cd hexo
-$ git clone https://github.com/theme-next/hexo-theme-next themes/next
-```
+ ```sh
+ $ cd hexo
+ $ git clone https://github.com/theme-next/hexo-theme-next themes/next
+ ```
此外,如果你想要使用其他方式,你也可以参见[详细安装步骤][docs-installation-url]。
## 插件
-NexT 支持大量的第三方插件,它们可以被轻松地配置。
+在 NexT 配置中你现在可以找到已经被移至外部仓库的依赖项。你可以在[组织主页](https://github.com/theme-next)中找到它们。
-例如,你想要在你的站点中使用 `pjax` 插件,请进入 NexT 配置文件,启用 `pjax` 配置项:
+例如,假设你想要在你的站点中使用 `fancybox` 插件,请进入 NexT 配置文件,你会看到如下内容:
```yml
-# Easily enable fast Ajax navigation on your website.
-# Dependencies: https://github.com/theme-next/theme-next-pjax
-pjax: true
+# Fancybox
+# Dependencies: https://github.com/theme-next/theme-next-fancybox
+fancybox: false
```
-然后,打开它上面的 «Dependencies» 链接以查看它的安装步骤。
+将 `fancybox` 配置项打开,进入它上面的 «Dependencies» 链接以查看它的安装步骤。
-### 设置 CDN
+### 例外
-如果你想要通过 CDN 来加载插件脚本,那么需要设置相关的 CDN 链接。
+如果你使用的插件脚本依赖 CDN,那么需要替换你的 CDN 链接:
-例如,你想要使用 `mediumzoom` 插件并通过 CDN 加载,进入 Next 配置文件并找到如下内容:
+例如,假如你使用了 `fancybox` 插件并且配置了 CDN 加载链接,进入 Next 配置文件,你会看到如下内容:
```yml
vendors:
# ...
# Some contents...
# ...
- mediumzoom: # Set or update mediumzoom CDN URL.
+ fancybox: # Set or update fancybox cdn url.
+ fancybox_css: # Set or update fancybox cdn url.
```
+通过替换 CDN 链接来替换 [插件列表](https://github.com/theme-next) 项目来升级。
+
## 更新
-NexT 每个月都会发布新版本。你可以通过如下命令更新到最新的 master 分支:
+你可以通过如下命令更新到最新的 master 分支:
```sh
$ cd themes/next
@@ -84,68 +79,78 @@ $ git pull
如果你在此过程中收到了任何错误报告 (例如 **«Commit your changes or stash them before you can merge»**),我们推荐你使用 [Hexo 数据文件][docs-data-files-url]特性。\
然而你也可以通过提交(`Commit`)、贮藏(`Stash`)或忽视(`Discard`)本地更改以绕过这种更新错误。具体方法请参考[这里](https://stackoverflow.com/a/15745424/5861495)。
-**如果你想要从 v5.1.x 更新到最新版本,阅读[这篇文档][docs-update-5-1-x-url]。**
+**如果你想要从 v5.1.x 更新到 v6.0.x,阅读[这篇文档][docs-update-5-1-x-url]。**
-## 反馈
+## 已知问题
-* 浏览 [Awesome NexT][awesome-next-url] 列表,与其它用户分享插件和教程。
-* 加入我们的 [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] 聊天。
-* 请花几秒钟来[添加或修正翻译][i18n-url]。
-* 在 [GitHub Issues][issues-bug-url] 报告Bug。
-* 在 [GitHub][issues-feat-url] 请求新的功能。
-* 为 [受欢迎的 Feature request][feat-req-vote-url] 投票。
+对于仍然遇到 **«[Error: Cannot find module 'hexo-util'](https://github.com/iissnan/hexo-theme-next/issues/1490)»** 这一错误的用户,请检查你的 NPM 版本。
+
+* `> 3`:仍然出现错误吗?请删除 `node_modules` 目录并通过 `npm install` 重新安装。
+* `< 3`:请通过 `npm install --save-dev hexo-util` 将 `hexo-util` 依赖手动添加至你的站点依赖包中。
## 贡献你的代码
-我们欢迎你加入 NexT 的开发,贡献出你的一份力量。请看[开源贡献指南][contributing-document-url]。 🤗
+我们欢迎你贡献出你的一份力量,你可以随时提交 issue 或 fork 本仓库。静候你的 pull request。
+
+## 反馈
-你也可以随时向我们的[官方插件][official-plugins-url]提交 Issue 或 Pull Request。
+* 在 [Stack Overflow][stack-url] 上提问。
+* 在 [GitHub Issues][issues-bug-url] 报告Bug。
+* 在 [GitHub][issues-feat-url] 请求新的功能。
+* 为 [popular feature requests][feat-req-vote-url] 投票。
+* 加入我们的 [Gitter][gitter-url] / [Riot][riot-url] / [Telegram][t-chat-url] 聊天。
+* 关注我们的 [Telegram Channel][t-news-url] 以获取最新消息。
-## 贡献者
+## 第三方应用程序
-[![][contributors-image]][contributors-url]
+* :triangular_flag_on_post: HexoEditor
## 鸣谢
- «NexT» 特别感谢这些支持我们核心基础设施的优质服务:
-
-
-
-
-
-
+«NexT» 特别感谢这些支持我们核心基础设施的优质服务:
+
+
+
+ 
+
GitHub 容许我们托管 Git 仓库,Netlify 容许我们分发文档。
-
-
-
-
+
+
+
+
Crowdin 容许我们方便地翻译文档。
-
-
-
-
-
-
- Codacy 容许我们监控代码质量,Travis CI 容许我们运行测试套件。
-[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md
-[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/DATA-FILES.md
-[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/UPDATE-FROM-5.1.X.md
+
+ 
+
+ Codacy 容许我们运行测试套件,BrowserStack 容许我们在真实的浏览器中进行测试。
+
-[t-news-url]: https://t.me/theme_next_news
-[t-chat-url]: https://t.me/theme_next_chinese
-[gitter-url]: https://gitter.im/theme-next
-[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
-[i18n-url]: https://i18n.theme-next.org
+[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg
+[browser-url]: https://www.browserstack.com
-[awesome-next-url]: https://github.com/theme-next/awesome-next
+[stack-url]: https://stackoverflow.com/questions/tagged/theme-next
[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md
[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md
-[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22
+[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22+sort%3Areactions-%2B1-desc
-[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/CONTRIBUTING.md
-[official-plugins-url]: https://github.com/theme-next
-[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890
-[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors
+[gitter-url]: https://gitter.im/theme-next
+[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
+[t-chat-url]: https://t.me/theme_next_chinese
+[t-news-url]: https://t.me/theme_next_news
+
+
+
+
+
+[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip
+[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest
+
+[tags-url]: https://github.com/theme-next/hexo-theme-next/tags
+[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master
+
+[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md
+[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/DATA-FILES.md
+[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/UPDATE-FROM-5.1.X.md
diff --git a/docs/zh-CN/UPDATE-FROM-5.1.X.md b/docs/zh-CN/UPDATE-FROM-5.1.X.md
index 436616d19d..ab097eac16 100644
--- a/docs/zh-CN/UPDATE-FROM-5.1.X.md
+++ b/docs/zh-CN/UPDATE-FROM-5.1.X.md
@@ -1,21 +1,19 @@
从 NexT v5.1.x 更新
-在使用 Hexo 3 时,NexT V5 版本仍然能够正常运行,但是如果你想获得更多的功能和帮助,还是建议您升级到 NexT V7+ 版本,并移步 [Theme-Next](https://github.com/theme-next/hexo-theme-next) 仓库。
-
-在 5.1.x 版本和新版本之间没有很大的革命性改进。主版本号变更至 7 主要是因为:
+在 5.1.x 版本和 6.0.x 版本之间没有很大的革命性改进。主版本号变更至 6 主要是因为:
1. 主仓库已从 [iissnan 名下](https://github.com/iissnan/hexo-theme-next) 迁移至 [theme-next](https://github.com/theme-next) 组织。
2. `next/source/lib` 目录下的绝大多数库被移出到了 [NexT 组织的外部仓库](https://github.com/theme-next)中。
-3. 第三方插件 [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) 被 [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) 所取代,因为 `hexo-symbols-count-time` 没有任何外部 Node.js 依赖、也没有会导致生成站点时的性能问题 [language filter](https://github.com/willin/hexo-wordcount/issues/7)。
+3. 第三方插件 [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) 被 [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) 所取代,因为 `hexo-symbols-count-time` 没有任何外部 nodejs 依赖、也没有会导致生成站点时的性能问题 [language filter](https://github.com/willin/hexo-wordcount/issues/7)。
-我们推荐通过如下步骤从 v5 升级到 v7:
+推荐通过如下步骤从 v5 升级到 v6:
1. 并不修改原有的 `next` 目录,而只是复制部分 NexT 文件:
- 1. `_config.yml` 或 `next.yml`(如果你使用了[数据文件](DATA-FILES.md))。
+ 1. `config.yml` 或 `next.yml`(如果你使用了[数据文件](DATA-FILES.md))。
2. 自定义的 CSS 配置,它们应在 `next/source/css/_custom/*` 和 `next/source/css/_variables/*` 中。
3. 自定义的排布配置,它们应在 `next/layout/_custom/*` 中。
4. 任何其它可能的附加自定义内容;为了定位它们,你可以通过某些工具在仓库间比较。
-2. 克隆新的仓库到任一异于 `next` 的目录(如 `next-reloaded`):
+2. 克隆新的 v6.x 仓库到任一异于 `next` 的目录(如 `next-reloaded`):
```sh
$ git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded
```
@@ -30,11 +28,8 @@
4. 更新语言配置
- 从 v6.0.3 版本起,`zh-Hans` 改名为 `zh-CN`:https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3
-
- 升级到 v6.0.3 及以后版本的用户,需要显式修改 Hexo 主配置文件 `_config.yml` 里的 `language` 配置,否则语言显示不正确。
-5. 更新 Hexo 和 Hexo 插件
-
- 如果完成了以上步骤后,执行 `hexo s` 或 `hexo g` 出现错误,这意味着可能是旧版的 Hexo 和 Hexo 插件与新版的 NexT 主题产生了冲突。我们建议将 Hexo 升级至 4.0 以上的版本,将 Hexo 插件升级到最新版本。你可以执行 `npm outdated` 查看所有可以升级的插件。
+ 从 v6.0.3版本起,`zh-Hans`改名为`zh-CN`:https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3
+
+ 升级到v6.0.3及以后版本的用户,需要显式修改`_config.xml`里的language配置,否则语言显示不正确。
关于第三方库的启用,参见[这里](https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md#插件)。
diff --git a/gulpfile.coffee b/gulpfile.coffee
new file mode 100644
index 0000000000..d556e15297
--- /dev/null
+++ b/gulpfile.coffee
@@ -0,0 +1,53 @@
+fs = require('fs')
+path = require('path')
+gulp = require('gulp')
+jshint = require('gulp-jshint')
+stylish = require('jshint-stylish')
+shell = require('gulp-shell')
+yaml = require('js-yaml')
+
+gulp.task 'lint', ->
+ return gulp.src([
+ './source/js/utils.js',
+ './source/js/motion.js',
+ './source/js/algolia-search.js',
+ './source/js/bootstrap.js',
+ './source/js/post-details.js',
+ './source/js/schemes/pisces.js'
+ ]).pipe jshint()
+ .pipe jshint.reporter(stylish)
+
+gulp.task 'lint:stylus', shell.task [
+ '"./node_modules/.bin/stylint" ./source/css/'
+]
+
+gulp.task 'validate:config', (cb) ->
+ themeConfig = fs.readFileSync path.join(__dirname, '_config.yml')
+
+ try
+ yaml.safeLoad(themeConfig)
+ cb()
+ catch error
+ cb new Error(error)
+
+gulp.task 'validate:languages', (cb) ->
+ languagesPath = path.join __dirname, 'languages'
+ languages = fs.readdirSync languagesPath
+ errors = []
+
+ for lang in languages
+ languagePath = path.join languagesPath, lang
+ try
+ yaml.safeLoad fs.readFileSync(languagePath), {
+ filename: path.relative(__dirname, languagePath)
+ }
+ catch error
+ errors.push error
+
+ if errors.length == 0
+ cb()
+ else
+ cb(errors)
+
+
+gulp.task 'default', ['lint', 'validate:config', 'validate:languages']
diff --git a/gulpfile.js b/gulpfile.js
deleted file mode 100644
index 7be68fd2c4..0000000000
--- a/gulpfile.js
+++ /dev/null
@@ -1,48 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const gulp = require('gulp');
-const eslint = require('gulp-eslint');
-const shell = require('gulp-shell');
-const yaml = require('js-yaml');
-
-gulp.task('lint', () => gulp.src([
- './source/js/**/*.js',
- './scripts/**/*.js'
-]).pipe(eslint())
- .pipe(eslint.format()));
-
-gulp.task('lint:stylus', shell.task([
- 'npx stylint ./source/css/'
-]));
-
-gulp.task('validate:config', cb => {
- const themeConfig = fs.readFileSync(path.join(__dirname, '_config.yml'));
-
- try {
- yaml.safeLoad(themeConfig);
- return cb();
- } catch (error) {
- return cb(new Error(error));
- }
-});
-
-gulp.task('validate:languages', cb => {
- const languagesPath = path.join(__dirname, 'languages');
- const languages = fs.readdirSync(languagesPath);
- const errors = [];
-
- languages.forEach(lang => {
- const languagePath = path.join(languagesPath, lang);
- try {
- yaml.safeLoad(fs.readFileSync(languagePath), {
- filename: path.relative(__dirname, languagePath)
- });
- } catch (error) {
- errors.push(error);
- }
- });
-
- return errors.length === 0 ? cb() : cb(errors);
-});
-
-gulp.task('default', gulp.series('lint', 'validate:config', 'validate:languages'));
diff --git a/languages/ar.yml b/languages/ar.yml
deleted file mode 100644
index 7978f22794..0000000000
--- a/languages/ar.yml
+++ /dev/null
@@ -1,90 +0,0 @@
----
-name: عربي
-title:
- archive: الأرشيف
- category: تصنيف
- tag: وسم
- schedule: التقويم
-menu:
- home: Home
- archives: الأرشيفات
- categories: التصنيفات
- tags: الوسوم
- about: معلومات
- search: بحث
- schedule: التقويم
- sitemap: خريطة الموقع
- commonweal: Commonweal 404
-sidebar:
- overview: عام
- toc: المحتويات
-post:
- posted: نُشر في
- edited: عُدل في
- created: أُنشأ
- modified: عُدل
- edit: تحرير هذا المقال
- in: في
- read_more: تابع القراءة
- untitled: بدون عنوان
- sticky: مثبت
- views: مشاهدات
- related_posts: مقالات مشابهة
- copyright:
- author: مؤلف المقال
- link: رابط المقال
- license_title: حقوق الملكية
- license_content: "حميع المقالات في هذه المدوّنة منشورة تحت رخصة %s إلا عند التنويه بخلافه."
-footer:
- powered: "تطبيق الموقع %s"
- total_views: إجمالي المشاهدات
- total_visitors: إجمالي الزوار
-counter:
- tag_cloud:
- zero: لا وسوم
- one: وسمٌ واحدٌ
- other: "%d وسماً بالمُجمل"
- categories:
- zero: لا تصنيفات
- one: تصنيفٌ واحد
- other: "%d تصنيفات بالمُجمل"
- archive_posts:
- zero: لا مقالات.
- one: مقالٌ واحد.
- other: "%d مقالاً بالمُجمل."
-state:
- posts: المقالات
- tags: الوسوم
- categories: التصنيفات
-search:
- placeholder: بحث...
-cheers:
- um: هِم..
- ok: حسناً
- nice: جميل
- good: جيد
- great: عظيم
- excellent: ممتاز
-keep_on: واصل الكتابة.
-symbol:
- comma: "، "
- period: ". "
- colon: ": "
-reward:
- donate: تبرّع
- wechatpay: WeChat Pay
- alipay: Alipay
- paypal: PayPal
- bitcoin: Bitcoin
-follow_me:
- welcome: مرحباً بك حيثُ أنشر أيضاً
-accessibility:
- nav_toggle: تشغيل شريط التصفح
- prev_page: الصفحة السابقة
- next_page: الصفحة التالية
-symbols_count_time:
- count: عدد الحروف في المقال
- count_total: مُجمل عدد الحروف
- time: زمن القراءة
- time_total: مُجمل زمن القراءة
- time_minutes: دقائق.
diff --git a/languages/de.yml b/languages/de.yml
index 0e37d2ae8e..2c0731090a 100644
--- a/languages/de.yml
+++ b/languages/de.yml
@@ -1,5 +1,4 @@
---
-name: Deutsch
title:
archive: Archiv
category: Kategorie
@@ -25,18 +24,28 @@ post:
modified: Geändert am
edit: Diesen Beitrag bearbeiten
in: in
+ more: mehr
read_more: Weiterlesen
untitled: Unbenannt
sticky: Angepinnt
+ toc_empty: Dieser Artikel hat kein Inhaltsverzeichnis
views: Aufrufe
+ comments_count: Kommentare
related_posts: Ähnliche Beiträge
+ copy_button: Kopieren
+ copy_success: Kopiert
+ copy_failure: Kopieren fehlgeschlagen
copyright:
author: Beitragsautor
link: Beitragslink
license_title: Urheberrechtshinweis
license_content: "Alle Artikel in diesem Blog sind unter %s lizenziert, außer es wird anders angegeben."
+page:
+ totally: Gesamt
+ tags: schlagwörter
footer:
powered: "Erstellt mit %s"
+ theme: Design
total_views: Alle Aufrufe
total_visitors: Alle Besucher
counter:
@@ -54,6 +63,7 @@ counter:
other: "Insgesamt %d Artikel."
state:
posts: Artikel
+ pages: Seiten
tags: schlagwörter
categories: Kategorien
search:
@@ -74,10 +84,7 @@ reward:
donate: Spenden
wechatpay: WeChat Bezahlung
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Navigationsleiste an/ausschalten
prev_page: Vorherige Seite
diff --git a/languages/en.yml b/languages/en.yml
index 390bbd6624..ed25551727 100644
--- a/languages/en.yml
+++ b/languages/en.yml
@@ -1,5 +1,3 @@
-name: English
-
title:
archive: Archive
category: Category
@@ -28,19 +26,30 @@ post:
modified: Modified
edit: Edit this post
in: In
+ more: more
read_more: Read more
untitled: Untitled
sticky: Sticky
+ toc_empty: This post does not have a Table of Contents
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: Totally
+ tags: tags
+
footer:
powered: "Powered by %s"
+ theme: Theme
total_views: Total Views
total_visitors: Total Visitors
@@ -62,6 +71,7 @@ counter:
state:
posts: posts
+ pages: pages
tags: tags
categories: categories
@@ -87,11 +97,9 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
+gitmentbutton: Show comments from Gitment
accessibility:
nav_toggle: Toggle navigation bar
diff --git a/languages/es.yml b/languages/es.yml
index 36b0b90261..edd9b36bba 100644
--- a/languages/es.yml
+++ b/languages/es.yml
@@ -1,5 +1,4 @@
---
-name: Español
title:
archive: Archivo
category: Categoría
@@ -25,18 +24,28 @@ post:
modified: Modificado por
edit: Editar esta entrada
in: En
+ more: más
read_more: Leer más
untitled: Sin título
sticky: Sticky
+ toc_empty: Esta entrada no tiene una tabla de contenidos
views: Visitas
+ comments_count: Comentarios
related_posts: Entradas relacionadas
+ copy_button: Copiar
+ copy_success: Copiado
+ copy_failure: Copiar falló
copyright:
author: Autor de la entrada
link: Enlace a la entrada
license_title: Copyright
license_content: "Todos los artículos de este blog están licenciados bajo %s a no ser que se especifique una licencia adicional."
+page:
+ totally: Totalidad
+ tags: etiquetas
footer:
powered: "Creado mediante %s"
+ theme: Tema
total_views: Visitas totales
total_visitors: Visitantes totales
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d entradas en total."
state:
posts: entradas
+ pages: páginas
tags: tags
categories: categorías
search:
@@ -74,10 +84,7 @@ reward:
donate: Donar
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Cambiar a barra de navegación
prev_page: Página anterior
diff --git a/languages/fa.yml b/languages/fa.yml
index 77455a6dae..72186f85b6 100644
--- a/languages/fa.yml
+++ b/languages/fa.yml
@@ -1,5 +1,4 @@
---
-name: فارسی
title:
archive: بایگانی
category: دسته بندی
@@ -25,18 +24,28 @@ post:
modified: تغییر یافته
edit: ویرایش این پست
in: در
+ more: بیشتر
read_more: ادامه مطلب
untitled: بدون عنوان
sticky: چسبنده
+ toc_empty: این پست فهرست مطالب را ندارد
views: بازدیدها
+ comments_count: نظرات
related_posts: پست های مرتبط
+ copy_button: کپی
+ copy_success: کپی شد
+ copy_failure: کپی انجام نشد
copyright:
author: نویسنده پست
link: لینک پست
license_title: مقررات کپی رایت
license_content: "همه مقالات در این وبلاگ تحت %s مجاز می باشند مگر اینکه به طور اضافی بیان شوند."
+page:
+ totally: درمجموع
+ tags: برجسب ها
footer:
powered: "قدرت گرفته از %s"
+ theme: پوسته
total_views: مجموع بازدیدها
total_visitors: تعداد بازدید کنندگان
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d برچسب در مجموع."
state:
posts: پست ها
+ pages: صفحات
tags: برجسب ها
categories: دسته بندی ها
search:
@@ -74,10 +84,7 @@ reward:
donate: کمک مالی
wechatpay: پرداخت WeChat
alipay: AliPay
- paypal: PayPal
bitcoin: بیت کوین
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: تغییر ناوبری
prev_page: صفحه قبلی
diff --git a/languages/fr.yml b/languages/fr.yml
index 44b68dbf16..299de407e5 100644
--- a/languages/fr.yml
+++ b/languages/fr.yml
@@ -1,5 +1,4 @@
---
-name: Français
title:
archive: Archive
category: Catégorie
@@ -16,36 +15,46 @@ menu:
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
- overview: Aperçu
+ overview: Ensemble
toc: Table Des Matières
post:
posted: Posté le
- edited: Édité le
+ edited: Éditer sur
created: Article créé le
- modified: Mis à jour le
+ modified: Mise à jour le
edit: Éditer cet article
- in: dans
+ in: In
+ more: plus
read_more: Lire la suite
- untitled: Sans titre
+ untitled: Non titré
sticky: Épingler
+ toc_empty: Cet article n'a pas de table des matières
views: Vues
- related_posts: Articles similaires
+ comments_count: Commentaires
+ related_posts: Articles similares
+ copy_button: Copie
+ copy_success: Copie réussie
+ copy_failure: Copie ratée
copyright:
author: Auteur de l'article
link: Lien de l'article
license_title: Droit d'auteur
license_content: "Tous les articles de ce blog sont sous licence %s, sauf mention contraire."
+page:
+ totally: Total
+ tags: mots clé
footer:
- powered: "Propulsé par %s"
+ powered: "Alimenté par %s"
+ theme: Thème
total_views: Vues totales
total_visitors: Total visiteurs
counter:
tag_cloud:
- zero: Aucun tag
+ zero: Aucun mot clé
one: 1 tag au total
other: "%d tags au total"
categories:
- zero: Aucune categorie
+ zero: Aucun categories
one: 1 catégorie au total
other: "%d catégories au total"
archive_posts:
@@ -54,6 +63,7 @@ counter:
other: "%d articles au total."
state:
posts: articles
+ pages: pages
tags: mots clé
categories: catégories
search:
@@ -74,17 +84,14 @@ reward:
donate: Donner
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Basculer la barre de navigation
prev_page: Page précédente
next_page: Page suivante
symbols_count_time:
- count: Caractères dans l'article
- count_total: Caractères total
+ count: Symbols count in article
+ count_total: Symbols count total
time: Temps de lecture
time_total: Temps total de lecture
time_minutes: mins.
diff --git a/languages/hu.yml b/languages/hu.yml
index e9bd0992d8..b8b5032dd5 100644
--- a/languages/hu.yml
+++ b/languages/hu.yml
@@ -1,10 +1,9 @@
---
-name: magyar
title:
archive: Archive
category: Category
tag: Tag
- schedule: Ütemterv
+ schedule: Schedule
menu:
home: Home
archives: Archives
@@ -25,18 +24,28 @@ post:
modified: Modified
edit: Edit this post
in: In
+ more: more
read_more: Read more
untitled: Untitled
sticky: Sticky
+ toc_empty: This post does not have a Table of Contents
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: Totally
+ tags: tags
footer:
powered: "Powered by %s"
+ theme: Theme
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d posts in total."
state:
posts: posts
+ pages: pages
tags: tags
categories: categories
search:
@@ -74,10 +84,7 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Previous page
diff --git a/languages/id.yml b/languages/id.yml
index e11a81ae72..76bf9744d3 100644
--- a/languages/id.yml
+++ b/languages/id.yml
@@ -1,5 +1,4 @@
---
-name: Bahasa Indonesia
title:
archive: Arsip
category: Kategori
@@ -25,18 +24,28 @@ post:
modified: Updated at
edit: Edit this post
in: Di
+ more: more
read_more: Baca lebih
untitled: Tidak ada title
sticky: Sticky
+ toc_empty: Posting ini tidak memiliki Daftar Isi
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: Total
+ tags: tags
footer:
powered: "Powered by %s"
+ theme: Tema
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d total posting."
state:
posts: posting
+ pages: halaman
tags: tags
categories: kategori
search:
@@ -74,10 +84,7 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Halaman sebelumnya
diff --git a/languages/it.yml b/languages/it.yml
index b0e499457f..b43733373a 100644
--- a/languages/it.yml
+++ b/languages/it.yml
@@ -1,5 +1,4 @@
---
-name: Italiano
title:
archive: Archivio
category: Categoria
@@ -25,18 +24,28 @@ post:
modified: Post modificato
edit: Edit this post
in: In
+ more: espandi
read_more: Leggi di più
untitled: Senza titolo
sticky: Sticky
+ toc_empty: Questo post non ha un indice
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Autore
link: Link
license_title: Copyright
license_content: "Tutti gli articoli in questo sito sono sotto licenza %s salvo disposizione contraria."
+page:
+ totally: Totale
+ tags: tags
footer:
powered: "Powered by %s"
+ theme: Tema
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d posts in totale."
state:
posts: posts
+ pages: pagine
tags: tags
categories: categorie
search:
@@ -74,10 +84,7 @@ reward:
donate: Dona
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Pagina precedente
diff --git a/languages/ja.yml b/languages/ja.yml
index 6181fa6189..3bd0301950 100644
--- a/languages/ja.yml
+++ b/languages/ja.yml
@@ -1,5 +1,4 @@
---
-name: 日本語
title:
archive: アーカイブ
category: カテゴリ
@@ -25,18 +24,28 @@ post:
modified: 修正日
edit: この記事を編集する
in: カテゴリ
+ more: もっと見る
read_more: 続きを読む
untitled: 無題
sticky: 固定
+ toc_empty: 見出しがありません
views: 閲覧数
+ comments_count: コメント
related_posts: 関連記事
+ copy_button: コピー
+ copy_success: コピーしました
+ copy_failure: コピーに失敗しました
copyright:
author: 著者
link: 記事へのリンク
license_title: 著作権表示
license_content: "このブログ内のすべての記事は、特別な記載がない限り %s の下のライセンスで保護されています。"
+page:
+ totally: 全ページ
+ tags: タグ
footer:
powered: "Powered by %s"
+ theme: テーマ
total_views: 閲覧合計数
total_visitors: 合計閲覧者数
counter:
@@ -54,6 +63,7 @@ counter:
other: "全 %d ポスト"
state:
posts: ポスト
+ pages: ページ
tags: タグ
categories: カテゴリ
search:
@@ -74,10 +84,7 @@ reward:
donate: 寄付
wechatpay: WeChat 支払う
alipay: Alipay
- paypal: PayPal
bitcoin: ビットコイン
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: ナビゲーションバーの切り替え
prev_page: 前のページ
diff --git a/languages/ko.yml b/languages/ko.yml
index 9751fc79f5..8cafc75718 100644
--- a/languages/ko.yml
+++ b/languages/ko.yml
@@ -1,5 +1,4 @@
---
-name: 한국어
title:
archive: 아카이브
category: 카테고리
@@ -25,18 +24,28 @@ post:
modified: Updated at
edit: Edit this post
in: In
+ more: more
read_more: 더 읽어보기
untitled: 제목 없음
sticky: 고정
+ toc_empty: 목차 없음
views: Views
+ comments_count: 댓글
related_posts: Related Posts
+ copy_button: 복사
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: 모두
+ tags: 태그
footer:
powered: "Powered by %s"
+ theme: Theme
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "총 %d개의 포스트"
state:
posts: 포스트
+ pages: 페이지
tags: 태그
categories: 카테고리
search:
@@ -74,10 +84,7 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: 이전 페이지
diff --git a/languages/nl.yml b/languages/nl.yml
index 2da6ee78e0..c7b4e3c3c9 100644
--- a/languages/nl.yml
+++ b/languages/nl.yml
@@ -1,5 +1,4 @@
---
-name: Niederländisch
title:
archive: Archief
category: Categorie
@@ -25,18 +24,28 @@ post:
modified: Post aangepast
edit: Edit this post
in: In
+ more: meer
read_more: Lees meer
untitled: Naamloos
sticky: Sticky
+ toc_empty: Deze post heeft geen inhoudsopgave
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post auteur
link: Post link
license_title: Copyright melding
license_content: "Alle artikelen op deze blog zijn gelicenseerd onder %s, mits niet anders aangegeven."
+page:
+ totally: Totaal
+ tags: labels
footer:
powered: "Mede mogelijk gemaakt door %s"
+ theme: Thema
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d posts in totaal."
state:
posts: posts
+ pages: pagina's
tags: labels
categories: categorieën
search:
@@ -74,10 +84,7 @@ reward:
donate: Doneer
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Vorige pagina
diff --git a/languages/pt-BR.yml b/languages/pt-BR.yml
index a28df261d4..5f833f903f 100644
--- a/languages/pt-BR.yml
+++ b/languages/pt-BR.yml
@@ -1,5 +1,4 @@
---
-name: Português
title:
archive: Arquivo
category: Categoria
@@ -25,18 +24,28 @@ post:
modified: Updated at
edit: Edit this post
in: Em
+ more: more
read_more: Leia mais
untitled: Sem título
sticky: Sticky
+ toc_empty: Este post não possui tabela de conteúdo
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: Totalmente
+ tags: tags
footer:
powered: "Feito com %s"
+ theme: Tema
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d posts no total."
state:
posts: Posts
+ pages: Páginas
tags: Tags
categories: Categorias
search:
@@ -74,10 +84,7 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Página anterior
diff --git a/languages/pt.yml b/languages/pt.yml
index 49f5ccc440..aaa02170f3 100644
--- a/languages/pt.yml
+++ b/languages/pt.yml
@@ -1,5 +1,4 @@
---
-name: Português
title:
archive: Arquivo
category: Categoria
@@ -25,18 +24,28 @@ post:
modified: Updated at
edit: Edit this post
in: Em
+ more: more
read_more: Ler mais
untitled: Sem título
sticky: Sticky
+ toc_empty: Esta publicação não possui uma tabela de conteúdo
views: Views
+ comments_count: Comments
related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
+page:
+ totally: Totalmente
+ tags: tags
footer:
powered: "Desenvolvido com amor com %s"
+ theme: Tema
total_views: Total Views
total_visitors: Total Visitors
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d publicações no total."
state:
posts: publicações
+ pages: páginas
tags: tags
categories: categorias
search:
@@ -74,10 +84,7 @@ reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Página anterior
diff --git a/languages/ru.yml b/languages/ru.yml
index 069f3015f0..0fa9be1eca 100644
--- a/languages/ru.yml
+++ b/languages/ru.yml
@@ -1,5 +1,4 @@
---
-name: Русский
title:
archive: Архив
category: Категория
@@ -25,18 +24,28 @@ post:
modified: Изменено
edit: Редактировать запись
in: в категории
+ more: more
read_more: Читать полностью
untitled: Без имени
sticky: Ссылка
+ toc_empty: Эта запись без оглавления
views: Просмотров
+ comments_count: Комментариев
related_posts: Похожие записи
+ copy_button: Скопировать
+ copy_success: Скопировано!
+ copy_failure: Ошибка копирования!
copyright:
author: Автор записи
link: Ссылка на запись
license_title: Информация об авторских правах
license_content: "Все записи на этом сайте защищены лицензией %s, если не указано дополнительно."
+page:
+ totally: Всего
+ tags: тэги
footer:
powered: "Генератор — %s"
+ theme: Тема
total_views: Всего просмотров
total_visitors: Всего посетителей
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d записей всего."
state:
posts: Архив
+ pages: Страницы
tags: Тэги
categories: Категории
search:
@@ -74,10 +84,7 @@ reward:
donate: Донат
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Добро пожаловать на другие мои издательские каналы
accessibility:
nav_toggle: Показать/скрыть меню
prev_page: Предыдущая страница
diff --git a/languages/tr.yml b/languages/tr.yml
index 056433d0d1..0008318248 100644
--- a/languages/tr.yml
+++ b/languages/tr.yml
@@ -1,5 +1,4 @@
---
-name: Türk
title:
archive: Arşiv
category: Kategori
@@ -25,18 +24,28 @@ post:
modified: Değiştirildi
edit: Bu gönderiyi düzenle
in: İçinde
+ more: daha fazla
read_more: Daha fazla oku
untitled: Başlıksız
sticky: Sabit
+ toc_empty: Bu gönderinin içindekiler kısmı yok
views: Görünümler
+ comments_count: Yorumlar
related_posts: İlgili Gönderiler
+ copy_button: Kopyala
+ copy_success: Kopyalandı
+ copy_failure: Kopyalanamadı
copyright:
author: Gönderiyi yazan
link: Gönderi bağlantısı
license_title: Telif Hakkı Bildirimi
license_content: "Bu blogdaki tüm makaleler aksi belirtilmediği sürece %s altında lisanslıdır."
+page:
+ totally: Toplamda
+ tags: etiketler
footer:
powered: "%s tarafından desteklenmektedir"
+ theme: Tema
total_views: Toplam görüntülenme
total_visitors: Toplam Ziyaretçi
counter:
@@ -54,6 +63,7 @@ counter:
other: "Toplamda %d gönderi."
state:
posts: gönderiler
+ pages: sayfalar
tags: etiketler
categories: kategoriler
search:
@@ -74,10 +84,7 @@ reward:
donate: Bağış
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Gezinti çubuğunu değiştir
prev_page: Önceki sayfa
diff --git a/languages/uk.yml b/languages/uk.yml
index c9abacaa3c..355ec896e6 100644
--- a/languages/uk.yml
+++ b/languages/uk.yml
@@ -1,5 +1,4 @@
---
-name: Український
title:
archive: Архів
category: Категорія
@@ -25,18 +24,28 @@ post:
modified: Змінено
edit: Редагувати запис
in: в категорії
+ more: more
read_more: Читати повністю
untitled: Без імені
sticky: Посилання
+ toc_empty: Цей запис без змісту
views: Переглядів
+ comments_count: Коментарів
related_posts: Схожі записи
+ copy_button: Скопіювати
+ copy_success: Скопійовано!
+ copy_failure: Помилка копіювання!
copyright:
author: Автор запису
link: Посилання на запис
license_title: Інформація про авторські права
license_content: "Всі записи на цьому сайті захищені ліцензією %s, якщо не вказано додатково."
+page:
+ totally: Всього
+ tags: теги
footer:
powered: "Генератор — %s"
+ theme: Тема
total_views: Всього переглядів
total_visitors: Всього відвідувачів
counter:
@@ -54,6 +63,7 @@ counter:
other: "%d записів всього."
state:
posts: Архів
+ pages: Сторінки
tags: Теги
categories: Категорії
search:
@@ -74,10 +84,7 @@ reward:
donate: Донат
wechatpay: WeChat Pay
alipay: Alipay
- paypal: PayPal
bitcoin: Bitcoin
-follow_me:
- welcome: Мої інші видавничі канали
accessibility:
nav_toggle: Показати/приховати меню
prev_page: Попередня сторінка
diff --git a/languages/vi.yml b/languages/vi.yml
index fc93594e9f..e9bcffafda 100644
--- a/languages/vi.yml
+++ b/languages/vi.yml
@@ -1,5 +1,4 @@
---
-name: Tiếng Việt
title:
archive: Lưu Trữ
category: Phân Loại
@@ -14,31 +13,41 @@ menu:
search: Tìm Kiếm
schedule: Danh Mục
sitemap: Bản đồ trang
- commonweal: Commonwealth Act No. 404
+ commonweal: Commonweal 404
sidebar:
overview: Tổng Quan
toc: Mục Lục
post:
posted: Tạo lúc
- edited: Chỉnh sửa vào
+ edited: Edited on
created: Được tạo
modified: Được thay đổi
- edit: Chính sửa bài viết này
+ edit: Edit this post
in: Trong
+ more: thêm
read_more: Đọc tiếp
untitled: Không có tiêu đề
sticky: Đính
- views: Lượt xem
- related_posts: Các bài viết liên quan
+ toc_empty: Bài viết này không có mục lục
+ views: Views
+ comments_count: Comments
+ related_posts: Related Posts
+ copy_button: Copy
+ copy_success: Copied
+ copy_failure: Copy failed
copyright:
author: Người viết
link: Liên kết bài viết
license_title: Chú ý bản quyền
license_content: "Tất cả bài viết trong blog này được đăng ký bởi %s trừ khi có thông báo bổ sung."
+page:
+ totally: Toàn bộ
+ tags: thẻ
footer:
powered: "Cung cấp bởi %s"
- total_views: Tổng số người xem
- total_visitors: Tổng số truy cập
+ theme: Giao Diện
+ total_views: Total Views
+ total_visitors: Total Visitors
counter:
tag_cloud:
zero: Không có thẻ nào
@@ -54,6 +63,7 @@ counter:
other: "tổng số %d bài viết."
state:
posts: bài viết
+ pages: trang
tags: thẻ
categories: mục
search:
@@ -74,17 +84,14 @@ reward:
donate: Tài trợ
wechatpay: WeChat Pay
alipay: Alipay
- paypal: Paypal
bitcoin: Bitcoin
-follow_me:
- welcome: Xin chào mừng đến với các kênh khác của tôi
accessibility:
- nav_toggle: Thanh điều hướng chuyển đổi
+ nav_toggle: Toggle navigation bar
prev_page: Trang trước
next_page: Trang sau
symbols_count_time:
- count: Số biểu tượng trong bài viết
- count_total: Tổng số biểu tượng
- time: Thời lượng đọc
- time_total: Tổng thời lượng đọc
- time_minutes: phút.
+ count: Symbols count in article
+ count_total: Symbols count total
+ time: Reading time
+ time_total: Reading time total
+ time_minutes: mins.
diff --git a/languages/zh-CN.yml b/languages/zh-CN.yml
index 17ce437bec..bad532c5ce 100644
--- a/languages/zh-CN.yml
+++ b/languages/zh-CN.yml
@@ -1,5 +1,4 @@
---
-name: 简体中文
title:
archive: 归档
category: 分类
@@ -25,18 +24,28 @@ post:
modified: 修改时间
edit: 编辑
in: 分类于
+ more: 更多
read_more: 阅读全文
untitled: 未命名
sticky: 置顶
+ toc_empty: 此文章未包含目录
views: 阅读次数
+ comments_count: 评论数
related_posts: 相关文章
+ copy_button: 复制
+ copy_success: 复制成功
+ copy_failure: 复制失败
copyright:
author: 本文作者
link: 本文链接
license_title: 版权声明
license_content: "本博客所有文章除特别声明外,均采用 %s 许可协议。转载请注明出处!"
+page:
+ totally: 共有
+ tags: 标签
footer:
powered: "由 %s 强力驱动"
+ theme: 主题
total_views: 总访问量
total_visitors: 总访客量
counter:
@@ -54,6 +63,7 @@ counter:
other: "目前共计 %d 篇日志。"
state:
posts: 日志
+ pages: 页面
tags: 标签
categories: 分类
search:
@@ -74,10 +84,7 @@ reward:
donate: 打赏
wechatpay: 微信支付
alipay: 支付宝
- paypal: 贝宝
bitcoin: 比特币
-follow_me:
- welcome: 欢迎关注我的其它发布渠道
accessibility:
nav_toggle: 切换导航栏
prev_page: 上一页
diff --git a/languages/zh-HK.yml b/languages/zh-HK.yml
index 65de8d53c8..7ed3a67075 100644
--- a/languages/zh-HK.yml
+++ b/languages/zh-HK.yml
@@ -1,5 +1,4 @@
---
-name: 繁體中文(香港)
title:
archive: 歸檔
category: 分類
@@ -25,18 +24,28 @@ post:
modified: 修改時間
edit: 編輯
in: 分類於
+ more: 更多
read_more: 閱讀全文
untitled: 未命名
sticky: 置頂
+ toc_empty: 此文章未包含目錄
views: 閱讀次數
+ comments_count: 評論數
related_posts: 相關文章
+ copy_button: 複製
+ copy_success: 複製成功
+ copy_failure: 複製失敗
copyright:
author: 博主
link: 文章連結
license_title: 版權聲明
license_content: "本網誌所有文章除特別聲明外,均採用 %s 許可協議。轉載請註明出處!"
+page:
+ totally: 共有
+ tags: 標籤
footer:
powered: "由 %s 強力驅動"
+ theme: 主題
total_views: 總瀏覽次數
total_visitors: 訪客總數
counter:
@@ -54,6 +63,7 @@ counter:
other: "目前共有 %d 篇文章。"
state:
posts: 文章
+ pages: 頁面
tags: 標籤
categories: 分類
search:
@@ -74,10 +84,7 @@ reward:
donate: 打賞
wechatpay: 微信支付
alipay: 支付寶
- paypal: PayPal
bitcoin: 比特幣
-follow_me:
- welcome: 歡迎關注我的其它發布渠道
accessibility:
nav_toggle: 切換導航欄
prev_page: 上一頁
diff --git a/languages/zh-TW.yml b/languages/zh-TW.yml
index bfdc2f214d..b4a7ae2146 100644
--- a/languages/zh-TW.yml
+++ b/languages/zh-TW.yml
@@ -1,5 +1,4 @@
---
-name: 繁體中文
title:
archive: 歸檔
category: 分類
@@ -25,18 +24,28 @@ post:
modified: 修改時間
edit: 編輯
in: 分類於
+ more: 更多
read_more: 閱讀全文
untitled: 未命名
sticky: 置頂
+ toc_empty: 此文章沒有目錄
views: 閱讀次數
+ comments_count: 評論數
related_posts: 相關文章
+ copy_button: 複製
+ copy_success: 複製成功
+ copy_failure: 複製失敗
copyright:
author: 作者
link: 文章連結
license_title: 版權聲明
license_content: "本網誌所有文章除特別聲明外,均採用 %s 許可協議。轉載請註明出處!"
+page:
+ totally: 共有
+ tags: 標籤
footer:
powered: "由 %s 強力驅動"
+ theme: 主題
total_views: 總瀏覽次數
total_visitors: 訪客總數
counter:
@@ -54,6 +63,7 @@ counter:
other: "目前共有 %d 篇文章。"
state:
posts: 文章
+ pages: 頁面
tags: 標籤
categories: 分類
search:
@@ -74,10 +84,7 @@ reward:
donate: 捐贈
wechatpay: 微信支付
alipay: 支付寶
- paypal: PayPal
bitcoin: 比特幣
-follow_me:
- welcome: 歡迎關注我的其它發布渠道
accessibility:
nav_toggle: 切換導航欄
prev_page: 上一頁
diff --git a/layout/_custom/head.swig b/layout/_custom/head.swig
new file mode 100644
index 0000000000..6aed40d5e2
--- /dev/null
+++ b/layout/_custom/head.swig
@@ -0,0 +1,3 @@
+{#
+Custom head.
+#}
diff --git a/layout/_custom/header.swig b/layout/_custom/header.swig
new file mode 100644
index 0000000000..8b13789179
--- /dev/null
+++ b/layout/_custom/header.swig
@@ -0,0 +1 @@
+
diff --git a/layout/_custom/sidebar.swig b/layout/_custom/sidebar.swig
new file mode 100644
index 0000000000..8b13789179
--- /dev/null
+++ b/layout/_custom/sidebar.swig
@@ -0,0 +1 @@
+
diff --git a/layout/_layout.swig b/layout/_layout.swig
index f656d2a440..f3003fb870 100644
--- a/layout/_layout.swig
+++ b/layout/_layout.swig
@@ -1,40 +1,61 @@
-
+
+{# NexT version #}
+{% set version = next_env('version') %}
+
+{# Language & Config #}
+{% set title = __('title') !== 'title' && __('title') || config.title %}
+{% set subtitle = __('subtitle') !== 'subtitle' && __('subtitle') || config.subtitle %}
+{% set author = __('author') !== 'author' && __('author') || config.author %}
+{% set description = __('description') !== 'description' && __('description') || config.description %}
+
+{% set html_class = 'theme-next ' + theme.scheme %}
+{% if theme.motion.enable %}
+ {% set html_class = html_class + ' use-motion' %}
+{% endif %}
+
+
{{ partial('_partials/head/head.swig', {}, {cache: theme.cache.enable}) }}
{% include '_partials/head/head-unique.swig' %}
- {{- next_inject('head') }}
{% block title %}{% endblock %}
- {{ partial('_third-party/analytics/index.swig', {}, {cache: theme.cache.enable}) }}
+ {% include '_third-party/analytics/index.swig' %}
{{ partial('_scripts/noscript.swig', {}, {cache: theme.cache.enable}) }}
-
-
+
+
+ {% set container_class = 'container' %}
+ {% if theme.sidebar.position %}
+ {% set container_class = container_class + ' sidebar-position-' + theme.sidebar.position %}
+ {% endif %}
+
+