\n\n[NexT](https://theme-next.org) is an elegant and powerful theme for [Hexo](https://hexo.io/). With it, you can build a static blog hosted on [GitHub Pages](https://pages.github.com/) to share your life and communicate with new friends.\n\nA CODE_OF_CONDUCT dictates how conversation during code updates, issue communication, and pull requests should happen within [NexT](https://github.com/theme-next/hexo-theme-next) repository. We expect all users to show respect and courtesy to others through our repositories. Anyone violating these rules will not be reviewed and will be blocked and expelled from our repositories immediately upon discovery.\n\n## Table Of Contents\n\n- [Our Pledge](#our-pledge)\n- [Our Responsibilities](#our-responsibilities)\n- [Our Standards](#our-standards)\n- [Scope](#scope)\n- [Enforcement](#enforcement)\n- [Contacting Maintainers](#contacting-maintainers)\n- [Attribution](#attribution)\n\n## Our Pledge\n\nAs contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.\n\nIn the interest of fostering an open and welcoming environment, we are committed to making participation in our community a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual identity and orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.\n\n## Our Responsibilities\n\nProject maintainers have the right and responsibility to clarify the standards of acceptable behavior and are expected to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to block temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.\n\n## Our Standards\n\nAs a project on GitHub, this project is overed by the [GitHub Community Guidelines](https://help.github.com/articles/github-community-guidelines/). Additionally, as a project hosted on npm, it is covered by [npm Inc's Code of Conduct](https://www.npmjs.com/policies/conduct).\n\nExamples of behavior that contributes to creating a positive environment include:\n\n* Using welcoming and inclusive language.\n* Being respectful of differing viewpoints and experiences.\n* Gracefully accepting constructive feedback.\n* Focusing on what is best for the community.\n* Showing empathy and kindness towards other community members.\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others’ private information, such as a physical or electronic address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community.\n\nDepending on the violation, the maintainers may decide that violations of this code of conduct that have happened outside of the scope of the community may deem an individual unwelcome, and take appropriate action to maintain the comfort and safety of its members.\n\n## Enforcement\n\nIf you see a Code of Conduct violation, follow these steps:\n\n1. Let the person know that what they did is not appropriate and ask them to stop and/or edit their message(s) or commits. That person should immediately stop the behavior and correct the issue.\n2. If this doesn’t happen, or if you're uncomfortable speaking up, [contact the maintainers](#contacting-maintainers). When reporting, please include any relevant details, links, screenshots, context, or other information that may be used to better understand and resolve the situation.\n3. As soon as available, a maintainer will look into the issue, and take further action.\n\nOnce the maintainers get involved, they will follow a documented series of steps and do their best to preserve the well-being of project members.\n\nAll complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.\n\nThesehese are the steps maintainers will take for further enforcement, as needed:\n\n1. Repeat the request to stop.\n2. If the person doubles down, they will have offending messages removed or edited by a maintainers given an official warning. The PR or Issue may be locked.\n3. If the behavior continues or is repeated later, the person will be blocked from participating for 24 hours.\n4. If the behavior continues or is repeated after the temporary block, a long-term (6-12 months) ban will be used.\n\nOn top of this, maintainers may remove any offending messages, images, contributions, etc, as they deem necessary. Maintainers reserve full rights to skip any of these steps, at their discretion, if the violation is considered to be a serious and/or immediate threat to the well-being of members of the community. These include any threats, serious physical or verbal attacks, and other such behavior that would be completely unacceptable in any social setting that puts our members at risk.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.\n\n## Contacting Maintainers\n\nYou may get in touch with the maintainer team through any of the following methods:\n\n* Through Email:\n * [support@theme-next.org](mailto:support@theme-next.org)\n\n* Through Chat:\n * [Gitter](https://gitter.im/theme-next)\n * [Riot](https://riot.im/app/#/room/#NexT:matrix.org)\n * [Telegram](https://t.me/joinchat/GUNHXA-vZkgSMuimL1VmMw)\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/) and [WeAllJS Code of Conduct](https://wealljs.org/code-of-conduct).\n"
},
{
"path": ".github/CONTRIBUTING.md",
"content": "
\n\nFirst of all, thanks for taking your time to contribute and help make our project even better than it is today! The following is a set of guidelines for contributing to [Theme-Next](https://github.com/theme-next) and its libs submodules. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.\n\n## Table Of Contents\n\n[How Can I Contribute?](#how-can-i-contribute)\n\n * [Before Submitting An Issue](#before-submitting-an-issue)\n * [Read the docs](#read-the-docs)\n * [Quick debug instructions](quick-debug-instructions)\n * [Reporting Bugs](#reporting-bugs)\n * [Reporting Security Bugs](#reporting-security-bugs)\n * [Suggesting Enhancements](#suggesting-enhancements)\n * [Submitting a Pull Request](#submitting-a-pull-request)\n * [Creating Releases](#creating-releases)\n\n[Guides](#guides)\n\n * [Coding Rules](#coding-rules)\n * [Coding Standards](#coding-standards)\n * [Labels Rules](#labels-rules)\n * [Commit Messages Rules](#commit-messages-rules)\n\n## How Can I Contribute?\n\n### Before Submitting An Issue\n\n#### Read the docs\n\nIf 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).\n\nAlso, 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.\n\n#### Quick debug instructions\n\nBefore submitting an Issue on GitHub, you can follow the steps below to debug:\n\n* Execute `hexo clean`, clear the browser cache and disable all CDN services (e.g. Cloudflare Rocket Loader)\n* 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.\n* Upgrade theme NexT to the latest version.\n* Upgrade Hexo and Hexo plugins to the latest version.\n* Upgrade Node.js and `npm` to the latest version.\n* Uninstall all non-essential Hexo plugins, or reinstall all plugins using `npm install --save`.\n\nIf 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.\n\nIf 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.\n\n### Reporting Bugs\n\nBefore creating bug reports, 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 bug 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).\n\nFollowing these guidelines helps maintainers and the community understand your report :pencil:, reproduce the behavior, and find related reports:\n\n* Use a clear and descriptive title for the issue to identify the problem.\n* Provide more context by answering these questions:\n * Can you reproduce the problem? Can you reliably reproduce the issue? If not, provide details about how often the problem happens and under which conditions it normally happens.\n * Did the problem start happening recently or was this always a problem?\n * If the problem started happening recently, can you reproduce the problem in an older version of Next? What's the most recent version in which the problem doesn't happen? You can download older versions of Next from [the releases page](https://github.com/theme-next/hexo-theme-next/releases).\n * Which version of Node, Hexo and Next are you using? You can get the exact version by running `node -v`, `hexo version` in your terminal, or copy the contents in site's`package.json`.\n * Which packages do you have installed? You can get that list by copying the contents in site's`package.json`.\n* Describe the exact steps which reproduce the problem in as many details as possible. When listing steps, don't just say what you did, but explain how you did it, e.g. which command exactly you used. If you're providing snippets in the issue, use [Markdown code blocks](https://help.github.com/articles/creating-and-highlighting-code-blocks/) or [a permanent link to a code snippet](https://help.github.com/articles/creating-a-permanent-link-to-a-code-snippet/), or a [Gist link](https://gist.github.com/).\n* Provide specific examples to demonstrate the steps. Include links to files (screenshots or GIFs) or live demo.\n* Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.\n* Explain which behavior you expected to see instead and why.\n\n#### Reporting Security Bugs\n\nIf 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).\n\nWe 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.\n\n### Suggesting Enhancements\n\nBefore 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).\n\nFollowing these guidelines helps maintainers and the community understand your suggestion :pencil: and find related suggestions.\n\n* Use a clear and descriptive title for the issue to identify the suggestion.\n* Describe the current behavior and explain which behavior you expected to see instead and Explain why this enhancement would be useful to most users.\n* Provide specific examples to demonstrate the suggestion. Include links to files (screenshots or GIFs) or live demo.\n\n### Submitting a Pull Request\n\nBefore 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/).\n\nFollowing these guidelines helps maintainers and the community understand your pull request :pencil::\n\n* Follow our [Coding Rules](#coding-rules) and [commit message conventions](#commit-messages-rules).\n* Use a clear and descriptive title for the issue to identify the pull request. Do not include issue numbers in the PR title.\n* Fill in [the required template](PULL_REQUEST_TEMPLATE.md) as many details as possible.\n* 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.\n\n### Creating Releases\n\nReleases are a great way to ship projects on GitHub to your users.\n\n1. On GitHub, navigate to the main page of the repository. Under your repository name, click **Releases**. Click **Draft a new release**.\n2. Type a version number for your release. Versions are based on [Git tags](https://git-scm.com/book/en/Git-Basics-Tagging). We recommend naming tags that fit within [About Major and Minor NexT versions](https://github.com/theme-next/hexo-theme-next/issues/187).\n3. Select a branch that contains the project you want to release. Usually, you'll want to release against your `master` branch, unless you're releasing beta software.\n4. Type a title and description that describes your release.\n - Use the version as the title.\n - The types of changes include **Breaking Changes**, **Updates**, **Features**, and **Bug Fixes**. In the section of Breaking Changes, use multiple secondary headings, and use item list in other sections.\n - Use the passive tense and subject-less sentences.\n - All changes must be documented in release notes. If commits happen without pull request (minimal changes), just add this commit ID into release notes. If commits happen within pull request alreay, just add the related pull request ID including all possible commits.\n5. 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.\n6. 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.\n\n## Guides\n\n### Coding Rules\n\nThis 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.\n\n### Coding Standards\n\nWe 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.\n\n### Labels Rules\n\nWe use \"labels\" in the issue tracker to help classify Pull requests and Issues. Using labels enables maintainers and users to quickly find issues they should look into, either because they experience them, or because it meets their area of expertise.\n\nIf you are unsure what a label is about or which labels you should apply to a PR or issue, look no further!\n\nIssues related:\n\n- By types\n - `Bug`: A detected bug that needs to be confirmed\n - `Feature Request`: An issue that wants a new feature\n - `Question`: An issue about questions\n - `Meta`: Denoting a change of usage conditions\n - `Support`: An issue labeled as support requests\n - `Polls`: An issue that initiated a poll\n- By results\n - `Duplicate`: An issue which had been mentioned\n - `Irrelevant`: An irrelevant issue for Next\n - `Invalid`: An issue that cannot be reproduced\n - `Expected Behavior`: An issue that corresponds to expected behavior\n - `Need More Info`: Need more information for solving the issue\n - `Verified`: An issue that has been verified\n - `Solved`: An issue that has been solved\n - `Backlog`: An issue that is to be completed and later compensated\n - `Stale`: This issue has been automatically marked as stale because lack of recent activity\n\nPull requests related:\n\n- `Breaking Change`: A pull request that makes breaking change\n- `Bug Fix`: A pull request that fixes the related bug\n- `New Feature`: A pull request that provides a new feature\n- `Feature`: A pull request that provides an option or addition to existing feature\n- `i18n`: A pull request that makes new languages translation\n- `Work in Progress`: A pull request that is still working in progress\n- `Skip Release`: A pull request that should be excluded from release note\n\nBoth:\n\n- `Roadmap`: An issue / pull request about future development\n- `Help Wanted`: An issue / pull request that needs help\n- `Discussion`: An issue / pull request that needs to be discussed\n- `Improvement`: An issue that needs improvement or a pull request that improves NexT\n- `Performance`: An issue / pull request that improves the performance\n- `Hexo`: An issue / pull request related to Hexo or Hexo plugins\n- `Template Engine`: An issue / pull request related to template engine\n- `CSS`: An issue / pull request related to CSS\n- `Fonts`: An issue / pull request related to fonts\n- `PJAX`: An issue / pull request related to PJAX\n- `3rd Party Plugin`: An issue / pull request related to 3rd party plugins & service\n- `Docs`: An issue / pull request related to instruction document\n- `Configurations`: An issue / pull request related to configurations\n\n### Commit Messages Rules\n\nWe have very precise rules over how our git commit messages can be formatted. Each commit message consists of a `type` and a `subject`. This leads to more\nreadable messages that are easy to follow when looking through the project history.\n\n- `type` describes the meaning of this commit including but not limited to the following items, and capitalize the first letter.\n * `Build`: Changes that affect the build system or external dependencies\n * `Ci`: Changes to our CI configuration files and scripts\n * `Docs`: Documentation only changes\n * `Feat`: A new feature\n * `Fix`: A bug fix\n * `Perf`: A code change that improves performance\n * `Refactor`: A code change that neither fixes a bug nor adds a feature\n * `Style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)\n * `Revert`: Revert some existing commits\n * `Release`: Commit a release for a conventional changelog project\n- The `subject` contains a succinct description of the change, like `Update code highlighting in readme.md`.\n * No dot (.) at the end.\n * Use the imperative, present tense: \"change\" not \"changed\" nor \"changes\".\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug-report.md",
"content": "---\nname: Bug Report\nabout: Something isn't working as expected\ntitle: ''\nlabels: Bug\nassignees: ''\n\n---\n\nPlease follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.\n请按照此 Issue 模版提供相关信息，例如源码仓库、博客链接和屏幕截图，这将有助于我们进行调查。\n\n## Issue Checklist \n\n\n- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.\n- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).\n- [ ] 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.\n\n***\n\n## Expected behavior \n\n\n## Actual behavior \n\n\n- Links to demo site with this issue: N/A\n- Links to repository or source code of the blog: N/A\n\n\n## Steps to reproduce the behavior \n1. N/A\n2. N/A\n3. N/A\n\n\n## Environment Information\n\n### Node.js and NPM Information\n\n```\n\n```\n\n### Package dependencies Information\n\n```\n\n```\n\n### Hexo Configuration\n\n```yml\n\n```\n\n### NexT Configuration\n\n```yml\n\n```\n\n## Other Information \n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature-request.md",
"content": "---\nname: Feature Request\nabout: Suggest an idea for this project\ntitle: ''\nlabels: Feature Request\nassignees: ''\n\n---\n\nPlease follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.\n请按照此 Issue 模版提供相关信息，例如源码仓库、博客链接和屏幕截图，这将有助于我们进行调查。\n\n## Issue Checklist \n\n\n- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.\n- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).\n- [ ] 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.\n\n***\n\n## Expected behavior \n\n\n## Actual behavior \n\n\n- Links to demo site with this feature: N/A\n- Links to repository or source code of the blog: N/A\n\n\n## Steps to reproduce the behavior \n1. N/A\n2. N/A\n3. N/A\n\n## Other Information \n"
},
{
"path": ".github/ISSUE_TEMPLATE/other.md",
"content": "---\nname: Other\nabout: Not a question, feature request or bug report\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\nPlease follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.\n请按照此 Issue 模版提供相关信息，例如源码仓库、博客链接和屏幕截图，这将有助于我们进行调查。\n\n## Issue Checklist \n\n\n- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.\n- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).\n- [ ] 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.\n\n***\n\n## Other Information \n"
},
{
"path": ".github/ISSUE_TEMPLATE/question.md",
"content": "---\nname: Question\nabout: I have a question for NexT (e.g. Customize)\ntitle: ''\nlabels: Custom\nassignees: ''\n\n---\n\nPlease follow this Issue template to provide relevant information, such as source code repositories, blog links, and screenshots, which will help us investigate.\n请按照此 Issue 模版提供相关信息，例如源码仓库、博客链接和屏幕截图，这将有助于我们进行调查。\n\n## Issue Checklist \n\n\n- [ ] I am using [the latest](https://github.com/theme-next/hexo-theme-next/releases/latest) version of NexT.\n- [ ] I have read the relevant documents of [Hexo](https://hexo.io/docs/) and [NexT](https://theme-next.org/docs/).\n- [ ] 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.\n\n***\n\n## Expected behavior \n\n\n## Actual behavior \n\n\n- Links to demo site with this issue: N/A\n- Links to repository or source code of the blog: N/A\n\n\n## Steps to reproduce the behavior \n1. N/A\n2. N/A\n3. N/A\n\n\n## Environment Information\n\n### Node.js and NPM Information\n\n```\n\n```\n\n### Package dependencies Information\n\n```\n\n```\n\n### Hexo Configuration\n\n```yml\n\n```\n\n### NexT Configuration\n\n```yml\n\n```\n\n## Other Information \n"
},
{
"path": ".github/PULL_REQUEST_TEMPLATE.md",
"content": "\n\n## PR Checklist \n\n\n- [ ] The commit message follows [guidelines for NexT](https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md).\n- [ ] Tests for the changes was maked (for bug fixes / features).\n - [ ] Muse | Mist have been tested.\n - [ ] Pisces | Gemini have been tested.\n- [ ] [Docs](https://github.com/theme-next/theme-next.org/tree/source/source/docs) in [NexT website](https://theme-next.org/docs/) have been added / updated (for features).\n\n\n## PR Type\n\n\n- [ ] Bugfix.\n- [ ] Feature.\n- [ ] Code style update (formatting, local variables).\n- [ ] Refactoring (no functional changes, no api changes).\n- [ ] Build & CI related changes.\n- [ ] Documentation.\n- [ ] Translation. \n- [ ] Other... Please describe:\n\n## What is the current behavior?\n\n\nIssue resolved: N/A\n\n## What is the new behavior?\n\n\n- Screenshots with this changes: N/A\n- Link to demo site with this changes: N/A\n\n### How to use?\nIn NexT `_config.yml`:\n```yml\n\n```\n"
},
{
"path": ".github/config.yml",
"content": "# =============================================================================================== #\n# Configuration for welcome - https://github.com/behaviorbot/welcome\n\n# Comment to be posted to on first time issues\nnewIssueWelcomeComment: >\n Thanks for opening this issue, maintainers will get back to you as soon as possible!\n\n# Comment to be posted to on PRs from first time contributors in your repository\nnewPRWelcomeComment: >\n Thanks so much for opening your first PR here!\n\n# Comment to be posted to on pull requests merged by a first time user\nfirstPRMergeComment: >\n Congrats on merging your first pull request here! :tada: How awesome!\n\n# =============================================================================================== #\n# Configuration for request-info - https://github.com/behaviorbot/request-info\n\n# *OPTIONAL* Label to be added to Issues and Pull Requests with insufficient information given\nrequestInfoLabelToAdd: Need More Info\n\n# *OPTIONAL* Add a list of people whose Issues/PRs will not be commented on\n# keys must be GitHub usernames\nrequestInfoUserstoExclude:\n - 1v9\n - Acris\n - flashlab\n - geekrainy\n - iissnan\n - ivan-nginx\n - JiangTJ\n - LEAFERx\n - liolok\n - maple3142\n - Raincal\n - sli1989\n - stevenjoezhang\n - tsanie\n - wafer-li\n\n# =============================================================================================== #\nlockThreads:\n toxicityThreshold: .7\n numComments: 2\n setTimeInHours: 72\n replyComment: >\n This thread is being locked due to exceeding the toxicity minimums. cc/ @theme-next/next\n"
},
{
"path": ".github/issue-close-app.yml",
"content": "# Comment that will be sent if an issue is judged to be closed.\ncomment: \"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).\"\nissueConfigs:\n# There can be several configs for different kind of issues.\n- content:\n - \"Issue Checklist\"\n# Optional configuration:\n#\n# whether the keywords are case-insensitive\n# default value is false, which means keywords are case-sensitive\ncaseInsensitive: true\n# the label that will be added when the bot close an issue\n# The bot will only add a label if this property is set.\nlabel: \"Invalid\"\n# The issue is judged to be legal if it includes all keywords from any of these two configs.\n# Or it will be closed by the app.\n"
},
{
"path": ".github/issue_label_bot.yaml",
"content": "label-alias:\n bug: 'Bug'\n feature_request: 'Feature Request'\n question: 'Question'\n"
},
{
"path": ".github/lock.yml",
"content": "# Configuration for Lock Threads - https://github.com/dessant/lock-threads\n\n# Number of days of inactivity before a closed issue or pull request is locked\ndaysUntilLock: 365\n\n# Skip issues and pull requests created before a given timestamp. Timestamp must\n# follow ISO 8601 (`YYYY-MM-DD`). Set to `false` to disable\nskipCreatedBefore: false\n\n# Issues and pull requests with these labels will be ignored. Set to `[]` to disable\nexemptLabels: []\n\n# Label to add before locking, such as `outdated`. Set to `false` to disable\nlockLabel: false\n\n# Comment to post before locking. Set to `false` to disable\nlockComment: >\n This thread has been automatically locked since there has not been\n any recent activity after it was closed. It is possible issue was\n solved or at least outdated. Feel free to open new for related bugs.\n\n# Assign `resolved` as the reason for locking. Set to `false` to disable\nsetLockReason: true\n\n# Limit to only `issues` or `pulls`\nonly: issues\n\n# Optionally, specify configuration settings just for `issues` or `pulls`\n# issues:\n# exemptLabels:\n# - help-wanted\n# lockLabel: outdated\n\n# pulls:\n# daysUntilLock: 30\n\n# Repository to extend settings from\n# _extends: repo\n"
},
{
"path": ".github/mergeable.yml",
"content": "# Configuration for Mergeable - https://github.com/jusx/mergeable\n\nversion: 2\nmergeable:\n - when: pull_request.*\n validate:\n - do: description\n no_empty:\n enabled: false\n\n - do: title\n must_exclude:\n regex: ^\\[WIP\\]\n\n - do: label\n must_include:\n regex: 'change|feat|imp|fix|doc|i18n'\n must_exclude:\n regex: 'wip|work in progress'\n\n #- do: project\n # no_empty:\n # enabled: true\n # must_include:\n # regex: 'change|feat|imp|fix|doc|loc'\n\n - do: milestone\n no_empty:\n enabled: true\n"
},
{
"path": ".github/release-drafter.yml",
"content": "# Configuration for Release Drafter - https://github.com/toolmantim/release-drafter\n\nname-template: 'v$NEXT_MINOR_VERSION'\ntag-template: 'v$NEXT_MINOR_VERSION'\ncategories:\n - title: '💥 Breaking Changes'\n label: '💥 Breaking Change'\n\n - title: '🌟 New Features'\n label: '🌟 New Feature'\n\n - title: '⭐ Features'\n label: '⭐ Feature'\n\n - title: '🐞 Bug Fixes'\n label: '🐞 Bug Fix'\n\n - title: '🛠 Improvements'\n label: '🛠 Improvement'\n\n - title: '🌀 External Changes'\n label: '🔌 3rd Party Plugin'\n\n - title: '📖 Documentation'\n label: '📖 Docs'\n\n - title: '🌍 Localization'\n label: '🌍 i18n'\n\nchange-template: '- $TITLE (#$NUMBER)'\nno-changes-template: '- No changes'\ntemplate: |\n $CHANGES\n\n ***\n\n 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)\n\nexclude-labels:\n - 'Skip Release'\n"
},
{
"path": ".github/stale.yml",
"content": "# Configuration for probot-stale - https://github.com/probot/stale\n\n# Number of days of inactivity before an Issue or Pull Request becomes stale\ndaysUntilStale: 30\n# Number of days of inactivity before a stale Issue or Pull Request is closed\ndaysUntilClose: 7\n# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable\nexemptLabels:\n - Bug\n - Feature Request\n - Discussion\n - Help Wanted\n - Question\n# Label to use when marking as stale\nstaleLabel: stale\n# Comment to post when marking as stale. Set to `false` to disable\nmarkComment: >\n This issue has been automatically marked as stale because lack of\n recent activity. It will be closed if no further activity occurs. Thank you\n for your contributions. You can also use our [support channels](https://github.com/theme-next/hexo-theme-next#feedback) to get help with the project.\n# Comment to post when removing the stale label. Set to `false` to disable\nunmarkComment: false\n# Comment to post when closing a stale Issue or Pull Request. Set to `false` to disable\ncloseComment: false\n# Limit to only `issues` or `pulls`\nonly: issues\n"
},
{
"path": ".github/support.yml",
"content": "# Configuration for Support Requests - https://github.com/dessant/support-requests\n\n# Label used to mark issues as support requests\nsupportLabel: Support\n\n# Comment to post on issues marked as support requests, `{issue-author}` is an\n# optional placeholder. Set to `false` to disable\nsupportComment: >\n :wave: @{issue-author}, we use the issue tracker exclusively for bug reports\n and feature requests. However, this issue appears to be a support request.\n Please use our [support channels](https://github.com/theme-next/hexo-theme-next/tree/master#feedback) to get help with the project.\n\n# Close issues marked as support requests\nclose: true\n\n# Lock issues marked as support requests\nlock: false\n\n# Assign `off-topic` as the reason for locking. Set to `false` to disable\nsetLockReason: true\n\n# Repository to extend settings from\n# _extends: repo\n"
},
{
"path": ".gitignore",
"content": ".DS_Store\n.idea/\n*.log\n*.iml\nyarn.lock\npackage-lock.json\nnode_modules/\n\n# Ignore optional external libraries\nsource/lib/*\n\n# Track internal libraries & Ignore unused verdors files\n!source/lib/font-awesome/\n!source/lib/anime.min.js\n!source/lib/velocity/\n"
},
{
"path": ".stylintrc",
"content": "{\n \"blocks\": false,\n \"brackets\": \"always\",\n \"colons\": \"always\",\n \"colors\": \"always\",\n \"commaSpace\": \"always\",\n \"commentSpace\": \"always\",\n \"cssLiteral\": \"never\",\n \"customProperties\": [],\n \"depthLimit\": false,\n \"duplicates\": true,\n \"efficient\": \"always\",\n \"exclude\": [],\n \"extendPref\": false,\n \"globalDupe\": false,\n \"groupOutputByFile\": true,\n \"indentPref\": false,\n \"leadingZero\": \"never\",\n \"maxErrors\": false,\n \"maxWarnings\": false,\n \"mixed\": false,\n \"mixins\": [],\n \"namingConvention\": \"lowercase-dash\",\n \"namingConventionStrict\": false,\n \"none\": \"never\",\n \"noImportant\": true,\n \"parenSpace\": false,\n \"placeholders\": \"always\",\n \"prefixVarsWithDollar\": \"always\",\n \"quotePref\": false,\n \"reporterOptions\": {\n \"columns\": [\"lineData\", \"severity\", \"description\", \"rule\"],\n \"columnSplitter\": \" \",\n \"showHeaders\": false,\n \"truncate\": true\n },\n \"semicolons\": \"always\",\n \"sortOrder\": \"alphabetical\",\n \"stackedProperties\": false,\n \"trailingWhitespace\": \"never\",\n \"universal\": false,\n \"valid\": true,\n \"zeroUnits\": \"never\",\n \"zIndexNormalize\": false\n}\n"
},
{
"path": ".travis.yml",
"content": "language: node_js\n\nnode_js: node\n\ncache:\n npm: true\n\ninstall: npm install\n"
},
{
"path": "LICENSE.md",
"content": "#
Detail attribution information for «NexT» \n is contained in the 'docs/AUTHORS.md' file.
\n\n This program is free software; you can redistribute it and/or modify\nit under the terms of the [GNU Affero General Public License version 3][AGPL3]\nas published by the Free Software Foundation with the addition of the\nfollowing permission added to [Section 15][AGPL3-15] as permitted in [Section 7(a)][AGPL3-7]:\nFOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY «NEXT»,\n«NEXT» DISCLAIMS THE WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.\n\n This program is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\nor FITNESS FOR A PARTICULAR PURPOSE.\nSee the GNU Affero General Public License for more details.\nYou should have received a copy of the GNU Affero General Public License\nalong with this program; if not, see: https://www.gnu.org/licenses/agpl.txt\n\n In accordance with [Section 7(b)][AGPL3-7] of the GNU Affero General Public License:\n\n* a) It is not necessary to specify copyright in each source file of\n this program because GitHub fully save commits of all modified files\n with their authors and provides to see for this changes publicly.\n\n* b) For any part of the covered work in which the copyright not specified,\n except of third party libraries ('[source/lib/*](source/lib)') and '\\*custom.\\*' files,\n will mean this part owned by «NexT» in accord with terms in this file.\n\n* c) A covered work must retain «NexT» official website link\n (https://theme-next.org) in footer section of every website created,\n modified or manipulated by using «NexT».\n «NexT» theme configuration must be:\n ```yml\n footer:\n theme:\n enable: true\n ```\n Collaborators, best contributors and all authors specified in the\n '[docs/AUTHORS.md][AUTHORS]' file of «NexT» repository under the\n 'https://github.com/theme-next' organization can ignore theme info link\n requirements.\n\nAnyone can be released from the requirements of the license by purchasing\na commercial license. Buying such a license is mandatory as soon as you\ndevelop commercial activities involving the «NexT» software without\ndisclosing the source code of your own applications.\nThese activities include:\n 1. Access to private repository with various premium features.\n 2. Priority support for resolve all possible issues with «NexT».\n 3. Priority support for implement all possible features to «NexT».\n\n For more information, please contact «NexT» Organization at this\naddress: support@theme-next.org\n\n
\n\n## Installation\n\nThe simplest way to install is to clone the entire repository:\n\n```sh\n$ cd hexo\n$ git clone https://github.com/theme-next/hexo-theme-next themes/next\n```\n\nOr you can see [detailed installation instructions][docs-installation-url] if you want any other variant.\n\n## Plugins\n\nNexT supports a large number of third-party plugins, which can be easily configured.\n\nFor example, if you want to enable `pjax` on your site, just set `pjax` to `true` in NexT config file:\n\n```yml\n# Easily enable fast Ajax navigation on your website.\n# Dependencies: https://github.com/theme-next/theme-next-pjax\npjax: true\n```\n\nThen visit the «Dependencies» link to get the installation instructions of this module.\n\n### Configure CDN\n\nIf you want to specify a CDN link for any plugins, you need to set / update the CDN link.\n\nFor example, if you want to use `mediumzoom` and load the plugin via CDN, go to NexT config and see:\n\n```yml\nvendors:\n # ...\n # Some contents...\n # ...\n mediumzoom: # Set or update mediumzoom CDN URL.\n```\n\n## Update\n\nNexT releases new versions every month. You can update to latest master branch by the following command:\n\n```sh\n$ cd themes/next\n$ git pull\n```\n\nAnd 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.\\\nHowever, 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.\n\n**If you want to update from v5.1.x to the latest version, read [this][docs-update-5-1-x-url].**\n\n## Feedback\n\n* Visit the [Awesome NexT][awesome-next-url] list to share plugins and tutorials with other users.\n* Join our [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] chats.\n* [Add or improve translation][i18n-url] in few seconds.\n* Report a bug in [GitHub Issues][issues-bug-url].\n* Request a new feature on [GitHub][issues-feat-url].\n* Vote for [popular feature requests][feat-req-vote-url].\n\n## Contributing\n\nWe welcome you to join the development of NexT. Please see [contributing document][contributing-document-url]. 🤗\n\nAlso, we welcome Issue or PR to our [official-plugins][official-plugins-url].\n\n## Contributors\n\n[![][contributors-image]][contributors-url]\n\n## Thanks\n\n
\n «NexT» send special thanks to these great services that sponsor our core infrastructure:\n \n \n \n \n \n \n \n GitHub allows us to host the Git repository, Netlify allows us to distribute the documentation.\n \n \n \n \n \n Crowdin allows us to translate conveniently the documentation.\n \n \n \n \n \n \n \n Codacy allows us to monitor code quality, Travis CI allows us to run the test suite.\n
\n\n[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md\n[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/DATA-FILES.md\n[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md\n\n[t-news-url]: https://t.me/theme_next_news\n[t-chat-url]: https://t.me/theme_next\n[gitter-url]: https://gitter.im/theme-next\n[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org\n[i18n-url]: https://i18n.theme-next.org\n\n[awesome-next-url]: https://github.com/theme-next/awesome-next\n[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md\n[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md\n[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22\n\n[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md\n[official-plugins-url]: https://github.com/theme-next\n[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890\n[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors\n"
},
{
"path": "_config.yml",
"content": "# ---------------------------------------------------------------\n# Theme Core Configuration Settings\n# See: https://theme-next.org/docs/theme-settings/\n# ---------------------------------------------------------------\n\n# If false, merge configs from `_data/next.yml` into default configuration (rewrite).\n# If true, will fully override default configuration by options from `_data/next.yml` (override). Only for NexT settings.\n# 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.\n# Useful if you want to comment some options from NexT `_config.yml` by `next.yml` without editing default config.\noverride: false\n\n# Console reminder if new version released.\nreminder: false\n\n# Allow to cache content generation. Introduced in NexT v6.0.0.\ncache:\n enable: true\n\n# Remove unnecessary files after hexo generate.\nminify: false\n\n# Define custom file paths.\n# Create your custom files in site directory `source/_data` and uncomment needed files below.\ncustom_file_path:\n #head: source/_data/head.swig\n #header: source/_data/header.swig\n #sidebar: source/_data/sidebar.swig\n #postMeta: source/_data/post-meta.swig\n #postBodyEnd: source/_data/post-body-end.swig\n #footer: source/_data/footer.swig\n #bodyEnd: source/_data/body-end.swig\n #variable: source/_data/variables.styl\n #mixin: source/_data/mixins.styl\n #style: source/_data/styles.styl\n\n\n# ---------------------------------------------------------------\n# Site Information Settings\n# See: https://theme-next.org/docs/getting-started/\n# ---------------------------------------------------------------\n\nfavicon:\n small: /images/favicon-16x16-next.png\n medium: /images/favicon-32x32-next.png\n apple_touch_icon: /images/apple-touch-icon-next.png\n safari_pinned_tab: /images/logo.svg\n #android_manifest: /images/manifest.json\n #ms_browserconfig: /images/browserconfig.xml\n\n# Show multilingual switcher in footer.\nlanguage_switcher: false\n\nfooter:\n # Specify the date when the site was setup. If not defined, current year will be used.\n #since: 2015\n\n # Icon between year and copyright info.\n icon:\n # Icon name in Font Awesome. See: https://fontawesome.com/icons\n name: fa fa-heart\n # If you want to animate the icon, set it to true.\n animated: false\n # Change the color of icon, using Hex Code.\n color: \"#ff0000\"\n\n # If not defined, `author` from Hexo `_config.yml` will be used.\n copyright:\n\n # Powered by Hexo & NexT\n powered: true\n\n # Beian ICP and gongan information for Chinese users. See: https://beian.miit.gov.cn, http://www.beian.gov.cn\n beian:\n enable: false\n icp:\n # The digit in the num of gongan beian.\n gongan_id:\n # The full num of gongan beian.\n gongan_num:\n # The icon for gongan beian. See: http://www.beian.gov.cn/portal/download\n gongan_icon_url:\n\n# Creative Commons 4.0 International License.\n# See: https://creativecommons.org/share-your-work/licensing-types-examples\n# Available values of license: by | by-nc | by-nc-nd | by-nc-sa | by-nd | by-sa | zero\n# You can set a language value if you prefer a translated version of CC license, e.g. deed.zh\n# CC licenses are available in 39 languages, you can find the specific and correct abbreviation you need on https://creativecommons.org\ncreative_commons:\n license: by-nc-sa\n sidebar: false\n post: false\n language:\n\n\n# ---------------------------------------------------------------\n# Scheme Settings\n# ---------------------------------------------------------------\n\n# Schemes\nscheme: Muse\n#scheme: Mist\n#scheme: Pisces\n#scheme: Gemini\n\n# Dark Mode\ndarkmode: false\n\n\n# ---------------------------------------------------------------\n# Menu Settings\n# ---------------------------------------------------------------\n\n# Usage: `Key: /link/ || icon`\n# 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.\n# Value before `||` delimiter is the target link, value after `||` delimiter is the name of Font Awesome icon.\n# When running the site in a subdirectory (e.g. yoursite.com/blog), remove the leading slash from link value (/archives -> archives).\n# External url should start with http:// or https://\nmenu:\n home: / || fa fa-home\n #about: /about/ || fa fa-user\n #tags: /tags/ || fa fa-tags\n #categories: /categories/ || fa fa-th\n archives: /archives/ || fa fa-archive\n #schedule: /schedule/ || fa fa-calendar\n #sitemap: /sitemap.xml || fa fa-sitemap\n #commonweal: /404/ || fa fa-heartbeat\n\n# Enable / Disable menu icons / item badges.\nmenu_settings:\n icons: true\n badges: false\n\n\n# ---------------------------------------------------------------\n# Sidebar Settings\n# See: https://theme-next.org/docs/theme-settings/sidebar\n# ---------------------------------------------------------------\n\nsidebar:\n # Sidebar Position.\n position: left\n #position: right\n\n # Manual define the sidebar width. If commented, will be default for:\n # Muse | Mist: 320\n # Pisces | Gemini: 240\n #width: 300\n\n # Sidebar Display (only for Muse | Mist), available values:\n # - post expand on posts automatically. Default.\n # - always expand for all pages automatically.\n # - hide expand only when click on the sidebar toggle icon.\n # - remove totally remove sidebar including sidebar toggle.\n display: post\n\n # Sidebar padding in pixels.\n padding: 18\n # Sidebar offset from top menubar in pixels (only for Pisces | Gemini).\n offset: 12\n # Enable sidebar on narrow view (only for Muse | Mist).\n onmobile: false\n\n# Sidebar Avatar\navatar:\n # Replace the default image and set the url here.\n url: #/images/avatar.gif\n # If true, the avatar will be dispalyed in circle.\n rounded: false\n # If true, the avatar will be rotated with the cursor.\n rotated: false\n\n# Posts / Categories / Tags in sidebar.\nsite_state: true\n\n# Social Links\n# Usage: `Key: permalink || icon`\n# Key is the link label showing to end users.\n# Value before `||` delimiter is the target permalink, value after `||` delimiter is the name of Font Awesome icon.\nsocial:\n #GitHub: https://github.com/yourname || fab fa-github\n #E-Mail: mailto:yourname@gmail.com || fa fa-envelope\n #Weibo: https://weibo.com/yourname || fab fa-weibo\n #Google: https://plus.google.com/yourname || fab fa-google\n #Twitter: https://twitter.com/yourname || fab fa-twitter\n #FB Page: https://www.facebook.com/yourname || fab fa-facebook\n #StackOverflow: https://stackoverflow.com/yourname || fab fa-stack-overflow\n #YouTube: https://youtube.com/yourname || fab fa-youtube\n #Instagram: https://instagram.com/yourname || fab fa-instagram\n #Skype: skype:yourname?call|chat || fab fa-skype\n\nsocial_icons:\n enable: true\n icons_only: false\n transition: false\n\n# Blog rolls\nlinks_settings:\n icon: fa fa-link\n title: Links\n # Available values: block | inline\n layout: block\n\nlinks:\n #Title: http://yoursite.com\n\n# Table of Contents in the Sidebar\n# Front-matter variable (unsupport wrap expand_all).\ntoc:\n enable: true\n # Automatically add list number to toc.\n number: true\n # If true, all words will placed on next lines if header width longer then sidebar width.\n wrap: false\n # If true, all level of TOC in a post will be displayed, rather than the activated part of it.\n expand_all: false\n # Maximum heading depth of generated toc.\n max_depth: 6\n\n# A button to open designated chat widget in sidebar.\n# Firstly, you need enable the chat service you want to activate its sidebar button.\nchat:\n enable: false\n #service: chatra\n #service: tidio\n icon: fa fa-comment # Icon name in Font Awesome, set false to disable icon.\n text: Chat # Button text, change it as you wish.\n\n\n# ---------------------------------------------------------------\n# Post Settings\n# See: https://theme-next.org/docs/theme-settings/posts\n# ---------------------------------------------------------------\n\n# Automatically excerpt description in homepage as preamble text.\nexcerpt_description: true\n\n# Read more button\n# If true, the read more button will be displayed in excerpt section.\nread_more_btn: true\n\n# Post meta display settings\npost_meta:\n item_text: true\n created_at: true\n updated_at:\n enable: true\n another_day: true\n categories: true\n\n# Post wordcount display settings\n# Dependencies: https://github.com/theme-next/hexo-symbols-count-time\nsymbols_count_time:\n separated_meta: true\n item_text_post: true\n item_text_total: false\n\n# Use icon instead of the symbol # to indicate the tag at the bottom of the post\ntag_icon: false\n\n# Reward (Donate)\n# Front-matter variable (unsupport animation).\nreward_settings:\n # If true, reward will be displayed in every article by default.\n enable: false\n animation: false\n #comment: Donate comment here.\n\nreward:\n #wechatpay: /images/wechatpay.png\n #alipay: /images/alipay.png\n #paypal: /images/paypal.png\n #bitcoin: /images/bitcoin.png\n\n# Subscribe through Telegram Channel, Twitter, etc.\n# Usage: `Key: permalink || icon` (Font Awesome)\nfollow_me:\n #Twitter: https://twitter.com/username || fab fa-twitter\n #Telegram: https://t.me/channel_name || fab fa-telegram\n #WeChat: /images/wechat_channel.jpg || fab fa-weixin\n #RSS: /atom.xml || fa fa-rss\n\n# Related popular posts\n# Dependencies: https://github.com/tea3/hexo-related-popular-posts\nrelated_posts:\n enable: false\n title: # Custom header, leave empty to use the default one\n display_in_home: false\n params:\n maxCount: 5\n #PPMixingRate: 0.0\n #isDate: false\n #isImage: false\n #isExcerpt: false\n\n# Post edit\n# Dependencies: https://github.com/hexojs/hexo-deployer-git\npost_edit:\n enable: false\n url: https://github.com/user-name/repo-name/tree/branch-name/subdirectory-name # Link for view source\n #url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name # Link for fork & edit\n\n# Show previous post and next post in post footer if exists\n# Available values: left | right | false\npost_navigation: left\n\n\n# ---------------------------------------------------------------\n# Custom Page Settings\n# See: https://theme-next.org/docs/theme-settings/custom-pages\n# ---------------------------------------------------------------\n\n# TagCloud settings for tags page.\ntagcloud:\n # All values below are same as default, change them by yourself.\n min: 12 # Minimun font size in px\n max: 30 # Maxium font size in px\n start: \"#ccc\" # Start color (hex, rgba, hsla or color keywords)\n end: \"#111\" # End color (hex, rgba, hsla or color keywords)\n amount: 200 # Amount of tags, change it if you have more than 200 tags\n\n# Google Calendar\n# Share your recent schedule to others via calendar page.\ncalendar:\n calendar_id: # Your Google account E-Mail\n api_key: \n orderBy: startTime\n offsetMax: 24 # Time Range\n offsetMin: 4 # Time Range\n showDeleted: false\n singleEvents: true\n maxResults: 250\n\n\n# ---------------------------------------------------------------\n# Misc Theme Settings\n# ---------------------------------------------------------------\n\n# Set the text alignment in posts / pages.\ntext_align:\n # Available values: start | end | left | right | center | justify | justify-all | match-parent\n desktop: justify\n mobile: justify\n\n# Reduce padding / margin indents on devices with narrow width.\nmobile_layout_economy: false\n\n# Android Chrome header panel color ($brand-bg / $headband-bg => $black-deep).\nandroid_chrome_color: \"#222\"\n\n# Custom Logo (Do not support scheme Mist)\ncustom_logo: #/uploads/custom-logo.jpg\n\ncodeblock:\n # Code Highlight theme\n # Available values: normal | night | night eighties | night blue | night bright | solarized | solarized dark | galactic\n # See: https://github.com/chriskempson/tomorrow-theme\n highlight_theme: normal\n # Add copy button on codeblock\n copy_button:\n enable: false\n # Show text copy result.\n show_result: false\n # Available values: default | flat | mac\n style:\n\nback2top:\n enable: true\n # Back to top in sidebar.\n sidebar: false\n # Scroll percent label in b2t button.\n scrollpercent: false\n\n# Reading progress bar\nreading_progress:\n enable: false\n # Available values: top | bottom\n position: top\n color: \"#37c6c0\"\n height: 3px\n\n# Bookmark Support\nbookmark:\n enable: false\n # Customize the color of the bookmark.\n color: \"#222\"\n # If auto, save the reading progress when closing the page or clicking the bookmark-icon.\n # If manual, only save it by clicking the bookmark-icon.\n save: auto\n\n# `Follow me on GitHub` banner in the top-right corner.\ngithub_banner:\n enable: false\n permalink: https://github.com/yourname\n title: Follow me on GitHub\n\n\n# ---------------------------------------------------------------\n# Font Settings\n# See: https://theme-next.org/docs/theme-settings/#Fonts-Customization\n# ---------------------------------------------------------------\n# Find fonts on Google Fonts (https://www.google.com/fonts)\n# All fonts set here will have the following styles:\n# light | light italic | normal | normal italic | bold | bold italic\n# Be aware that setting too much fonts will cause site running slowly\n# ---------------------------------------------------------------\n# To avoid space between header and sidebar in scheme Pisces / Gemini, Web Safe fonts are recommended for `global` (and `title`):\n# Arial | Tahoma | Helvetica | Times New Roman | Courier New | Verdana | Georgia | Palatino | Garamond | Comic Sans MS | Trebuchet MS\n# ---------------------------------------------------------------\n\nfont:\n enable: false\n\n # Uri of fonts host, e.g. https://fonts.googleapis.com (Default).\n host:\n\n # Font options:\n # `external: true` will load this font family from `host` above.\n # `family: Times New Roman`. Without any quotes.\n # `size: x.x`. Use `em` as unit. Default: 1 (16px)\n\n # Global font settings used for all elements inside .\n global:\n external: true\n family: Lato\n size:\n\n # Font settings for site title (.site-title).\n title:\n external: true\n family:\n size:\n\n # Font settings for headlines (
to
).\n headings:\n external: true\n family:\n size:\n\n # Font settings for posts (.post-body).\n posts:\n external: true\n family:\n\n # Font settings for and code blocks.\n codes:\n external: true\n family:\n\n\n# ---------------------------------------------------------------\n# SEO Settings\n# ---------------------------------------------------------------\n\n# Disable Baidu transformation on mobile devices.\ndisable_baidu_transformation: false\n\n# If true, site-subtitle will be added to index page.\n# Remember to set up your site-subtitle in Hexo `_config.yml` (e.g. subtitle: Subtitle)\nindex_with_subtitle: false\n\n# Automatically add external URL with Base64 encrypt & decrypt.\nexturl: false\n\n# Google Webmaster tools verification.\n# See: https://www.google.com/webmasters\ngoogle_site_verification:\n\n# Bing Webmaster tools verification.\n# See: https://www.bing.com/webmaster\nbing_site_verification:\n\n# Yandex Webmaster tools verification.\n# See: https://webmaster.yandex.ru\nyandex_site_verification:\n\n# Baidu Webmaster tools verification.\n# See: https://ziyuan.baidu.com/site\nbaidu_site_verification:\n\n# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO.\nbaidu_push: false\n\n\n# ---------------------------------------------------------------\n# Third Party Plugins & Services Settings\n# See: https://theme-next.org/docs/third-party-services/\n# More plugins: https://github.com/theme-next/awesome-next\n# You may need to install dependencies or set CDN URLs in `vendors`\n# There are two different CDN providers by default:\n# - jsDelivr (cdn.jsdelivr.net), works everywhere even in China\n# - CDNJS (cdnjs.cloudflare.com), provided by cloudflare\n# ---------------------------------------------------------------\n\n# Math Formulas Render Support\nmath:\n # Default (true) will load mathjax / katex script on demand.\n # That is it only render those page which has `mathjax: true` in Front-matter.\n # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.\n per_page: true\n\n # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.\n mathjax:\n enable: false\n # See: https://mhchem.github.io/MathJax-mhchem/\n mhchem: false\n\n # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.\n katex:\n enable: false\n # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex\n copy_tex: false\n\n# Easily enable fast Ajax navigation on your website.\n# Dependencies: https://github.com/theme-next/theme-next-pjax\npjax: false\n\n# FancyBox is a tool that offers a nice and elegant way to add zooming functionality for images.\n# For more information: https://fancyapps.com/fancybox\nfancybox: false\n\n# A JavaScript library for zooming images like Medium.\n# Do not enable both `fancybox` and `mediumzoom`.\n# For more information: https://github.com/francoischalifour/medium-zoom\nmediumzoom: false\n\n# Vanilla JavaScript plugin for lazyloading images.\n# For more information: https://github.com/ApoorvSaxena/lozad.js\nlazyload: false\n\n# Pangu Support\n# For more information: https://github.com/vinta/pangu.js\npangu: false\n\n# Quicklink Support\n# Do not enable both `pjax` and `quicklink`.\n# For more information: https://github.com/GoogleChromeLabs/quicklink\n# Front-matter (unsupport home archive).\nquicklink:\n enable: false\n\n # Home page and archive page can be controlled through home and archive options below.\n # This configuration item is independent of `enable`.\n home: false\n archive: false\n\n # Default (true) will initialize quicklink after the load event fires.\n delay: true\n # Custom a time in milliseconds by which the browser must execute prefetching.\n timeout: 3000\n # Default (true) will enable fetch() or falls back to XHR.\n priority: true\n\n # For more flexibility you can add some patterns (RegExp, Function, or Array) to ignores.\n # See: https://github.com/GoogleChromeLabs/quicklink#custom-ignore-patterns\n ignores:\n\n\n# ---------------------------------------------------------------\n# Comments Settings\n# See: https://theme-next.org/docs/third-party-services/comments\n# ---------------------------------------------------------------\n\n# Multiple Comment System Support\ncomments:\n # Available values: tabs | buttons\n style: tabs\n # Choose a comment system to be displayed by default.\n # Available values: changyan | disqus | disqusjs | gitalk | livere | valine\n active:\n # Setting `true` means remembering the comment system selected by the visitor.\n storage: true\n # Lazyload all comment systems.\n lazyload: false\n # Modify texts or order for any navs, here are some examples.\n nav:\n #disqus:\n # text: Load Disqus\n # order: -1\n #gitalk:\n # order: -2\n\n# Disqus\ndisqus:\n enable: false\n shortname:\n count: true\n #post_meta_order: 0\n\n# DisqusJS\n# Alternative Disqus - Render comment component using Disqus API.\n# Demo: https://suka.js.org/DisqusJS/\n# For more information: https://github.com/SukkaW/DisqusJS\ndisqusjs:\n enable: false\n # API Endpoint of Disqus API (https://disqus.com/api/).\n # Leave api empty if you are able to connect to Disqus API. Otherwise you need a reverse proxy for it.\n # For example:\n # api: https://disqus.skk.moe/disqus/\n api:\n apikey: # Register new application from https://disqus.com/api/applications/\n shortname: # See: https://disqus.com/admin/settings/general/\n\n# Changyan\nchangyan:\n enable: false\n appid:\n appkey:\n #post_meta_order: 0\n\n# Valine\n# For more information: https://valine.js.org, https://github.com/xCss/Valine\nvaline:\n enable: false\n appid: # Your leancloud application appid\n appkey: # Your leancloud application appkey\n notify: false # Mail notifier\n verify: false # Verification code\n placeholder: Just go go # Comment box placeholder\n avatar: mm # Gravatar style\n guest_info: nick,mail,link # Custom comment header\n pageSize: 10 # Pagination size\n language: # Language, available values: en, zh-cn\n visitor: false # Article reading statistic\n comment_count: true # If false, comment count will only be displayed in post page, not in home page\n recordIP: false # Whether to record the commenter IP\n serverURLs: # When the custom domain name is enabled, fill it in here (it will be detected automatically by default, no need to fill in)\n #post_meta_order: 0\n\n# LiveRe comments system\n# You can get your uid from https://livere.com/insight/myCode (General web site)\nlivere_uid: # \n\n# Gitalk\n# For more information: https://gitalk.github.io, https://github.com/gitalk/gitalk\ngitalk:\n enable: false\n github_id: # GitHub repo owner\n repo: # Repository name to store issues\n client_id: # GitHub Application Client ID\n client_secret: # GitHub Application Client Secret\n admin_user: # GitHub repo owner and collaborators, only these guys can initialize gitHub issues\n distraction_free_mode: true # Facebook-like distraction free mode\n # Gitalk's display language depends on user's browser or system environment\n # If you want everyone visiting your site to see a uniform language, you can set a force language value\n # Available values: en | es-ES | fr | ru | zh-CN | zh-TW\n language:\n\n\n# ---------------------------------------------------------------\n# Post Widgets & Content Sharing Services\n# See: https://theme-next.org/docs/third-party-services/post-widgets\n# ---------------------------------------------------------------\n\n# Star rating support to each article.\n# To get your ID visit https://widgetpack.com\nrating:\n enable: false\n id: # \n color: fc6423\n\n# AddThis Share. See: https://www.addthis.com\n# Go to https://www.addthis.com/dashboard to customize your tools.\nadd_this_id:\n\n\n# ---------------------------------------------------------------\n# Statistics and Analytics\n# See: https://theme-next.org/docs/third-party-services/statistics-and-analytics\n# ---------------------------------------------------------------\n\n# Google Analytics\ngoogle_analytics:\n tracking_id: # \n # By default, NexT will load an external gtag.js script on your site.\n # If you only need the pageview feature, set the following option to true to get a better performance.\n only_pageview: false\n\n# Baidu Analytics\nbaidu_analytics: # \n\n# Growingio Analytics\ngrowingio_analytics: # \n\n# CNZZ count\ncnzz_siteid:\n\n# Show number of visitors of each article.\n# You can visit https://leancloud.cn to get AppID and AppKey.\n# AppID and AppKey are recommended to be the same as valine's for counter compatibility.\n# Do not enable both `valine.visitor` and `leancloud_visitors`.\nleancloud_visitors:\n enable: false\n app_id: # \n app_key: # \n # Required for apps from CN region\n server_url: # \n # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security\n # If you don't care about security in leancloud counter and just want to use it directly\n # (without hexo-leancloud-counter-security plugin), set `security` to `false`.\n security: true\n\n# Another tool to show number of visitors to each article.\n# Visit https://console.firebase.google.com/u/0/ to get apiKey and projectId.\n# Visit https://firebase.google.com/docs/firestore/ to get more information about firestore.\nfirestore:\n enable: false\n collection: articles # Required, a string collection name to access firestore database\n apiKey: # Required\n projectId: # Required\n\n# Show Views / Visitors of the website / page with busuanzi.\n# Get more information on http://ibruce.info/2015/04/04/busuanzi\nbusuanzi_count:\n enable: false\n total_visitors: true\n total_visitors_icon: fa fa-user\n total_views: true\n total_views_icon: fa fa-eye\n post_views: true\n post_views_icon: fa fa-eye\n\n\n# ---------------------------------------------------------------\n# Search Services\n# See: https://theme-next.org/docs/third-party-services/search-services\n# ---------------------------------------------------------------\n\n# Algolia Search\n# For more information: https://www.algolia.com\nalgolia_search:\n enable: false\n hits:\n per_page: 10\n labels:\n input_placeholder: Search for Posts\n hits_empty: \"We didn't find any results for the search: ${query}\"\n hits_stats: \"${hits} results found in ${time} ms\"\n\n# Local Search\n# Dependencies: https://github.com/theme-next/hexo-generator-searchdb\nlocal_search:\n enable: false\n # If auto, trigger search by changing input.\n # If manual, trigger search by pressing enter key or search button.\n trigger: auto\n # Show top n results per article, show all results by setting to -1\n top_n_per_article: 1\n # Unescape html strings to the readable one.\n unescape: false\n # Preload the search data when the page loads.\n preload: false\n\n# Swiftype Search API Key\nswiftype_key:\n\n\n# ---------------------------------------------------------------\n# Chat Services\n# See: https://theme-next.org/docs/third-party-services/chat-services\n# ---------------------------------------------------------------\n\n# Chatra Support\n# See: https://chatra.io\n# Dashboard: https://app.chatra.io/settings/general\nchatra:\n enable: false\n async: true\n id: # Visit Dashboard to get your ChatraID\n #embed: # Unfinished experimental feature for developers. See: https://chatra.io/help/api/#injectto\n\n# Tidio Support\n# See: https://www.tidiochat.com\n# Dashboard: https://www.tidiochat.com/panel/dashboard\ntidio:\n enable: false\n key: # Public Key, get it from dashboard. See: https://www.tidiochat.com/panel/settings/developer\n\n\n# ---------------------------------------------------------------\n# Tags Settings\n# See: https://theme-next.org/docs/tag-plugins/\n# ---------------------------------------------------------------\n\n# Note tag (bs-callout)\nnote:\n # Note tag style values:\n # - simple bs-callout old alert style. Default.\n # - modern bs-callout new (v2-v3) alert style.\n # - flat flat callout style with background, like on Mozilla or StackOverflow.\n # - disabled disable all CSS styles import of note tag.\n style: simple\n icons: false\n # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).\n # Offset also applied to label tag variables. This option can work with disabled note tag.\n light_bg_offset: 0\n\n# Tabs tag\ntabs:\n transition:\n tabs: false\n labels: true\n\n# PDF tag\n# NexT will try to load pdf files natively, if failed, pdf.js will be used.\n# So, you have to install the dependency of pdf.js if you want to use pdf tag and make it available to all browsers.\n# See: https://github.com/theme-next/theme-next-pdf\npdf:\n enable: false\n # Default height\n height: 500px\n\n# Mermaid tag\nmermaid:\n enable: false\n # Available themes: default | dark | forest | neutral\n theme: forest\n\n\n# ---------------------------------------------------------------\n# Animation Settings\n# ---------------------------------------------------------------\n\n# Use velocity to animate everything.\n# For more information: http://velocityjs.org\nmotion:\n enable: true\n async: false\n transition:\n # Transition variants:\n # fadeIn | flipXIn | flipYIn | flipBounceXIn | flipBounceYIn\n # swoopIn | whirlIn | shrinkIn | expandIn\n # bounceIn | bounceUpIn | bounceDownIn | bounceLeftIn | bounceRightIn\n # slideUpIn | slideDownIn | slideLeftIn | slideRightIn\n # slideUpBigIn | slideDownBigIn | slideLeftBigIn | slideRightBigIn\n # perspectiveUpIn | perspectiveDownIn | perspectiveLeftIn | perspectiveRightIn\n post_block: fadeIn\n post_header: slideDownIn\n post_body: slideDownIn\n coll_header: slideLeftIn\n # Only for Pisces | Gemini.\n sidebar: slideUpIn\n\n# Progress bar in the top during page loading.\n# Dependencies: https://github.com/theme-next/theme-next-pace\n# For more information: https://github.com/HubSpot/pace\npace:\n enable: false\n # Themes list:\n # big-counter | bounce | barber-shop | center-atom | center-circle | center-radar | center-simple\n # corner-indicator | fill-left | flat-top | flash | loading-bar | mac-osx | material | minimal\n theme: minimal\n\n# JavaScript 3D library.\n# Dependencies: https://github.com/theme-next/theme-next-three\nthree:\n enable: false\n three_waves: false\n canvas_lines: false\n canvas_sphere: false\n\n# Canvas-ribbon\n# Dependencies: https://github.com/theme-next/theme-next-canvas-ribbon\n# For more information: https://github.com/zproo/canvas-ribbon\ncanvas_ribbon:\n enable: false\n size: 300 # The width of the ribbon\n alpha: 0.6 # The transparency of the ribbon\n zIndex: -1 # The display level of the ribbon\n\n\n#! ---------------------------------------------------------------\n#! DO NOT EDIT THE FOLLOWING SETTINGS\n#! UNLESS YOU KNOW WHAT YOU ARE DOING\n#! See: https://theme-next.org/docs/advanced-settings\n#! ---------------------------------------------------------------\n\n# Script Vendors. Set a CDN address for the vendor you want to customize.\n# Be aware that you would better use the same version as internal ones to avoid potential problems.\n# Remember to use the https protocol of CDN files when you enable https on your site.\nvendors:\n # Internal path prefix.\n _internal: lib\n\n # Internal version: 3.1.0\n # anime: //cdn.jsdelivr.net/npm/animejs@3.1.0/lib/anime.min.js\n anime:\n\n # Internal version: 5.13.0\n # fontawesome: //cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css\n # fontawesome: //cdnjs.cloudflare.com/ajax/libs/font-awesome/5.13.0/css/all.min.css\n fontawesome:\n\n # MathJax\n # mathjax: //cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js\n mathjax:\n\n # KaTeX\n # katex: //cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css\n # katex: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.11.1/katex.min.css\n # copy_tex_js: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.js\n # copy_tex_css: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.css\n katex:\n copy_tex_js:\n copy_tex_css:\n\n # Internal version: 0.2.8\n # pjax: //cdn.jsdelivr.net/gh/theme-next/theme-next-pjax@0/pjax.min.js\n pjax:\n\n # FancyBox\n # jquery: //cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js\n # fancybox: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.js\n # fancybox_css: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.css\n jquery:\n fancybox:\n fancybox_css:\n\n # Medium-zoom\n # mediumzoom: //cdn.jsdelivr.net/npm/medium-zoom@1/dist/medium-zoom.min.js\n mediumzoom:\n\n # Lazyload\n # lazyload: //cdn.jsdelivr.net/npm/lozad@1/dist/lozad.min.js\n # lazyload: //cdnjs.cloudflare.com/ajax/libs/lozad.js/1.14.0/lozad.min.js\n lazyload:\n\n # Pangu\n # pangu: //cdn.jsdelivr.net/npm/pangu@4/dist/browser/pangu.min.js\n # pangu: //cdnjs.cloudflare.com/ajax/libs/pangu/4.0.7/pangu.min.js\n pangu:\n\n # Quicklink\n # quicklink: //cdn.jsdelivr.net/npm/quicklink@1/dist/quicklink.umd.js\n quicklink:\n\n # DisqusJS\n # disqusjs_js: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js\n # disqusjs_css: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css\n disqusjs_js:\n disqusjs_css:\n\n # Valine\n # valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js\n # valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.10/Valine.min.js\n valine:\n\n # Gitalk\n # gitalk_js: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js\n # gitalk_css: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.css\n gitalk_js:\n gitalk_css:\n\n # Algolia Search\n # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js\n # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js\n algolia_search:\n instant_search:\n\n # Mermaid\n # mermaid: //cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js\n # mermaid: //cdnjs.cloudflare.com/ajax/libs/mermaid/8.4.8/mermaid.min.js\n mermaid:\n\n # Internal version: 1.2.1\n # velocity: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.min.js\n # velocity: //cdnjs.cloudflare.com/ajax/libs/velocity/1.2.1/velocity.min.js\n # velocity_ui: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.ui.min.js\n # velocity_ui: //cdnjs.cloudflare.com/ajax/libs/velocity/1.2.1/velocity.ui.min.js\n velocity:\n velocity_ui:\n\n # Internal version: 1.0.2\n # pace: //cdn.jsdelivr.net/npm/pace-js@1/pace.min.js\n # pace: //cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/pace.min.js\n # pace_css: //cdn.jsdelivr.net/npm/pace-js@1/themes/blue/pace-theme-minimal.css\n # pace_css: //cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/themes/blue/pace-theme-minimal.min.css\n pace:\n pace_css:\n\n # Internal version: 1.0.0\n # three: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three.min.js\n # three_waves: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three-waves.min.js\n # canvas_lines: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/canvas_lines.min.js\n # canvas_sphere: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/canvas_sphere.min.js\n three:\n three_waves:\n canvas_lines:\n canvas_sphere:\n\n # Internal version: 1.0.0\n # canvas_ribbon: //cdn.jsdelivr.net/gh/theme-next/theme-next-canvas-ribbon@1/canvas-ribbon.js\n canvas_ribbon:\n\n# Assets\ncss: css\njs: js\nimages: images\n"
},
{
"path": "crowdin.yml",
"content": "files:\n - source: /languages/en.yml\n translation: /languages/%two_letters_code%.%file_extension%\n languages_mapping:\n two_letters_code:\n zh-CN: zh-CN\n zh-TW: zh-TW\n zh-HK: zh-HK\n pt-BR: pt-BR\n"
},
{
"path": "docs/AGPL3.md",
"content": "#
Everyone is permitted to copy and distribute verbatim copies\nof this license document, but changing it is not allowed.
\n\n##
Preamble
\n\nThe GNU Affero General Public License is a free, copyleft license for\nsoftware and other kinds of works, specifically designed to ensure\ncooperation with the community in the case of network server software.\n\nThe licenses for most software and other practical works are designed\nto take away your freedom to share and change the works. By contrast,\nour General Public Licenses are intended to guarantee your freedom to\nshare and change all versions of a program--to make sure it remains free\nsoftware for all its users.\n\nWhen we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthem if you wish), that you receive source code or can get it if you\nwant it, that you can change the software or use pieces of it in new\nfree programs, and that you know you can do these things.\n\nDevelopers that use our General Public Licenses protect your rights\nwith two steps: **(1)** assert copyright on the software, and **(2)** offer\nyou this License which gives you legal permission to copy, distribute\nand/or modify the software.\n\nA secondary benefit of defending all users' freedom is that\nimprovements made in alternate versions of the program, if they\nreceive widespread use, become available for other developers to\nincorporate. Many developers of free software are heartened and\nencouraged by the resulting cooperation. However, in the case of\nsoftware used on network servers, this result may fail to come about.\nThe GNU General Public License permits making a modified version and\nletting the public access it on a server without ever releasing its\nsource code to the public.\n\nThe GNU Affero General Public License is designed specifically to\nensure that, in such cases, the modified source code becomes available\nto the community. It requires the operator of a network server to\nprovide the source code of the modified version running there to the\nusers of that server. Therefore, public use of a modified version, on\na publicly accessible server, gives the public access to the source\ncode of the modified version.\n\nAn older license, called the Affero General Public License and\npublished by Affero, was designed to accomplish similar goals. This is\na different license, not a version of the Affero GPL, but Affero has\nreleased a new version of the Affero GPL which permits relicensing under\nthis license.\n\nThe precise terms and conditions for copying, distribution and\nmodification follow.\n\n##
TERMS AND CONDITIONS
\n\n### 0. Definitions\n\n“This License” refers to version 3 of the GNU Affero General Public License.\n\n“Copyright” also means copyright-like laws that apply to other kinds of\nworks, such as semiconductor masks.\n\n“The Program” refers to any copyrightable work licensed under this\nLicense. Each licensee is addressed as “you”. “Licensees” and\n“recipients” may be individuals or organizations.\n\nTo “modify” a work means to copy from or adapt all or part of the work\nin a fashion requiring copyright permission, other than the making of an\nexact copy. The resulting work is called a “modified version” of the\nearlier work or a work “based on” the earlier work.\n\nA “covered work” means either the unmodified Program or a work based\non the Program.\n\nTo “propagate” a work means to do anything with it that, without\npermission, would make you directly or secondarily liable for\ninfringement under applicable copyright law, except executing it on a\ncomputer or modifying a private copy. Propagation includes copying,\ndistribution (with or without modification), making available to the\npublic, and in some countries other activities as well.\n\nTo “convey” a work means any kind of propagation that enables other\nparties to make or receive copies. Mere interaction with a user through\na computer network, with no transfer of a copy, is not conveying.\n\nAn interactive user interface displays “Appropriate Legal Notices”\nto the extent that it includes a convenient and prominently visible\nfeature that **(1)** displays an appropriate copyright notice, and **(2)**\ntells the user that there is no warranty for the work (except to the\nextent that warranties are provided), that licensees may convey the\nwork under this License, and how to view a copy of this License. If\nthe interface presents a list of user commands or options, such as a\nmenu, a prominent item in the list meets this criterion.\n\n### 1. Source Code\n\nThe “source code” for a work means the preferred form of the work\nfor making modifications to it. “Object code” means any non-source\nform of a work.\n\nA “Standard Interface” means an interface that either is an official\nstandard defined by a recognized standards body, or, in the case of\ninterfaces specified for a particular programming language, one that\nis widely used among developers working in that language.\n\nThe “System Libraries” of an executable work include anything, other\nthan the work as a whole, that **(a)** is included in the normal form of\npackaging a Major Component, but which is not part of that Major\nComponent, and **(b)** serves only to enable use of the work with that\nMajor Component, or to implement a Standard Interface for which an\nimplementation is available to the public in source code form. A\n“Major Component”, in this context, means a major essential component\n(kernel, window system, and so on) of the specific operating system\n(if any) on which the executable work runs, or a compiler used to\nproduce the work, or an object code interpreter used to run it.\n\nThe “Corresponding Source” for a work in object code form means all\nthe source code needed to generate, install, and (for an executable\nwork) run the object code and to modify the work, including scripts to\ncontrol those activities. However, it does not include the work's\nSystem Libraries, or general-purpose tools or generally available free\nprograms which are used unmodified in performing those activities but\nwhich are not part of the work. For example, Corresponding Source\nincludes interface definition files associated with source files for\nthe work, and the source code for shared libraries and dynamically\nlinked subprograms that the work is specifically designed to require,\nsuch as by intimate data communication or control flow between those\nsubprograms and other parts of the work.\n\nThe Corresponding Source need not include anything that users\ncan regenerate automatically from other parts of the Corresponding\nSource.\n\nThe Corresponding Source for a work in source code form is that\nsame work.\n\n### 2. Basic Permissions\n\nAll rights granted under this License are granted for the term of\ncopyright on the Program, and are irrevocable provided the stated\nconditions are met. This License explicitly affirms your unlimited\npermission to run the unmodified Program. The output from running a\ncovered work is covered by this License only if the output, given its\ncontent, constitutes a covered work. This License acknowledges your\nrights of fair use or other equivalent, as provided by copyright law.\n\nYou may make, run and propagate covered works that you do not\nconvey, without conditions so long as your license otherwise remains\nin force. You may convey covered works to others for the sole purpose\nof having them make modifications exclusively for you, or provide you\nwith facilities for running those works, provided that you comply with\nthe terms of this License in conveying all material for which you do\nnot control copyright. Those thus making or running the covered works\nfor you must do so exclusively on your behalf, under your direction\nand control, on terms that prohibit them from making any copies of\nyour copyrighted material outside their relationship with you.\n\nConveying under any other circumstances is permitted solely under\nthe conditions stated below. Sublicensing is not allowed; section 10\nmakes it unnecessary.\n\n### 3. Protecting Users' Legal Rights From Anti-Circumvention Law\n\nNo covered work shall be deemed part of an effective technological\nmeasure under any applicable law fulfilling obligations under article\n11 of the WIPO copyright treaty adopted on 20 December 1996, or\nsimilar laws prohibiting or restricting circumvention of such\nmeasures.\n\nWhen you convey a covered work, you waive any legal power to forbid\ncircumvention of technological measures to the extent such circumvention\nis effected by exercising rights under this License with respect to\nthe covered work, and you disclaim any intention to limit operation or\nmodification of the work as a means of enforcing, against the work's\nusers, your or third parties' legal rights to forbid circumvention of\ntechnological measures.\n\n### 4. Conveying Verbatim Copies\n\nYou may convey verbatim copies of the Program's source code as you\nreceive it, in any medium, provided that you conspicuously and\nappropriately publish on each copy an appropriate copyright notice;\nkeep intact all notices stating that this License and any\nnon-permissive terms added in accord with section 7 apply to the code;\nkeep intact all notices of the absence of any warranty; and give all\nrecipients a copy of this License along with the Program.\n\nYou may charge any price or no price for each copy that you convey,\nand you may offer support or warranty protection for a fee.\n\n### 5. Conveying Modified Source Versions\n\nYou may convey a work based on the Program, or the modifications to\nproduce it from the Program, in the form of source code under the\nterms of section 4, provided that you also meet all of these conditions:\n\n* **a)** The work must carry prominent notices stating that you modified\nit, and giving a relevant date.\n* **b)** The work must carry prominent notices stating that it is\nreleased under this License and any conditions added under section 7.\nThis requirement modifies the requirement in section 4 to\n“keep intact all notices”.\n* **c)** You must license the entire work, as a whole, under this\nLicense to anyone who comes into possession of a copy. This\nLicense will therefore apply, along with any applicable section 7\nadditional terms, to the whole of the work, and all its parts,\nregardless of how they are packaged. This License gives no\npermission to license the work in any other way, but it does not\ninvalidate such permission if you have separately received it.\n* **d)** If the work has interactive user interfaces, each must display\nAppropriate Legal Notices; however, if the Program has interactive\ninterfaces that do not display Appropriate Legal Notices, your\nwork need not make them do so.\n\nA compilation of a covered work with other separate and independent\nworks, which are not by their nature extensions of the covered work,\nand which are not combined with it such as to form a larger program,\nin or on a volume of a storage or distribution medium, is called an\n“aggregate” if the compilation and its resulting copyright are not\nused to limit the access or legal rights of the compilation's users\nbeyond what the individual works permit. Inclusion of a covered work\nin an aggregate does not cause this License to apply to the other\nparts of the aggregate.\n\n### 6. Conveying Non-Source Forms\n\nYou may convey a covered work in object code form under the terms\nof sections 4 and 5, provided that you also convey the\nmachine-readable Corresponding Source under the terms of this License,\nin one of these ways:\n\n* **a)** Convey the object code in, or embodied in, a physical product\n(including a physical distribution medium), accompanied by the\nCorresponding Source fixed on a durable physical medium\ncustomarily used for software interchange.\n* **b)** Convey the object code in, or embodied in, a physical product\n(including a physical distribution medium), accompanied by a\nwritten offer, valid for at least three years and valid for as\nlong as you offer spare parts or customer support for that product\nmodel, to give anyone who possesses the object code either **(1)** a\ncopy of the Corresponding Source for all the software in the\nproduct that is covered by this License, on a durable physical\nmedium customarily used for software interchange, for a price no\nmore than your reasonable cost of physically performing this\nconveying of source, or **(2)** access to copy the\nCorresponding Source from a network server at no charge.\n* **c)** Convey individual copies of the object code with a copy of the\nwritten offer to provide the Corresponding Source. This\nalternative is allowed only occasionally and noncommercially, and\nonly if you received the object code with such an offer, in accord\nwith subsection 6b.\n* **d)** Convey the object code by offering access from a designated\nplace (gratis or for a charge), and offer equivalent access to the\nCorresponding Source in the same way through the same place at no\nfurther charge. You need not require recipients to copy the\nCorresponding Source along with the object code. If the place to\ncopy the object code is a network server, the Corresponding Source\nmay be on a different server (operated by you or a third party)\nthat supports equivalent copying facilities, provided you maintain\nclear directions next to the object code saying where to find the\nCorresponding Source. Regardless of what server hosts the\nCorresponding Source, you remain obligated to ensure that it is\navailable for as long as needed to satisfy these requirements.\n* **e)** Convey the object code using peer-to-peer transmission, provided\nyou inform other peers where the object code and Corresponding\nSource of the work are being offered to the general public at no\ncharge under subsection 6d.\n\nA separable portion of the object code, whose source code is excluded\nfrom the Corresponding Source as a System Library, need not be\nincluded in conveying the object code work.\n\nA “User Product” is either **(1)** a “consumer product”, which means any\ntangible personal property which is normally used for personal, family,\nor household purposes, or **(2)** anything designed or sold for incorporation\ninto a dwelling. In determining whether a product is a consumer product,\ndoubtful cases shall be resolved in favor of coverage. For a particular\nproduct received by a particular user, “normally used” refers to a\ntypical or common use of that class of product, regardless of the status\nof the particular user or of the way in which the particular user\nactually uses, or expects or is expected to use, the product. A product\nis a consumer product regardless of whether the product has substantial\ncommercial, industrial or non-consumer uses, unless such uses represent\nthe only significant mode of use of the product.\n\n“Installation Information” for a User Product means any methods,\nprocedures, authorization keys, or other information required to install\nand execute modified versions of a covered work in that User Product from\na modified version of its Corresponding Source. The information must\nsuffice to ensure that the continued functioning of the modified object\ncode is in no case prevented or interfered with solely because\nmodification has been made.\n\nIf you convey an object code work under this section in, or with, or\nspecifically for use in, a User Product, and the conveying occurs as\npart of a transaction in which the right of possession and use of the\nUser Product is transferred to the recipient in perpetuity or for a\nfixed term (regardless of how the transaction is characterized), the\nCorresponding Source conveyed under this section must be accompanied\nby the Installation Information. But this requirement does not apply\nif neither you nor any third party retains the ability to install\nmodified object code on the User Product (for example, the work has\nbeen installed in ROM).\n\nThe requirement to provide Installation Information does not include a\nrequirement to continue to provide support service, warranty, or updates\nfor a work that has been modified or installed by the recipient, or for\nthe User Product in which it has been modified or installed. Access to a\nnetwork may be denied when the modification itself materially and\nadversely affects the operation of the network or violates the rules and\nprotocols for communication across the network.\n\nCorresponding Source conveyed, and Installation Information provided,\nin accord with this section must be in a format that is publicly\ndocumented (and with an implementation available to the public in\nsource code form), and must require no special password or key for\nunpacking, reading or copying.\n\n### 7. Additional Terms\n\n“Additional permissions” are terms that supplement the terms of this\nLicense by making exceptions from one or more of its conditions.\nAdditional permissions that are applicable to the entire Program shall\nbe treated as though they were included in this License, to the extent\nthat they are valid under applicable law. If additional permissions\napply only to part of the Program, that part may be used separately\nunder those permissions, but the entire Program remains governed by\nthis License without regard to the additional permissions.\n\nWhen you convey a copy of a covered work, you may at your option\nremove any additional permissions from that copy, or from any part of\nit. (Additional permissions may be written to require their own\nremoval in certain cases when you modify the work.) You may place\nadditional permissions on material, added by you to a covered work,\nfor which you have or can give appropriate copyright permission.\n\nNotwithstanding any other provision of this License, for material you\nadd to a covered work, you may (if authorized by the copyright holders of\nthat material) supplement the terms of this License with terms:\n\n* **a)** Disclaiming warranty or limiting liability differently from the\nterms of sections 15 and 16 of this License; or\n* **b)** Requiring preservation of specified reasonable legal notices or\nauthor attributions in that material or in the Appropriate Legal\nNotices displayed by works containing it; or\n* **c)** Prohibiting misrepresentation of the origin of that material, or\nrequiring that modified versions of such material be marked in\nreasonable ways as different from the original version; or\n* **d)** Limiting the use for publicity purposes of names of licensors or\nauthors of the material; or\n* **e)** Declining to grant rights under trademark law for use of some\ntrade names, trademarks, or service marks; or\n* **f)** Requiring indemnification of licensors and authors of that\nmaterial by anyone who conveys the material (or modified versions of\nit) with contractual assumptions of liability to the recipient, for\nany liability that these contractual assumptions directly impose on\nthose licensors and authors.\n\nAll other non-permissive additional terms are considered “further\nrestrictions” within the meaning of section 10. If the Program as you\nreceived it, or any part of it, contains a notice stating that it is\ngoverned by this License along with a term that is a further\nrestriction, you may remove that term. If a license document contains\na further restriction but permits relicensing or conveying under this\nLicense, you may add to a covered work material governed by the terms\nof that license document, provided that the further restriction does\nnot survive such relicensing or conveying.\n\nIf you add terms to a covered work in accord with this section, you\nmust place, in the relevant source files, a statement of the\nadditional terms that apply to those files, or a notice indicating\nwhere to find the applicable terms.\n\nAdditional terms, permissive or non-permissive, may be stated in the\nform of a separately written license, or stated as exceptions;\nthe above requirements apply either way.\n\n### 8. Termination\n\nYou may not propagate or modify a covered work except as expressly\nprovided under this License. Any attempt otherwise to propagate or\nmodify it is void, and will automatically terminate your rights under\nthis License (including any patent licenses granted under the third\nparagraph of section 11).\n\nHowever, if you cease all violation of this License, then your\nlicense from a particular copyright holder is reinstated **(a)**\nprovisionally, unless and until the copyright holder explicitly and\nfinally terminates your license, and **(b)** permanently, if the copyright\nholder fails to notify you of the violation by some reasonable means\nprior to 60 days after the cessation.\n\nMoreover, your license from a particular copyright holder is\nreinstated permanently if the copyright holder notifies you of the\nviolation by some reasonable means, this is the first time you have\nreceived notice of violation of this License (for any work) from that\ncopyright holder, and you cure the violation prior to 30 days after\nyour receipt of the notice.\n\nTermination of your rights under this section does not terminate the\nlicenses of parties who have received copies or rights from you under\nthis License. If your rights have been terminated and not permanently\nreinstated, you do not qualify to receive new licenses for the same\nmaterial under section 10.\n\n### 9. Acceptance Not Required for Having Copies\n\nYou are not required to accept this License in order to receive or\nrun a copy of the Program. Ancillary propagation of a covered work\noccurring solely as a consequence of using peer-to-peer transmission\nto receive a copy likewise does not require acceptance. However,\nnothing other than this License grants you permission to propagate or\nmodify any covered work. These actions infringe copyright if you do\nnot accept this License. Therefore, by modifying or propagating a\ncovered work, you indicate your acceptance of this License to do so.\n\n### 10. Automatic Licensing of Downstream Recipients\n\nEach time you convey a covered work, the recipient automatically\nreceives a license from the original licensors, to run, modify and\npropagate that work, subject to this License. You are not responsible\nfor enforcing compliance by third parties with this License.\n\nAn “entity transaction” is a transaction transferring control of an\norganization, or substantially all assets of one, or subdividing an\norganization, or merging organizations. If propagation of a covered\nwork results from an entity transaction, each party to that\ntransaction who receives a copy of the work also receives whatever\nlicenses to the work the party's predecessor in interest had or could\ngive under the previous paragraph, plus a right to possession of the\nCorresponding Source of the work from the predecessor in interest, if\nthe predecessor has it or can get it with reasonable efforts.\n\nYou may not impose any further restrictions on the exercise of the\nrights granted or affirmed under this License. For example, you may\nnot impose a license fee, royalty, or other charge for exercise of\nrights granted under this License, and you may not initiate litigation\n(including a cross-claim or counterclaim in a lawsuit) alleging that\nany patent claim is infringed by making, using, selling, offering for\nsale, or importing the Program or any portion of it.\n\n### 11. Patents\n\nA “contributor” is a copyright holder who authorizes use under this\nLicense of the Program or a work on which the Program is based. The\nwork thus licensed is called the contributor's “contributor version”.\n\nA contributor's “essential patent claims” are all patent claims\nowned or controlled by the contributor, whether already acquired or\nhereafter acquired, that would be infringed by some manner, permitted\nby this License, of making, using, or selling its contributor version,\nbut do not include claims that would be infringed only as a\nconsequence of further modification of the contributor version. For\npurposes of this definition, “control” includes the right to grant\npatent sublicenses in a manner consistent with the requirements of\nthis License.\n\nEach contributor grants you a non-exclusive, worldwide, royalty-free\npatent license under the contributor's essential patent claims, to\nmake, use, sell, offer for sale, import and otherwise run, modify and\npropagate the contents of its contributor version.\n\nIn the following three paragraphs, a “patent license” is any express\nagreement or commitment, however denominated, not to enforce a patent\n(such as an express permission to practice a patent or covenant not to\nsue for patent infringement). To “grant” such a patent license to a\nparty means to make such an agreement or commitment not to enforce a\npatent against the party.\n\nIf you convey a covered work, knowingly relying on a patent license,\nand the Corresponding Source of the work is not available for anyone\nto copy, free of charge and under the terms of this License, through a\npublicly available network server or other readily accessible means,\nthen you must either **(1)** cause the Corresponding Source to be so\navailable, or **(2)** arrange to deprive yourself of the benefit of the\npatent license for this particular work, or **(3)** arrange, in a manner\nconsistent with the requirements of this License, to extend the patent\nlicense to downstream recipients. “Knowingly relying” means you have\nactual knowledge that, but for the patent license, your conveying the\ncovered work in a country, or your recipient's use of the covered work\nin a country, would infringe one or more identifiable patents in that\ncountry that you have reason to believe are valid.\n\nIf, pursuant to or in connection with a single transaction or\narrangement, you convey, or propagate by procuring conveyance of, a\ncovered work, and grant a patent license to some of the parties\nreceiving the covered work authorizing them to use, propagate, modify\nor convey a specific copy of the covered work, then the patent license\nyou grant is automatically extended to all recipients of the covered\nwork and works based on it.\n\nA patent license is “discriminatory” if it does not include within\nthe scope of its coverage, prohibits the exercise of, or is\nconditioned on the non-exercise of one or more of the rights that are\nspecifically granted under this License. You may not convey a covered\nwork if you are a party to an arrangement with a third party that is\nin the business of distributing software, under which you make payment\nto the third party based on the extent of your activity of conveying\nthe work, and under which the third party grants, to any of the\nparties who would receive the covered work from you, a discriminatory\npatent license **(a)** in connection with copies of the covered work\nconveyed by you (or copies made from those copies), or **(b)** primarily\nfor and in connection with specific products or compilations that\ncontain the covered work, unless you entered into that arrangement,\nor that patent license was granted, prior to 28 March 2007.\n\nNothing in this License shall be construed as excluding or limiting\nany implied license or other defenses to infringement that may\notherwise be available to you under applicable patent law.\n\n### 12. No Surrender of Others' Freedom\n\nIf conditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot convey a\ncovered work so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you may\nnot convey it at all. For example, if you agree to terms that obligate you\nto collect a royalty for further conveying from those to whom you convey\nthe Program, the only way you could satisfy both those terms and this\nLicense would be to refrain entirely from conveying the Program.\n\n### 13. Remote Network Interaction; Use with the GNU General Public License\n\nNotwithstanding any other provision of this License, if you modify the\nProgram, your modified version must prominently offer all users\ninteracting with it remotely through a computer network (if your version\nsupports such interaction) an opportunity to receive the Corresponding\nSource of your version by providing access to the Corresponding Source\nfrom a network server at no charge, through some standard or customary\nmeans of facilitating copying of software. This Corresponding Source\nshall include the Corresponding Source for any work covered by version 3\nof the GNU General Public License that is incorporated pursuant to the\nfollowing paragraph.\n\nNotwithstanding any other provision of this License, you have\npermission to link or combine any covered work with a work licensed\nunder version 3 of the GNU General Public License into a single\ncombined work, and to convey the resulting work. The terms of this\nLicense will continue to apply to the part which is the covered work,\nbut the work with which it is combined will remain governed by version\n3 of the GNU General Public License.\n\n### 14. Revised Versions of this License\n\nThe Free Software Foundation may publish revised and/or new versions of\nthe GNU Affero General Public License from time to time. Such new versions\nwill be similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\nEach version is given a distinguishing version number. If the\nProgram specifies that a certain numbered version of the GNU Affero General\nPublic License “or any later version” applies to it, you have the\noption of following the terms and conditions either of that numbered\nversion or of any later version published by the Free Software\nFoundation. If the Program does not specify a version number of the\nGNU Affero General Public License, you may choose any version ever published\nby the Free Software Foundation.\n\nIf the Program specifies that a proxy can decide which future\nversions of the GNU Affero General Public License can be used, that proxy's\npublic statement of acceptance of a version permanently authorizes you\nto choose that version for the Program.\n\nLater license versions may give you additional or different\npermissions. However, no additional obligations are imposed on any\nauthor or copyright holder as a result of your choosing to follow a\nlater version.\n\n### 15. Disclaimer of Warranty\n\nTHERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY\nAPPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT\nHOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY\nOF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM\nIS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF\nALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n### 16. Limitation of Liability\n\nIN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS\nTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY\nGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE\nUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF\nDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD\nPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),\nEVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGES.\n\n### 17. Interpretation of Sections 15 and 16\n\nIf the disclaimer of warranty and limitation of liability provided\nabove cannot be given local legal effect according to their terms,\nreviewing courts shall apply local law that most closely approximates\nan absolute waiver of all civil liability in connection with the\nProgram, unless a warranty or assumption of liability accompanies a\ncopy of the Program in return for a fee.\n\n##
END OF TERMS AND CONDITIONS
\n\n###
How to Apply These Terms to Your New Programs
\n\nIf you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\nTo do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nstate the exclusion of warranty; and each file should have at least\nthe “copyright” line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU Affero General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU Affero General Public License for more details.\n\n You should have received a copy of the GNU Affero General Public License\n along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\nIf your software can interact with users remotely through a computer\nnetwork, you should also make sure that it provides a way for users to\nget its source. For example, if your program is a web application, its\ninterface could display a “Source” link that leads users to an archive\nof the code. There are many ways you could offer source, and different\nsolutions will be better for different programs; see section 13 for the\nspecific requirements.\n\nYou should also get your employer (if you work as a programmer) or school,\nif any, to sign a “copyright disclaimer” for the program, if necessary.\nFor more information on this, and how to apply and follow the GNU AGPL, see\n<>."
},
{
"path": "docs/ALGOLIA-SEARCH.md",
"content": "
Algolia Search
\n\nNexT 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.\n\n1. 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.\n\n1. If a tutorial pops up, you can skip it. Go straight to create an `Index` which will be used later.\n\n \n\n1. 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.\n\n \n\n1. In your site's `_config.yml`, add the following configuration and replace the `applicationID` & `apiKey` & `indexName` with corresponding fields obtained at Algolia.\n\n ```yml\n algolia:\n applicationID: 'Application ID'\n apiKey: 'Search-only API key'\n indexName: 'indexName'\n chunkSize: 5000\n ```\n\n1. 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`.\n\n \n \n\n1. 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.\n\n ```\n $ cd hexo\n $ npm install hexo-algolia\n ```\n\n1. Run the following command to upload index data, keep a weather eye out the output of the command.\n\n ```\n $ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Git Bash\n # set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Windows command line\n $ hexo clean\n $ hexo algolia\n ```\n\n \n\n1. 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.\n\n ```yml\n # Algolia Search\n algolia_search:\n enable: true\n hits:\n per_page: 10\n labels:\n input_placeholder: Search for Posts\n hits_empty: \"We didn't find any results for the search: ${query}\"\n hits_stats: \"${hits} results found in ${time} ms\"\n ```\n\n1. If you want to use a different version from CDN, please follow the instructions below.\n\n You need to **set vendors** in NexT `_config.yml` file:\n ```yml\n vendors:\n ...\n # Algolia Search\n # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js\n # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js\n algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js\n instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js\n ...\n ```\n\n
Known Issues
\n\n1. 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.\n\n1. The [Hexo-Algoliasearch](https://github.com/LouisBarranqueiro/hexo-algoliasearch) plugin provides content indexing functionality, but requires the replacement of keywords in the NEXT theme. The same problem exists with `Record Too Big` for Algolia's free account.\n - Replace all `applicationID` in `source/js/algolia-search.js` with `appId`\n - Replace all `applicationID` in `layout/_partials/head/head.swig` with `appId`\n"
},
{
"path": "docs/AUTHORS.md",
"content": "#
«NexT» Authors
\n\nNexT theme was initially developed by:\n\n- **IIssNaN**: [NexT](https://github.com/iissnan/hexo-theme-next) (2014 - 2017)\n\nWith collaborators from initially repository:\n\n- **Ivan.Nginx**: [DIFF highlight](https://github.com/iissnan/hexo-theme-next/pull/1079),\n [HyperComments](https://github.com/iissnan/hexo-theme-next/pull/1155),\n [`{% note %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1160),\n [`seo` option](https://github.com/iissnan/hexo-theme-next/pull/1311),\n [`{% button %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1328),\n [VK API](https://github.com/iissnan/hexo-theme-next/pull/1381),\n [WordCount plugin support](https://github.com/iissnan/hexo-theme-next/pull/1381),\n [Yandex verification option](https://github.com/iissnan/hexo-theme-next/pull/1381),\n [`{% exturl %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1438),\n [`b2t` option](https://github.com/iissnan/hexo-theme-next/pull/1438),\n [`scrollpercent` option](https://github.com/iissnan/hexo-theme-next/pull/1438),\n [`save_scroll` option](https://github.com/iissnan/hexo-theme-next/pull/1574),\n [Star rating](https://github.com/iissnan/hexo-theme-next/pull/1649),\n [`mobile_layout_economy` option](https://github.com/iissnan/hexo-theme-next/pull/1697),\n [`{% tabs %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1697),\n [`{% label %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1697),\n [**`Gemini`** scheme](https://github.com/iissnan/hexo-theme-next/pull/1697),\n [Menu & Sidebar icons in 1 line](https://github.com/iissnan/hexo-theme-next/pull/1830),\n [Sidebar scrollable](https://github.com/iissnan/hexo-theme-next/pull/1898),\n [Responsive favicons](https://github.com/iissnan/hexo-theme-next/pull/1898)\n and many other [PR's with fixes and enhancements](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aivan-nginx)\n- **Acris**: [Many PR's with fixes and updates](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3AAcris)\n\nAnd best contributors from initially repository:\n\n- **Rainy**: [Gentie comments](https://github.com/iissnan/hexo-theme-next/pull/1301),\n [Han](https://github.com/iissnan/hexo-theme-next/pull/1598)\n and many [PR's with fixes and optimizations](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Ageekrainy)\n- **Jeff**: [Local search](https://github.com/iissnan/hexo-theme-next/pull/694)\n and many [PR's with fixes and improvements](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aflashlab)\n- **Haocen**: [Footer enhancements](https://github.com/iissnan/hexo-theme-next/pull/1886)\n and some other [PR's with improvements](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3AHaocen)\n- **uchuhimo**: [Greatest enhancements for local search](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Auchuhimo)\n- **Kei**: [Change static file setting to support subdirectory](https://github.com/iissnan/hexo-theme-next/pull/4)\n- **Jolyon**: [Swiftype](https://github.com/iissnan/hexo-theme-next/pull/84)\n- **xirong**: [404 page](https://github.com/iissnan/hexo-theme-next/pull/126)\n- **PinkyJie**: [Fix Swiftype](https://github.com/iissnan/hexo-theme-next/pull/132)\n- **Tim Kuijsten**: [Split javascript into separate files](https://github.com/iissnan/hexo-theme-next/pull/152)\n- **iamwent**: [Friendly links](https://github.com/iissnan/hexo-theme-next/pull/250)\n- **arao lin**: [Option to lazyload images](https://github.com/iissnan/hexo-theme-next/pull/269)\n- **Konstantin Pavlov**: [Microdata, opengraph and other semantic features](https://github.com/iissnan/hexo-theme-next/pull/276)\n- **Gary**: [FastClick](https://github.com/iissnan/hexo-theme-next/pull/324)\n- **Octavian**: [Baidu site vertification](https://github.com/iissnan/hexo-theme-next/pull/367)\n- **Henry Chang**: [Facebook SDK](https://github.com/iissnan/hexo-theme-next/pull/410)\n- **XiaMo**: [LeanCloud visitors](https://github.com/iissnan/hexo-theme-next/pull/439)\n- **iblogc**: [Fix UA in Duoshuo](https://github.com/iissnan/hexo-theme-next/pull/489)\n- **Vincent**: [Automatic headline ID's](https://github.com/iissnan/hexo-theme-next/pull/588)\n- **cissoid**: [Tencent analytics](https://github.com/iissnan/hexo-theme-next/pull/603)\n- **CosmoX**: [AddThis](https://github.com/iissnan/hexo-theme-next/pull/660)\n- **Jason Guo**: [Reward for post](https://github.com/iissnan/hexo-theme-next/pull/687)\n- **Jerry Bendy**: [CNZZ counter](https://github.com/iissnan/hexo-theme-next/pull/712)\n- **Hui Wang**: [Wechat subscriber](https://github.com/iissnan/hexo-theme-next/pull/788)\n- **PoonChiTim**: [Busuanzi counter](https://github.com/iissnan/hexo-theme-next/pull/809)\n- **hydai**: [Facebook comments](https://github.com/iissnan/hexo-theme-next/pull/925)\n- **OAwan**: [`canonical` option](https://github.com/iissnan/hexo-theme-next/pull/931)\n- **Jim Zenn**: [Google Calendar](https://github.com/iissnan/hexo-theme-next/pull/1167)\n- **Abner Chou**: [Disqus improvements](https://github.com/iissnan/hexo-theme-next/pull/1173)\n- **Igor Fesenko**: [Application Insights](https://github.com/iissnan/hexo-theme-next/pull/1257)\n- **jinfang**: [Youyan comments](https://github.com/iissnan/hexo-theme-next/pull/1324)\n- **AlynxZhou**: [`canvas_nest` option](https://github.com/iissnan/hexo-theme-next/pull/1327)\n- **aleon**: [Tencent MTA](https://github.com/iissnan/hexo-theme-next/pull/1408)\n- **asmoker**: [LiveRe comments](https://github.com/iissnan/hexo-theme-next/pull/1415)\n- **Jacksgong**: [Copyright on posts](https://github.com/iissnan/hexo-theme-next/pull/1497)\n- **zhaiqianfeng**: [Changyan comments](https://github.com/iissnan/hexo-theme-next/pull/1514)\n- **zproo**: [`canvas_ribbon` option](https://github.com/iissnan/hexo-theme-next/pull/1565)\n- **jjandxa**: [`three_waves`](https://github.com/iissnan/hexo-theme-next/pull/1534),\n [`canvas_lines` and `canvas_sphere`](https://github.com/iissnan/hexo-theme-next/pull/1595) options\n- **shenzekun**: [Load bar at the top](https://github.com/iissnan/hexo-theme-next/pull/1689)\n- **elkan1788**: [Upgrade jiathis share](https://github.com/iissnan/hexo-theme-next/pull/1796)\n- **xCss**: [Valine comment system support](https://github.com/iissnan/hexo-theme-next/pull/1811)\n- **Julian Xhokaxhiu**: [`override` option](https://github.com/iissnan/hexo-theme-next/pull/1861)\n- **LEAFERx**: [NeedMoreShare2](https://github.com/iissnan/hexo-theme-next/pull/1913)\n- **aimingoo & LEAFERx**: [Gitment supported with Mint](https://github.com/iissnan/hexo-theme-next/pull/1919)\n- **LeviDing**: [Fix the bug of Gitment](https://github.com/iissnan/hexo-theme-next/pull/1944)\n- **maple3142**: [Firestore visitor counter](https://github.com/iissnan/hexo-theme-next/pull/1978)\n\nIt 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).\n\nP.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.\n"
},
{
"path": "docs/DATA-FILES.md",
"content": "
Data Files
\n\nCurrently, 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.\n\nAt 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:\n1. Configurations are splitted into two pieces\n2. Users may be confused which place should be for options\n\nIn order to resolve this issue, NexT provides the following two solutions.\n\n
Option 1: Hexo-Way
\n\nWith 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.\n\nIf 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.\n\n### Usage\n\n1. Please confirm that the `/source/_data/next.yml` file does not exist (delete it if exists).\n2. Copy needed NexT theme options from theme's `/themes/next/_config.yml` into `/_config.yml`, then\\\n 2.1. Move all this settings to the right with two spaces (in Visual Studio Code: select all strings, CTRL + ]).\\\n 2.2. Add `theme_config:` parameter above all this settings.\n\n### Useful links\n\n* [Hexo Configuration](https://hexo.io/docs/configuration.html)\n* [Hexo Pull #757](https://github.com/hexojs/hexo/pull/757)\n\n
Option 2: NexT-Way
\n\nWith 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`.\nBut 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).\n\nIf 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.\n\nThis 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.\n\n### Usage\n\n1. Please ensure you are using Hexo 3 (or above).\n2. Create an file named `next.yml` in site's `/source/_data` directory (create `_data` directory if it does not exist).\n\n
And after that steps there are 2 variants, need to choose only one of them and resume next steps.
\n\n* **Variant 1: `override: false` (default)**:\n\n 1. Check your `override` option in default NexT config, it must set on `false`.\\\n In `next.yml` it must not be defined or set on `false` too.\n 2. Copy needed options from both site's `/_config.yml` and theme's `/themes/next/_config.yml` into `/source/_data/next.yml`.\n\n* **Variant 2: `override: true`**:\n\n 1. In `next.yml` set `override` option on `true`.\n 2. Copy **all** NexT theme options from theme's `/themes/next/_config.yml` into `/source/_data/next.yml`.\n\n3. Then, in main site's `/_config.yml` need to define `theme: next` option (and if needed, `source_dir: source`).\n4. Use standard parameters to start server, generate or deploy (`hexo clean && hexo g -d && hexo s`).\n\n### Useful links\n\n* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328)\n"
},
{
"path": "docs/INSTALLATION.md",
"content": "
Installation
\n\n
Step 1 → Go to Hexo dir
\n\nChange dir to **Hexo root** directory. There must be `node_modules`, `source`, `themes` and other directories:\n\n```sh\n$ cd hexo\n$ ls\n_config.yml node_modules package.json public scaffolds source themes\n```\n\n
Step 2 → Get NexT
\n\n
Download theme from GitHub. \nThere are 3 options to do it, need to choose only one of them.
\n\n### Option 1: Download [latest release version][releases-latest-url]\n\n At most cases **stable**. Recommended for beginners.\n\n * Install with [curl & tar & wget][curl-tar-wget-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -s https://api.github.com/repos/theme-next/hexo-theme-next/releases/latest | grep tarball_url | cut -d '\"' -f 4 | wget -i - -O- | tar -zx -C themes/next --strip-components=1\n ```\n This variant will give to you **only latest release version** (without `.git` directory inside).\\\n So, there is impossible to update this version with `git` later.\\\n Instead you always can use separate configuration (e.g. [data-files][docs-data-files-url]) and download new version inside old directory (or create new directory and redefine `theme` in Hexo config), without losing your old configuration.\n\n### Option 2: Download [tagged release version][releases-url]\n\n In rare cases useful, but not recommended.\\\n You must define version. Replace `v6.0.0` with any version from [tags list][tags-url].\n\n * Variant 1: Install with [curl & tar][curl-tar-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1\n ```\n Same as above under `curl & tar & wget` variant, but will download **only concrete version**.\n\n * Variant 2: Install with [git][git-url]:\n\n ```sh\n $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next\n ```\n This variant will give to you the **defined release version** (with `.git` directory inside).\\\n And in any time you can switch to any tagged release, but with limit to defined version.\n\n### Option 3: Download [latest master branch][download-latest-url]\n\n May be **unstable**, but includes latest features. Recommended for advanced users and for developers.\n\n * Variant 1: Install with [curl & tar][curl-tar-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1\n ```\n Same as above under `curl & tar & wget` variant, but will download **only latest master branch version**.\\\n At some cases useful for developers.\n\n * Variant 2: Install with [git][git-url]:\n\n ```sh\n $ git clone https://github.com/theme-next/hexo-theme-next themes/next\n ```\n\n This variant will give to you the **whole repository** (with `.git` directory inside).\\\n And in any time you can [update current version with git][update-with-git-url] and switch to any tagged release or on latest master or any other branch.\\\n At most cases useful as for users and for developers.\n\n Get tags list:\n\n ```sh\n $ cd themes/next\n $ git tag -l\n …\n v6.0.0\n v6.0.1\n v6.0.2\n ```\n\n For example, you want to switch on `v6.0.1` [tagged release version][tags-url]. Input the following command:\n\n ```sh\n $ git checkout tags/v6.0.1\n Note: checking out 'tags/v6.0.1'.\n …\n HEAD is now at da9cdd2... Release v6.0.1\n ```\n\n And if you want to switch back on [master branch][commits-url], input this command:\n\n ```sh\n $ git checkout master\n ```\n\n
\n\nNexT provides two render engines for displaying Math Equations.\n\nIf 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`).\n\nNotice: 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.\n\n
Provided Render Engine
\n\nFor now, NexT provides two Render Engines: [MathJax](https://www.mathjax.org/) and [Katex](https://khan.github.io/KaTeX/).\n\n### MathJax\n\nIf 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.\n\nFirstly, you need to uninstall the original renderer `hexo-renderer-marked`, and install **one of the renderer above**:\n\n```sh\nnpm uninstall hexo-renderer-marked\nnpm install hexo-renderer-pandoc # or hexo-renderer-kramed\n```\n\nSecondly, in `next/_config.yml`, turn on `enable` of `mathjax`.\n\n```yml\nmath:\n ...\n mathjax:\n enable: true\n```\n\nFinally, run standard Hexo generate, deploy process or start the server:\n\n```sh\nhexo clean && hexo g -d\n# or hexo clean && hexo s\n```\n\n#### Numbering and referring equations in MathJax\n\nIn the new version of NexT, we have added feature to automatically number equations and to refer to equations. We briefly describe how to use this feature below.\n\nIn general, to make the automatic equation numbering work, you have to wrap your LaTeX equations in `equation` environment. Using the plain old style (i.e., wrap an equation with two dollar signs in each side) will not work. How to refer to an equation? Just give a `\\label{}` tag and then in your later text, use `\\ref{}` or `\\eqref{}` to refer it. Using `\\eqref{}` is preferred since if you use `\\ref{}`, there are no parentheses around the equation number. Below are some of the common scenarios for equation numbering.\n\nFor simple equations, use the following form to give a tag,\n\n```latex\n$$\\begin{equation}\\label{eq1}\ne=mc^2\n\\end{equation}$$\n```\n\nThen, you can refer to this equation in your text easily by using something like\n\n```\nthe famous matter-energy equation $\\eqref{eq1}$ proposed by Einstein ...\n```\n\nFor multi-line equations, inside the `equation` environment, you can use the `aligned` environment to split it into multiple lines:\n\n```latex\n$$\\begin{equation}\\label{eq2}\n\\begin{aligned}\na &= b + c \\\\\n &= d + e + f + g \\\\\n &= h + i\n\\end{aligned}\n\\end{equation}$$\n```\n\nWe can use `align` environment to align multiple equations. Each of these equations will get its own numbers.\n\n```\n$$\\begin{align}\na &= b + c \\label{eq3} \\\\\nx &= yz \\label{eq4}\\\\\nl &= m - n \\label{eq5}\n\\end{align}$$\n```\n\nIn the `align` environment, if you do not want to number one or some equations, just [use `\\nonumber`](https://tex.stackexchange.com/questions/17528/show-equation-number-only-once-in-align-environment) right behind these equations. Like the following:\n\n```latex\n$$\\begin{align}\n-4 + 5x &= 2+y \\nonumber \\\\\n w+2 &= -1+w \\\\\n ab &= cb\n\\end{align}$$\n```\n\nSometimes, you want to use more “exotic” style to refer your equation. You can use `\\tag{}` to achieve this. For example:\n\n```latex\n$$x+1\\over\\sqrt{1-x^2} \\tag{i}\\label{eq_tag}$$\n```\n\nFor 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.\n\n### Katex\n\nThe Katex engine is a **much faster** math render engine compared to MathJax. And it could survive without JavaScript.\n\nBut, what Katex supports is not as full as MathJax. You could check it from the Useful Links below.\n\nIf you use Katex to render Math Equations, you need to use **only one of those renderer**: [hexo-renderer-markdown-it-plus](https://github.com/CHENXCHEN/hexo-renderer-markdown-it-plus) or [hexo-renderer-markdown-it](https://github.com/hexojs/hexo-renderer-markdown-it).\n\nFirstly, you need to uninstall the original renderer `hexo-renderer-marked`, and **install one of selected above**.\n\n```sh\nnpm uninstall hexo-renderer-marked\nnpm install hexo-renderer-markdown-it-plus\n# or hexo-renderer-markdown-it\n```\n\nSecondly, in `next/_config.yml`, turn on `enable` option of `katex`.\n\n```yml\nmath:\n ...\n katex:\n enable: true\n```\n\nFinally, run the standard Hexo generate, deploy process or start the server:\n\n```sh\nhexo clean && hexo g -d\n# or hexo clean && hexo s\n```\n\n#### If you use hexo-renderer-markdown-it\n\nIf you use `hexo-renderer-markdown-it`，you also need to add `markdown-it-katex` as its plugin：\n\n```\nnpm install markdown-it-katex\n```\n\nAnd then in `hexo/_config.yml` you need to add `markdown-it-katex` as a plugin for `hexo-renderer-markdown-it`:\n\n```yml\n# config of hexo-renderer-markdown-it\nmarkdown:\n render:\n html: true\n xhtmlOut: false\n breaks: true\n linkify: true\n typographer: true\n quotes: '“”‘’'\n plugins:\n - markdown-it-katex\n```\n\n#### Known Bugs\n\n1. Firstly, please check [Common Issues](https://github.com/Khan/KaTeX#common-issues) of Katex.\n2. Displayed Math (i.e. `$$...$$`) needs to started with new clear line.\\\n In other words: you must not have any characters (except of whitespaces) **before the opening `$$` and after the ending `$$`** ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)).\n3. Don't support Unicode ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)).\n4. Inline Math (..`$...$`) must not have white spaces **after the opening `$` and before the ending `$`** ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)).\n5. If you use math in Heading (i.e. `## Heading`).\\\n 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)).\n6. 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)).\n\nWe currently use Katex 0.11.1, some of those bugs might be caused by the outdated version of Katex we use.\n\nBut, 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.\n\nWe 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.\n\n### Useful Links\n\n* [Speed test between Katex and MathJax](https://www.intmath.com/cg5/katex-mathjax-comparison.php)\n* [Function support by Katex](https://khan.github.io/KaTeX/function-support.html)\n\n
Configuration Specifications
\n\nATTENTION! When you edit those configs, **don't change indentation!**\n\nCurrently, all NexT config use **2 spaces indents**.\n\nIf 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`)\n\n```yml\n# Math Formulas Render Support\nmath:\n # Default (true) will load mathjax / katex script on demand.\n # That is it only render those page which has `mathjax: true` in Front-matter.\n # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.\n per_page: true\n\n # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.\n mathjax:\n enable: true\n # See: https://mhchem.github.io/MathJax-mhchem/\n mhchem: false\n\n # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.\n katex:\n enable: false\n # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex\n copy_tex: false\n```\n\n### `per_page`\n\n`true` or `false`, default is `true`.\n\nThis option is to control whether to render Math Equations every page.\n\nThe behavior of default (`true`) is to render Math Equations **on demand**.\n\nIt will only render those posts which have `mathjax: true` in their Front-matter.\n\nFor example:\n\n```md\n\n---\ntitle: 'Will Render Math'\nmathjax: true\n---\n....\n```\n\n```md\n\n---\ntitle: 'Not Render Math'\nmathjax: false\n---\n....\n```\n\n```md\n\n---\ntitle: 'Not Render Math Either'\n---\n....\n```\n\nWhen you set it to `false`, the math will be rendered on **EVERY PAGE**.\n"
},
{
"path": "docs/UPDATE-FROM-5.1.X.md",
"content": "
Update from NexT v5.1.x
\n\nNexT 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.\n\nThere are no hard breaking changes between 5.1.x and the latest version. It's change major version to 7 because:\n\n1. Main repo was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [theme-next](https://github.com/theme-next) organization.\n2. Most libraries under the `next/source/lib` directory was moved out to [external repos under NexT organization](https://github.com/theme-next).\n3. 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.\n\nSo, we suggest to update from version 5 to version 7 in this way:\n\n1. You don't touch old `next` dir and just do some copies of NexT files:\\\n 1.1. `_config.yml` or `next.yml` (if you used [data-files](DATA-FILES.md)).\\\n 1.2. Custom CSS styles what placed in `next/source/css/_custom/*` and `next/source/css/_variables/*` directories.\\\n 1.3. Custom layout styles what placed in `next/layout/_custom/*`.\\\n 1.4. Any another possible custom additions which can be finded by compare tools between repos.\n2. 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.\n3. 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.\n4. Update language configuration (For Chinese)\n\n 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\n\n 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.\n5. Update Hexo and Hexo plugin\n\n 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.\n\nAnd how to enable 3rd-party libraries see [here](https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md#plugins).\n"
},
{
"path": "docs/ru/DATA-FILES.md",
"content": "
Дата Файлы
\n\nОбновление темы NexT через пулы проходит не слишком гладко. Часто происходит конфликтная ситуация при обновлении по команде `git pull`, хотя её и можно обойти, если смерджить настройки в файле конфигурации вручную.\n\nНа данный момент, пользователи хранят одни настройки в корневом `_config.yml` (Hexo), а другие настройки в конфиге темы `_config.yml` (NexT). И всё вроде бы ничего, но имеются некоторые недостатки:\n1. Конфигурация разделяется на две части.\n2. Пользователи могут запутаться, в каком файле какие должны быть настройки.\n\nВо избежании проблемы, NexT предлагает два варианта.\n\n
Способ 1: Hexo-Путь
\n\nИспользуя этот способ, вся конфигурация будет раположена в корневом конфиге hexo (`/_config.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`) или создавать какие-либо новые файлы. Но в этом случае необходимо сохранять двойные отступы внутри `theme_config` параметра.\n\nЕсли в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` в редактируемый `/_config.yml` и настроить по своему усмотрению.\n\n### Использование\n\n1. Проверяем на существование `/source/_data/next.yml` файл (удаляем, если существует).\n2. Копируем необходимые опции из конфига темы NexT `/themes/next/_config.yml` в `/_config.yml`, затем\\\n 2.1. Сдвигаем все опции вправо на 2 пробела (в Visual Studio Code: выделяем все строки, CTRL + ]).\\\n 2.2. Добавляем `theme_config:` параметр перед всеми этими настройками.\n\n### Полезные ссылки\n\n* [Конфигурация Hexo](https://hexo.io/ru/docs/configuration.html)\n* [Hexo Pull #757](https://github.com/hexojs/hexo/pull/757)\n\n
Способ 2: NexT-Путь
\n\nИспользуя этот способ, вся конфигурация будет храниться в одном файле (`/source/_data/next.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`).\nНо с этим способом могут не корректно обрабатываться все внешние библиотеки hexo при использовании их дополнительных опций (например, опции модуля `hexo-server` могут быть считаны только из стандартного конфига hexo).\n\nЕсли в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `/themes/next/_config.yml` во внешний `_data/next.yml` и настроить по своему усмотрению.\n\nЭтот метод опирается на Hexo [дата-файлов](https://hexo.io/docs/data-files.html). И т.к. дата-файлы были представлены в Hexo 3, необходимо обновиться до Hexo 3.0 (или выше) для использования этой возможности.\n\n### Использование\n\n1. Убеждаемся, что Hexo версии 3 (или выше).\n2. Создаём файл под именем `next.yml` в корневой директории сайта — `/source/_data` (создаём директорию `_data`, если отсутствует).\n\n
И после этих шагов есть 2 варианта, нужно выбрать только 1 из них и продолжить следующие шаги.
\n\n* **Вариант 1: `override: false` (по-умолчанию)**:\n\n 1. Проверяем опцию `override` в стандартном конфиге NexT'а, должно быть установлено в `false`.\\\n В файле `next.yml` эта опция не должна быть вписана вовсе или вписана и установлена в `false`.\n 2. Копируем настройки из конфига темы NexT (`_config.yml`) и из корневого конфига сайта (`_config.yml`) в файл `/source/_data/next.yml`.\n\n* **Вариант 2: `override: true`**:\n\n 1. В файле `next.yml` ставим опцию `override` в `true`.\n 2. Копируем **все** опции из оригинального конфига NexT'а `/themes/next/_config.yml` в `/source/_data/next.yml`.\n\n3. Затем, в корневом конфиге сайта `/_config.yml` необходимо установить опцию `theme: next` (и если требуется, `source_dir: source`).\n4. Используем станадартные параметры для запускаь генерации или развёртывания (`hexo clean && hexo g -d && hexo s`).\n\n### Полезные ссылки\n\n* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328)\n"
},
{
"path": "docs/ru/INSTALLATION.md",
"content": "
Установка
\n\n
Шаг 1 → Идём в директорию Hexo
\n\nМеняем каталог на **корневой hexo**. Там должны находиться `node_modules`, `source`, `themes` и другие папки:\n\n```sh\n$ cd hexo\n$ ls\n_config.yml node_modules package.json public scaffolds source themes\n```\n\n
Шаг 2 → Скачиваем NexT
\n\n
Скачиваем тему с GitHub. \nИмеются 3 способа как зделать это, нужно выбрать только 1 из них.
\n\n### Способ 1: Скачиваем [последнюю версию релиза][releases-latest-url]\n\n В большинстве случаев **стабильна**. Рекомендуется для начинающих пользователей.\n\n * Установка с помощью [curl & tar & wget][curl-tar-wget-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -s https://api.github.com/repos/theme-next/hexo-theme-next/releases/latest | grep tarball_url | cut -d '\"' -f 4 | wget -i - -O- | tar -zx -C themes/next --strip-components=1\n ```\n Этим способом Вы скачаете **только последнюю версию релиза** (без директории `.git` внутри).\\\n Поэтому, в дальнейшем будет невозможно обновить эту версию через `git`.\\\n Зато всегда можно использовать отдельную конфигурацию (т.е. [дата-файлы][docs-data-files-url]) и скачивать новую версию перезаписывая старую (или создать новый каталог и переопределить параметр `theme` в конфиге Hexo), без потери старой конфигурации.\n\n### Способ 2: Скачиваем [указанную версию релиза][releases-url]\n\n В редких случаях полезно, но не рекомендуется.\\\n Необходимо указать версию. Замените `v6.0.0` на любую версию из [списка тэгов][tags-url].\n\n * Вариант 1: Установка с помощью [curl & tar][curl-tar-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1\n ```\n То же, что и описано выше в способе `curl & tar & wget`, но скачает **только конкретную версию**.\n\n * Вариант 2: Установка с помощью [git][git-url]:\n\n ```sh\n $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next\n ```\n Этот вариант скачает **указанную версию релиза** (включая директорию `.git` внутри).\\\n И в любой момент Вы можете переключиться на любую весию тэга, но с лимитом до указанной версии.\n\n### Способ 3: Скачиваем [последнюю мастер-ветку][download-latest-url]\n\n Иногда может быть **нестабильна**, но включает самые последние нововведения. Рекомендуется для продвинутых пользователей и для разработчиков.\n\n * Вариант 1: Установка с помощью [curl & tar][curl-tar-url]:\n\n ```sh\n $ mkdir themes/next\n $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1\n ```\n То же, что и описано выше в варианте `curl & tar & wget`, но скачает **только последнюю мастер-ветку**.\\\n В некоторых случаях полезно для разработчиков.\n\n * Вариант 2: Установка с помощью [git][git-url]:\n\n ```sh\n $ git clone https://github.com/theme-next/hexo-theme-next themes/next\n ```\n\n Этот вариант скачает **весь репозиторий** (включая директорию `.git` внутри).\\\n И в любой момент Вы можете [обновить текущую версию через git][update-with-git-url] и переключиться на любую версию тэга или на последнюю мастер или любую другую ветку.\\\n В большинстве случаев полезно как для пользователей, так и для разработчиков.\n\n Смотрим список тэгов:\n\n ```sh\n $ cd themes/next\n $ git tag -l\n …\n v6.0.0\n v6.0.1\n v6.0.2\n ```\n\n Например, Вы хотите переключиться на [версию релиза][tags-url] `v6.0.1`. Вводим следующую команду:\n\n ```sh\n $ git checkout tags/v6.0.1\n Note: checking out 'tags/v6.0.1'.\n …\n HEAD is now at da9cdd2... Release v6.0.1\n ```\n\n И если вы хотите переключиться обратно на [мастер-ветку][commits-url], вводим следующее:\n\n ```sh\n $ git checkout master\n ```\n\n
\n\n## Установка\n\nПростейший вариант установки — склонировать весь репозиторий:\n\n```sh\n$ cd hexo\n$ git clone https://github.com/theme-next/hexo-theme-next themes/next\n```\n\nИли предлагаю почитать [детальные инструкции по установке][docs-installation-url], если вариант выше не устраивает.\n\n## Плагины\n\nВ конфиге NexT'а теперь можно найти зависимости на каждый модуль, который был вынесен во внешние репозитории, которые могут быть найдены по [ссылке основной организации][official-plugins-url].\n\nНапример, Вы хотите использовать `pjax` для своего сайта. Открываем конфиг NexT'а и находим:\n\n```yml\n# Easily enable fast Ajax navigation on your website.\n# Dependencies: https://github.com/theme-next/theme-next-pjax\npjax: true\n```\n\nЗатем включаем параметр `pjax` и переходим по ссылке «Dependencies» с дальнейшеми инструкциями по установке этого модуля.\n\n## Обновление\n\nNexT выпускает новые версии каждый месяц. Можно обновить до последней мастер-ветки следующей командой:\n\n```sh\n$ cd themes/next\n$ git pull\n```\n\nА если всплывают ошибки во время обновления (что-то наподобии **«Commit your changes or stash them before you can merge»**), рекомендуется ознакомиться с особенностью хранения [дата-файлов в Hexo][docs-data-files-url].\\\nКак бы то ни было, можно обойти ошибки при обновлении если «Закомитить», «Стэшнуть» или «Откатить» локальные изменения. Смотрим [здесь](https://stackoverflow.com/a/15745424/5861495) как это сделать.\n\n**Если нужно обновиться с версии v5.1.x на последней версиями, читаем [здесь][docs-update-5-1-x-url].**\n\n## Обратная связь\n\n* Посетите [Awesome NexT][awesome-next-url] список.\n* Вступить в наши [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] чаты.\n* [Добавить или улучшить перевод][i18n-url] за несколько секунд.\n* Сообщить об ошибке в разделе [GitHub Issues][issues-bug-url].\n* Запросить новую возможность на [GitHub][issues-feat-url].\n* Голосовать за [популярные запросы возможностей][feat-req-vote-url].\n\n## Содействие\n\n[![][contributors-image]][contributors-url]\n\nПриветсвуется любое содействие, не стесняйтесь сообщать «Баги», брать «Форки» и вливать «Пулы».\n\n## Благодарности\n\n
\n «NexT» выражает особую благодарность этим замечательным сервисам, которые спонсируют нашу основную инфраструктуру:\n \n \n \n \n \n \n GitHub позволяет нам хостить Git-репозиторий, Netlify позволяет нам деплоить документацию.\n \n \n \n \n Crowdin позволяет нам удобно переводить документацию.\n \n \n \n \n \n \n Codacy позволяет нам контролировать качество кода, Travis CI позволяет нам запускать набор тестов.\n
\n\nМежду версией 5.1.x и последней версиями нет жёстких изменений. Версия сменилась на мажорную 7 по следующим причинам:\n1. Основной репозиторий перебазировался из профиля [iissnan'а](https://github.com/iissnan/hexo-theme-next) в [theme-next](https://github.com/theme-next) организацию.\n2. Большинство библиотек в `next/source/lib` директории были вынесены в [отдельные репозитории под организацией NexT](https://github.com/theme-next).\n3. 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) что обеспечивает улучшенную производительность при генерации сайта.\n\nПоэтому, я предлагаю обновиться с версии 5 на версию 7 следующим способом:\n\n1. Вы не трогаете старую директорию `next`, а всего-лишь делаете резервные копии файлов NexT:\\\n 1.1. `config.yml` или `next.yml` (если Вы использовали [дата-файлы](DATA-FILES.md)).\\\n 1.2. Пользовательских CSS-стилей, которые расположены в `next/source/css/_custom/*` и `next/source/css/_variables/*` директориях.\\\n 1.3. Пользовательских layout-стилей, которые расположены в `next/layout/_custom/*`.\\\n 1.4. Любые другие всевозможные пользовательские изменения, которые могут быть найдены любым инструментом для сравнения файлов.\n2. Склонировать новый репозиторий в любую другую директорию, отличную от `next`. Например, в директорию `next-reloaded`: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. Итак, нет необходимости трогать старую NexT 5.1.x директорию и можно работать с новой `next-reloaded`.\n3. Открываем главную Hexo-конфигурацию и устанавливаем параметр темы: `theme: next-reloaded`. Так Ваша директория `next-reloaded` должна грузиться при генерации. Если Вы будете наблюдать какие-либо баги или Вам попросту не нравится эта новая версия, в любой момент Вы можете использовать старую 5.1.x.\n\nА как активировать 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).\n"
},
{
"path": "docs/zh-CN/ALGOLIA-SEARCH.md",
"content": "
Algolia 搜索
\n\nNexT 内部提供 Algolia 的搜索功能，要使用此功能请确保所使用的 NexT 版本在 `v5.1.0` 之后。需要注意的是，仅仅将 `next/_config.yml` 中 `algolia_search` 的 `enable` 打开**并不能让你使用 Algolia 搜索**，你还需要**使用对应的 Hexo-Algolia 插件** 才能真正在博客页面中使用 Algolia 搜索。按照下面介绍的步骤操作即可完成 Algolia 搜索的安装。\n\n1. 前往 [Algolia 注册页面](https://www.algolia.com/)，注册一个新账户。 可以使用 GitHub 或者 Google 账户直接登录，注册后的 14 天内拥有所有功能（包括收费类别的）。之后若未续费会自动降级为免费账户，免费账户 总共有 10,000 条记录，每月有 100,000 的可以操作数。注册完成后，创建一个新的 Index，这个 Index 将在后面使用。\n\n \n\n1. 在 `API Keys` 页面找到需要使用的一些配置的值，包括 `Application ID` 和 `Search-Only API Key`。注意，`Admin API Key` 需要保密保存，不要外泄。\n\n \n\n1. 编辑 `站点配置文件`，新增以下配置，除了 `chunkSize` 字段，替换成在 Algolia 获取到的值：\n\n ```yml\n algolia:\n applicationID: 'Application ID'\n apiKey: 'Search-Only API Key'\n indexName: 'indexName'\n chunkSize: 5000\n ```\n\n1. 在 `API Keys` 页面，点击 `All API Keys` 切换到对应的页面中。接着点击 `New API Key` 按钮，来**编辑权限**。在弹出框中找到 ACL ，**输入 addObject、 deleteObject、listIndexes、deleteIndex 权限**，然后点击最下方的 `Create` 按钮。将这个新创建的 API Key 复制到剪贴板，我们称之为 `High-privilege API key`。\n\n \n \n\n1. 在 Index 和 API Key 创建完成后，此时这个 Index 里未包含任何数据。接下来需要安装 [Hexo Algolia](https://github.com/oncletom/hexo-algolia) 扩展，这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录，执行命令安装：\n\n ```\n $ cd hexo\n $ npm install hexo-algolia\n ```\n\n1. 当配置完成，在站点根目录下执行以下命令来更新上传 Index。请注意观察命令的输出。\n\n ```\n $ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Git Bash\n # set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Windows CMD 命令行\n $ hexo clean\n $ hexo algolia\n ```\n\n \n\n1. 更改`主题配置文件`，找到 Algolia Search 配置部分，将 `enable` 改为 `true`。同时你需要**关闭**其他搜索插件，如 Local Search 等。你也可以根据需要调整 `labels` 中的文本：\n\n ```yml\n # Algolia Search\n algolia_search:\n enable: true\n hits:\n per_page: 10\n labels:\n input_placeholder: Search for Posts\n hits_empty: \"We didn't find any results for the search: ${query}\"\n hits_stats: \"${hits} results found in ${time} ms\"\n ```\n\n1. 如果你需要通过 CDN 使用其它版本的 algolia-instant-search ，请根据以下步骤操作。\n\n 你需要在`主题配置文件`中的 vendors 字段进行设置：\n\n ```yml\n vendors:\n ...\n # Algolia Search\n # algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js\n # instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js\n algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js\n instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js\n ...\n ```\n\n
\n\n注意，在修改配置选项时，**不要更改配置的缩进**；\n\n目前，NexT 的所有配置都采用**2 空格的缩进**；\n\n如果配置的内容接在冒号后面，那么内容和冒号之间必须有一个空格(例如`enable: true`)\n\n```yml\n# Math Formulas Render Support\nmath:\n # Default (true) will load mathjax / katex script on demand.\n # That is it only render those page which has `mathjax: true` in Front-matter.\n # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.\n per_page: true\n\n # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.\n mathjax:\n enable: true\n # See: https://mhchem.github.io/MathJax-mhchem/\n mhchem: false\n\n # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.\n katex:\n enable: false\n # See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex\n copy_tex: false\n```\n\n### `per_page`\n\n`true` 或者 `false`，默认为 `true`。\n\n这个选项是控制是否在每篇文章都渲染数学公式；\n\n默认(`true`) 的行为是**只对 Front-matter 中含有 `mathjax: true` 的文章进行数学公式渲染**。\n\n如果 Front-matter 中不含有 `mathjax: true`，或者 `mathjax: false`，那么 NexT 将不会对这些文章进行数学公式渲染。\n\n例如：\n\n```md\n\n---\ntitle: 'Will Render Math'\nmathjax: true\n---\n....\n```\n\n```md\n\n---\ntitle: 'Not Render Math'\nmathjax: false\n---\n....\n```\n\n```md\n\n---\ntitle: 'Not Render Math Either'\n---\n....\n```\n\n当你将它设置为 `false` 时，它就会在每个页面都加载 MathJax 或者 Katex 来进行数学公式渲染。\n"
},
{
"path": "docs/zh-CN/README.md",
"content": "
\n {%- endif %}\n {% include '_third-party/math/index.swig' %}\n {% include '_third-party/quicklink.swig' %}\n\n {{- next_inject('bodyEnd') }}\n {%- if theme.pjax %}\n
\n {%- endif %}\n\n\n"
},
{
"path": "layout/_macro/post-collapse.swig",
"content": "{% macro render(posts) %}\n{%- set current_year = '1970' %}\n{%- for post in posts.toArray() %}\n\n {%- set year = date(post.date, 'YYYY') %}\n\n {%- if year !== current_year %}\n {%- set current_year = year %}\n
\n {{ current_year }}\n
\n {%- endif %}\n\n \n \n\n
\n \n
\n\n
\n {%- if post.link %}{# Link posts #}\n {%- set postTitleIcon = '' %}\n {%- set postText = post.title or post.link %}\n {{ next_url(post.link, postText + postTitleIcon, {class: 'post-title-link post-title-link-external', itemprop: 'url'}) }}\n {% else %}\n \n {{ post.title or __('post.untitled') }}\n \n {%- endif %}\n
\n\n {%- set menuIcon = '' %}\n {%- if theme.menu_settings.icons %}\n {%- set menuIcon = '' %}\n {%- endif %}\n {%- set menuText = __('menu.' + name) | replace('menu.', '') %}\n\n {%- set menuBadge = '' %}\n {%- if theme.menu_settings.badges %}\n {%- set badges = {\n archives : site.posts.length,\n categories: site.categories.length,\n tags : site.tags.length\n }\n %}\n {%- for menu, count in badges %}\n {%- if name == menu %}\n {%- set menuBadge = '' + count + '' %}\n {%- endif %}\n {%- endfor %}\n {%- endif %}\n\n {{ next_url(itemURL, menuIcon + menuText + menuBadge, {rel: 'section'}) }}\n\n
\n\n{% endmacro %}\n"
},
{
"path": "layout/_partials/header/menu.swig",
"content": "{% import 'menu-item.swig' as menu_item with context %}\n\n\n"
},
{
"path": "layout/_partials/header/sub-menu.swig",
"content": "{% import '_partials/header/menu-item.swig' as menu_item with context %}\n\n{%- if theme.menu and is_page() %}\n {# Submenu & Submenu-2 #}\n {%- for name, value in theme.menu %}\n {%- set respath = value %}\n {%- if value == '[object Object]' %}\n\n {# If current URL is value of parent submenu 'default' path #}\n {%- set currentParentUrl = page.path.split('/')[0] | trim %}\n {%- if currentParentUrl == value.default.split('||')[0] | trim | replace('/', '') %}\n\n {# Submenu items #}\n
\n {%- for subname, subvalue in value %}\n {# For main submenu items #}\n {%- if subvalue != '[object Object]' %}\n {%- set itemName = subname | lower %}\n {%- if itemName == 'default' %}\n {%- set parentValue = subvalue.split('||')[0] | trim %}\n {% else %}\n {%- if subvalue.startsWith('http') %}\n {%- set respath = subvalue %}\n {% else %}\n {%- set respath = parentValue + subvalue %}\n {%- endif %}\n {{ menu_item.render(subname, itemName, respath) }}\n {%- endif %}\n {% else %}\n {# For 'default' submenu item in main submenu #}\n {%- set itemName = subname | lower %}\n {%- for subname2, subvalue2 in subvalue %}\n {%- if subname2 == 'default' %}\n {%- set respath = parentValue + subvalue2 %}\n {{ menu_item.render(subname, itemName, respath) }}\n {%- endif %}\n {%- endfor %}\n {%- endif %}\n {%- endfor %}\n
\n {# End Submenu items #}\n\n {# Submenu-2 #}\n {%- for name, value in theme.menu %}\n {%- set respath = value %}\n {%- if value == '[object Object]' %}\n\n {%- for subname, subvalue in value %}\n {%- set itemName = subname | lower %}\n {%- if itemName == 'default' %}\n {%- set parentValue = subvalue.split('||')[0] | trim %}\n {%- endif %}\n {%- if subvalue == '[object Object]' %}\n\n {# If current URL is value of parent submenu 'default' path #}\n {%- set paths = page.path.split('/') %}\n {%- if paths.length > 2 %}\n {%- if paths[1] == subvalue.default.split('||')[0] | trim | replace('/', '') %}\n\n {# Submenu-2 items #}\n
\n {%- for subname2, subvalue2 in subvalue %}\n {%- set respath2 = subvalue %}\n {%- set itemName = subname2 | lower %}\n {%- if itemName == 'default' %}\n {%- set parentSubValue = subvalue2.split('||')[0] | trim %}\n {% else %}\n {%- if subvalue2.startsWith('http') %}\n {%- set respath2 = subvalue2 %}\n {% else %}\n {%- set respath2 = parentValue + parentSubValue + subvalue2 %}\n {%- endif %}\n {{ menu_item.render(subname2, itemName, respath2) }}\n {%- endif %}\n {%- endfor %}\n
\n{%- endif %}\n"
},
{
"path": "layout/_partials/page/breadcrumb.swig",
"content": "{%- set paths = page.path.split('/') %}\n{%- set count = paths.length %}\n{%- if count > 2 %}\n {%- set current = 0 %}\n {%- set link = '' %}\n
\n {%- for path in paths %}\n {%- set current = current + 1 %}\n {%- if path != 'index.html' %}\n {%- if current == count - 1 and paths[count - 1] == 'index.html' %}\n
{{ path | upper }}
\n {% else %}\n {%- if link == '' %}\n {%- set link = '/' + path %}\n {% else %}\n {%- set link = link + '/' + path %}\n {%- endif %}\n {%- if path.includes('.html') %}\n
![](\"https://raw.githubusercontent.com/theme-next/hexo-theme-next/master/source/images/logo.svg?sanitize=true\"){kind=logo}
![](\"https://img.shields.io/github/package-json/v/theme-next/hexo-theme-next?style=flat-square\")
![](\"https://img.shields.io/badge/node-%3E=10.9.0-green?style=flat-square\"){kind=icon}
![](\"https://img.shields.io/badge/hexo-%3E=4.0.0-blue?style=flat-square&logo=hexo\"){kind=icon}
![](\"https://img.shields.io/badge/license-%20AGPL-orange?style=flat-square&logo=gnu\"){kind=icon}
![](\"https://img.shields.io/cii/level/2625?style=flat-square\" "\\"Core")
![](\"https://img.shields.io/travis/theme-next/hexo-theme-next/master?style=flat-square&logo=travis%20ci\" "\\"Travis")
![](\"https://img.shields.io/codacy/grade/72f7fe7609c2438a92069f448e5a341a/master?style=flat-square&logo=codacy\" "\\"Project")
![](\"https://img.shields.io/snyk/vulnerabilities/github/theme-next/hexo-theme-next?style=flat-square\" "\\"Vulnerabilities\\"")
\n![](\"https://user-images.githubusercontent.com/16272760/63487983-da41b080-c4df-11e9-951c-64883a8a5e9b.png\")
\n![](\"https://github.githubassets.com/images/modules/logos_page/GitHub-Logo.png\"){kind=logo}
![](\"https://cdn.netlify.com/15ecf59b59c9d04b88097c6b5d2c7e8a7d1302d0/1b6d6/img/press/logos/full-logo-light.svg\"){kind=logo}
![](\"https://support.crowdin.com/assets/logos/crowdin-logo1-small.png\"){kind=logo}
![](\"https://user-images.githubusercontent.com/16944225/55026017-623f8f00-5002-11e9-88bf-0d6a5884c6c2.png\")
![](\"https://raw.githubusercontent.com/travis-ci/travis-web/master/public/images/logos/TravisCI-Full-Color.png\")
![](\"{{)
\n {%- endfor %}\n