From 8bb36c2073b2ab4e77a7a9b1cee3d1b78e029fab Mon Sep 17 00:00:00 2001 From: NaBian <836904362@qq.com> Date: Sat, 29 Aug 2020 13:55:29 +0800 Subject: [PATCH 1/3] update doc --- .../handycontrol/data/GrowlInfo/index.md | 1 - .../handycontrol/data/InfoType/index.md | 1 - doc/source/handycontrol/tools/effect/index.md | 72 +- .../tools/hatchBrushGenerator/index.md | 20 +- doc/source/handycontrol/tools/index.md | 4 +- doc/themes/next/.github/CODE_OF_CONDUCT.md | 94 --- doc/themes/next/.github/CONTRIBUTING.md | 230 ------- doc/themes/next/.github/ISSUE_TEMPLATE.md | 84 --- .../next/.github/ISSUE_TEMPLATE/bug-report.md | 92 --- .../ISSUE_TEMPLATE/custom-issue-template.md | 92 --- .../.github/ISSUE_TEMPLATE/feature-request.md | 47 -- .../.github/ISSUE_TEMPLATE/non-english.md | 92 --- .../next/.github/PULL_REQUEST_TEMPLATE.md | 48 -- doc/themes/next/.github/auto_assign.yml | 23 - doc/themes/next/.github/config.yml | 63 -- .../next/.github/eslint-disable-bot.yml | 8 - doc/themes/next/.github/lock.yml | 39 -- doc/themes/next/.github/mergeable.yml | 29 - doc/themes/next/.github/release-drafter.yml | 34 - doc/themes/next/.github/stale.yml | 29 - doc/themes/next/.github/support.yml | 23 - doc/themes/next/.github/topissuebot.yml | 5 - doc/themes/next/.github/weekly-digest.yml | 8 - doc/themes/next/_config.yml | 2 +- doc/themes/next/docs/AGPL3.md | 649 ------------------ doc/themes/next/docs/ALGOLIA-SEARCH.md | 87 --- doc/themes/next/docs/AUTHORS.md | 87 --- doc/themes/next/docs/DATA-FILES.md | 61 -- doc/themes/next/docs/INSTALLATION.md | 120 ---- .../next/docs/LEANCLOUD-COUNTER-SECURITY.md | 177 ----- doc/themes/next/docs/LICENSE.txt | 56 -- doc/themes/next/docs/MATH.md | 286 -------- doc/themes/next/docs/UPDATE-FROM-5.1.X.md | 19 - doc/themes/next/docs/ru/DATA-FILES.md | 61 -- doc/themes/next/docs/ru/INSTALLATION.md | 120 ---- doc/themes/next/docs/ru/README.md | 139 ---- doc/themes/next/docs/ru/UPDATE-FROM-5.1.X.md | 19 - doc/themes/next/docs/zh-CN/ALGOLIA-SEARCH.md | 84 --- doc/themes/next/docs/zh-CN/CODE_OF_CONDUCT.md | 99 --- doc/themes/next/docs/zh-CN/CONTRIBUTING.md | 225 ------ doc/themes/next/docs/zh-CN/DATA-FILES.md | 61 -- doc/themes/next/docs/zh-CN/INSTALLATION.md | 120 ---- .../docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md | 186 ----- doc/themes/next/docs/zh-CN/MATH.md | 291 -------- doc/themes/next/docs/zh-CN/README.md | 156 ----- .../next/docs/zh-CN/UPDATE-FROM-5.1.X.md | 35 - 46 files changed, 93 insertions(+), 4185 deletions(-) delete mode 100644 doc/themes/next/.github/CODE_OF_CONDUCT.md delete mode 100644 doc/themes/next/.github/CONTRIBUTING.md delete mode 100644 doc/themes/next/.github/ISSUE_TEMPLATE.md delete mode 100644 doc/themes/next/.github/ISSUE_TEMPLATE/bug-report.md delete mode 100644 doc/themes/next/.github/ISSUE_TEMPLATE/custom-issue-template.md delete mode 100644 doc/themes/next/.github/ISSUE_TEMPLATE/feature-request.md delete mode 100644 doc/themes/next/.github/ISSUE_TEMPLATE/non-english.md delete mode 100644 doc/themes/next/.github/PULL_REQUEST_TEMPLATE.md delete mode 100644 doc/themes/next/.github/auto_assign.yml delete mode 100644 doc/themes/next/.github/config.yml delete mode 100644 doc/themes/next/.github/eslint-disable-bot.yml delete mode 100644 doc/themes/next/.github/lock.yml delete mode 100644 doc/themes/next/.github/mergeable.yml delete mode 100644 doc/themes/next/.github/release-drafter.yml delete mode 100644 doc/themes/next/.github/stale.yml delete mode 100644 doc/themes/next/.github/support.yml delete mode 100644 doc/themes/next/.github/topissuebot.yml delete mode 100644 doc/themes/next/.github/weekly-digest.yml delete mode 100644 doc/themes/next/docs/AGPL3.md delete mode 100644 doc/themes/next/docs/ALGOLIA-SEARCH.md delete mode 100644 doc/themes/next/docs/AUTHORS.md delete mode 100644 doc/themes/next/docs/DATA-FILES.md delete mode 100644 doc/themes/next/docs/INSTALLATION.md delete mode 100644 doc/themes/next/docs/LEANCLOUD-COUNTER-SECURITY.md delete mode 100644 doc/themes/next/docs/LICENSE.txt delete mode 100644 doc/themes/next/docs/MATH.md delete mode 100644 doc/themes/next/docs/UPDATE-FROM-5.1.X.md delete mode 100644 doc/themes/next/docs/ru/DATA-FILES.md delete mode 100644 doc/themes/next/docs/ru/INSTALLATION.md delete mode 100644 doc/themes/next/docs/ru/README.md delete mode 100644 doc/themes/next/docs/ru/UPDATE-FROM-5.1.X.md delete mode 100644 doc/themes/next/docs/zh-CN/ALGOLIA-SEARCH.md delete mode 100644 doc/themes/next/docs/zh-CN/CODE_OF_CONDUCT.md delete mode 100644 doc/themes/next/docs/zh-CN/CONTRIBUTING.md delete mode 100644 doc/themes/next/docs/zh-CN/DATA-FILES.md delete mode 100644 doc/themes/next/docs/zh-CN/INSTALLATION.md delete mode 100644 doc/themes/next/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md delete mode 100644 doc/themes/next/docs/zh-CN/MATH.md delete mode 100644 doc/themes/next/docs/zh-CN/README.md delete mode 100644 doc/themes/next/docs/zh-CN/UPDATE-FROM-5.1.X.md diff --git a/doc/source/handycontrol/data/GrowlInfo/index.md b/doc/source/handycontrol/data/GrowlInfo/index.md index 814e4576d..24c597178 100644 --- a/doc/source/handycontrol/data/GrowlInfo/index.md +++ b/doc/source/handycontrol/data/GrowlInfo/index.md @@ -1,6 +1,5 @@ --- title: GrowlInfo -date: 2019-04-02 22:16:16 --- {% note info no-icon %} diff --git a/doc/source/handycontrol/data/InfoType/index.md b/doc/source/handycontrol/data/InfoType/index.md index 34b544ac6..4093808f3 100644 --- a/doc/source/handycontrol/data/InfoType/index.md +++ b/doc/source/handycontrol/data/InfoType/index.md @@ -1,6 +1,5 @@ --- title: InfoType -date: 2019-04-02 22:27:13 --- {% note info no-icon %} diff --git a/doc/source/handycontrol/tools/effect/index.md b/doc/source/handycontrol/tools/effect/index.md index a82e557d8..eb83900fc 100644 --- a/doc/source/handycontrol/tools/effect/index.md +++ b/doc/source/handycontrol/tools/effect/index.md @@ -1,3 +1,73 @@ --- -title: Effect +title: Effect 特效 --- + +# BlendEffectBox 特效混合器 + +通过特效混合器可以很方便得把多种特效应用在同一个控件上: + +```xml + + + + + + + // 你的控件 + +``` + +# BrightnessEffect 明度特效 + +```xml + + + + + +``` + +# ColorComplementEffect 补色特效 + +```xml + + + + + +``` + +# ColorMatrixEffect 颜色矩阵特效 + +```xml + + + + + + + + + + +``` + +# ContrastEffect 对比度特效 + +```xml + + + + + +``` + +# GrayScaleEffect 灰度特效 + +```xml + + + + + +``` \ No newline at end of file diff --git a/doc/source/handycontrol/tools/hatchBrushGenerator/index.md b/doc/source/handycontrol/tools/hatchBrushGenerator/index.md index c3ab9e7e3..c7c524952 100644 --- a/doc/source/handycontrol/tools/hatchBrushGenerator/index.md +++ b/doc/source/handycontrol/tools/hatchBrushGenerator/index.md @@ -1,3 +1,21 @@ --- -title: HatchBrushGenerator +title: HatchBrushGenerator 阴影画笔生成器 --- + +HC提供了50多种不同图案的阴影样式,其行为与winform中的表现一致. + +# 案例 + +## 基础用法 + +我们先创建一个阴影画笔生成器实例: + +```cs +var brushGenerator = new HatchBrushGenerator(); +``` + +再调用 `GetHatchBrush` 方法,传入 `HatchStyle` 枚举、前景色、背景色,即可返回一个 `DrawingBrush` 画刷. + +```cs +var brush = brushGenerator.GetHatchBrush(HatchStyle.Horizontal, 前景色, 背景色); +``` \ No newline at end of file diff --git a/doc/source/handycontrol/tools/index.md b/doc/source/handycontrol/tools/index.md index ca12ad623..0f01f8315 100644 --- a/doc/source/handycontrol/tools/index.md +++ b/doc/source/handycontrol/tools/index.md @@ -1,5 +1,5 @@ --- -title: 建设中 +title: 工具和扩展 --- -建设中 \ No newline at end of file +除了扩展控件,hc还提供了很多有用的工具和扩展,包括特效、动画、笔刷等等。 \ No newline at end of file diff --git a/doc/themes/next/.github/CODE_OF_CONDUCT.md b/doc/themes/next/.github/CODE_OF_CONDUCT.md deleted file mode 100644 index 93861acdd..000000000 --- a/doc/themes/next/.github/CODE_OF_CONDUCT.md +++ /dev/null @@ -1,94 +0,0 @@ -
Language: :us: -:cn: -:ru:
- -#
e x T
- -[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. - -A 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. - -## Table Of Contents - -- [Our Pledge](#our-pledge) -- [Our Responsibilities](#our-responsibilities) -- [Our Standards](#our-standards) -- [Scope](#scope) -- [Enforcement](#enforcement) -- [Contacting Maintainers](#contacting-maintainers) -- [Attribution](#attribution) - -## Our Pledge - -As 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. - -In 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. - -## Our Responsibilities - -Project 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. - -## Our Standards - -As 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). - -Examples of behavior that contributes to creating a positive environment include: - -* Using welcoming and inclusive language. -* Being respectful of differing viewpoints and experiences. -* Gracefully accepting constructive feedback. -* Focusing on what is best for the community. -* Showing empathy and kindness towards other community members. - -Examples of unacceptable behavior by participants include: - -* The use of sexualized language or imagery and unwelcome sexual attention or advances -* Trolling, insulting/derogatory comments, and personal or political attacks -* Public or private harassment -* Publishing others’ private information, such as a physical or electronic address, without explicit permission -* Other conduct which could reasonably be considered inappropriate in a professional setting - -## Scope - -This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. - -Depending 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. - -## Enforcement - -If you see a Code of Conduct violation, follow these steps: - -1. 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. -2. 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. -3. As soon as available, a maintainer will look into the issue, and take further action. - -Once the maintainers get involved, they will follow a documented series of steps and do their best to preserve the well-being of project members. - -All 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. - -Thesehese are the steps maintainers will take for further enforcement, as needed: - -1. Repeat the request to stop. -2. 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. -3. If the behavior continues or is repeated later, the person will be blocked from participating for 24 hours. -4. If the behavior continues or is repeated after the temporary block, a long-term (6-12 months) ban will be used. - -On 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. - -Project 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. - -## Contacting Maintainers - -You may get in touch with the maintainer team through any of the following methods: - -* Through Email: - * [support@theme-next.org](mailto:support@theme-next.org) - -* Through Chat: - * [Gitter](https://gitter.im/theme-next) - * [Riot](https://riot.im/app/#/room/#NexT:matrix.org) - * [Telegram](https://t.me/joinchat/GUNHXA-vZkgSMuimL1VmMw) - -## Attribution - -This 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). diff --git a/doc/themes/next/.github/CONTRIBUTING.md b/doc/themes/next/.github/CONTRIBUTING.md deleted file mode 100644 index 5fc11b32c..000000000 --- a/doc/themes/next/.github/CONTRIBUTING.md +++ /dev/null @@ -1,230 +0,0 @@ -
Language: :us: -:cn: -:ru:
- -#
e x T
- -First 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. - -## Table Of Contents - -[How Can I Contribute?](#how-can-i-contribute) - - * [Before Submitting An Issue](#before-submitting-an-issue) - * [Reporting Bugs](#reporting-bugs) - * [Reporting Security Bugs](#reporting-security-bugs) - * [Suggesting Enhancements](#suggesting-enhancements) - * [Submitting a Pull Request](#submitting-a-pull-request) - * [Creating Releases](#creating-releases) - -[Guides](#guides) - - * [Coding Rules](#coding-rules) - * [Coding Standards](#coding-standards) - * [Labels Rules](#labels-rules) - * [Commit Messages Rules](#commit-messages-rules) - - - -## How Can I Contribute? - -Main Theme-Next repository was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [Theme-Next](https://github.com/theme-next) organization on GitHub. Most libraries under the `next/source/lib` directory was moved out to [external repos](https://github.com/theme-next) under NexT organization. Version 5 works fine at most cases, but for frequent users, you maybe need to [upgrade version 5 to 6](https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md) to get features and supports in new [Theme-Next](https://github.com/theme-next/hexo-theme-next) repository. - - - -### Before Submitting An Issue - -If you just have a question, you'll get faster results by checking the FAQs for a list of common questions and problems (Work in progress) or the [«NexT» Documentation Site](https://theme-next.org/docs/) (Work in progress). - -Also, you can perform a [cursory search](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) to see if the problem has already been reported or solved. You don't want to duplicate effort. You might be able to find the cause of the problem and fix things yourself, or add comments to the existed issue. - -If you find a bug in the source code, most importantly, please check carefully if you can reproduce the problem [in the latest release version of Next](https://github.com/theme-next/hexo-theme-next/releases/latest). Then, you can help us by -[Reporting Bugs](#reporting-bugs) or [Suggesting Enhancements](#suggesting-enhancements) to our [ Repository](https://github.com/theme-next/hexo-theme-next). Even better, you can -[submit a Pull Request](#submitting-a-pull-request) with a fix. - - - -### Reporting Bugs - -Before 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). - -Following these guidelines helps maintainers and the community understand your report :pencil:, reproduce the behavior, and find related reports: - -* Use a clear and descriptive title for the issue to identify the problem. -* Provide more context by answering these questions: - * 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. - * Did the problem start happening recently or was this always a problem? - * 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). - * 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`. - * Which packages do you have installed? You can get that list by copying the contents in site's`package.json`. -* 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/). -* Provide specific examples to demonstrate the steps. Include links to files (screenshots or GIFs) or live demo. -* Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior. -* Explain which behavior you expected to see instead and why. - - - -#### Reporting Security Bugs - -If you find a security issue, please act responsibly and report it not in the public issue tracker, but directly to us, so we can fix it before it can be exploited. Please send the related information to security@theme-next.com (desirable with using PGP for e-mail encryption). - -We will gladly special thanks to anyone who reports a vulnerability so that we can fix it. If you want to remain anonymous or pseudonymous instead, please let us know that; we will gladly respect your wishes. - - - -### Suggesting Enhancements - -Before creating enhancement suggestions, please check [this list](#before-submitting-an-issue) as you might find out that you don't need to create one. After you've determined the repository your enhancement suggestion is related to, create an issue on that repository and provide the information as many details as possible by filling in [the required template](ISSUE_TEMPLATE.md). - -Following these guidelines helps maintainers and the community understand your suggestion :pencil: and find related suggestions. - -* Use a clear and descriptive title for the issue to identify the suggestion. -* Describe the current behavior and explain which behavior you expected to see instead and Explain why this enhancement would be useful to most users. -* Provide specific examples to demonstrate the suggestion. Include links to files (screenshots or GIFs) or live demo. - - - -### Submitting a Pull Request - -Before creating a Pull Request (PR), please check [this list](#before-submitting-an-issue) as you might find out that you don't need to create one. After you've determined the repository your pull request is related to, create a pull request on that repository. The detailed document of creating a pull request can be found [here](https://help.github.com/articles/creating-a-pull-request/). - -1. On GitHub, navigate to the original page of the [hexo-theme-next](https://github.com/theme-next/hexo-theme-next). In the top-right corner of the page, click **Fork**. -2. Under the repository name in your forked repository, click **Clone or download**. In the `Clone with SSH` section, copy the clone URL for the repository. Open Git Bash, and change the current working directory to the location where you want the cloned directory to be made. Type `git clone`, and then paste the URL you copied. Press **Enter**. Your local clone will be created. - ```bash - $ git clone git@github.com:username/hexo-theme-next.git - ``` -3. Navigate into your new cloned repository. Switch branches to the compare branch of the pull request where the original changes were made. - ```bash - $ cd hexo-theme-next - $ git checkout -b patchname - ``` -4. After you commit your changes to the head branch of the pull request you can push your changes up to the original pull request directly. - ```bash - $ git add . - $ git commit -m "add commit messamge" - $ git push origin patchname - ``` -5. Navigate to the original repository you created your fork from. To the right of the Branch menu, click **New pull request**. On the Compare page, confirm that the base fork is the repository you'd like to merge changes into. Use the base branch drop-down menu to select the branch of the upstream repository you'd like to merge changes into. Use the head fork drop-down menu to select your fork, then use the compare branch drop-down menu to select the branch you made your changes in. Click **Create pull request** and type a title and description for your pull request. - -Following these guidelines helps maintainers and the community understand your pull request :pencil:: - -* Follow our [Coding Rules](#coding-rules) and [commit message conventions](#commit-messages-rules). -* Use a clear and descriptive title for the issue to identify the pull request. Do not include issue numbers in the PR title. -* Fill in [the required template](PULL_REQUEST_TEMPLATE.md) as many details as possible. -* All features or bug fixes must be tested in all schemes. And provide specific examples to demonstrate the pull request. Include links to files (screenshots or GIFs) or live demo. - - - -### Creating Releases - -Releases are a great way to ship projects on GitHub to your users. - -1. On GitHub, navigate to the main page of the repository. Under your repository name, click **Releases**. Click **Draft a new release**. -2. 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). -3. 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. -4. Type a title and description that describes your release. - - Use the version as the title. - - 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. - - Use the passive tense and subject-less sentences. - - 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. -5. If you'd like to include binary files along with your release, such as compiled programs, drag and drop or select files manually in the binaries box. -6. If the release is unstable, select **This is a pre-release** to notify users that it's not ready for production. If you're ready to publicize your release, click **Publish release**. Otherwise, click **Save draft** to work on it later. - - - -## Guides - - - -### Coding Rules - -This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md) to keep open and inclusive. By participating, you are expected to uphold this code. - - - -### Coding Standards - -To be continued. - - - -### Labels Rules - -We 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. - -If you are unsure what a label is about or which labels you should apply to a PR or issue, look no further! - -Issues related: `types`+`contents`+`results` - -- By types - - `Irrelevant`: An irrelevant issue for Next - - `Duplicate`: An issue which had been mentioned - - `Bug`: A detected bug that needs to be confirmed - - `Improvement Need`: An issue that needs to be improvement - - `Feature Request`: An issue that wants a new feature - - `High Priority`: A detected bugs or misprints with high priority - - `Low Priority`: A detected bugs or misprints with low priority - - `Non English`: Requires the attention of a multi-lingual maintainer - - `Discussion`: An issue that needs to be discussed - - `Question`: An issue about questions - - `Backlog`: An issue that is to be completed and later compensated - - `Meta`: Denoting a change of usage conditions -- By contents - - `Roadmap`: An issue about future development - - `Hexo`: An issue related to Hexo - - `Scheme [1] - Mist`: An issue related to Scheme Mist - - `Scheme [2] - Muse`: An issue related to Scheme Muse - - `Scheme [3] - Pisces`: An issue related to Scheme Pisces - - `Scheme [4] - Gemini`: An issue related to Scheme Gemini - - `3rd Party Service`: An issue related to 3rd party service - - `Docs`: Need to add instruction document - - `Configurations`: An issue related to configurations - - `CSS`: An issue related to CSS - - `Custom`: An issue related to custom things -- By results - - `Wontfix`: An issue that will not to be fixed - - `Need More Info`: Need more information for solving the issue - - `Need Verify`: Need confirmation from the developers or user about the bug or solution - - `Can't Reproduce`: An issue that can’t be reproduced - - `Verified`: An issue that has been verified - - `Help Wanted`: An issue that needs help - - `Wait for Answer`: An issue that needs to be answered by the developers or user - - `Resolved Maybe`: An issue that has been resolved maybe - - `Solved`: An issue that has been solved - - `Stale`: This issue has been automatically marked as stale because lack of recent activity - -Pull requests related: - -- `Breaking Change`: A Pull requests that makes breaking change -- `Bug Fix`: A Pull requests that fixes the related bug -- `Docs`: A Pull requests that Instruction document has been added -- `New Feature`: A Pull requests that provides a new feature -- `Feature`: A Pull requests that provides an option or addition to existing feature -- `Improvement`: A Pull requests that improves NexT -- `i18n`: A Pull requests that makes new languages translation -- `Performance`: A Pull requests that improves the performance -- `Discussion`: A Pull requests that needs to be discussed -- `v6.x`: A Pull requests that bug fixes and some improvements, related to old NexT version 6 -- `v7.x`: A Pull requests that bug fixes and some improvements, related to old NexT version 7 - - - -### Commit Messages Rules - -We 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 -readable messages that are easy to follow when looking through the project history. - -- `type` describes the meaning of this commit including but not limited to the following items, and capitalize the first letter. - * `Build`: Changes that affect the build system or external dependencies - * `Ci`: Changes to our CI configuration files and scripts - * `Docs`: Documentation only changes - * `Feat`: A new feature - * `Fix`: A bug fix - * `Perf`: A code change that improves performance - * `Refactor`: A code change that neither fixes a bug nor adds a feature - * `Style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc) - * `Revert`: Revert some existing commits - * `Release`: Commit a release for a conventional changelog project -- The `subject` contains a succinct description of the change, like `Update code highlighting in readme.md`. - * No dot (.) at the end. - * Use the imperative, present tense: "change" not "changed" nor "changes". diff --git a/doc/themes/next/.github/ISSUE_TEMPLATE.md b/doc/themes/next/.github/ISSUE_TEMPLATE.md deleted file mode 100644 index 8332ad0da..000000000 --- a/doc/themes/next/.github/ISSUE_TEMPLATE.md +++ /dev/null @@ -1,84 +0,0 @@ - - -### I agree and want to create new issue - - -- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html). -- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/). -- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me. - -*** - -### Expected behavior - - -### Actual behavior - - -### Steps to reproduce the behavior -1. N/A -2. N/A -3. N/A - -* Link to demo site with this issue: N/A -* Link(s) to source code or any usefull link(s): N/A - -### Node.js and NPM Information - -``` - -``` - -### Package dependencies Information - -``` - -``` - -### Hexo Information - -#### Hexo version - -``` - -``` - -#### Hexo Configuration - -```yml - -``` - -### NexT Information - -**NexT Version:** - - -- [ ] Latest Master branch -- [ ] Latest Release version -- [ ] Old version - - -**NexT Scheme:** - - -- [ ] All schemes -- [ ] Muse -- [ ] Mist -- [ ] Pisces -- [ ] Gemini - - -#### NexT Configuration: - -```yml - -``` - -### Other Information diff --git a/doc/themes/next/.github/ISSUE_TEMPLATE/bug-report.md b/doc/themes/next/.github/ISSUE_TEMPLATE/bug-report.md deleted file mode 100644 index d628069fd..000000000 --- a/doc/themes/next/.github/ISSUE_TEMPLATE/bug-report.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -name: Bug Report -about: Create a report to help us improve. -title: '' -labels: Bug -assignees: '' - ---- - - - -### I agree and want to create new issue - - -- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html). -- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/). -- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me. - -*** - -### Expected behavior - - -### Actual behavior - - -### Steps to reproduce the behavior -1. N/A -2. N/A -3. N/A - -* Link to demo site with this bug: N/A -* Link(s) to source code or any usefull link(s): N/A - -### Node.js and NPM Information - -``` - -``` - -### Package dependencies Information - -``` - -``` - -### Hexo Information - -#### Hexo version - -``` - -``` - -#### Hexo Configuration - -```yml - -``` - -### NexT Information - -**NexT Version:** - - -- [ ] Latest Master branch -- [ ] Latest Release version -- [ ] Old version - - -**NexT Scheme:** - - -- [ ] All schemes -- [ ] Muse -- [ ] Mist -- [ ] Pisces -- [ ] Gemini - - -#### NexT Configuration: - -```yml - -``` - -### Other Information diff --git a/doc/themes/next/.github/ISSUE_TEMPLATE/custom-issue-template.md b/doc/themes/next/.github/ISSUE_TEMPLATE/custom-issue-template.md deleted file mode 100644 index ff7061d3e..000000000 --- a/doc/themes/next/.github/ISSUE_TEMPLATE/custom-issue-template.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -name: Custom Issue Template -about: Describe this issue template's purpose here. -title: '' -labels: Custom -assignees: '' - ---- - - - -### I agree and want to create new issue - - -- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html). -- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/). -- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me. - -*** - -### Expected behavior - - -### Actual behavior - - -### Steps to reproduce the behavior -1. N/A -2. N/A -3. N/A - -* Link to demo site with this issue: N/A -* Link(s) to source code or any usefull link(s): N/A - -### Node.js and NPM Information - -``` - -``` - -### Package dependencies Information - -``` - -``` - -### Hexo Information - -#### Hexo version - -``` - -``` - -#### Hexo Configuration - -```yml - -``` - -### NexT Information - -**NexT Version:** - - -- [ ] Latest Master branch -- [ ] Latest Release version -- [ ] Old version - - -**NexT Scheme:** - - -- [ ] All schemes -- [ ] Muse -- [ ] Mist -- [ ] Pisces -- [ ] Gemini - - -#### NexT Configuration: - -```yml - -``` - -### Other Information diff --git a/doc/themes/next/.github/ISSUE_TEMPLATE/feature-request.md b/doc/themes/next/.github/ISSUE_TEMPLATE/feature-request.md deleted file mode 100644 index 83d740d0b..000000000 --- a/doc/themes/next/.github/ISSUE_TEMPLATE/feature-request.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -name: Feature Request -about: Suggest an idea for this project. -title: '' -labels: Feature Request -assignees: '' - ---- - - - -### I agree and want to create new issue - - -- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html). -- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/). -- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me. - -*** - -### Expected behavior - - -### Actual behavior - - -### Steps to reproduce the behavior -1. N/A -2. N/A -3. N/A - -* Link to demo site with this feature: N/A -* Link(s) to source code or any usefull link(s): N/A - -**NexT Scheme:** - - -- [ ] All schemes -- [ ] Muse -- [ ] Mist -- [ ] Pisces -- [ ] Gemini diff --git a/doc/themes/next/.github/ISSUE_TEMPLATE/non-english.md b/doc/themes/next/.github/ISSUE_TEMPLATE/non-english.md deleted file mode 100644 index f07d69860..000000000 --- a/doc/themes/next/.github/ISSUE_TEMPLATE/non-english.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -name: Non English -about: Issue in Chinese or any other language. -title: '' -labels: Non English -assignees: '' - ---- - - - -### I agree and want to create new issue - - -- [ ] Yes, I was on [Hexo Docs page](https://hexo.io/docs/), especially on [Templates](https://hexo.io/docs/templates.html), [Variables](https://hexo.io/docs/variables.html), [Helpers](https://hexo.io/docs/helpers.html) and [Troubleshooting](https://hexo.io/docs/troubleshooting.html). -- [ ] Yes, I was on [NexT Documentation Site](http://theme-next.org/docs/). -- [ ] And yes, I already searched for current [issues](https://github.com/theme-next/hexo-theme-next/issues?utf8=%E2%9C%93&q=is%3Aissue) and this is not help to me. - -*** - -### Expected behavior - - -### Actual behavior - - -### Steps to reproduce the behavior -1. N/A -2. N/A -3. N/A - -* Link to demo site with this issue: N/A -* Link(s) to source code or any usefull link(s): N/A - -### Node.js and NPM Information - -``` - -``` - -### Package dependencies Information - -``` - -``` - -### Hexo Information - -#### Hexo version - -``` - -``` - -#### Hexo Configuration - -```yml - -``` - -### NexT Information - -**NexT Version:** - - -- [ ] Latest Master branch -- [ ] Latest Release version -- [ ] Old version - - -**NexT Scheme:** - - -- [ ] All schemes -- [ ] Muse -- [ ] Mist -- [ ] Pisces -- [ ] Gemini - - -#### NexT Configuration: - -```yml - -``` - -### Other Information diff --git a/doc/themes/next/.github/PULL_REQUEST_TEMPLATE.md b/doc/themes/next/.github/PULL_REQUEST_TEMPLATE.md deleted file mode 100644 index 626b61f0f..000000000 --- a/doc/themes/next/.github/PULL_REQUEST_TEMPLATE.md +++ /dev/null @@ -1,48 +0,0 @@ - - -## PR Checklist -**Please check if your PR fulfills the following requirements:** - - -- [ ] The commit message follows [our guidelines](https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md). -- [ ] Tests for the changes was maked (for bug fixes / features). - - [ ] Muse | Mist have been tested. - - [ ] Pisces | Gemini have been tested. -- [ ] Docs in [NexT website](https://theme-next.org/docs/) have been added / updated (for new features). - -## PR Type -**What kind of change does this PR introduce?** - -- [ ] Bugfix. -- [ ] Feature. -- [ ] Code style update (formatting, local variables). -- [ ] Refactoring (no functional changes, no api changes). -- [ ] Build related changes. -- [ ] CI related changes. -- [ ] Documentation content changes. -- [ ] Other... Please describe: - -## What is the current behavior? - - -Issue resolved: N/A - -## What is the new behavior? - - -- Screenshots with this changes: N/A -- Link to demo site with this changes: N/A - -### How to use? -In NexT `_config.yml`: -```yml -... -``` - -## Does this PR introduce a breaking change? -- [ ] Yes. -- [ ] No. diff --git a/doc/themes/next/.github/auto_assign.yml b/doc/themes/next/.github/auto_assign.yml deleted file mode 100644 index abb8f5703..000000000 --- a/doc/themes/next/.github/auto_assign.yml +++ /dev/null @@ -1,23 +0,0 @@ -# Configuration for Auto Assign - https://github.com/kentaro-m/auto-assign - -# Set to true to add reviewers to pull requests -addReviewers: true - -# Set to true to add assignees to pull requests -addAssignees: false - -# A list of reviewers to be added to pull requests (GitHub user name) -reviewers: - - 1v9 - - ivan-nginx - - maple3142 - - sli1989 - - stevenjoezhang - -# A number of reviewers added to the pull request -# Set 0 to add all the reviewers (default: 0) -numberOfReviewers: 0 - -# A list of keywords to be skipped the process that add reviewers if pull requests include it -skipKeywords: - - wip diff --git a/doc/themes/next/.github/config.yml b/doc/themes/next/.github/config.yml deleted file mode 100644 index 7d5d0ecaa..000000000 --- a/doc/themes/next/.github/config.yml +++ /dev/null @@ -1,63 +0,0 @@ -# =============================================================================================== # -# Configuration for welcome - https://github.com/behaviorbot/welcome - -# Comment to be posted to on first time issues -newIssueWelcomeComment: > - Thanks for opening this issue, maintainers will get back to you as soon as possible! - -# Comment to be posted to on PRs from first time contributors in your repository -newPRWelcomeComment: > - Thanks so much for opening your first PR here! - -# Comment to be posted to on pull requests merged by a first time user -firstPRMergeComment: > - Congrats on merging your first pull request here! :tada: How awesome! - -# =============================================================================================== # -# Configuration for request-info - https://github.com/behaviorbot/request-info - -# *OPTIONAL* Label to be added to Issues and Pull Requests with insufficient information given -requestInfoLabelToAdd: Need More Info - -# *OPTIONAL* Add a list of people whose Issues/PRs will not be commented on -# keys must be GitHub usernames -requestInfoUserstoExclude: - - 1v9 - - Acris - - flashlab - - geekrainy - - iissnan - - ivan-nginx - - JiangTJ - - LEAFERx - - liolok - - maple3142 - - Raincal - - sli1989 - - stevenjoezhang - - tsanie - - wafer-li - -# =============================================================================================== # -# Configuration for sentiment-bot - https://github.com/behaviorbot/sentiment-bot - -# *Required* toxicity threshold between 0 and .99 with the higher numbers being the most toxic -# Anything higher than this threshold will be marked as toxic and commented on -sentimentBotToxicityThreshold: .6 - -# *Required* Comment to reply with -sentimentBotReplyComment: > - Please be sure to review the [code of conduct](https://github.com/theme-next/hexo-theme-next/blob/master/.github/code-of-conduct.md) and be respectful of other users. cc/ @theme-next/next - -# =============================================================================================== # -lockThreads: - toxicityThreshold: .7 - numComments: 2 - setTimeInHours: 72 - replyComment: > - This thread is being locked due to exceeding the toxicity minimums. cc/ @theme-next/next - -# =============================================================================================== # -# Configuration for todo-bot - https://github.com/JasonEtco/todo -todo: - label: '🗒 To-Do' diff --git a/doc/themes/next/.github/eslint-disable-bot.yml b/doc/themes/next/.github/eslint-disable-bot.yml deleted file mode 100644 index 9899fef6b..000000000 --- a/doc/themes/next/.github/eslint-disable-bot.yml +++ /dev/null @@ -1,8 +0,0 @@ -# Configuration for ESLint Disable Watcher - https://github.com/koddsson/eslint-disable-probot - -# Change this to set the number of comments the watcher should comment on a given PR. -commentLimit: 10 -# The message the bot will post on any lines containing a eslint disable comment. -commentMessage: Please don't disable eslint rules :pray: -# A optional regular expression that will match against the branch name and not comment on it if it matches. -skipBranchMatching: null diff --git a/doc/themes/next/.github/lock.yml b/doc/themes/next/.github/lock.yml deleted file mode 100644 index a6826f8de..000000000 --- a/doc/themes/next/.github/lock.yml +++ /dev/null @@ -1,39 +0,0 @@ -# Configuration for Lock Threads - https://github.com/dessant/lock-threads - -# Number of days of inactivity before a closed issue or pull request is locked -daysUntilLock: 365 - -# Skip issues and pull requests created before a given timestamp. Timestamp must -# follow ISO 8601 (`YYYY-MM-DD`). Set to `false` to disable -skipCreatedBefore: false - -# Issues and pull requests with these labels will be ignored. Set to `[]` to disable -exemptLabels: - - backlog - -# Label to add before locking, such as `outdated`. Set to `false` to disable -lockLabel: 🔒 Locked - -# Comment to post before locking. Set to `false` to disable -lockComment: > - This thread has been automatically locked since there has not been - any recent activity after it was closed. It is possible issue was - solved or at least outdated. Feel free to open new for related bugs. - -# Assign `resolved` as the reason for locking. Set to `false` to disable -setLockReason: true - -# Limit to only `issues` or `pulls` -only: issues - -# Optionally, specify configuration settings just for `issues` or `pulls` -# issues: -# exemptLabels: -# - help-wanted -# lockLabel: outdated - -# pulls: -# daysUntilLock: 30 - -# Repository to extend settings from -# _extends: repo diff --git a/doc/themes/next/.github/mergeable.yml b/doc/themes/next/.github/mergeable.yml deleted file mode 100644 index ceadcc9e4..000000000 --- a/doc/themes/next/.github/mergeable.yml +++ /dev/null @@ -1,29 +0,0 @@ -# Configuration for Mergeable - https://github.com/jusx/mergeable - -version: 2 -mergeable: - - when: pull_request.* - validate: - - do: description - no_empty: - enabled: false - - - do: title - must_exclude: - regex: ^\[WIP\] - - - do: label - must_include: - regex: 'feat|imp|fix|doc|i18n' - must_exclude: - regex: 'wip|work in progress' - - - do: project - no_empty: - enabled: true - must_include: - regex: 'feat|imp|fix|doc|loc' - - - do: milestone - no_empty: - enabled: true diff --git a/doc/themes/next/.github/release-drafter.yml b/doc/themes/next/.github/release-drafter.yml deleted file mode 100644 index b82fc1554..000000000 --- a/doc/themes/next/.github/release-drafter.yml +++ /dev/null @@ -1,34 +0,0 @@ -# Configuration for Release Drafter - https://github.com/toolmantim/release-drafter - -name-template: v$NEXT_MINOR_VERSION -tag-template: v$NEXT_MINOR_VERSION -categories: - - title: 💥 Breaking Changes - label: Breaking Change - - - title: 🌟 New Features - label: New Feature - - - title: ⭐ Features - label: Feature - - - title: 🛠 Improvements - label: Improvement - - - title: 🐞 Bug Fixes - label: Bug Fix - - - title: 📖 Documentation - label: Docs - - - title: 🌍 Localization - label: i18n - -change-template: '- $TITLE (#$NUMBER)' -no-changes-template: '- No changes' -template: | - $CHANGES - - *** - - For full changes, see the [comparison between v$PREVIOUS_TAG and v$NEXT_MINOR_VERSION](https://github.com/theme-next/hexo-theme-next/compare/v$PREVIOUS_TAG...v$NEXT_MINOR_VERSION) diff --git a/doc/themes/next/.github/stale.yml b/doc/themes/next/.github/stale.yml deleted file mode 100644 index 7cd44811e..000000000 --- a/doc/themes/next/.github/stale.yml +++ /dev/null @@ -1,29 +0,0 @@ -# Configuration for probot-stale - https://github.com/probot/stale - -# Number of days of inactivity before an Issue or Pull Request becomes stale -daysUntilStale: 30 -# Number of days of inactivity before a stale Issue or Pull Request is closed -daysUntilClose: 7 -# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable -exemptLabels: - - bug - - feature request - - improvement need - - wait for answer - - need verify - - question - - backlog - - docs -# Label to use when marking as stale -staleLabel: stale -# Comment to post when marking as stale. Set to `false` to disable -markComment: > - This issue has been automatically marked as stale because lack of - recent activity. It will be closed if no further activity occurs. Thank you - 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. -# Comment to post when removing the stale label. Set to `false` to disable -unmarkComment: false -# Comment to post when closing a stale Issue or Pull Request. Set to `false` to disable -closeComment: false -# Limit to only `issues` or `pulls` -only: issues diff --git a/doc/themes/next/.github/support.yml b/doc/themes/next/.github/support.yml deleted file mode 100644 index 6eb974137..000000000 --- a/doc/themes/next/.github/support.yml +++ /dev/null @@ -1,23 +0,0 @@ -# Configuration for Support Requests - https://github.com/dessant/support-requests - -# Label used to mark issues as support requests -supportLabel: Support - -# Comment to post on issues marked as support requests, `{issue-author}` is an -# optional placeholder. Set to `false` to disable -supportComment: > - :wave: @{issue-author}, we use the issue tracker exclusively for bug reports - and feature requests. However, this issue appears to be a support request. - Please use our [support channels](https://github.com/theme-next/hexo-theme-next/tree/master#feedback) to get help with the project. - -# Close issues marked as support requests -close: true - -# Lock issues marked as support requests -lock: false - -# Assign `off-topic` as the reason for locking. Set to `false` to disable -setLockReason: true - -# Repository to extend settings from -# _extends: repo diff --git a/doc/themes/next/.github/topissuebot.yml b/doc/themes/next/.github/topissuebot.yml deleted file mode 100644 index 81dbe6b35..000000000 --- a/doc/themes/next/.github/topissuebot.yml +++ /dev/null @@ -1,5 +0,0 @@ -# Configuration for top-issue-bot - https://github.com/adamzolyak/gh-vote-bot - -labelName: '👍 Top Issue!' -labelColor: '006b75' -numberOfIssuesToLabel: 10 diff --git a/doc/themes/next/.github/weekly-digest.yml b/doc/themes/next/.github/weekly-digest.yml deleted file mode 100644 index a2a6f797f..000000000 --- a/doc/themes/next/.github/weekly-digest.yml +++ /dev/null @@ -1,8 +0,0 @@ -# Configuration for weekly-digest - https://github.com/apps/weekly-digest - -publishDay: sun -canPublishIssues: true -canPublishPullRequests: true -canPublishContributors: true -canPublishStargazers: true -canPublishCommits: true diff --git a/doc/themes/next/_config.yml b/doc/themes/next/_config.yml index 26b26ca5f..a77b5530a 100644 --- a/doc/themes/next/_config.yml +++ b/doc/themes/next/_config.yml @@ -316,7 +316,7 @@ menu: InfoType: /InfoType/ || 工具和扩展: default: /tools/ || - Effect 效果: /effect/ || + Effect 特效: /effect/ || HatchBrushGenerator 阴影画笔生成器: /hatchBrushGenerator/ || MorphingAnimation 变形动画: /morphingAnimation/ || 国际化: diff --git a/doc/themes/next/docs/AGPL3.md b/doc/themes/next/docs/AGPL3.md deleted file mode 100644 index 2dcf18c88..000000000 --- a/doc/themes/next/docs/AGPL3.md +++ /dev/null @@ -1,649 +0,0 @@ -#
GNU Affero General Public License
- -

Version 3, 19 November 2007 Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>

- -

Everyone is permitted to copy and distribute verbatim copies -of this license document, but changing it is not allowed.

- -##
Preamble
- -The GNU Affero General Public License is a free, copyleft license for -software and other kinds of works, specifically designed to ensure -cooperation with the community in the case of network server software. - -The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -our General Public Licenses are intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. - -When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - -Developers that use our General Public Licenses protect your rights -with two steps: **(1)** assert copyright on the software, and **(2)** offer -you this License which gives you legal permission to copy, distribute -and/or modify the software. - -A secondary benefit of defending all users' freedom is that -improvements made in alternate versions of the program, if they -receive widespread use, become available for other developers to -incorporate. Many developers of free software are heartened and -encouraged by the resulting cooperation. However, in the case of -software used on network servers, this result may fail to come about. -The GNU General Public License permits making a modified version and -letting the public access it on a server without ever releasing its -source code to the public. - -The GNU Affero General Public License is designed specifically to -ensure that, in such cases, the modified source code becomes available -to the community. It requires the operator of a network server to -provide the source code of the modified version running there to the -users of that server. Therefore, public use of a modified version, on -a publicly accessible server, gives the public access to the source -code of the modified version. - -An older license, called the Affero General Public License and -published by Affero, was designed to accomplish similar goals. This is -a different license, not a version of the Affero GPL, but Affero has -released a new version of the Affero GPL which permits relicensing under -this license. - -The precise terms and conditions for copying, distribution and -modification follow. - -##
TERMS AND CONDITIONS
- -### 0. Definitions - -“This License” refers to version 3 of the GNU Affero General Public License. - -“Copyright” also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - -“The Program” refers to any copyrightable work licensed under this -License. Each licensee is addressed as “you”. “Licensees” and -“recipients” may be individuals or organizations. - -To “modify” a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a “modified version” of the -earlier work or a work “based on” the earlier work. - -A “covered work” means either the unmodified Program or a work based -on the Program. - -To “propagate” a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - -To “convey” a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - -An interactive user interface displays “Appropriate Legal Notices” -to the extent that it includes a convenient and prominently visible -feature that **(1)** displays an appropriate copyright notice, and **(2)** -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - -### 1. Source Code - -The “source code” for a work means the preferred form of the work -for making modifications to it. “Object code” means any non-source -form of a work. - -A “Standard Interface” means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - -The “System Libraries” of an executable work include anything, other -than the work as a whole, that **(a)** is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and **(b)** serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -“Major Component”, in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - -The “Corresponding Source” for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - -The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - -The Corresponding Source for a work in source code form is that -same work. - -### 2. Basic Permissions - -All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - -You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - -Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - -### 3. Protecting Users' Legal Rights From Anti-Circumvention Law - -No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - -When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - -### 4. Conveying Verbatim Copies - -You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - -You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - -### 5. Conveying Modified Source Versions - -You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - -* **a)** The work must carry prominent notices stating that you modified -it, and giving a relevant date. -* **b)** The work must carry prominent notices stating that it is -released under this License and any conditions added under section 7. -This requirement modifies the requirement in section 4 to -“keep intact all notices”. -* **c)** You must license the entire work, as a whole, under this -License to anyone who comes into possession of a copy. This -License will therefore apply, along with any applicable section 7 -additional terms, to the whole of the work, and all its parts, -regardless of how they are packaged. This License gives no -permission to license the work in any other way, but it does not -invalidate such permission if you have separately received it. -* **d)** If the work has interactive user interfaces, each must display -Appropriate Legal Notices; however, if the Program has interactive -interfaces that do not display Appropriate Legal Notices, your -work need not make them do so. - -A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -“aggregate” if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - -### 6. Conveying Non-Source Forms - -You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - -* **a)** Convey the object code in, or embodied in, a physical product -(including a physical distribution medium), accompanied by the -Corresponding Source fixed on a durable physical medium -customarily used for software interchange. -* **b)** Convey the object code in, or embodied in, a physical product -(including a physical distribution medium), accompanied by a -written offer, valid for at least three years and valid for as -long as you offer spare parts or customer support for that product -model, to give anyone who possesses the object code either **(1)** a -copy of the Corresponding Source for all the software in the -product that is covered by this License, on a durable physical -medium customarily used for software interchange, for a price no -more than your reasonable cost of physically performing this -conveying of source, or **(2)** access to copy the -Corresponding Source from a network server at no charge. -* **c)** Convey individual copies of the object code with a copy of the -written offer to provide the Corresponding Source. This -alternative is allowed only occasionally and noncommercially, and -only if you received the object code with such an offer, in accord -with subsection 6b. -* **d)** Convey the object code by offering access from a designated -place (gratis or for a charge), and offer equivalent access to the -Corresponding Source in the same way through the same place at no -further charge. You need not require recipients to copy the -Corresponding Source along with the object code. If the place to -copy the object code is a network server, the Corresponding Source -may be on a different server (operated by you or a third party) -that supports equivalent copying facilities, provided you maintain -clear directions next to the object code saying where to find the -Corresponding Source. Regardless of what server hosts the -Corresponding Source, you remain obligated to ensure that it is -available for as long as needed to satisfy these requirements. -* **e)** Convey the object code using peer-to-peer transmission, provided -you inform other peers where the object code and Corresponding -Source of the work are being offered to the general public at no -charge under subsection 6d. - -A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - -A “User Product” is either **(1)** a “consumer product”, which means any -tangible personal property which is normally used for personal, family, -or household purposes, or **(2)** anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, “normally used” refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - -“Installation Information” for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - -If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - -The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - -Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - -### 7. Additional Terms - -“Additional permissions” are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - -When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - -Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - -* **a)** Disclaiming warranty or limiting liability differently from the -terms of sections 15 and 16 of this License; or -* **b)** Requiring preservation of specified reasonable legal notices or -author attributions in that material or in the Appropriate Legal -Notices displayed by works containing it; or -* **c)** Prohibiting misrepresentation of the origin of that material, or -requiring that modified versions of such material be marked in -reasonable ways as different from the original version; or -* **d)** Limiting the use for publicity purposes of names of licensors or -authors of the material; or -* **e)** Declining to grant rights under trademark law for use of some -trade names, trademarks, or service marks; or -* **f)** Requiring indemnification of licensors and authors of that -material by anyone who conveys the material (or modified versions of -it) with contractual assumptions of liability to the recipient, for -any liability that these contractual assumptions directly impose on -those licensors and authors. - -All other non-permissive additional terms are considered “further -restrictions” within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - -If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - -Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - -### 8. Termination - -You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - -However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated **(a)** -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and **(b)** permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - -Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - -Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - -### 9. Acceptance Not Required for Having Copies - -You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - -### 10. Automatic Licensing of Downstream Recipients - -Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - -An “entity transaction” is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - -You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - -### 11. Patents - -A “contributor” is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's “contributor version”. - -A contributor's “essential patent claims” are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, “control” includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - -Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - -In the following three paragraphs, a “patent license” is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To “grant” such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - -If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either **(1)** cause the Corresponding Source to be so -available, or **(2)** arrange to deprive yourself of the benefit of the -patent license for this particular work, or **(3)** arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. “Knowingly relying” means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - -If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - -A patent license is “discriminatory” if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license **(a)** in connection with copies of the covered work -conveyed by you (or copies made from those copies), or **(b)** primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - -Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - -### 12. No Surrender of Others' Freedom - -If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - -### 13. Remote Network Interaction; Use with the GNU General Public License - -Notwithstanding any other provision of this License, if you modify the -Program, your modified version must prominently offer all users -interacting with it remotely through a computer network (if your version -supports such interaction) an opportunity to receive the Corresponding -Source of your version by providing access to the Corresponding Source -from a network server at no charge, through some standard or customary -means of facilitating copying of software. This Corresponding Source -shall include the Corresponding Source for any work covered by version 3 -of the GNU General Public License that is incorporated pursuant to the -following paragraph. - -Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the work with which it is combined will remain governed by version -3 of the GNU General Public License. - -### 14. Revised Versions of this License - -The Free Software Foundation may publish revised and/or new versions of -the GNU Affero General Public License from time to time. Such new versions -will be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU Affero General -Public License “or any later version” applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU Affero General Public License, you may choose any version ever published -by the Free Software Foundation. - -If the Program specifies that a proxy can decide which future -versions of the GNU Affero General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - -Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - -### 15. Disclaimer of Warranty - -THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - -### 16. Limitation of Liability - -IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - -### 17. Interpretation of Sections 15 and 16 - -If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - -##
END OF TERMS AND CONDITIONS
- -###
How to Apply These Terms to Your New Programs
- -If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - -To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the “copyright” line and a pointer to where the full notice is found. - - - Copyright (C) - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU Affero General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU Affero General Public License for more details. - - You should have received a copy of the GNU Affero General Public License - along with this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - -If your software can interact with users remotely through a computer -network, you should also make sure that it provides a way for users to -get its source. For example, if your program is a web application, its -interface could display a “Source” link that leads users to an archive -of the code. There are many ways you could offer source, and different -solutions will be better for different programs; see section 13 for the -specific requirements. - -You should also get your employer (if you work as a programmer) or school, -if any, to sign a “copyright disclaimer” for the program, if necessary. -For more information on this, and how to apply and follow the GNU AGPL, see -<>. \ No newline at end of file diff --git a/doc/themes/next/docs/ALGOLIA-SEARCH.md b/doc/themes/next/docs/ALGOLIA-SEARCH.md deleted file mode 100644 index 998d8dcec..000000000 --- a/doc/themes/next/docs/ALGOLIA-SEARCH.md +++ /dev/null @@ -1,87 +0,0 @@ -

Algolia Search

- - -NexT provides Algolia search plugin for index your hexo website content. To use this feature, make sure that the version of NexT you are using is after the v5.1.0 release. What you should note here is that only turn on `enable` of `algolia_search` in `next/_config.yml` cannot let you use the algolia search correctly, you need to install corresponding [Hexo Algolia](https://github.com/oncletom/hexo-algolia) plugin to seach your website with Algolia. Follow the steps described below to complete the installation of Algolia search. - -1. Register at [Algolia](https://www.algolia.com/), you can log in directly using GitHub or Google Account. Upon Customer’s initial sign-up for an Account, Customer will have a free, fourteen (14) day evaluation period (the “Evaluation Period”) for the Algolia Services commencing on the Effective Date, subject to the limitations on Algolia’s website. After that, Algolia offers a free, branded version for up to 10k records and 100k operations per month. - -1. If a tutorial pops up, you can skip it. Go straight to create an `Index` which will be used later. - - ![](http://theme-next.iissnan.com/uploads/algolia/algolia-step-2.png) - -1. Algolia requires users to upload their search index data either manually or via provided APIs. Install and configure [Hexo Algolia](https://github.com/oncletom/hexo-algolia) in your Hexo directory. This plugin will index your site and upload selected data to Algolia. - - ``` - $ cd hexo - $ npm install --save hexo-algolia - ``` - -1. Go to the `API Keys` page and find your credentials. You will need the `Application ID` and the `Search-only API key` in the following sections. The `Admin API key` need to keep confidential. Never store your Admin API Key as apiKey in the` _config.yml` file: it would give full control of your Algolia index to others and you don't want to face the consequences. - - ![](https://user-images.githubusercontent.com/8521181/35479066-64e35aec-0428-11e8-91f9-1ec3afa45c5c.png) - -1. In the `API Keys` page, click the `ALL API KEYS` and the `edit` option in the created APIKEY to activate a pop-up box where you can setup authorizations and restrictions with a great level of precision. Check `Add records`, `Delete records`, `List indices`, `Delete index` features in ACL permissions that will be allowed for the given API key. And then click the `Update` button. - - ![](https://user-images.githubusercontent.com/8521181/35479064-611aa0b4-0428-11e8-85a1-cfb449b486ec.png) - ![](https://user-images.githubusercontent.com/8521181/35479084-d4f7ac02-0428-11e8-95a6-c4e3b1bef47b.png) - -1. In your site's `_config.yml`, add the following configuration and replace the `applicationID` & `apiKey` & `indexName` with corresponding fields obtained at Algolia. - - ```yml - algolia: - applicationID: 'Application ID' - apiKey: 'Search-only API key' - indexName: 'indexName' - chunkSize: 5000 - ``` - -1. Run the following command to upload index data, keep a weather eye out the output of the command. - - ``` - $ export HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # Use Git Bash - # set HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # Use Windows command line - $ hexo clean - $ hexo algolia - ``` - - ![](http://theme-next.iissnan.com/uploads/algolia/algolia-step-4.png) - -1. Change dir to NexT directory, and install module to `source/lib` directory. - - ``` - $ cd themes/next - $ git clone https://github.com/theme-next/theme-next-algolia-instant-search source/lib/algolia-instant-search - ``` - - If you want to use the CDN instead of clone this repo, then need to **set vendors** in NexT `_config.yml` file: - ```yml - vendors: - ... - # Internal version: 1 - # https://www.algolia.com - algolia_instant_js: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.js - algolia_instant_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.min.css - ... - ``` - -1. In `next/_config.yml`, turn on `enable` of `algolia_search`. At the same time, you need to **turn off other search plugins** like Local Search. You can also adjust the text in `labels` according to your needs. - - ```yml - # Algolia Search - algolia_search: - enable: true - hits: - per_page: 10 - labels: - input_placeholder: Search for Posts - hits_empty: "We didn't find any results for the search: ${query}" - hits_stats: "${hits} results found in ${time} ms" - ``` - -

Known Issues

- -1. The latest version of the [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) plugin removes the content indexing feature, given Algolia's free account limitation. - -1. 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. - - Replace all `applicationID` in `source/js/algolia-search.js` with `appId` - - Replace all `applicationID` in `layout/_partials/head/head.swig` with `appId` diff --git a/doc/themes/next/docs/AUTHORS.md b/doc/themes/next/docs/AUTHORS.md deleted file mode 100644 index f54eef7bb..000000000 --- a/doc/themes/next/docs/AUTHORS.md +++ /dev/null @@ -1,87 +0,0 @@ -#
«NexT» Authors
- -NexT theme was initially developed by: - -- **IIssNaN**: [NexT](https://github.com/iissnan/hexo-theme-next) (2014 - 2017) - -With collaborators from initially repository: - -- **Ivan.Nginx**: [DIFF highlight](https://github.com/iissnan/hexo-theme-next/pull/1079), - [HyperComments](https://github.com/iissnan/hexo-theme-next/pull/1155), - [`{% note %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1160), - [`seo` option](https://github.com/iissnan/hexo-theme-next/pull/1311), - [`{% button %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1328), - [VK API](https://github.com/iissnan/hexo-theme-next/pull/1381), - [WordCount plugin support](https://github.com/iissnan/hexo-theme-next/pull/1381), - [Yandex verification option](https://github.com/iissnan/hexo-theme-next/pull/1381), - [`{% exturl %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1438), - [`b2t` option](https://github.com/iissnan/hexo-theme-next/pull/1438), - [`scrollpercent` option](https://github.com/iissnan/hexo-theme-next/pull/1438), - [`save_scroll` option](https://github.com/iissnan/hexo-theme-next/pull/1574), - [Star rating](https://github.com/iissnan/hexo-theme-next/pull/1649), - [`mobile_layout_economy` option](https://github.com/iissnan/hexo-theme-next/pull/1697), - [`{% tabs %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1697), - [`{% label %}` tag](https://github.com/iissnan/hexo-theme-next/pull/1697), - [**`Gemini`** scheme](https://github.com/iissnan/hexo-theme-next/pull/1697), - [Menu & Sidebar icons in 1 line](https://github.com/iissnan/hexo-theme-next/pull/1830), - [Sidebar scrollable](https://github.com/iissnan/hexo-theme-next/pull/1898), - [Responsive favicons](https://github.com/iissnan/hexo-theme-next/pull/1898) - 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) -- **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) - -And best contributors from initially repository: - -- **Rainy**: [Gentie comments](https://github.com/iissnan/hexo-theme-next/pull/1301), - [Han](https://github.com/iissnan/hexo-theme-next/pull/1598) - 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) -- **Jeff**: [Local search](https://github.com/iissnan/hexo-theme-next/pull/694) - 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) -- **Haocen**: [Footer enhancements](https://github.com/iissnan/hexo-theme-next/pull/1886) - and some other [PR's with improvements](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3AHaocen) -- **uchuhimo**: [Greatest enhancements for local search](https://github.com/iissnan/hexo-theme-next/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Auchuhimo) -- **Kei**: [Change static file setting to support subdirectory](https://github.com/iissnan/hexo-theme-next/pull/4) -- **Jolyon**: [Swiftype](https://github.com/iissnan/hexo-theme-next/pull/84) -- **xirong**: [404 page](https://github.com/iissnan/hexo-theme-next/pull/126) -- **PinkyJie**: [Fix Swiftype](https://github.com/iissnan/hexo-theme-next/pull/132) -- **Tim Kuijsten**: [Split javascript into separate files](https://github.com/iissnan/hexo-theme-next/pull/152) -- **iamwent**: [Friendly links](https://github.com/iissnan/hexo-theme-next/pull/250) -- **arao lin**: [Option to lazyload images](https://github.com/iissnan/hexo-theme-next/pull/269) -- **Konstantin Pavlov**: [Microdata, opengraph and other semantic features](https://github.com/iissnan/hexo-theme-next/pull/276) -- **Gary**: [FastClick](https://github.com/iissnan/hexo-theme-next/pull/324) -- **Octavian**: [Baidu site vertification](https://github.com/iissnan/hexo-theme-next/pull/367) -- **Henry Chang**: [Facebook SDK](https://github.com/iissnan/hexo-theme-next/pull/410) -- **XiaMo**: [LeanCloud visitors](https://github.com/iissnan/hexo-theme-next/pull/439) -- **iblogc**: [Fix UA in Duoshuo](https://github.com/iissnan/hexo-theme-next/pull/489) -- **Vincent**: [Automatic headline ID's](https://github.com/iissnan/hexo-theme-next/pull/588) -- **cissoid**: [Tencent analytics](https://github.com/iissnan/hexo-theme-next/pull/603) -- **CosmoX**: [AddThis](https://github.com/iissnan/hexo-theme-next/pull/660) -- **Jason Guo**: [Reward for post](https://github.com/iissnan/hexo-theme-next/pull/687) -- **Jerry Bendy**: [CNZZ counter](https://github.com/iissnan/hexo-theme-next/pull/712) -- **Hui Wang**: [Wechat subscriber](https://github.com/iissnan/hexo-theme-next/pull/788) -- **PoonChiTim**: [Busuanzi counter](https://github.com/iissnan/hexo-theme-next/pull/809) -- **hydai**: [Facebook comments](https://github.com/iissnan/hexo-theme-next/pull/925) -- **OAwan**: [`canonical` option](https://github.com/iissnan/hexo-theme-next/pull/931) -- **Jim Zenn**: [Google Calendar](https://github.com/iissnan/hexo-theme-next/pull/1167) -- **Abner Chou**: [Disqus improvements](https://github.com/iissnan/hexo-theme-next/pull/1173) -- **Igor Fesenko**: [Application Insights](https://github.com/iissnan/hexo-theme-next/pull/1257) -- **jinfang**: [Youyan comments](https://github.com/iissnan/hexo-theme-next/pull/1324) -- **AlynxZhou**: [`canvas_nest` option](https://github.com/iissnan/hexo-theme-next/pull/1327) -- **aleon**: [Tencent MTA](https://github.com/iissnan/hexo-theme-next/pull/1408) -- **asmoker**: [LiveRe comments](https://github.com/iissnan/hexo-theme-next/pull/1415) -- **Jacksgong**: [Copyright on posts](https://github.com/iissnan/hexo-theme-next/pull/1497) -- **zhaiqianfeng**: [Changyan comments](https://github.com/iissnan/hexo-theme-next/pull/1514) -- **zproo**: [`canvas_ribbon` option](https://github.com/iissnan/hexo-theme-next/pull/1565) -- **jjandxa**: [`three_waves`](https://github.com/iissnan/hexo-theme-next/pull/1534), - [`canvas_lines` and `canvas_sphere`](https://github.com/iissnan/hexo-theme-next/pull/1595) options -- **shenzekun**: [Load bar at the top](https://github.com/iissnan/hexo-theme-next/pull/1689) -- **elkan1788**: [Upgrade jiathis share](https://github.com/iissnan/hexo-theme-next/pull/1796) -- **xCss**: [Valine comment system support](https://github.com/iissnan/hexo-theme-next/pull/1811) -- **Julian Xhokaxhiu**: [`override` option](https://github.com/iissnan/hexo-theme-next/pull/1861) -- **LEAFERx**: [NeedMoreShare2](https://github.com/iissnan/hexo-theme-next/pull/1913) -- **aimingoo & LEAFERx**: [Gitment supported with Mint](https://github.com/iissnan/hexo-theme-next/pull/1919) -- **LeviDing**: [Fix the bug of Gitment](https://github.com/iissnan/hexo-theme-next/pull/1944) -- **maple3142**: [Firestore visitor counter](https://github.com/iissnan/hexo-theme-next/pull/1978) - -It lives on as an open source project with many contributors, a self updating list is [here](https://github.com/theme-next/hexo-theme-next/graphs/contributors). - -P.S. If you was do some useful pulls/commits in original repository and you are not in list, let me know and you will be added here. diff --git a/doc/themes/next/docs/DATA-FILES.md b/doc/themes/next/docs/DATA-FILES.md deleted file mode 100644 index bdf8ab002..000000000 --- a/doc/themes/next/docs/DATA-FILES.md +++ /dev/null @@ -1,61 +0,0 @@ -

Data Files

- -Currently, it is not smooth to update NexT theme from pulling or downloading new releases. It is quite often running into conflict status when updating NexT theme via `git pull`, or need to merge configurations manually when upgrading to new releases. - - At present, NexT encourages users to store some options in site's `_config.yml` and other options in theme's `_config.yml`. This approach is applicable, but has some drawbacks: -1. Configurations are splitted into two pieces -2. Users may be confused which place should be for options - -In order to resolve this issue, NexT will take advantage of Hexo [Data files](https://hexo.io/docs/data-files.html). Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature. - -If you prefer Hexo 2.x, you can still use the old approach for configurations. NexT is still compatible with Hexo 2.x (but errors are possible). - -

Option 1: Hexo-Way

- -With this way, all your configurations locate in main hexo config file (`hexo/_config.yml`), you don't need to touch `next/_config.yml` or create any new files. But you must preserve double spaces indents within `theme_config` option. - -If there are any new options in new releases, you just need to copy those options from `next/_config.yml`, paste into `hexo/_config.yml` and set their values to whatever you want. - -### Usage - -1. Check for no exists `hexo/source/_data/next.yml` file (delete it if exists). -2. Copy needed NexT theme options from theme's `next/_config.yml` into `hexo/_config.yml`, then\ - 2.1. Move all this settings to the right with two spaces (in Visual Studio Code: select all strings, CTRL + ]).\ - 2.2. Add `theme_config:` parameter above all this settings. - -### Useful links - -* [Hexo Configuration](https://hexo.io/docs/configuration.html) -* [Hexo Pull #757](https://github.com/hexojs/hexo/pull/757) - -

Option 2: NexT-Way

- -With this way, you can put all your configurations into one place (`source/_data/next.yml`), you don't need to touch `next/_config.yml`. -But option may not accurately procces all hexo external libraries with their additional options (for example, `hexo-server` module options may be readed only in default hexo config). - -If there are any new options in new releases, you just need to copy those options from `next/_config.yml`, paste into `_data/next.yml` and set their values to whatever you want. - -### Usage - -1. Please ensure you are using Hexo 3 (or above). -2. Create an file named `next.yml` in site's `hexo/source/_data` directory (create `_data` directory if it did not exists). - -

And after that steps there are 2 variants, need to choose only one of them and resume next steps.

- -* **Variant 1: `override: false` (default)**: - - 1. Check your `override` option in default NexT config, it must set on `false`.\ - In `next.yml` it must not be defined or set on `false` too. - 2. Copy needed options from both site's `_config.yml` and theme's `_config.yml` into `hexo/source/_data/next.yml`. - -* **Variant 2: `override: true`**: - - 1. In `next.yml` set `override` option on `true`. - 2. Copy **all** NexT theme options from theme's `next/_config.yml` into `hexo/source/_data/next.yml`. - -3. Then, in main site's `hexo/_config.yml` need to define `theme: next` option (and if needed, `source_dir: source`). -4. Use standart parameters to start server, generate or deploy (`hexo clean && hexo g -d && hexo s`). - -### Useful links - -* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328) diff --git a/doc/themes/next/docs/INSTALLATION.md b/doc/themes/next/docs/INSTALLATION.md deleted file mode 100644 index 3f229994d..000000000 --- a/doc/themes/next/docs/INSTALLATION.md +++ /dev/null @@ -1,120 +0,0 @@ -

Installation

- -

Step 1 → Go to Hexo dir

- -Change dir to **hexo root** directory. There must be `node_modules`, `source`, `themes` and other directories: - ```sh - $ cd hexo - $ ls - _config.yml node_modules package.json public scaffolds source themes - ``` - -

Step 2 → Get NexT

- -

Download theme from GitHub.
-There are 3 options to do it, need to choose only one of them.

- -### Option 1: Download [latest release version][releases-latest-url] - - At most cases **stable**. Recommended for beginners. - - * Install with [curl & tar & wget][curl-tar-wget-url]: - - ```sh - $ mkdir themes/next - $ 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 - ``` - This variant will give to you **only latest release version** (without `.git` directory inside).\ - So, there is impossible to update this version with `git` later.\ - 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. - -### Option 2: Download [tagged release version][releases-url] - - In rare cases useful, but not recommended.\ - You must define version. Replace `v6.0.0` with any version from [tags list][tags-url]. - - * Variant 1: Install with [curl & tar][curl-tar-url]: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1 - ``` - Same as above under `curl & tar & wget` variant, but will download **only concrete version**. - - * Variant 2: Install with [git][git-url]: - - ```sh - $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next - ``` - This variant will give to you the **defined release version** (with `.git` directory inside).\ - And in any time you can switch to any tagged release, but with limit to defined version. - -### Option 3: Download [latest master branch][download-latest-url] - - May be **unstable**, but includes latest features. Recommended for advanced users and for developers. - - * Variant 1: Install with [curl & tar][curl-tar-url]: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1 - ``` - Same as above under `curl & tar & wget` variant, but will download **only latest master branch version**.\ - At some cases useful for developers. - - * Variant 2: Install with [git][git-url]: - - ```sh - $ git clone https://github.com/theme-next/hexo-theme-next themes/next - ``` - - This variant will give to you the **whole repository** (with `.git` directory inside).\ - 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.\ - At most cases useful as for users and for developers. - - Get tags list: - - ```sh - $ cd themes/next - $ git tag -l - … - v6.0.0 - v6.0.1 - v6.0.2 - ``` - - For example, you want to switch on `v6.0.1` [tagged release version][tags-url]. Input the following command: - - ```sh - $ git checkout tags/v6.0.1 - Note: checking out 'tags/v6.0.1'. - … - HEAD is now at da9cdd2... Release v6.0.1 - ``` - - And if you want to switch back on [master branch][commits-url], input this command: - - ```sh - $ git checkout master - ``` - -

Step 3 → Set it up

- -Set theme in main **hexo root config** `_config.yml` file: - -```yml -theme: next -``` - -[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip -[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest -[releases-url]: https://github.com/theme-next/hexo-theme-next/releases -[tags-url]: https://github.com/theme-next/hexo-theme-next/tags -[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master - -[git-url]: http://lmgtfy.com/?q=linux+git+install -[curl-tar-url]: http://lmgtfy.com/?q=linux+curl+tar+install -[curl-tar-wget-url]: http://lmgtfy.com/?q=linux+curl+tar+wget+install - -[update-with-git-url]: https://github.com/theme-next/hexo-theme-next/blob/master/README.md#update -[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/DATA-FILES.md diff --git a/doc/themes/next/docs/LEANCLOUD-COUNTER-SECURITY.md b/doc/themes/next/docs/LEANCLOUD-COUNTER-SECURITY.md deleted file mode 100644 index 9a6c8a0dd..000000000 --- a/doc/themes/next/docs/LEANCLOUD-COUNTER-SECURITY.md +++ /dev/null @@ -1,177 +0,0 @@ -Before you make the config, please upgrade your NexT version to v6.0.6 or greater. - -Please note the difference between **site config file** and **theme config file** - ---- - -# Sign up to Leancloud and create an app -- Go to Leancloud website [leancloud.cn](leancloud.cn) and sign up to Leancloud. Then login. -- Click `1` to enter the console: - - ![1](https://lc-cqha0xyi.cn-n1.lcfile.com/fc0c048a1e25dc3d10aa.jpg) - -- Then click `1` to create an app: - - ![2](https://lc-cqha0xyi.cn-n1.lcfile.com/33a56b754753a5d34b01.jpg) - -- Type your app name in `1` in the pop up window(eg. "test"), then choose `2`, which means developer's plan, and then click `3` to create the app: - - ![3](https://lc-cqha0xyi.cn-n1.lcfile.com/649ccfc6f12015d1eefb.jpg) - -# Create Counter class and enable plugin in NexT -- Click `1`(app name) to enter the app manage page: - - ![4](https://lc-cqha0xyi.cn-n1.lcfile.com/d0889df29841661e0b9e.jpg) - -- then click `1` to create a class for counter: - - ![5](https://lc-cqha0xyi.cn-n1.lcfile.com/b0fbc81bd6c19fa09a46.jpg) - -- Type `Counter` in the pop up window in `1`, check `2`, then click `3`: - - ![6](https://lc-cqha0xyi.cn-n1.lcfile.com/ae6154d6a55f02f11ebf.jpg) - -- Click `1` to enter the app setting, then click `2`: - - ![8](https://lc-cqha0xyi.cn-n1.lcfile.com/9501a6372918dd9a8a92.jpg) - -- Paste `App ID` and `App Key` to **theme config file**`_config.yml` like this: - ```yml - leancloud_visitors: - enable: true - app_id: <> - app_key: <> - # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security - security: true - betterPerformance: false - ``` - -- Set domain whitelist: Click`1`, then type your domain into `2`(**protocol, domain and port should be exactly the same**): - - ![9](https://lc-cqha0xyi.cn-n1.lcfile.com/0e537cc4bec2e185201d.jpg) - -# Deploy web engine to avoid your data being changed illegally -- Click `1 -> 2 -> 3` by order - - ![10](https://lc-cqha0xyi.cn-n1.lcfile.com/d7056dfeeef7c5d66318.jpg) - -- Click`1`: - - ![11](https://lc-cqha0xyi.cn-n1.lcfile.com/2737841bbc2bdd572ae0.jpg) - -- In the pop up window, click `1` to choose type `Hook`, then choose`beforeUpdate` in `2`, choose `Counter` in `3`. Paste code below into `4`, then click `5` to save it: - ```javascript - var query = new AV.Query("Counter"); - if (request.object.updatedKeys.indexOf('time') !== -1) { - return query.get(request.object.id).then(function (obj) { - if (obj.get("time") > request.object.get("time")) { - throw new AV.Cloud.Error('Invalid update!'); - } - return request.object.save(); - }); - } - ``` - - ![12](https://lc-cqha0xyi.cn-n1.lcfile.com/a8e13418ed1d9405315b.jpg) - -- Click `1` to deploy after the message in the red rect shows up: - - ![13](https://lc-cqha0xyi.cn-n1.lcfile.com/ca56bf2e5fc2a1343565.jpg) - -- Click `1` in the pop up: - - ![14](https://lc-cqha0xyi.cn-n1.lcfile.com/17548c13b3b23c71d845.jpg) - -- Click `1` to close the pop up window after the message in the red rect shows up: - - ![15](https://lc-cqha0xyi.cn-n1.lcfile.com/d2f50de6cefea9fd0ed3.jpg) - -# Set access control for your database -- Open **theme config file**`_config.yml`, set `leancloud_visitors: security` to `true`: - ```yml - leancloud_visitors: - enable: true - app_id: <> - app_key: <> - # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security - security: true - betterPerformance: false - ``` - - **Explaination for `betterPerformance`:** - Because the Leancloud developer's plan has limits in requst thread amount and running time, counter number may be very slow to load in some times. If set `betterPerformance` to true, counter number will be displayed quickly by assuming the request is accepted normally. - -- Open cmd then switch to **root path of site**, type commands to install `hexo-leancloud-counter-security` plugin: - ``` - npm install hexo-leancloud-counter-security --save - ``` - -- Open **site config file**`_config.yml`, add those config: - ```yml - leancloud_counter_security: - enable_sync: true - app_id: <> - app_key: < - username: - password: - ``` - -- Type command: - ``` - hexo lc-counter register <> <> - ``` - or - ``` - hexo lc-counter r <> <> - ``` - - Change `<>` and `<>` to your own username and password (no need to be the same as leancloud account). They will be used in the hexo deploying. - - - Open **site config file**`_config.yml`, change `<>` and `<>`to those you set above: - ```yml - leancloud_counter_security: - enable_sync: true - app_id: <> - app_key: < - username: <> # will be asked while deploying if be left blank - password: <> # recommend to leave it blank for security, will be asked while deploying if be left blank - ``` - -- Add the deployer in the `deploy` of **site config file**`_config.yml`: - ```yml - deploy: - - type: git - repo: // your repo - ... - - type: leancloud_counter_security_sync - ``` - -- Return to the Leancloud console. Click `1 -> 2`, check if there is a record added in the _User (the img below is using username "admin" for example): - - ![16](https://lc-cqha0xyi.cn-n1.lcfile.com/99faa5a0e7160e66d506.jpg) - -- Click `1 -> 2 -> 3` by order: - - ![17](https://lc-cqha0xyi.cn-n1.lcfile.com/b72a9e64579f5b71749d.jpg) - -- Click `1`(add_fields), then choose `2`:Do as below "create" setting(choose the user you create): - - ![18](https://lc-cqha0xyi.cn-n1.lcfile.com/14a8cb37062693d768ad.jpg) - -- click `1`(create), then choose `2`, type the username in `3`, then click `4 -> 5`: - - ![19](https://lc-cqha0xyi.cn-n1.lcfile.com/d91714cfd703ef42b94c.jpg) - - Now your page should be similar to this img after finishing the step. - - ![20](https://lc-cqha0xyi.cn-n1.lcfile.com/c05e7ec9218820baf412.jpg) - -- Click `1`(delete), then choose `2`: - - ![21](https://lc-cqha0xyi.cn-n1.lcfile.com/c37b6e20726cfb1d3197.jpg) - -Now the bug is fixed. - ---- - -See detailed version here: https://leaferx.online/2018/03/16/lc-security-en/ diff --git a/doc/themes/next/docs/LICENSE.txt b/doc/themes/next/docs/LICENSE.txt deleted file mode 100644 index 40a71e830..000000000 --- a/doc/themes/next/docs/LICENSE.txt +++ /dev/null @@ -1,56 +0,0 @@ - «NexT» – Elegant and powerful theme for Hexo. - - Copyright © 2017 «NexT» (github.com/theme-next/hexo-theme-next). - - Detail attribution information for «NexT» - is contained in the 'docs/AUTHORS.md' file. - - This program is free software; you can redistribute it and/or modify -it under the terms of the GNU Affero General Public License version 3 -as published by the Free Software Foundation with the addition of the -following permission added to Section 15 as permitted in Section 7(a): -FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY «NEXT», -«NEXT» DISCLAIMS THE WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS. - - This program is distributed in the hope that it will be useful, but -WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -or FITNESS FOR A PARTICULAR PURPOSE. -See the GNU Affero General Public License for more details. -You should have received a copy of the GNU Affero General Public License -along with this program; if not, see: https://www.gnu.org/licenses/agpl.txt - - In accordance with Section 7(b) of the GNU Affero General Public License: - - a) It is not necessary to specify copyright in each source file of - this program because GitHub fully save commits of all modified files - with their authors and provides to see for this changes publicly. - - b) For any part of the covered work in which the copyright not specified, - except of third party libraries ('source/lib/*') and '*custom.*' files, - will mean this part owned by «NexT» in accord with terms in this file. - -* c) A covered work must retain «NexT» official website link - (https://theme-next.org) in footer section of every website created, - modified or manipulated by using «NexT». - «NexT» theme configuration must be: - ``` - footer: - theme: - enable: true - ``` - Collaborators, best contributors and all authors specified in the - 'docs/AUTHORS.md' file of «NexT» repository under the - 'https://github.com/theme-next' organization can ignore theme info link - requirements. - - Anyone can be released from the requirements of the license by purchasing -a commercial license. Buying such a license is mandatory as soon as you -develop commercial activities involving the «NexT» software without -disclosing the source code of your own applications. -These activities include: - 1. Access to private repository with various premium features. - 2. Priority support for resolve all possible issues with «NexT». - 3. Priority support for implement all possible features to «NexT». - - For more information, please contact «NexT» Organization at this -address: support@theme-next.org diff --git a/doc/themes/next/docs/MATH.md b/doc/themes/next/docs/MATH.md deleted file mode 100644 index 76498ff04..000000000 --- a/doc/themes/next/docs/MATH.md +++ /dev/null @@ -1,286 +0,0 @@ -

Math Equations

- -NexT provides two render engines for displaying Math Equations. - -If you choose to use this feature, you don't need to manually import any JS or CSS. You just need to turn on `enable` of `math` and choose a render `engine` for it (located in `next/_config.yml`): - -```yml -math: - enable: true - ... - engine: mathjax -``` - -Notice: only turning on `enable` of `math` **cannot let you see the displayed equations correctly**, you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations. The corresponding Hexo Renderer per engine will be provided below. - -

Provided Render Engine

- -For now, NexT provides two Render Engines: [MathJax](https://www.mathjax.org/) and [Katex](https://khan.github.io/KaTeX/) (default is MathJax). - -### MathJax (default) - -If you use MathJax to render Math Equations, you need to use **only one of them**: [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) or [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed). - -Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and install one of the renderer above: - -```sh -npm un hexo-renderer-marked --save -npm i hexo-renderer-pandoc --save # or hexo-renderer-kramed -``` - -Secondly, in `next/_config.yml`, turn on `enable` of `math` and choose `mathjax` as `engine`. - -```yml -math: - enable: true - ... - engine: mathjax - #engine: katex -``` - -Finally, run standard Hexo generate, deploy process or start the server: - -```sh -hexo clean && hexo g -d -# or hexo clean && hexo s -``` - -#### Numbering and referring equations in MathJax - -In 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. - -In 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. - -For simple equations, use the following form to give a tag, - -```latex -$$\begin{equation} -e=mc^2 -\end{equation}\label{eq1}$$ -``` - -Then, you can refer to this equation in your text easily by using something like - -``` -the famous matter-energy equation $\eqref{eq1}$ proposed by Einstein ... -``` - -For multi-line equations, inside the `equation` environment, you can use the `aligned` environment to split it into multiple lines: - -```latex -$$\begin{equation} -\begin{aligned} -a &= b + c \\ - &= d + e + f + g \\ - &= h + i -\end{aligned} -\end{equation}\label{eq2}$$ -``` - -We can use `align` environment to align multiple equations. Each of these equations will get its own numbers. - -``` -$$\begin{align} -a &= b + c \label{eq3} \\ -x &= yz \label{eq4}\\ -l &= m - n \label{eq5} -\end{align}$$ -``` - -In 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: - -```latex -$$\begin{align} --4 + 5x &= 2+y \nonumber \\ - w+2 &= -1+w \\ - ab &= cb -\end{align}$$ -``` - -Sometimes, you want to use more “exotic” style to refer your equation. You can use `\tag{}` to achieve this. For example: - -```latex -$$x+1\over\sqrt{1-x^2} \tag{i}\label{eq_tag}$$ -``` - -For more information, you can visit the [official MathJax documentation on equation numbering](http://docs.mathjax.org/en/latest/tex.html#automatic-equation-numbering). You can also visit this [post](https://jdhao.github.io/2018/01/25/hexo-mathjax-equation-number/) for more details. - -### Katex - -The Katex engine is a **much faster** math render engine compared to MathJax. And it could survive without JavaScript. - -But, what Katex supports is not as full as MathJax. You could check it from the Useful Links below. - -If 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). - -Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and **install one of selected above**. - -```sh -npm un hexo-renderer-marked --save -npm i hexo-renderer-markdown-it-plus --save -# or hexo-renderer-markdown-it -``` - -Secondly, in `next/_config.yml`, turn on `enable` option of `math` and choose `katex` as render `engine`. - -```yml -math: - enable: true - ... - #engine: mathjax - engine: katex -``` - -Finally, run the standard Hexo generate, deploy process or start the server: - -```sh -hexo clean && hexo g -d -# or hexo clean && hexo s -``` - -#### If you use hexo-renderer-markdown-it - -If you use `hexo-renderer-markdown-it`,you also need to add `markdown-it-katex` as its plugin: - -``` -npm i markdown-it-katex --save -``` - -And then in `hexo/_config.yml` you need to add `markdown-it-katex` as a plugin for `hexo-renderer-markdown-it`: - -```yml -# config of hexo-renderer-markdown-it -markdown: - render: - html: true - xhtmlOut: false - breaks: true - linkify: true - typographer: true - quotes: '“”‘’' - plugins: - - markdown-it-katex -``` - -#### Known Bugs - -1. Firstly, please check [Common Issues](https://github.com/Khan/KaTeX#common-issues) of Katex. -2. Displayed Math (i.e. `$$...$$`) needs to started with new clear line.\ - 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)). -3. Don't support Unicode ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)). -4. 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)). -5. If you use math in Heading (i.e. `## Heading`).\ - Then in corresponding TOC item it will show the related LaTex code 3 times ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359018694)). -6. If you use math in your post's title, it will not be rendered ([comment #32](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359142879)). - -We currently use Katex 0.7.1, some of those bugs might be caused by the outdated version of Katex we use. - -But, as what is described in the beginning, the render of Math Equations relies on Hexo Renderer. Currently, Katex-related renderers only support Katex version until 0.7.1. - -We will continuously monitor the updates of corresponding renderers, if there is a renderer which supports newer version of Katex, we will update the Katex we use. - -### Useful Links - -* [Speed test between Katex and MathJax](https://www.intmath.com/cg5/katex-mathjax-comparison.php) -* [Function support by Katex](https://khan.github.io/KaTeX/function-support.html) - -

Configuration Specifications

- -ATTENTION! When you edit those configs, **don't change indentation!** - -Currently, all NexT config use **2 spaces indents**. - -If your content of config is put just directly after the config name, then a space is needed between the colon and the config content (i.e. `enable: true`) - -```yml -# Math Equations Render Support -math: - enable: false - - # Default(true) will load mathjax/katex script on demand - # That is it only render those page who has 'mathjax: true' in Front Matter. - # If you set it to false, it will load mathjax/katex srcipt EVERY PAGE. - per_page: true - - engine: mathjax - #engine: katex - - # hexo-rendering-pandoc (or hexo-renderer-kramed) needed to full MathJax support. - mathjax: - # For newMathJax CDN (cdnjs.cloudflare.com) with fallback to oldMathJax (cdn.mathjax.org). - cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML - # For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com). - #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML - - # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) - # needed to full Katex support. - katex: - # Use Katex 0.7.1 as default - cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css - # If you want to try the latest version of Katex, use one below instead - #cdn: //cdn.jsdelivr.net/katex/latest/katex.min.css -``` - -### enable - -`true` or `false`, default is `false`. - -`true` to turn on render of Math Equations, `false` to turn off it. - -### per_page - -`true` or `false`, default is `true`. - -This option is to control whether to render Math Equations every page. - -The behavior of default (`true`) is to render Math Equations **on demand**. - -It will only render those posts which have `mathjax: true` in their Front Matter. - -For example: - -```md - ---- -title: 'Will Render Math' -mathjax: true ---- -.... -``` - -```md - ---- -title: 'Not Render Math' -mathjax: false ---- -.... -``` - -```md - ---- -title: 'Not Render Math Either' ---- -.... -``` - -When you set it to `false`, the math will be rendered on **EVERY PAGE**. - -### cdn - -Both MathJax and Katex provide a config `cdn`, if you don't know what is `cdn`, **do not touch it**. - -Firstly, both MathJax and Katex use the [jsDelivr](https://www.jsdelivr.com/) as the default CDN. - -The reason that jsDelivr is chosen is because it is fast everywhere, and jsDelivr has the valid ICP license issued by the Chinese government, it can be accessed in China pretty well. - -And we also provide other optional CDNs, including the famous [CDNJS](https://cdnjs.com/). - -For MathJax, we are currently using version 2.7.1. - -For Katex, due to the problem described above, we are now using version 0.7.1. - -If you want to try the other CDNs not included in the optional list, you must use the corresponding version. - -Particularly, if you are a Chinese blogger or most of your visits come from China, please note that **the CDNJS is blocked in some parts of China**, don't use it as your CDN. diff --git a/doc/themes/next/docs/UPDATE-FROM-5.1.X.md b/doc/themes/next/docs/UPDATE-FROM-5.1.X.md deleted file mode 100644 index 93ae14ec0..000000000 --- a/doc/themes/next/docs/UPDATE-FROM-5.1.X.md +++ /dev/null @@ -1,19 +0,0 @@ -

Update from NexT v5.1.x

- -There are no hard breaking changes between 5.1.x and 6.0.x versions. It's change major version to 6 because: - -1. Main repo was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [theme-next](https://github.com/theme-next) organization. -2. Most libraries under the `next/source/lib` directory was moved out to [external repos under NexT organization](https://github.com/theme-next). -3. 3rd-party plugin [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) was replaced by [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) because `hexo-symbols-count-time` no have any external nodejs dependencies, no have [language filter](https://github.com/willin/hexo-wordcount/issues/7) which causes better performance on speed at site generation. - -So, i suggest to update from version 5 to version 6 in this way: - -1. You don't touch old `next` dir and just do some copies of NexT files:\ - 1.1. `config.yml` or `next.yml` (if you used [data-files](DATA-FILES.md)).\ - 1.2. Custom CSS styles what placed in `next/source/css/_custom/*` and `next/source/css/_variables/*` directories.\ - 1.3. Custom layout styles what placed in `next/layout/_custom/*`.\ - 1.4. Any another possible custom additions which can be finded by compare tools between repos. -2. Clone new v6.x repo to any another directory instead of `next`. For example, in `next-reloaded` directory: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. So, you don't touch your old NexT 5.1.x directory and can work with new `next-reloaded` dir. -3. Go to Hexo main config and set theme parameter: `theme: next-reloaded`. So, your `next-reloaded` directory must loading with your generation. If you may see any bugs or you simply not like this version, you anytime can switch for 5.1.x version back. - -And how to enable 3rd-party libraries see [here](https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md#plugins). diff --git a/doc/themes/next/docs/ru/DATA-FILES.md b/doc/themes/next/docs/ru/DATA-FILES.md deleted file mode 100644 index a1788d74a..000000000 --- a/doc/themes/next/docs/ru/DATA-FILES.md +++ /dev/null @@ -1,61 +0,0 @@ -

Дата Файлы

- -Обновление темы NexT через пулы проходит не слишком гладко. Часто происходит конфликтная ситуация при обновлении по команде `git pull`, хотя её и можно обойти, если смерджить настройки в файле конфигурации вручную. - - На данный момент, пользователи хранят одни настройки в корневом `_config.yml` (Hexo), а другие настройки в конфиге темы `_config.yml` (NexT). И всё вроде бы ничего, но имеются некоторые недостатки: -1. Конфигурация разделяется на две части. -2. Пользователи могут запутаться, в каком файле какие должны быть настройки. - -Во избежании проблемы, NexT использует преимущество Hexo [дата-файлов](https://hexo.io/docs/data-files.html). И т.к. дата-файлы были представлены в Hexo 3, необходимо обновиться до Hexo 3.0 (или выше) для использования этой возможности. - -Если же Вы предпочитаете Hexo 2.x, то можно использовать старый способ для конфигураций. NexT всё ещё совместим с Hexo 2.x (но возможны ошибки). - -

Способ 1: Hexo-Путь

- -Используя этот способ, вся конфигурация будет раположена в корневом конфиге hexo (`hexo/_config.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`next/_config.yml`) или создавать какие-либо новые файлы. Но в этом случае необходимо сохранять двойные отступы внутри `theme_config` параметра. - -Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` в редактируемый `hexo/_config.yml` и настроить по своему усмотрению. - -### Использование - -1. Проверяем на существование `hexo/source/_data/next.yml` файл (удаляем, если существует). -2. Копируем необходимые опции из конфига темы NexT `next/_config.yml` в `hexo/_config.yml`, затем\ - 2.1. Сдвигаем все опции вправо на 2 пробела (в Visual Studio Code: выделяем все строки, CTRL + ]).\ - 2.2. Добавляем `theme_config:` параметр перед всеми этими настройками. - -### Полезные ссылки - -* [Конфигурация Hexo](https://hexo.io/ru/docs/configuration.html) -* [Hexo Pull #757](https://github.com/hexojs/hexo/pull/757) - -

Способ 2: NexT-Путь

- -Используя этот способ, вся конфигурация будет храниться в одном файле (`source/_data/next.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`next/_config.yml`). -Но с этим способом могут не корректно обрабатываться все внешние библиотеки hexo при использовании их дополнительных опций (например, опции модуля `hexo-server` могут быть считаны только из стандартного конфига hexo). - -Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` во внешний `_data/next.yml` и настроить по своему усмотрению. - -### Использование - -1. Убеждаемся, что Hexo версии 3 (или выше). -2. Создаём файл под именем `next.yml` в корневой директории сайта — `hexo/source/_data` (создаём директорию `_data`, если отсутствует). - -

И после этих шагов есть 2 варианта, нужно выбрать только 1 из них и продолжить следующие шаги.

- -* **Вариант 1: `override: false` (по-умолчанию)**: - - 1. Проверяем опцию `override` в стандартном конфиге NexT'а, должно быть установлено в `false`.\ - В файле `next.yml` эта опция не должна быть вписана вовсе или вписана и установлена в `false`. - 2. Копируем настройки из конфига темы NexT (`_config.yml`) и из корневого конфига сайта (`_config.yml`) в файл `hexo/source/_data/next.yml`. - -* **Вариант 2: `override: true`**: - - 1. В файле `next.yml` ставим опцию `override` в `true`. - 2. Копируем **все** опции из оригинального конфига NexT'а `next/_config.yml` в `hexo/source/_data/next.yml`. - -3. Затем, в корневом конфиге сайта `hexo/_config.yml` необходимо установить опцию `theme: next` (и если требуется, `source_dir: source`). -4. Используем станадартные параметры для запускаь генерации или развёртывания (`hexo clean && hexo g -d && hexo s`). - -### Полезные ссылки - -* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328) diff --git a/doc/themes/next/docs/ru/INSTALLATION.md b/doc/themes/next/docs/ru/INSTALLATION.md deleted file mode 100644 index 5cf98afd8..000000000 --- a/doc/themes/next/docs/ru/INSTALLATION.md +++ /dev/null @@ -1,120 +0,0 @@ -

Установка

- -

Шаг 1 → Идём в директорию Hexo

- -Меняем каталог на **корневой hexo**. Там должны находиться `node_modules`, `source`, `themes` и другие папки: - ```sh - $ cd hexo - $ ls - _config.yml node_modules package.json public scaffolds source themes - ``` - -

Шаг 2 → Скачиваем NexT

- -

Скачиваем тему с GitHub.
-Имеются 3 способа как зделать это, нужно выбрать только 1 из них.

- -### Способ 1: Скачиваем [последнюю версию релиза][releases-latest-url] - - В большинстве случаев **стабильна**. Рекомендуется для начинающих пользователей. - - * Установка с помощью [curl & tar & wget][curl-tar-wget-url]: - - ```sh - $ mkdir themes/next - $ 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 - ``` - Этим способом Вы скачаете **только последнюю версию релиза** (без директории `.git` внутри).\ - Поэтому, в дальнейшем будет невозможно обновить эту версию через `git`.\ - Зато всегда можно использовать отдельную конфигурацию (т.е. [дата-файлы][docs-data-files-url]) и скачивать новую версию перезаписывая старую (или создать новый каталог и переопределить параметр `theme` в конфиге Hexo), без потери старой конфигурации. - -### Способ 2: Скачиваем [указанную версию релиза][releases-url] - - В редких случаях полезно, но не рекомендуется.\ - Необходимо указать версию. Замените `v6.0.0` на любую версию из [списка тэгов][tags-url]. - - * Вариант 1: Установка с помощью [curl & tar][curl-tar-url]: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1 - ``` - То же, что и описано выше в способе `curl & tar & wget`, но скачает **только конкретную версию**. - - * Вариант 2: Установка с помощью [git][git-url]: - - ```sh - $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next - ``` - Этот вариант скачает **указанную версию релиза** (включая директорию `.git` внутри).\ - И в любой момент Вы можете переключиться на любую весию тэга, но с лимитом до указанной версии. - -### Способ 3: Скачиваем [последнюю мастер-ветку][download-latest-url] - - Иногда может быть **нестабильна**, но включает самые последние нововведения. Рекомендуется для продвинутых пользователей и для разработчиков. - - * Вариант 1: Установка с помощью [curl & tar][curl-tar-url]: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1 - ``` - То же, что и описано выше в варианте `curl & tar & wget`, но скачает **только последнюю мастер-ветку**.\ - В некоторых случаях полезно для разработчиков. - - * Вариант 2: Установка с помощью [git][git-url]: - - ```sh - $ git clone https://github.com/theme-next/hexo-theme-next themes/next - ``` - - Этот вариант скачает **весь репозиторий** (включая директорию `.git` внутри).\ - И в любой момент Вы можете [обновить текущую версию через git][update-with-git-url] и переключиться на любую версию тэга или на последнюю мастер или любую другую ветку.\ - В большинстве случаев полезно как для пользователей, так и для разработчиков. - - Смотрим список тэгов: - - ```sh - $ cd themes/next - $ git tag -l - … - v6.0.0 - v6.0.1 - v6.0.2 - ``` - - Например, Вы хотите переключиться на [версию релиза][tags-url] `v6.0.1`. Вводим следующую команду: - - ```sh - $ git checkout tags/v6.0.1 - Note: checking out 'tags/v6.0.1'. - … - HEAD is now at da9cdd2... Release v6.0.1 - ``` - - И если вы хотите переключиться обратно на [мастер-ветку][commits-url], вводим следующее: - - ```sh - $ git checkout master - ``` - -

Шаг 3 → Конфигурируем

- -Устанавливаем параметр темы в конфиге `_config.yml` **корневой директории hexo**: - -```yml -theme: next -``` - -[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip -[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest -[releases-url]: https://github.com/theme-next/hexo-theme-next/releases -[tags-url]: https://github.com/theme-next/hexo-theme-next/tags -[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master - -[git-url]: http://lmgtfy.com/?q=linux+git+install -[curl-tar-url]: http://lmgtfy.com/?q=linux+curl+tar+install -[curl-tar-wget-url]: http://lmgtfy.com/?q=linux+curl+tar+wget+install - -[update-with-git-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/README.md#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0 -[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md diff --git a/doc/themes/next/docs/ru/README.md b/doc/themes/next/docs/ru/README.md deleted file mode 100644 index 942dcf684..000000000 --- a/doc/themes/next/docs/ru/README.md +++ /dev/null @@ -1,139 +0,0 @@ -
Язык: :us: -:cn: -:ru:
- -#
e x T
- -

«NexT» — элегантная высококачественная тема под Hexo. Сделана с нуля, с любовью.

- -

- - - - - - - -

- -## Демо - -* :heart_decoration: Muse тема: [LEAFERx](https://leaferx.online) | [Alex LEE](http://saili.science) | [Miaia](https://11.tt) -* :six_pointed_star: Mist тема: [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com) -* :pisces: Pisces тема: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Jiaxi He](http://jiaxi.io) -* :gemini: Gemini тема: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me) - -Больше примеров «NexT» [здесь](https://github.com/iissnan/hexo-theme-next/issues/119). - -## Установка - -Простейший вариант установки — склонировать весь репозиторий: - - ```sh - $ cd hexo - $ git clone https://github.com/theme-next/hexo-theme-next themes/next - ``` - -Или предлагаю почитать [детальные инструкции по установке][docs-installation-url], если вариант выше не устраивает. - -## Плагины - -В конфиге NexT'а теперь можно найти зависимости на каждый модуль, который был вынесен во внешние репозитории, которые могут быть найдены по [ссылке основной организации](https://github.com/theme-next). - -Например, Вы хотите использовать `fancybox` для своего сайта. Открываем конфиг NexT'а и находим: - -```yml -# Fancybox -# Dependencies: https://github.com/theme-next/theme-next-fancybox -fancybox: false -``` - -Затем включаем параметр `fancybox` и переходим по ссылке «Dependencies» с дальнейшеми инструкциями по установке этого модуля. - -## Обновление - -Можно обновить до последней мастер-ветки следующей командой: - -```sh -$ cd themes/next -$ git pull -``` - -А если всплывают ошибки во время обновления (что-то наподобии **«Commit your changes or stash them before you can merge»**), рекомендуется ознакомиться с особенностью хранения [дата-файлов в Hexo][docs-data-files-url].\ -Как бы то ни было, можно обойти ошибки при обновлении если «Закомитить», «Стэшнуть» или «Откатить» локальные изменения. Смотрим [здесь](https://stackoverflow.com/a/15745424/5861495) как это сделать. - -**Если нужно обновиться с версии v5.1.x на v6.0.x, читаем [здесь][docs-update-5-1-x-url].** - -## Известные баги - -Для тех, кто столкнулся с ошибкой **«[Error: Cannot find module 'hexo-util'](https://github.com/iissnan/hexo-theme-next/issues/1490)»**, следует проверить версию NPM. - -* `> 3`: Всё равно не работает? Удалите директорию `node_modules` и переустановите с помощью `npm install`. -* `< 3`: Добавьте `hexo-util` принудительно командой `npm install --save-dev hexo-util` к основным пакетам с Hexo. - -## Содействие - -Приветсвуется любое содействие, не стесняйтесь сообщать «Баги», брать «Форки» и вливать «Пулы». - -## Обратная связь - -* Задать вопрос на [Stack Overflow][stack-url]. -* Сообщить об ошибке в разделе [GitHub Issues][issues-bug-url]. -* Запросить новую возможность на [GitHub][issues-feat-url]. -* Голосовать за [популярные запросы возможностей][feat-req-vote-url]. -* Вступить в наши [Gitter][gitter-url] / [Riot][riot-url] / [Telegram][t-chat-url] чаты. -* Подписаться на новости через [канал Telegram'а][t-news-url]. - -## Сторонние приложения - -* :triangular_flag_on_post: HexoEditor - -## Благодарности - -

-«NexT» выражает особую благодарность этим замечательным сервисам, которые спонсируют нашу основную инфраструктуру: -

- -

-

- GitHub позволяет нам хостить Git-репозиторий, Netlify позволяет нам деплоить документацию. -

- -

-

- Crowdin позволяет нам удобно переводить документацию. -

- -

-

- Codacy позволяет нам запускать набор тестов, BrowserStack позволяет нам тестировать в реальных браузерах. -

- -[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg -[browser-url]: https://www.browserstack.com - -[stack-url]: https://stackoverflow.com/questions/tagged/theme-next -[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md -[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md -[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22+sort%3Areactions-%2B1-desc - -[gitter-url]: https://gitter.im/theme-next -[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org -[t-chat-url]: https://t.me/theme_next -[t-news-url]: https://t.me/theme_next_news - - - - - -[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip -[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest - -[tags-url]: https://github.com/theme-next/hexo-theme-next/tags -[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master - -[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md -[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md -[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/UPDATE-FROM-5.1.X.md diff --git a/doc/themes/next/docs/ru/UPDATE-FROM-5.1.X.md b/doc/themes/next/docs/ru/UPDATE-FROM-5.1.X.md deleted file mode 100644 index 499302651..000000000 --- a/doc/themes/next/docs/ru/UPDATE-FROM-5.1.X.md +++ /dev/null @@ -1,19 +0,0 @@ -

Обновление из-под NexT v5.1.x

- -Между версиями 5.1.x и 6.0.x нет жёстких изменений. Версия сменилась на мажорную 6 по следующим причинам: - -1. Основной репозиторий перебазировался из профиля [iissnan'а](https://github.com/iissnan/hexo-theme-next) в [theme-next](https://github.com/theme-next) организацию. -2. Большинство библиотек в `next/source/lib` директории были вынесены в [отдельные репозитории под организацией NexT](https://github.com/theme-next). -3. 3rd-party плагин [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) был заменён на [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) т.к. `hexo-symbols-count-time` не имеет никаких сторонних nodejs зависимостей, не имеет [языкового фильтра](https://github.com/willin/hexo-wordcount/issues/7) что обеспечивает улучшенную производительность при генерации сайта. - -Поэтому, я предлагаю обновиться с версии 5 на версию 6 следующим способом: - -1. Вы не трогаете старую директорию `next`, а всего-лишь делаете резервные копии файлов NexT:\ - 1.1. `config.yml` или `next.yml` (если Вы использовали [дата-файлы](DATA-FILES.md)).\ - 1.2. Пользовательских CSS-стилей, которые расположены в `next/source/css/_custom/*` и `next/source/css/_variables/*` директориях.\ - 1.3. Пользовательских layout-стилей, которые расположены в `next/layout/_custom/*`.\ - 1.4. Любые другие всевозможные пользовательские изменения, которые могут быть найдены любым инструментом для сравнения файлов. -2. Склонировать новый v6.x репозиторий в любую другую директорию, отличную от `next`. Например, в директорию `next-reloaded`: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. Итак, нет необходимости трогать старую NexT 5.1.x директорию и можно работать с новой `next-reloaded`. -3. Открываем главную Hexo-конфигурацию и устанавливаем параметр темы: `theme: next-reloaded`. Так Ваша директория `next-reloaded` должна грузиться при генерации. Если Вы будете наблюдать какие-либо баги или Вам попросту не нравится эта новая версия, в любой момент Вы можете использовать старую 5.1.x. - -А как активировать 3rd-party библиотеки, смотрим здесь [здесь](https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md#%D0%9F%D0%BB%D0%B0%D0%B3%D0%B8%D0%BD%D1%8B). diff --git a/doc/themes/next/docs/zh-CN/ALGOLIA-SEARCH.md b/doc/themes/next/docs/zh-CN/ALGOLIA-SEARCH.md deleted file mode 100644 index 8aab587ca..000000000 --- a/doc/themes/next/docs/zh-CN/ALGOLIA-SEARCH.md +++ /dev/null @@ -1,84 +0,0 @@ -

Algolia 搜索

- -NexT 内部提供 Algolia 的搜索功能,要使用此功能请确保所使用的 NexT 版本在 `v5.1.0` 之后。需要注意的是,仅仅将 `next/_config.yml` 中 `algolia_search` 的 `enable` 打开**并不能让你使用 Algolia 搜索**,你还需要**使用对应的 Hexo-Algolia 插件** 才能真正在博客页面中使用 Algolia 搜索。按照下面介绍的步骤操作即可完成 Algolia 搜索的安装。 - -1. 前往 [Algolia 注册页面](https://www.algolia.com/),注册一个新账户。 可以使用 GitHub 或者 Google 账户直接登录,注册后的 14 天内拥有所有功能(包括收费类别的)。之后若未续费会自动降级为免费账户,免费账户 总共有 10,000 条记录,每月有 100,000 的可以操作数。注册完成后,创建一个新的 Index,这个 Index 将在后面使用。 - - ![](http://theme-next.iissnan.com/uploads/algolia/algolia-step-2.png) - -1. Index 创建完成后,此时这个 Index 里未包含任何数据。接下来需要安装 [Hexo Algolia](https://github.com/oncletom/hexo-algolia) 扩展,这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录,执行命令安装: - - ``` - $ cd hexo - $ npm install --save hexo-algolia - ``` - -1. 在 `API Keys` 页面找到需要使用的一些配置的值,包括 `ApplicationID` 和 `Search-Only API Key`。注意,`Admin API Key` 需要保密保存,不要外泄。 - - ![](https://user-images.githubusercontent.com/8521181/35479066-64e35aec-0428-11e8-91f9-1ec3afa45c5c.png) - -1. 在 `API Keys` 页面,点击 `ALL API KEYS` 找到新建 INDEX 对应的 key,**编辑权限**,在弹出框中找到 ACL ,**勾选 Add records、 Delete records、List indices、Delete index 权限**,点击 `update` 更新。 - - ![](https://user-images.githubusercontent.com/8521181/35479064-611aa0b4-0428-11e8-85a1-cfb449b486ec.png) - ![](https://user-images.githubusercontent.com/8521181/35479084-d4f7ac02-0428-11e8-95a6-c4e3b1bef47b.png) - -1. 编辑 `站点配置文件`,新增以下配置,除了 `chunkSize` 字段,替换成在 Algolia 获取到的值: - - ```yml - algolia: - applicationID: 'applicationID' - apiKey: 'apiKey' - indexName: 'indexName' - chunkSize: 5000 - ``` - -1. 当配置完成,在站点根目录下执行一下命令来更新上传 Index。请注意观察命令的输出。 - - ``` - $ export HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Git Bash - # set HEXO_ALGOLIA_INDEXING_KEY=Search-Only API key # 使用 Windows CMD 命令行 - $ hexo clean - $ hexo algolia - ``` - - ![](http://theme-next.iissnan.com/uploads/algolia/algolia-step-4.png) - -1. 切换到 NexT 目录,并安装 algolia-instant-search 到 `source/lib` 目录。 - - ``` - $ cd themes/next - $ git clone https://github.com/theme-next/theme-next-algolia-instant-search source/lib/algolia-instant-search - ``` - - 如果你想直接使用 CDN 设置 Algolia Search,则需要在`主题配置文件`中添加 vendors 字段: - - ```yml - vendors: - ... - # Internal version: 1 - # https://www.algolia.com - algolia_instant_js: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.js - algolia_instant_css: https://cdn.jsdelivr.net/npm/instantsearch.js@2.4.1/dist/instantsearch.min.css - ... - ``` - -1. 更改`主题配置文件`,找到 Algolia Search 配置部分,将 `enable` 改为 `true`。同时你需要**关闭**其他搜索插件,如 Local Search 等。你也可以根据需要调整 `labels` 中的文本: - - ```yml - # Algolia Search - algolia_search: - enable: true - hits: - per_page: 10 - labels: - input_placeholder: Search for Posts - hits_empty: "We didn't find any results for the search: ${query}" - hits_stats: "${hits} results found in ${time} ms" - ``` - -

已知的问题

- -1. 考虑到 Algolia 免费账户的限制,目前 [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) 插件最新版本去掉了正文索引功能。 -1. [Hexo-Algoliasearch](https://github.com/LouisBarranqueiro/hexo-algoliasearch) 插件提供了正文索引功能,不过需要替换 NEXT 主题中的关键字。对于免费账户,`Record Too Big` 的问题同样存在。 - - 替换 `source/js/algolia-search.js` 中所有的 `applicationID` 为 `appId` - - 替换 `layout/_partials/head/head.swig` 中所有的 `applicationID` 为 `appId` diff --git a/doc/themes/next/docs/zh-CN/CODE_OF_CONDUCT.md b/doc/themes/next/docs/zh-CN/CODE_OF_CONDUCT.md deleted file mode 100644 index ecc737649..000000000 --- a/doc/themes/next/docs/zh-CN/CODE_OF_CONDUCT.md +++ /dev/null @@ -1,99 +0,0 @@ -
Language: :us: -:cn: -:ru:
- -#
e x T
- -[NexT](https://theme-next.org) 是一个优雅而强大的 [Hexo](https://hexo.io/)主题。在这里,您可以构建一个托管在 [GitHub Pages](https://pages.github.com/) 上的静态博客,分享您的生活,并与新朋友进行交流。 - -参与者公约用来约束在 [NexT](https://github.com/theme-next/hexo-theme-next) 社区中代码更新、问题交流、请求合并等行为。我们期望所有用户相互尊重,礼貌待人。任何违反这些规则的人都将不会被审核,并会在发现后立即被阻止和驱逐。 - -## 目录 - -- [我们的保证](#our-pledge) -- [我们的责任](#our-responsibilities) -- [我们的标准](#our-standards) -- [使用范围](#scope) -- [强制执行](#enforcement) -- [联系项目维护者](#contacting-maintainers) -- [来源](#attribution) - - -## 我们的保证 - -作为此项目的贡献者和维护者,我们承诺尊重所有做出贡献的用户,这些贡献包括了报告问题、发布功能请求、更新文档、提交合并请求以及其他活动。 - -为了促进一个开放透明且友好的环境,我们作为贡献者和维护者保证:无论年龄、种族、民族、性别认同和表达(方式)、体型、身体健全与否、经验水平、国籍、个人表现、宗教或性别取向,参与者在我们项目和社区中都免于骚扰。 - - -## 我们的责任 - -项目维护者有责任为「可接受的行为」标准做出诠释,有权利及责任去删除、编辑、拒绝与本行为标准有所违背的评论(comments)、提交(commits)、代码、wiki 编辑、问题(issues)和其他贡献,以及项目维护者可暂时或永久性的禁止任何他们认为有不适当、威胁、冒犯、有害行为的贡献者。 - - -## 我们的标准 - -作为 GitHub 上的一个项目,本项目受到 [GitHub 社区准则](https://help.github.com/articles/github-community-guidelines/)的约束。 此外,作为 npm 托管的项目,[npm 公司的行为准则](https://www.npmjs.com/policies/conduct)也涵盖了本项目。 - -有助于创造正面环境的行为包括但不限于: - -* 使用友好和包容性语言 -* 尊重不同的观点和经历 -* 耐心地接受建设性批评 -* 关注对社区最有利的事情 -* 友善对待其他社区成员 - -身为参与者不能接受的行为包括但不限于: - -* 使用与性有关的言语或是图像,以及不受欢迎的性骚扰 -* 捣乱/煽动/造谣的行为或进行侮辱/贬损的评论,人身攻击及政治攻击 -* 公开或私下的骚扰 -* 未经许可地发布他人的个人资料,例如住址或是电子地址 -* 其他可以被合理地认定为不恰当或者违反职业操守的行为 - - -## 使用范围 - -当一个人代表该项目或是其社区时,本行为标准适用于其项目社区和公共社区。 - -根据某人在本社区范围以外发生的违规情况,项目维护者可以认为其不受欢迎,并采取适当措施来保证所有成员的安全性和舒适性。 - - -## 强制执行 - -如果您看到违反行为准则的行为,请按以下步骤操作: - -1. 让这个人知道他所做的并不合适,并要求他停止或编辑他们的提交信息。该人应立即停止行为并纠正问题。 -2. 如果该人没有纠正其行为,或者您不方便与其沟通,请[联系项目维护者](#contacting-maintainers)。上报时,请尽可能多的提供详细信息,链接,截图,上下文或可用于更好地理解和解决情况的其他信息。 -3. 收到上报信息后,项目维护者会查看问题,并采取进一步的措施。 - -一旦项目维护者参与其中,他们将遵循以下一系列步骤,并尽力保护项目成员的利益。任何维护团队认为有必要且适合的所有投诉都将进行审查及调查,并做出相对应的回应。项目小组有对事件回报者有保密的义务。具体执行的方针近一步细节可能会单独公布。 - -以下是项目维护者根据需要采取的进一步执法步骤: - -1. 再次要求停止违规行为。 -2. 如果违规者还是没有回应,将会受到正式的警告,并收到项目维护者的移除或修改消息。同时,相关的问题或合并请求将会被锁定。 -3. 如果警告后违规行为继续出现,违规者将会被禁言 24 小时。 -4. 如果禁言后违规行为继续出现,违规者将会被处罚长期(6-12个月)禁言。 - -除此之外,项目维护者可以根据需要删除任何违规的消息,图片,贡献等。如果违规行为被认为是对社区成员的严重或直接威胁,包括任何置社区成员于风险的威胁、身体或言语攻击,项目维护者有充分权利自行决定跳过上述任何步骤。 - -没有切实地遵守或是执行本行为标准的项目维护人员,可能会因项目领导人或是其他成员的决定,暂时或是永久地取消其参与资格。 - - -## 联系项目维护者 - -您可以通过以下任何方法与维护人员联系 - -* 电子邮件: - * [support@theme-next.org](mailto:support@theme-next.org) - -* 即时通信: - * [Gitter](https://gitter.im/theme-next) - * [Riot](https://riot.im/app/#/room/#NexT:matrix.org) - * [Telegram](https://t.me/joinchat/GUNHXA-vZkgSMuimL1VmMw) - - -## 来源 - -本行为标准改编自[Contributor Covenant](https://www.contributor-covenant.org/) 和 [WeAllJS Code of Conduct](https://wealljs.org/code-of-conduct)。 diff --git a/doc/themes/next/docs/zh-CN/CONTRIBUTING.md b/doc/themes/next/docs/zh-CN/CONTRIBUTING.md deleted file mode 100644 index 1b941ad36..000000000 --- a/doc/themes/next/docs/zh-CN/CONTRIBUTING.md +++ /dev/null @@ -1,225 +0,0 @@ -
语言::us: -:cn: -:ru:
- -#
e x T
- -首先,非常感谢大家抽出宝贵时间来让我们的 NexT 主题越变越好。在这里,我们介绍一下 [NexT 主题及其子模块](https://github.com/theme-next) 的开源贡献指南。不过,我们希望大家不要局限于此,更欢迎大家随时进行补充。 - -## 目录 - -[如何为 NexT 做贡献](#how-can-i-contribute) - - * [你需要了解的](#before-submitting-an-issue) - * [反馈 Bug](#reporting-bugs) - * [提交漏洞](#reporting-security-bugs) - * [提交功能需求](#suggesting-enhancements) - * [提交合并请求](#submitting-a-pull-request) - * [发布版本](#creating-releases) - -[规范](#guides) - - * [行为规范](#coding-rules) - * [编码规范](#coding-standards) - * [标签规范](#labels-rules) - * [提交信息规范](#commit-messages-rules) - - - -## 如何为 NexT 做贡献 - -目前 NexT 主题已经从 [iissnan](https://github.com/iissnan/hexo-theme-next) 的个人仓库移动到了 [Theme-Next](https://github.com/theme-next) 组织仓库中,并升级到 V6 版本。在 V6+ 版本中,`next/source/lib` 目录下的第三方依赖库将独立放置在 [Theme-Next](https://github.com/theme-next) 组织仓库中。在大多数情况下,NexT V5 版本仍然能够正常运行,但是如果你想获得更多的功能和帮助,还是建议您 [升级到 NexT V6+ 版本](https://github.com/theme-next/hexo-theme-next/blob/master/docs/UPDATE-FROM-5.1.X.md),并移步 [Theme-Next](https://github.com/theme-next/hexo-theme-next) 仓库。 - - - -### 你需要了解的 - -如果你在使用过程中遇到了问题,你可以查阅 FAQs(建设中) 或者 [NexT 帮助文档](https://theme-next.org/docs/)(建设中)。另外,你也可以通过 [这里](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) 进行大致检索,有些问题已经得到解答,你可以自行解决。对于没有解决的 Issue,你也可以继续提问。 - -如果你在使用过程中发现了 Bug,请再次确认 Bug 在 [最新发布版本](https://github.com/theme-next/hexo-theme-next/releases/latest) 中是否重现。如果 Bug 重现,欢迎你到我们的 [主题仓库](https://github.com/theme-next/hexo-theme-next) 中 [反馈 Bug ](#reporting-bugs) 或者 [提交功能需求](#suggesting-enhancements),也更期待您 [提交合并请求](#submitting-a-pull-request)。 - - - -### 反馈 Bug - -反馈 Bug 前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。 - -请认真遵守如下指南,这样我们才能更好地理解问题,重现问题和解决问题。 - -* 在标题中清晰准确地描述你的问题。 -* 参照如下问题尽可能多的提供信息: - * Bug 是否能够重现?是一直出现还是偶尔出现? - * Bug 是从什么时候开始发生的? - * 如果 Bug 突然发生,使用 [旧版本主题](https://github.com/theme-next/hexo-theme-next/releases) 是否能够重现 Bug?又是从哪个版本开始出现 Bug? - * 你所使用 Node,Hexo 以及 Next 的版本号多少?你可以运行 `node -v` 和 `hexo version` 获取版本号,或者查看文件 `package.json` 的内容。 - * 你使用了哪些插件包?查看文件 `package.json` 的内容即可获取。 -* 一步步详细你是如何重现 Bug 的,做了什么,使用了哪些功能等等。如果你需要展示代码段,请使用 [Markdown 代码块](https://help.github.com/articles/creating-and-highlighting-code-blocks/) 或 [Github 预览链接](https://help.github.com/articles/creating-a-permanent-link-to-a-code-snippet/) 或 [Gist 链接](https://gist.github.com/)。 -* 提供 Bug 的样例,如图像文件、在线演示网址等等。 -* 详细描述通过上述重现过程出现的问题。 -* 详细描述你期待的结果。 - - - -#### 提交漏洞 - -如果你发现安全问题,请以负责任的方式行事,即不要在公共 Issue 中提交而是直接向我们反馈,这样我们就可以在漏洞被利用之前对其进行修复。请将相关信息发送到 security@theme-next.com(可接受 PGP 加密邮件)。 - -我们很乐意对任何提交漏洞的人予以特别感谢以便我们修复它。如果你想保持匿名性或使用笔名替代,请告诉我们。我们将充分尊重你的意愿。 - - - -### 提交功能需求 - -提交功能需求前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的 Issue。确定相关仓库后,创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。 - -请认真遵守如下指南,这样我们才能更好地理解和开发功能需求:pencil:: - -* 在标题中清晰准确地描述你的功能需求。 -* 详细描述目前所具有的功能和你所期待的功能,并解释为什么需要该功能。 -* 提供功能需求的样例,如图像文件、在线演示网址等等。 - - - -### 提交合并请求 - -提交合并请求前,请再次确认您已经查看了 [你需要了解的](#before-submitting-an-issue) 内容,避免提交重复的合并请求。确定相关仓库后,创建合并请求。更多详细操作过程可以查看 [帮助文档](https://help.github.com/articles/creating-a-pull-request/)。 - -1. 进入 [hexo-theme-next](https://github.com/theme-next/hexo-theme-next) 主页面,点击`Fork`。 -2. 进入到已经`Fork`的个人仓库(`https://github.com/username/hexo-theme-next`),点击 **Clone or download** 并复制该仓库地址。选择本地文件夹,并打开 Git Bash ,输入如下命令并回车,即可完成仓库克隆。 - ```bash - $ git clone git@github.com:username/hexo-theme-next.git - ``` -3. 进入 `hexo-theme-next` 本地文件夹,并创建分支。 - ```bash - $ cd hexo-theme-next - $ git checkout -b patchname - ``` -4. 本地修改并测试,推送分支。 - ```bash - $ git add . - $ git commit -m "add commit messamge" - $ git push origin patchname - ``` -5. 进入 `fork` 后的仓库,切换到新提交的 `patchname` 分支,点击 `patchname` 分支右侧的 **New pull request** 。在 PR 对比页面,正确选择你需要发起合并请求的分支,然后点击 **Create pull request** ,建立一个新的合并申请并描述变动。 - -请认真遵守如下指南,这样我们才能更好地理解你的合并请求: - -* 创建合并请求时,请遵守 [编码规范](#coding-rules) 和 [提交信息规范](#commit-messages-rules)。 -* 在标题中清晰准确地描述你的合并请求,不要加入 Issue 编号。 -* 按照 [模板](../../.github/PULL_REQUEST_TEMPLATE.md) 尽可能的详细填写相关信息。 -* 合并请求需要在所有主题样式中测试通过,并提供所表现功能的样例,如图像文件、在线演示网址等等。 - - - -### 发布版本 - -版本发布是将项目发布给用户的一种很好的方式。 - -1. 进入 GitHub 项目主页,点击 **Releases** 和 **Draft a new release**。 -2. 输入你需要发布的版本号。版本控制是基于 [Git tags](https://git-scm.com/book/en/Git-Basics-Tagging) 工作的,建议按照 [About Major and Minor NexT versions](https://github.com/theme-next/hexo-theme-next/issues/187) 确定版本号。 -3. 确定你需要发布的分支。除非发布测试版本,通常情况下选择 `master` 分支。 -4. 输入发布版本的标题和说明。 - - 标题为版本号。 - - 所有内容更改的类型包括了 **Breaking Changes**, **Updates**, **Features** 和 **Bug Fixes**。在描述 Breaking Changes 时,使用二级标题分别陈述,描述其他类型时,使用项目列表陈述。 - - 使用被动语态,省略主语。 - - 所有的变化都需要记录在版本说明中。对于没有使用 PR 的更改,需要添加相应的 commit 编号。如果使用了 PR 进行合并修改,则直接添加相应的 PR 编号即可。 -5. 如果您希望随版本一起发布二进制文件(如编译的程序),请在上传二进制文件对话框中手动拖放或选择文件。 -6. 如果版本不稳定,请选择 **This is a pre-release**,以通知用户它尚未完全准备好。如果您准备公布您的版本,请点击 **Publish release**。否则,请单击 **Save draft** 以稍后处理。 - - - -## 规范 - - - -### 行为规范 - -为了保证本项目的顺利运作,所有参与人都需要遵守 [行为规范](CODE_OF_CONDUCT.md)。 - - - -### 编码规范 - -未完待续。 - - - -### 标签规范 - -为了方便维护人员和用户能够快速找到他们想要查看的问题,我们使用“标签”功能对拉取请求和问题进行分类。 - -如果您不确定某个标签的含义,或者不知道将哪些标签应用于拉取请求或问题,千万别错过这个。 - -Issues 的标签:使用`类型`+`内容`+`结果`的组合 - -- 类型 - - `Irrelevant`: 与 NexT 主题无关的 Issue - - `Duplicate`: 已经存在同样 Issue - - `Bug`: 提出了 Bug,等待确认 - - `Improvement Need`: 需要进行改进的 Issue - - `Feature Request`: 提出了特性需求的 Issue - - `High Priority`: 检测到的高优先级错误或笔误 Issue - - `Low Priority`: 检测到的低优先级错误或笔误 Issue - - `Non English`: 需要多语言维护者注意 Issue - - `Discussion`: 需要讨论的 Issue - - `Question`: 有关咨询的 Issue - - `Backlog`: 待解决的 Issue - - `Meta`: 表明使用条款变更 Issue -- 内容 - - `Roadmap`: 与 NexT 主题发展相关的 Issue - - `Hexo`: 与 Hexo 相关的 Issue - - `Scheme [1] - Mist`: 与 Mist 样式相关的 Issue - - `Scheme [2] - Muse`: 与 Muse 样式相关的 Issue - - `Scheme [3] - Pisces`: 与 Pisces 样式相关的 Issue - - `Scheme [4] - Gemini`: 与 Gemini 样式相关的 Issue - - `3rd Party Service`: 与第三方服务相关的 Issue - - `Docs`: 需要添加文档说明的 Issue - - `Configurations`: 与 NexT 主题设置相关的 Issue - - `CSS`: 与 NexT 主题 CSS 文件相关的 Issue - - `Custom`: 与 NexT 主题个性化相关的 Issue -- 结果 - - `Wontfix`: 不能或不被修复的 Issue - - `Need More Info`: 需要更多信息的 Issue - - `Need Verify`: 需要开发人员或用户确认的 Issue - - `Can't Reproduce`: 不能被重现的 Issue - - `Verified`: 已经被确认的 Issue - - `Help Wanted`: 需要帮助的 Issue - - `Wait for Answer`: 需要开发人员或用户回复的 Issue - - `Resolved Maybe`: 可能已经解决的 Issue - - `Solved`: 已经解决的 Issue - - `Stale`: 由于长期无人回应被封存的 Issue - -Pull requests 的标签: - -- `Breaking Change`: 产生重大变动的 Pull request -- `Bug Fix`: 修复 Bug 的 Pull request -- `Docs`: 添加了文档说明的 Pull request -- `New Feature`: 添加了新特性的 Pull request -- `Feature`: 为已存在的特性添加了选项或功能的 Pull request -- `Improvement`: 改进了 NexT 主题的 Pull request -- `i18n`: 更新了翻译的 Pull request -- `Performance`: 提高了 NexT 主题性能的 Pull request -- `Discussion`: 需要进行讨论的 Pull request -- `v6.x`: 与 NexT v6.x 旧版相关的用于修复和改进的 Pull request -- `v7.x`: 与 NexT v7.x 旧版相关的用于修复和改进的 Pull request - - - -### 提交信息规范 - -我们对项目的 git 提交信息格式进行统一格式约定,每条提交信息由 `type`+`subject` 组成,这将提升项目日志的可读性。 - -- `type` 用于表述此次提交信息的意义,首写字母大写,包括但不局限于如下类型: - * `Build`:基础构建系统或依赖库的变化 - * `Ci`:CI 构建系统及其脚本变化 - * `Docs`:文档内容变化 - * `Feat`:新功能 - * `Fix`:Bug 修复 - * `Perf`:性能优化 - * `Refactor`:重构(即不是新增功能,也不是修改 Bug 的代码变动) - * `Style`:格式(不影响代码运行的变动) - * `Revert`:代码回滚 - * `Release`:版本发布 -- `subject` 用于简要描述修改变更的内容,如 `Update code highlighting in readme.md`。 - * 句尾不要使用符号。 - * 使用现在时、祈使句语气。 diff --git a/doc/themes/next/docs/zh-CN/DATA-FILES.md b/doc/themes/next/docs/zh-CN/DATA-FILES.md deleted file mode 100644 index 624931bb6..000000000 --- a/doc/themes/next/docs/zh-CN/DATA-FILES.md +++ /dev/null @@ -1,61 +0,0 @@ -

数据文件

- -目前,通过 pull 或下载新的 release 版本来更新 NexT 主题的体验并不平滑。当用户使用 `git pull` 更新 NexT 主题时经常需要解决冲突问题,而在手动下载 release 版本时也经常需要手动合并配置。 - -现在来说,NexT 推荐用户存储部分配置在站点的 `_config.yml` 中,而另一部分在主题的 `_config.yml` 中。这一方式固然可用,但也有一些缺点: -1. 配置项被分裂为两部分; -2. 用户难以弄清何处存放配置选项。 - -为了解决这一问题,NexT 将利用 Hexo 的[数据文件](https://hexo.io/docs/data-files.html)特性。因为数据文件是在 Hexo 3 中被引入,所以你需要更新至 Hexo 3.0 以后的版本来使用这一特性。 - -如果你仍然希望使用 Hexo 2.x,你依旧可以按老的方式进行配置。NexT 仍然兼容 Hexo 2.x(但可能会出现错误)。 - -

选择 1:Hexo 方式

- -使用这一方式,你的全部配置都将置于 hexo 主要配置文件中(`hexo/_config.yml`),并且不需要修改 `next/_config.yml`,或者创建什么其他的文件。但是所有的主题选项必须放置在 `theme_config` 后,并全部增加两个空格的缩进。 - -如果在新的 release 中出现了任何新的选项,那么你只需要从 `next/_config.yml` 中将他们复制到 `hexo/_config.yml` 中并设置它们的值为你想要的选项。 - -### 用法 - -1. 请确认不存在 `hexo/source/_data/next.yml` 文件(如果已存在,请删除) -2. 从主题的 `next/_config.yml` 文件中复制你需要的 NexT 配置项到 `hexo/_config.yml` 中,然后\ - 2.1. 所有这些配置项右移两个空格(在 Visual Studio Code 中:选中这些文字,CTRL + ])。\ - 2.2. 在这些参数最上方添加一行 `theme_config:`。 - -### 相关链接 - -* [Hexo 配置](https://hexo.io/zh-cn/docs/configuration.html) -* [Hexo Pull #757](https://github.com/hexojs/hexo/pull/757) - -

选择 2: NexT 方式

- -使用这一方式,你现在可以将你的全部配置置于同一位置(`source/_data/next.yml`),并且不需要修改 `next/_config.yml`。 -但是可能无法让所有 Hexo 外部库都准确处理它们的附加选项(举个例子,`hexo-server` 模块只会从 Hexo 默认配置文件中读取选项)。 - -如果在新的 release 中出现了任何新的选项,那么你只需要从 `next/_config.yml` 中将他们复制到 `source/_data/next.yml` 中并设置它们的值为你想要的选项。 - -### 用法 - -1. 请确认你的 Hexo 版本为 3.0 或更高。 -2. 在你站点的 `hexo/source/_data` 目录创建一个 `next.yml` 文件(如果 `_data` 目录不存在,请创建之)。 - -

以上步骤之后有 两种选择,请任选其一然后继续后面的步骤

- -* **选择 1:`override: false`(默认)**: - - 1. 检查默认 NexT 配置中的 `override` 选项,必须设置为 `false`。\ - 在 `next.yml` 文件中,也要设置为 `false`,或者不定义此选项。 - 2. 从站点的 `_config.yml` 与主题的 `_config.yml` 中复制你需要的选项到 `hexo/source/_data/next.yml` 中。 - -* **选择 2:`override: true`**: - - 1. 在 `next.yml` 中设置 `override` 选项为 `true`。 - 2. 从 `next/_config.yml` 配置文件中复制**所有**的 NexT 主题选项到 `hexo/source/_data/next.yml` 中。 - -3. 然后,在站点的 `hexo/_config.yml`中需要定义 `theme: next` 选项(如果需要的话,`source_dir: source`)。 -4. 使用标准参数来启动服务器,生成或部署(`hexo clean && hexo g -d && hexo s`)。 - -### 相关链接 - -* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328) diff --git a/doc/themes/next/docs/zh-CN/INSTALLATION.md b/doc/themes/next/docs/zh-CN/INSTALLATION.md deleted file mode 100644 index 7ea4b8808..000000000 --- a/doc/themes/next/docs/zh-CN/INSTALLATION.md +++ /dev/null @@ -1,120 +0,0 @@ -

安装

- -

步骤 1 → 进入 Hexo 目录

- -进入 **hexo 根**目录。这一目录中应当有 `node_modules`、`source`、`themes` 等若干子目录: - ```sh - $ cd hexo - $ ls - _config.yml node_modules package.json public scaffolds source themes - ``` - -

步骤 2 → 获取 NexT

- -

从 GitHub 下载主题。
-为了下载这一主题,共有 3 种选项可选。你需要选择其中唯一一个方式

- -### 选项 1:下载[最新 release 版本][releases-latest-url] - - 通常情况下请选择 **stable** 版本。推荐不熟悉的用户按此方式进行。 - - * 使用 [curl、tar 和 wget][curl-tar-wget-url] 安装: - - ```sh - $ mkdir themes/next - $ 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 - ``` - 这种方式将**仅提供最新的 release 版本**(其中不附带 `.git` 目录)。\ - 因此,将来你将不可能通过 `git` 更新这一方式安装的主题。\ - 取而代之的,为了能不丢失你的自定义配置,你可以使用独立的配置文件(例如 [数据文件][docs-data-files-url])并下载最新版本到旧版本的目录中(或者下载到新的主题目录中并修改 Hexo 配置中的主题名)。 - -### 选项 2:下载 [tag 指向的 release 版本][releases-url] - - 在少数情况下将有所帮助,但这并非推荐方式。\ - 你必须指定一个版本:使用 [tags 列表][tags-url]中的任意 tag 替换 `v6.0.0`。 - - * 方式 1:使用 [curl 和 tar][curl-tar-url] 安装: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1 - ``` - 和上述的 `curl、tar 和 wget` 方法相同,但只会下载**指定的 release 版本**。 - - * 方式 2:使用 [git][git-url] 安装: - - ```sh - $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next - ``` - 这一方式将为你下载**指定的 release 版本**(其中包含 `.git` 目录)。\ - 并且,你可以随时切换到任何已定义的版本号所对应的 tag 的版本。 - -### 选项 3:下载[最新 master 分支][download-latest-url] - - 可能**不稳定**,但包含最新的特性。推荐进阶用户和开发者按此方式进行。 - - * 方式 1:使用 [curl 和 tar][curl-tar-url] 安装: - - ```sh - $ mkdir themes/next - $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1 - ``` - 和上述的 `curl、tar 和 wget` 方法相同,但只会下载**最新 master 分支版本**。\ - 在有些情况对开发者有所帮助。 - - * 方式 2:使用 [git][git-url] 安装: - - ```sh - $ git clone https://github.com/theme-next/hexo-theme-next themes/next - ``` - - 这一方式将为你下载**完整仓库**(其中包含 `.git` 目录)。\ - 你可以随时[使用 git 更新至最新版本][update-with-git-url]并切换至任何有 tag 标记的 release 版本、最新的 master 分支版本、甚至其他分支。\ - 在绝大多数情况下对用户和开发者友好。 - - 获取 tags 列表: - - ```sh - $ cd themes/next - $ git tag -l - … - v6.0.0 - v6.0.1 - v6.0.2 - ``` - - 例如,假设你想要切换到 `v6.0.1` 这一 [tag 指向的 release 版本][tags-url]。输入如下指令: - - ```sh - $ git checkout tags/v6.0.1 - Note: checking out 'tags/v6.0.1'. - … - HEAD is now at da9cdd2... Release v6.0.1 - ``` - - 然后,假设你想要切换回 [master 分支][commits-url],输入如下指令即可: - - ```sh - $ git checkout master - ``` - -

步骤 3 → 完成配置

- -在 **hexo 根配置**文件 `_config.yml` 中设置你的主题: - -```yml -theme: next -``` - -[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip -[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest -[releases-url]: https://github.com/theme-next/hexo-theme-next/releases -[tags-url]: https://github.com/theme-next/hexo-theme-next/tags -[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master - -[git-url]: http://lmgtfy.com/?q=linux+git+install -[curl-tar-url]: http://lmgtfy.com/?q=linux+curl+tar+install -[curl-tar-wget-url]: http://lmgtfy.com/?q=linux+curl+tar+wget+install - -[update-with-git-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/README.md#update -[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/DATA-FILES.md diff --git a/doc/themes/next/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md b/doc/themes/next/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md deleted file mode 100644 index 39fee3462..000000000 --- a/doc/themes/next/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md +++ /dev/null @@ -1,186 +0,0 @@ -在配置前,请升级NexT至**v6.0.6**以上。 - -在配置过程中请注意**博客配置文件**和**主题配置文件**的区别。 - ---- - -# 注册Leancloud并创建应用 -- 首先,前往Leancloud官网[leancloud.cn](leancloud.cn)进行注册,并登陆。 -- 然后点击图示`1`处,进入控制台: - - ![1](https://lc-cqha0xyi.cn-n1.lcfile.com/fc0c048a1e25dc3d10aa.jpg) - -- 接着,点击图示`1`处,创建应用: - - ![2](https://lc-cqha0xyi.cn-n1.lcfile.com/33a56b754753a5d34b01.jpg) - -- 在弹出窗口`1`处输入应用名称(可随意输入,可更改,为演示方便取名为test),并选择`2`处“开发版”,然后点击`3`处创建: - - ![3](https://lc-cqha0xyi.cn-n1.lcfile.com/649ccfc6f12015d1eefb.jpg) - -到这里应用创建完成。 - -# 建立Counter类并在NexT中启用插件 -- 点击`1`处应用名称进入应用管理界面: - - ![4](https://lc-cqha0xyi.cn-n1.lcfile.com/d0889df29841661e0b9e.jpg) - -- 如图,点击侧边栏`1`处创建Class: - - ![5](https://lc-cqha0xyi.cn-n1.lcfile.com/b0fbc81bd6c19fa09a46.jpg) - -- 在弹出窗口`1`处填入`Counter`,勾选`2`处无限制,并点击`3`处创建Class: - - ![6](https://lc-cqha0xyi.cn-n1.lcfile.com/ae6154d6a55f02f11ebf.jpg) - -- 此时类已创建完成。接下来点击图示`1`处进入设置,然后点击`2`处进入应用Key: - - ![8](https://lc-cqha0xyi.cn-n1.lcfile.com/9501a6372918dd9a8a92.jpg) - -- 粘贴`App ID`和`App Key`到**NexT主题配置文件**`_config.yml`对应位置。此时配置文件应如下: -```yml -leancloud_visitors: - enable: true - security: true - app_id: <> - app_key: <> -``` - -- 设置Web安全域名确保域名调用安全。点击`1`处进入安全中心,然后在`2`处填写自己博客对应的域名(**注意协议、域名和端口号需严格一致**): - - ![9](https://lc-cqha0xyi.cn-n1.lcfile.com/0e537cc4bec2e185201d.jpg) - -到这里内容均与Doublemine的[为NexT主题添加文章阅读量统计功能](https://notes.wanghao.work/2015-10-21-%E4%B8%BANexT%E4%B8%BB%E9%A2%98%E6%B7%BB%E5%8A%A0%E6%96%87%E7%AB%A0%E9%98%85%E8%AF%BB%E9%87%8F%E7%BB%9F%E8%AE%A1%E5%8A%9F%E8%83%BD.html#%E9%85%8D%E7%BD%AELeanCloud)这篇文章相同,只不过截图为新版的Leancloud的界面。 - -# 部署云引擎以保证访客数量不被随意篡改 -- 点击左侧`1`处云引擎,然后点击`2`处部署,再点击`3`处在线编辑: - - ![10](https://lc-cqha0xyi.cn-n1.lcfile.com/d7056dfeeef7c5d66318.jpg) - -- 点击`1`处创建函数: - - ![11](https://lc-cqha0xyi.cn-n1.lcfile.com/2737841bbc2bdd572ae0.jpg) - -- 在弹出窗口选择`1`处`Hook`类型,然后`2`处选择`beforeUpdate`,`3`处选择刚才建立的`Counter`类。在`4`中粘贴下方代码后,点`5`处保存。 - ```javascript - var query = new AV.Query("Counter"); - if (request.object.updatedKeys.indexOf('time') !== -1) { - return query.get(request.object.id).then(function (obj) { - if (obj.get("time") > request.object.get("time")) { - throw new AV.Cloud.Error('Invalid update!'); - } - return request.object.save(); - }); - } - ``` - - 如图所示: - - ![12](https://lc-cqha0xyi.cn-n1.lcfile.com/a8e13418ed1d9405315b.jpg) - -- 点击保存后应出现类似红框处函数。此时点击`1`处部署: - - ![13](https://lc-cqha0xyi.cn-n1.lcfile.com/ca56bf2e5fc2a1343565.jpg) - -- 在弹出窗口点击`1`处部署: - - ![14](https://lc-cqha0xyi.cn-n1.lcfile.com/17548c13b3b23c71d845.jpg) - -- 等待出现红框处的成功部署信息后,点击`1`处关闭: - - ![15](https://lc-cqha0xyi.cn-n1.lcfile.com/d2f50de6cefea9fd0ed3.jpg) - - -至此云引擎已成功部署,任何非法的访客数量更改请求都将失败。 - -# 进一步设置权限 -- 打开**NexT主题配置文件**`_config.yml`,将leancloud_visitors下的security设置为true(如没有则新增): - ```yml - leancloud_visitors: - enable: true - app_id: <> - app_key: <> - # Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security - security: true - betterPerformance: false - ``` - - **对`betterPerformance`选项的说明:** - 由于Leancloud免费版的云引擎存在请求线程数和运行时间限制以及休眠机制,很多时候访客数量加载会很慢。如果设置`betterPerformance`为`true`,则网页则会在提交请求之前直接显示访客人数为查询到的人数+1,以增加用户体验。 - -- 打开cmd并切换至**博客根目录**,键入以下命令以安装`hexo-leancloud-counter-security`插件: - ``` - npm install hexo-leancloud-counter-security --save - ``` - -- 打开**博客配置文件**`_config.yml`,新增以下配置: - ```yml - leancloud_counter_security: - enable_sync: true - app_id: <> - app_key: < - username: - password: - ``` - -- 在相同目录键入以下命令: - ``` - hexo lc-counter register <> <> - ``` - 或 - ``` - hexo lc-counter r <> <> - ``` - - 将`<>`和`<>`替换为你自己的用户名和密码(不必与leancloud的账号相同)。此用户名和密码将在hexo部署时使用。 - - - 打开**博客配置文件**`_config.yml`,将`<>`和`<>`替换为你刚刚设置的用户名和密码: - ```yml - leancloud_counter_security: - enable_sync: true - app_id: <> - app_key: < - username: <> #如留空则将在部署时询问 - password: <> #建议留空以保证安全性,如留空则将在部署时询问 - ``` - -- 在**博客配置文件**`_config.yml`的`deploy`下添加项: - ```yml - deploy: - # other deployer - - type: leancloud_counter_security_sync - ``` - -- 返回Leancloud控制台的应用内。依次点击`1` `2`,检查_User表中是否出现一条记录(图示以用户名为admin为例): - - ![16](https://lc-cqha0xyi.cn-n1.lcfile.com/99faa5a0e7160e66d506.jpg) - -- 点击`1`处进入Counter表,依次点击`2` `3`,打开权限设置: - - ![17](https://lc-cqha0xyi.cn-n1.lcfile.com/b72a9e64579f5b71749d.jpg) - -- 点击`1`add_fields后选择`2`指定用户, 并将下两栏留空:此处应与下条create设置相同(选择你所创建的用户): - - ![18](https://lc-cqha0xyi.cn-n1.lcfile.com/14a8cb37062693d768ad.jpg) - -- 点击`1`create后选择`2`指定用户, 在`3`处键入用户名,点击`4`处后点击`5`处添加: - - ![19](https://lc-cqha0xyi.cn-n1.lcfile.com/d91714cfd703ef42b94c.jpg) - - 完成此步操作后,界面应与图示类似: - - ![20](https://lc-cqha0xyi.cn-n1.lcfile.com/c05e7ec9218820baf412.jpg) - -- 点击`1`delete后选择`2`指定用户, 并将下两栏留空: - - ![21](https://lc-cqha0xyi.cn-n1.lcfile.com/c37b6e20726cfb1d3197.jpg) - -至此权限已设置完成,数据库记录只能在本地增删。 - -每次运行`hexo d`部署的时候,插件都会扫描本地`source/_posts`下的文章并与数据库对比,然后在数据库创建没有录入数据库的文章记录。 - -如果在**博客配置文件**中留空username或password,则在部署过程中程序会要求输入。 - ---- - -原文链接:https://leaferx.online/2018/02/11/lc-security/ diff --git a/doc/themes/next/docs/zh-CN/MATH.md b/doc/themes/next/docs/zh-CN/MATH.md deleted file mode 100644 index 760053a57..000000000 --- a/doc/themes/next/docs/zh-CN/MATH.md +++ /dev/null @@ -1,291 +0,0 @@ -

数学公式

- -NexT 内部提供数学公式渲染的引擎,这样你就不需要自己手动在模板中引入 JS 或者 CSS; -只需要将 `next/_config.yml` 中 `math` 的 `enable` 选项改为 `true`,并选择对应的渲染引擎即可: - - -```yml -math: - enable: true - ... - engine: mathjax -``` - - -需要注意的是,仅仅将 `math` 的 `enable` 打开**并不能让你看到数学公式**,你还需要**使用对应的 Hexo 渲染器(Renderer)** 才能真正在博客页面中显示出数学公式。引擎对应使用的 Hexo 渲染器会在引擎相关的部分介绍。 - -

提供的渲染引擎

- -目前,NexT 提供两种数学公式渲染引擎,分别为 [MathJax](https://www.mathjax.org/) 和 [Katex](https://khan.github.io/KaTeX/),默认为 MathJax。 - -### MathJax(默认) - -如果你选择使用 MathJax 进行数学公式渲染,你需要使用 [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) 或者 [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) 这两个渲染器的其中一个。 - -首先,卸载原有的渲染器 `hexo-renderer-marked`,并安装这两种渲染器的**其中一个**: - -```sh -npm un hexo-renderer-marked --save -npm i hexo-renderer-pandoc --save # 或者 hexo-renderer-kramed -``` - - -然后在 `next/_config.yml` 中将 `math` 的 `enable` 打开,并选择 `mathjax` 作为渲染引擎。 - -```yml -math: - enable: true - ... - engine: mathjax - #engine: katex -``` - -执行 Hexo 生成,部署,或者启动服务器: - -```sh -hexo clean && hexo g -d -# 或者 hexo clean && hexo s -``` - -#### 使用 MathJax 给公式编号并引用公式 - -在新版本的 NexT 主题中,我们加入了公式自动编号和引用功能。下面简要介绍一下如何使用这项功能。 - -为了使用这项功能,一般来说,你必须把所使用的 LaTeX 公式放在 `equation` 环境里面,采用旧的方法(也就是说,仅仅把公式的每一边用两个 $ 符号包含起来)是无效的。如何引用公式?你只需要在书写公式的时候给公式一个 `\ -label{}` 标记(tag),然后在正文中,可以使用 `\ref{}` 或者 `\eqref{}` 命令来引用对应的公式。使用 `\eqref{}` 是推荐的方式,因为如果你使用 `\ref{}`,公式在文中的引用编号将没有圆括号包围。下面介绍几种常见的公式编号例子。 - -对于简单的公式,使用下面的方式给公式一个标记, - -```latex -$$\begin{equation} -e=mc^2 -\end{equation}\label{eq1}$$ -``` - -然后,在正文中,你可以轻松引用上述公式,一个简单的例子如下: - -``` -著名的质能方程 $\eqref{eq1}$ 由爱因斯坦提出 ... -``` - -对于多行公式,在 `equation` 环境中,你可以使用 `aligned` 环境把公式分成多行, - -```latex -$$\begin{equation} -\begin{aligned} -a &= b + c \\ - &= d + e + f + g \\ - &= h + i -\end{aligned} -\end{equation}\label{eq2}$$ -``` - -要对齐多个公式,我们需要使用 `align` 环境。align 环境中的每个公式都有自己的编号: - -``` -$$\begin{align} -a &= b + c \label{eq3} \\ -x &= yz \label{eq4}\\ -l &= m - n \label{eq5} -\end{align}$$ -``` - -在 `align` 环境中,如果你不想给某个或某几个公式编号,那么在这些公式后面使用 [`\nonumber`](https://tex.stackexchange.com/questions/17528/show-equation-number-only-once-in-align-environment) 命令即可。例如: - -```latex -$$\begin{align} --4 + 5x &= 2+y \nonumber \\ - w+2 &= -1+w \\ - ab &= cb -\end{align}$$ -``` - -有时,你可能会希望采用更加奇特的方式来标记和引用你的公式,你可以通过使用 `\tag{}` 命令来实现,例如: - -```latex -$$x+1\over\sqrt{1-x^2} \tag{i}\label{eq_tag}$$ -``` - -如果你想要了解更多信息,请访问 [MathJax 关于公式编号的官方文档](http://docs.mathjax.org/en/latest/tex.html#automatic-equation-numbering)。同时,你也可以访问[这篇博客](https://jdhao.github.io/2018/01/25/hexo-mathjax-equation-number/) 来获取更多细节信息。 - -### Katex - -Katex 渲染引擎相对于 MathJax 来说**大大提高了速度**,而且在关掉 JavaScript 时也能渲染数学公式。 - -但是 Katex 所支持的东西没有 MathJax 全面,你可以从下面的相关链接中获取更多的信息。 - -如果你选择使用 Katex 进行数学公式渲染,你需要使用 [hexo-renderer-markdown-it-plus](https://github.com/CHENXCHEN/hexo-renderer-markdown-it-plus) 或者 [hexo-renderer-markdown-it](https://github.com/hexojs/hexo-renderer-markdown-it) 这两种渲染器的其中一个。 - -首先,卸载原有的渲染器 `hexo-renderer-marked`,并安装这两种渲染器的**其中一个**: - -```sh -npm un hexo-renderer-marked --save -npm i hexo-renderer-markdown-it-plus --save -# 或者 hexo-renderer-markdown-it -``` - - -然后在 `next/_config.yml` 中将 `math` 的 `enable` 打开,并选择 `katex` 作为渲染引擎。 - -```yml -math: - enable: true - ... - #engine: mathjax - engine: katex -``` - -执行 Hexo 生成,部署,或者启动服务器: - -```sh -hexo clean && hexo g -d -# 或者 hexo clean && hexo s -``` - -#### 如果你使用 hexo-renderer-markdown-it - -如果你使用 `hexo-renderer-markdown-it`,你还需要为其加上 `markdown-it-katex` 作为插件: - -``` -npm i markdown-it-katex --save -``` - -然后在 `hexo/_config.yml` 中将 `markdown-it-katex` 作为插件写入 `hexo-renderer-markdown-it` 的配置中: - -```yml -markdown: - render: - html: true - xhtmlOut: false - breaks: true - linkify: true - typographer: true - quotes: '“”‘’' - plugins: - - markdown-it-katex -``` - -#### 已知的问题 - -1. 首先请查阅 Katex 的 [Common Issue](https://github.com/Khan/KaTeX#common-issues) -2. 块级公式(例如 `$$...$$`)必须位于空行。\ - 即在开头的 `$$` 前和在结尾的 `$$` 后不能有除了空白字符以外的其他字符。([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)) -3. 不支持 Unicode。([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)) -4. 行内公式(例如 `$...$`)在开头的 `$` 后面和结尾的 `$` 前面**不能含有空格**。([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-357489509)) -5. 如果你在文章的各级标题中(例如 `## 标题`)使用公式。\ - 那么文章目录中的这个标题会出现 3 次未渲染的公式代码([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359018694)) -6. 如果你在文章 Title 中使用公式,那么公式将不会被渲染。([#32comment](https://github.com/theme-next/hexo-theme-next/pull/32#issuecomment-359142879)) - - -我们目前使用的 Katex 版本为 0.7.1,这里面可能有某些问题是因为 Katex 版本老旧导致的; - -但是,就像上面所说的,数学公式的渲染必须依靠渲染器来支持,目前的 Katex 相关的渲染器仅支持到 Katex 0.7.1; - -我们会持续关注相关渲染器的更新,如果有渲染器支持更高版本的 Katex,我们会及时更新我们的 Katex 版本。 - -### 相关链接 - -* [Katex 与 MathJax 渲染速度对比](https://www.intmath.com/cg5/katex-mathjax-comparison.php) -* [Katex 支持的功能列表](https://khan.github.io/KaTeX/function-support.html) - -

相关配置说明

- -注意,在修改配置选项时,**不要更改配置的缩进**; - -目前,NexT 的所有配置都采用**2 空格的缩进**; - -如果配置的内容接在冒号后面,那么内容和冒号之间必须有一个空格(例如`enable: true`) - -```yml - -# Math Equations Render Support -math: - enable: false - - # Default(true) will load mathjax/katex script on demand - # That is it only render those page who has 'mathjax: true' in Front Matter. - # If you set it to false, it will load mathjax/katex srcipt EVERY PAGE. - per_page: true - - engine: mathjax - #engine: katex - - # hexo-rendering-pandoc (or hexo-renderer-kramed) needed to full MathJax support. - mathjax: - # Use 2.7.1 as default, jsdelivr as default CDN, works everywhere even in China - cdn: //cdn.jsdelivr.net/npm/mathjax@2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML - # For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com). - #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML - - # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) - # needed to full Katex support. - katex: - # Use 0.7.1 as default, jsdelivr as default CDN, works everywhere even in China - cdn: //cdn.jsdelivr.net/npm/katex@0.7.1/dist/katex.min.css - # CDNJS, provided by cloudflare, maybe the best CDN, but not works in China - #cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css -``` - -### enable - -`true` 或者 `false`,默认为 `false`。 - -`true` 是打开数学公式渲染,`false` 则是关闭。 - -### per_page - -`true` 或者 `false`,默认为 `true`。 - -这个选项是控制是否在每篇文章都渲染数学公式; - -默认(`true`) 的行为是**只对 Front Matter 中含有 `mathjax: true` 的文章进行数学公式渲染**。 - -如果 Front Matter 中不含有 `mathjax: true`,或者 `mathjax: false`,那么 NexT 将不会对这些文章进行数学公式渲染。 - -例如: - -```md - ---- -title: 'Will Render Math' -mathjax: true ---- -.... -``` - -```md - ---- -title: 'Not Render Math' -mathjax: false ---- -.... -``` - -```md - ---- -title: 'Not Render Math Either' ---- -.... -``` - -当你将它设置为 `false` 时,它就会在每个页面都加载 MathJax 或者 Katex 来进行数学公式渲染。 - -### cdn - -MathJax 和 Katex 都提供了 `cdn` 的配置,如果你不知道什么是 `cdn` ,**请不要修改这个配置**。 - -首先,MathJax 和 Katex 都使用了 [jsDelivr](https://www.jsdelivr.com/) 作为默认 CDN; - -之所以选择 jsDelivr 是因为它在全球各地都有比较不错的速度,而且具有中国官方颁布的 ICP 证书,在中国也能比较好地访问。 - -同时,我们也提供了其他的 CDN 备选方案,包括著名的 [CDNJS](https://cdnjs.com/)。 - -对于 MathJax 来说,我们目前采用的版本为 2.7.1。 - -对于 Katex,由于上面提到的版本问题,我们目前采用的版本为 0.7.1。 - -如果你想尝试我们提供的备选方案以外的 CDN,请注意使用对应的版本。 - -特别的,对于中国的博客主,或者您的博客访问大部分来源于中国,由于 CDNJS 在部分中国地区被墙,请不要使用 CDNJS 作为 CDN。 diff --git a/doc/themes/next/docs/zh-CN/README.md b/doc/themes/next/docs/zh-CN/README.md deleted file mode 100644 index d25f43e27..000000000 --- a/doc/themes/next/docs/zh-CN/README.md +++ /dev/null @@ -1,156 +0,0 @@ -
语言: :us: -:cn: -:ru:
- -#
e x T
- -

«NexT» 是一款风格优雅的高质量 Hexo 主题,自点点滴滴中用爱雕琢而成。

- -

- - - - - - - -

- -## 即时预览 - -* :heart_decoration: Muse 主题: [LEAFERx](https://leaferx.online) | [Alex LEE](http://saili.science) | [Miaia](https://11.tt) -* :six_pointed_star: Mist 主题: [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com) -* :pisces: Pisces 主题: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Jiaxi He](http://jiaxi.io) -* :gemini: Gemini 主题: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me) - -更多 «NexT» 的例子参见[这里](https://github.com/iissnan/hexo-theme-next/issues/119)。 - -## 安装 - -最简单的安装方式是直接克隆整个仓库: - - ```sh - $ cd hexo - $ git clone https://github.com/theme-next/hexo-theme-next themes/next - ``` - -此外,如果你想要使用其他方式,你也可以参见[详细安装步骤][docs-installation-url]。 - -## 插件 - -在 NexT 配置中你现在可以找到已经被移至外部仓库的依赖项。你可以在[组织主页](https://github.com/theme-next)中找到它们。 - -例如,假设你想要在你的站点中使用 `fancybox` 插件,请进入 NexT 配置文件,你会看到如下内容: - -```yml -# Fancybox -# Dependencies: https://github.com/theme-next/theme-next-fancybox -fancybox: false -``` - -将 `fancybox` 配置项打开,进入它上面的 «Dependencies» 链接以查看它的安装步骤。 - -### 例外 - -如果你使用的插件脚本依赖 CDN,那么需要替换你的 CDN 链接: - -例如,假如你使用了 `fancybox` 插件并且配置了 CDN 加载链接,进入 Next 配置文件,你会看到如下内容: - -```yml -vendors: - # ... - # Some contents... - # ... - fancybox: # Set or update fancybox cdn url. - fancybox_css: # Set or update fancybox cdn url. -``` - -通过替换 CDN 链接来替换 [插件列表](https://github.com/theme-next) 项目来升级。 - -## 更新 - -你可以通过如下命令更新到最新的 master 分支: - -```sh -$ cd themes/next -$ git pull -``` - -如果你在此过程中收到了任何错误报告 (例如 **«Commit your changes or stash them before you can merge»**),我们推荐你使用 [Hexo 数据文件][docs-data-files-url]特性。\ -然而你也可以通过提交(`Commit`)、贮藏(`Stash`)或忽视(`Discard`)本地更改以绕过这种更新错误。具体方法请参考[这里](https://stackoverflow.com/a/15745424/5861495)。 - -**如果你想要从 v5.1.x 更新到 v6.0.x,阅读[这篇文档][docs-update-5-1-x-url]。** - -## 已知问题 - -对于仍然遇到 **«[Error: Cannot find module 'hexo-util'](https://github.com/iissnan/hexo-theme-next/issues/1490)»** 这一错误的用户,请检查你的 NPM 版本。 - -* `> 3`:仍然出现错误吗?请删除 `node_modules` 目录并通过 `npm install` 重新安装。 -* `< 3`:请通过 `npm install --save-dev hexo-util` 将 `hexo-util` 依赖手动添加至你的站点依赖包中。 - -## 贡献你的代码 - -我们欢迎你贡献出你的一份力量,你可以随时提交 issue 或 fork 本仓库。静候你的 pull request。 - -## 反馈 - -* 在 [Stack Overflow][stack-url] 上提问。 -* 在 [GitHub Issues][issues-bug-url] 报告Bug。 -* 在 [GitHub][issues-feat-url] 请求新的功能。 -* 为 [popular feature requests][feat-req-vote-url] 投票。 -* 加入我们的 [Gitter][gitter-url] / [Riot][riot-url] / [Telegram][t-chat-url] 聊天。 -* 关注我们的 [Telegram Channel][t-news-url] 以获取最新消息。 - -## 第三方应用程序 - -* :triangular_flag_on_post: HexoEditor - -## 鸣谢 - -

-«NexT» 特别感谢这些支持我们核心基础设施的优质服务: -

- -

-

- GitHub 容许我们托管 Git 仓库,Netlify 容许我们分发文档。 -

- -

-

- Crowdin 容许我们方便地翻译文档。 -

- -

-

- Codacy 容许我们运行测试套件,BrowserStack 容许我们在真实的浏览器中进行测试。 -

- -[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg -[browser-url]: https://www.browserstack.com - -[stack-url]: https://stackoverflow.com/questions/tagged/theme-next -[issues-bug-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md -[issues-feat-url]: https://github.com/theme-next/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md -[feat-req-vote-url]: https://github.com/theme-next/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22+sort%3Areactions-%2B1-desc - -[gitter-url]: https://gitter.im/theme-next -[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org -[t-chat-url]: https://t.me/theme_next -[t-news-url]: https://t.me/theme_next_news - - - - - -[download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip -[releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest - -[tags-url]: https://github.com/theme-next/hexo-theme-next/tags -[commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master - -[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md -[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/DATA-FILES.md -[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/UPDATE-FROM-5.1.X.md diff --git a/doc/themes/next/docs/zh-CN/UPDATE-FROM-5.1.X.md b/doc/themes/next/docs/zh-CN/UPDATE-FROM-5.1.X.md deleted file mode 100644 index ab097eac1..000000000 --- a/doc/themes/next/docs/zh-CN/UPDATE-FROM-5.1.X.md +++ /dev/null @@ -1,35 +0,0 @@ -

从 NexT v5.1.x 更新

- -在 5.1.x 版本和 6.0.x 版本之间没有很大的革命性改进。主版本号变更至 6 主要是因为: - -1. 主仓库已从 [iissnan 名下](https://github.com/iissnan/hexo-theme-next) 迁移至 [theme-next](https://github.com/theme-next) 组织。 -2. `next/source/lib` 目录下的绝大多数库被移出到了 [NexT 组织的外部仓库](https://github.com/theme-next)中。 -3. 第三方插件 [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) 被 [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) 所取代,因为 `hexo-symbols-count-time` 没有任何外部 nodejs 依赖、也没有会导致生成站点时的性能问题 [language filter](https://github.com/willin/hexo-wordcount/issues/7)。 - -推荐通过如下步骤从 v5 升级到 v6: - -1. 并不修改原有的 `next` 目录,而只是复制部分 NexT 文件: - 1. `config.yml` 或 `next.yml`(如果你使用了[数据文件](DATA-FILES.md))。 - 2. 自定义的 CSS 配置,它们应在 `next/source/css/_custom/*` 和 `next/source/css/_variables/*` 中。 - 3. 自定义的排布配置,它们应在 `next/layout/_custom/*` 中。 - 4. 任何其它可能的附加自定义内容;为了定位它们,你可以通过某些工具在仓库间比较。 -2. 克隆新的 v6.x 仓库到任一异于 `next` 的目录(如 `next-reloaded`): - ```sh - $ git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded - ``` - 如此,你可以在不修改原有的 NexT v5.1.x 目录的同时使用 `next-reloaded` 目录中的新版本主题。 -3. 在 Hexo 的主配置文件中设置主题: - ```yml - ... - theme: next-reloaded - ... - ``` - 如此,你的 `next-reloaded` 主题将在生成站点时被加载。如果你遇到了任何错误、或只是不喜欢这一新版本,你可以随时切换回旧的 v5.1.x 版本。 - -4. 更新语言配置 - - 从 v6.0.3版本起,`zh-Hans`改名为`zh-CN`:https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3 - - 升级到v6.0.3及以后版本的用户,需要显式修改`_config.xml`里的language配置,否则语言显示不正确。 - -关于第三方库的启用,参见[这里](https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md#插件)。 From 4ef70ba91d5f4b5569b3ecd83c67461158b514df Mon Sep 17 00:00:00 2001 From: NaBian <836904362@qq.com> Date: Sat, 3 Oct 2020 10:10:12 +0800 Subject: [PATCH 2/3] fixed #484 --- .../Themes/Styles/MessageBox.xaml | 29 ++- .../Controls/Window/MessageBox.cs | 211 ++++++++++++++++-- .../Themes/Styles/MessageBox.xaml | 29 ++- .../Tools/Interop/InteropMethods.cs | 3 + .../Tools/Interop/InteropValues.cs | 3 + 5 files changed, 237 insertions(+), 38 deletions(-) diff --git a/src/Net_40/HandyControl_Net_40/Themes/Styles/MessageBox.xaml b/src/Net_40/HandyControl_Net_40/Themes/Styles/MessageBox.xaml index 6b39d81d6..c2d390336 100644 --- a/src/Net_40/HandyControl_Net_40/Themes/Styles/MessageBox.xaml +++ b/src/Net_40/HandyControl_Net_40/Themes/Styles/MessageBox.xaml @@ -1,16 +1,26 @@  + + + + + + +