e x T e x TCopyright © 2017 «NexT».
Detail attribution information for «NexT»
is contained in the 'docs/AUTHORS.md' file.
This license also available in text format.
[AUTHORS]: docs/AUTHORS.md [AGPL3]: docs/AGPL3.md [AGPL3-7]: docs/AGPL3.md/#7-additional-terms [AGPL3-15]: docs/AGPL3.md/#15-disclaimer-of-warranty ================================================ FILE: README.md ================================================ # e x T
«NexT» is a high quality elegant Hexo theme. It is crafted from scratch with love.
💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
More «NexT» examples here.
«NexT» send special thanks to these great services that sponsor our core infrastructure:
GitHub allows us to host the Git repository, Netlify allows us to distribute the documentation.
Crowdin allows us to translate conveniently the documentation.
Codacy allows us to monitor code quality, Travis CI allows us to run the test suite.
and code blocks.
codes:
external: true
family:
# ---------------------------------------------------------------
# SEO Settings
# ---------------------------------------------------------------
# Disable Baidu transformation on mobile devices.
disable_baidu_transformation: false
# If true, site-subtitle will be added to index page.
# Remember to set up your site-subtitle in Hexo `_config.yml` (e.g. subtitle: Subtitle)
index_with_subtitle: false
# Automatically add external URL with Base64 encrypt & decrypt.
exturl: false
# Google Webmaster tools verification.
# See: https://www.google.com/webmasters
google_site_verification:
# Bing Webmaster tools verification.
# See: https://www.bing.com/webmaster
bing_site_verification:
# Yandex Webmaster tools verification.
# See: https://webmaster.yandex.ru
yandex_site_verification:
# Baidu Webmaster tools verification.
# See: https://ziyuan.baidu.com/site
baidu_site_verification:
# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO.
baidu_push: false
# ---------------------------------------------------------------
# Third Party Plugins & Services Settings
# See: https://theme-next.org/docs/third-party-services/
# More plugins: https://github.com/theme-next/awesome-next
# You may need to install dependencies or set CDN URLs in `vendors`
# There are two different CDN providers by default:
# - jsDelivr (cdn.jsdelivr.net), works everywhere even in China
# - CDNJS (cdnjs.cloudflare.com), provided by cloudflare
# ---------------------------------------------------------------
# Math Formulas Render Support
math:
# Default (true) will load mathjax / katex script on demand.
# That is it only render those page which has `mathjax: true` in Front-matter.
# If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
per_page: true
# hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
mathjax:
enable: false
# See: https://mhchem.github.io/MathJax-mhchem/
mhchem: false
# hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
katex:
enable: false
# See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
copy_tex: false
# Easily enable fast Ajax navigation on your website.
# Dependencies: https://github.com/theme-next/theme-next-pjax
pjax: false
# FancyBox is a tool that offers a nice and elegant way to add zooming functionality for images.
# For more information: https://fancyapps.com/fancybox
fancybox: false
# A JavaScript library for zooming images like Medium.
# Do not enable both `fancybox` and `mediumzoom`.
# For more information: https://github.com/francoischalifour/medium-zoom
mediumzoom: false
# Vanilla JavaScript plugin for lazyloading images.
# For more information: https://github.com/ApoorvSaxena/lozad.js
lazyload: false
# Pangu Support
# For more information: https://github.com/vinta/pangu.js
pangu: false
# Quicklink Support
# Do not enable both `pjax` and `quicklink`.
# For more information: https://github.com/GoogleChromeLabs/quicklink
# Front-matter (unsupport home archive).
quicklink:
enable: false
# Home page and archive page can be controlled through home and archive options below.
# This configuration item is independent of `enable`.
home: false
archive: false
# Default (true) will initialize quicklink after the load event fires.
delay: true
# Custom a time in milliseconds by which the browser must execute prefetching.
timeout: 3000
# Default (true) will enable fetch() or falls back to XHR.
priority: true
# For more flexibility you can add some patterns (RegExp, Function, or Array) to ignores.
# See: https://github.com/GoogleChromeLabs/quicklink#custom-ignore-patterns
ignores:
# ---------------------------------------------------------------
# Comments Settings
# See: https://theme-next.org/docs/third-party-services/comments
# ---------------------------------------------------------------
# Multiple Comment System Support
comments:
# Available values: tabs | buttons
style: tabs
# Choose a comment system to be displayed by default.
# Available values: changyan | disqus | disqusjs | gitalk | livere | valine
active:
# Setting `true` means remembering the comment system selected by the visitor.
storage: true
# Lazyload all comment systems.
lazyload: false
# Modify texts or order for any navs, here are some examples.
nav:
#disqus:
# text: Load Disqus
# order: -1
#gitalk:
# order: -2
# Disqus
disqus:
enable: false
shortname:
count: true
#post_meta_order: 0
# DisqusJS
# Alternative Disqus - Render comment component using Disqus API.
# Demo: https://suka.js.org/DisqusJS/
# For more information: https://github.com/SukkaW/DisqusJS
disqusjs:
enable: false
# API Endpoint of Disqus API (https://disqus.com/api/).
# Leave api empty if you are able to connect to Disqus API. Otherwise you need a reverse proxy for it.
# For example:
# api: https://disqus.skk.moe/disqus/
api:
apikey: # Register new application from https://disqus.com/api/applications/
shortname: # See: https://disqus.com/admin/settings/general/
# Changyan
changyan:
enable: false
appid:
appkey:
#post_meta_order: 0
# Valine
# For more information: https://valine.js.org, https://github.com/xCss/Valine
valine:
enable: false
appid: # Your leancloud application appid
appkey: # Your leancloud application appkey
notify: false # Mail notifier
verify: false # Verification code
placeholder: Just go go # Comment box placeholder
avatar: mm # Gravatar style
guest_info: nick,mail,link # Custom comment header
pageSize: 10 # Pagination size
language: # Language, available values: en, zh-cn
visitor: false # Article reading statistic
comment_count: true # If false, comment count will only be displayed in post page, not in home page
recordIP: false # Whether to record the commenter IP
serverURLs: # When the custom domain name is enabled, fill it in here (it will be detected automatically by default, no need to fill in)
#post_meta_order: 0
# LiveRe comments system
# You can get your uid from https://livere.com/insight/myCode (General web site)
livere_uid: #
# Gitalk
# For more information: https://gitalk.github.io, https://github.com/gitalk/gitalk
gitalk:
enable: false
github_id: # GitHub repo owner
repo: # Repository name to store issues
client_id: # GitHub Application Client ID
client_secret: # GitHub Application Client Secret
admin_user: # GitHub repo owner and collaborators, only these guys can initialize gitHub issues
distraction_free_mode: true # Facebook-like distraction free mode
# Gitalk's display language depends on user's browser or system environment
# If you want everyone visiting your site to see a uniform language, you can set a force language value
# Available values: en | es-ES | fr | ru | zh-CN | zh-TW
language:
# ---------------------------------------------------------------
# Post Widgets & Content Sharing Services
# See: https://theme-next.org/docs/third-party-services/post-widgets
# ---------------------------------------------------------------
# Star rating support to each article.
# To get your ID visit https://widgetpack.com
rating:
enable: false
id: #
color: fc6423
# AddThis Share. See: https://www.addthis.com
# Go to https://www.addthis.com/dashboard to customize your tools.
add_this_id:
# ---------------------------------------------------------------
# Statistics and Analytics
# See: https://theme-next.org/docs/third-party-services/statistics-and-analytics
# ---------------------------------------------------------------
# Google Analytics
google_analytics:
tracking_id: #
# By default, NexT will load an external gtag.js script on your site.
# If you only need the pageview feature, set the following option to true to get a better performance.
only_pageview: false
# Baidu Analytics
baidu_analytics: #
# Growingio Analytics
growingio_analytics: #
# CNZZ count
cnzz_siteid:
# Show number of visitors of each article.
# You can visit https://leancloud.cn to get AppID and AppKey.
# AppID and AppKey are recommended to be the same as valine's for counter compatibility.
# Do not enable both `valine.visitor` and `leancloud_visitors`.
leancloud_visitors:
enable: false
app_id: #
app_key: #
# Required for apps from CN region
server_url: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
# If you don't care about security in leancloud counter and just want to use it directly
# (without hexo-leancloud-counter-security plugin), set `security` to `false`.
security: true
# Another tool to show number of visitors to each article.
# Visit https://console.firebase.google.com/u/0/ to get apiKey and projectId.
# Visit https://firebase.google.com/docs/firestore/ to get more information about firestore.
firestore:
enable: false
collection: articles # Required, a string collection name to access firestore database
apiKey: # Required
projectId: # Required
# Show Views / Visitors of the website / page with busuanzi.
# Get more information on http://ibruce.info/2015/04/04/busuanzi
busuanzi_count:
enable: false
total_visitors: true
total_visitors_icon: fa fa-user
total_views: true
total_views_icon: fa fa-eye
post_views: true
post_views_icon: fa fa-eye
# ---------------------------------------------------------------
# Search Services
# See: https://theme-next.org/docs/third-party-services/search-services
# ---------------------------------------------------------------
# Algolia Search
# For more information: https://www.algolia.com
algolia_search:
enable: false
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"
# Local Search
# Dependencies: https://github.com/theme-next/hexo-generator-searchdb
local_search:
enable: false
# If auto, trigger search by changing input.
# If manual, trigger search by pressing enter key or search button.
trigger: auto
# Show top n results per article, show all results by setting to -1
top_n_per_article: 1
# Unescape html strings to the readable one.
unescape: false
# Preload the search data when the page loads.
preload: false
# Swiftype Search API Key
swiftype_key:
# ---------------------------------------------------------------
# Chat Services
# See: https://theme-next.org/docs/third-party-services/chat-services
# ---------------------------------------------------------------
# Chatra Support
# See: https://chatra.io
# Dashboard: https://app.chatra.io/settings/general
chatra:
enable: false
async: true
id: # Visit Dashboard to get your ChatraID
#embed: # Unfinished experimental feature for developers. See: https://chatra.io/help/api/#injectto
# Tidio Support
# See: https://www.tidiochat.com
# Dashboard: https://www.tidiochat.com/panel/dashboard
tidio:
enable: false
key: # Public Key, get it from dashboard. See: https://www.tidiochat.com/panel/settings/developer
# ---------------------------------------------------------------
# Tags Settings
# See: https://theme-next.org/docs/tag-plugins/
# ---------------------------------------------------------------
# Note tag (bs-callout)
note:
# Note tag style values:
# - simple bs-callout old alert style. Default.
# - modern bs-callout new (v2-v3) alert style.
# - flat flat callout style with background, like on Mozilla or StackOverflow.
# - disabled disable all CSS styles import of note tag.
style: simple
icons: false
# Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
# Offset also applied to label tag variables. This option can work with disabled note tag.
light_bg_offset: 0
# Tabs tag
tabs:
transition:
tabs: false
labels: true
# PDF tag
# NexT will try to load pdf files natively, if failed, pdf.js will be used.
# So, you have to install the dependency of pdf.js if you want to use pdf tag and make it available to all browsers.
# See: https://github.com/theme-next/theme-next-pdf
pdf:
enable: false
# Default height
height: 500px
# Mermaid tag
mermaid:
enable: false
# Available themes: default | dark | forest | neutral
theme: forest
# ---------------------------------------------------------------
# Animation Settings
# ---------------------------------------------------------------
# Use velocity to animate everything.
# For more information: http://velocityjs.org
motion:
enable: true
async: false
transition:
# Transition variants:
# fadeIn | flipXIn | flipYIn | flipBounceXIn | flipBounceYIn
# swoopIn | whirlIn | shrinkIn | expandIn
# bounceIn | bounceUpIn | bounceDownIn | bounceLeftIn | bounceRightIn
# slideUpIn | slideDownIn | slideLeftIn | slideRightIn
# slideUpBigIn | slideDownBigIn | slideLeftBigIn | slideRightBigIn
# perspectiveUpIn | perspectiveDownIn | perspectiveLeftIn | perspectiveRightIn
post_block: fadeIn
post_header: slideDownIn
post_body: slideDownIn
coll_header: slideLeftIn
# Only for Pisces | Gemini.
sidebar: slideUpIn
# Progress bar in the top during page loading.
# Dependencies: https://github.com/theme-next/theme-next-pace
# For more information: https://github.com/HubSpot/pace
pace:
enable: false
# Themes list:
# big-counter | bounce | barber-shop | center-atom | center-circle | center-radar | center-simple
# corner-indicator | fill-left | flat-top | flash | loading-bar | mac-osx | material | minimal
theme: minimal
# JavaScript 3D library.
# Dependencies: https://github.com/theme-next/theme-next-three
three:
enable: false
three_waves: false
canvas_lines: false
canvas_sphere: false
# Canvas-ribbon
# Dependencies: https://github.com/theme-next/theme-next-canvas-ribbon
# For more information: https://github.com/zproo/canvas-ribbon
canvas_ribbon:
enable: false
size: 300 # The width of the ribbon
alpha: 0.6 # The transparency of the ribbon
zIndex: -1 # The display level of the ribbon
#! ---------------------------------------------------------------
#! DO NOT EDIT THE FOLLOWING SETTINGS
#! UNLESS YOU KNOW WHAT YOU ARE DOING
#! See: https://theme-next.org/docs/advanced-settings
#! ---------------------------------------------------------------
# Script Vendors. Set a CDN address for the vendor you want to customize.
# Be aware that you would better use the same version as internal ones to avoid potential problems.
# Remember to use the https protocol of CDN files when you enable https on your site.
vendors:
# Internal path prefix.
_internal: lib
# Internal version: 3.1.0
# anime: //cdn.jsdelivr.net/npm/animejs@3.1.0/lib/anime.min.js
anime:
# Internal version: 5.13.0
# fontawesome: //cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css
# fontawesome: //cdnjs.cloudflare.com/ajax/libs/font-awesome/5.13.0/css/all.min.css
fontawesome:
# MathJax
# mathjax: //cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
mathjax:
# KaTeX
# katex: //cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css
# katex: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.11.1/katex.min.css
# copy_tex_js: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.js
# copy_tex_css: //cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.css
katex:
copy_tex_js:
copy_tex_css:
# Internal version: 0.2.8
# pjax: //cdn.jsdelivr.net/gh/theme-next/theme-next-pjax@0/pjax.min.js
pjax:
# FancyBox
# jquery: //cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js
# fancybox: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.js
# fancybox_css: //cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.css
jquery:
fancybox:
fancybox_css:
# Medium-zoom
# mediumzoom: //cdn.jsdelivr.net/npm/medium-zoom@1/dist/medium-zoom.min.js
mediumzoom:
# Lazyload
# lazyload: //cdn.jsdelivr.net/npm/lozad@1/dist/lozad.min.js
# lazyload: //cdnjs.cloudflare.com/ajax/libs/lozad.js/1.14.0/lozad.min.js
lazyload:
# Pangu
# pangu: //cdn.jsdelivr.net/npm/pangu@4/dist/browser/pangu.min.js
# pangu: //cdnjs.cloudflare.com/ajax/libs/pangu/4.0.7/pangu.min.js
pangu:
# Quicklink
# quicklink: //cdn.jsdelivr.net/npm/quicklink@1/dist/quicklink.umd.js
quicklink:
# DisqusJS
# disqusjs_js: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js
# disqusjs_css: //cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css
disqusjs_js:
disqusjs_css:
# Valine
# valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js
# valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.10/Valine.min.js
valine:
# Gitalk
# gitalk_js: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js
# gitalk_css: //cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.css
gitalk_js:
gitalk_css:
# Algolia Search
# algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
# instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
algolia_search:
instant_search:
# Mermaid
# mermaid: //cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js
# mermaid: //cdnjs.cloudflare.com/ajax/libs/mermaid/8.4.8/mermaid.min.js
mermaid:
# Internal version: 1.2.1
# velocity: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.min.js
# velocity: //cdnjs.cloudflare.com/ajax/libs/velocity/1.2.1/velocity.min.js
# velocity_ui: //cdn.jsdelivr.net/npm/velocity-animate@1/velocity.ui.min.js
# velocity_ui: //cdnjs.cloudflare.com/ajax/libs/velocity/1.2.1/velocity.ui.min.js
velocity:
velocity_ui:
# Internal version: 1.0.2
# pace: //cdn.jsdelivr.net/npm/pace-js@1/pace.min.js
# pace: //cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/pace.min.js
# pace_css: //cdn.jsdelivr.net/npm/pace-js@1/themes/blue/pace-theme-minimal.css
# pace_css: //cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/themes/blue/pace-theme-minimal.min.css
pace:
pace_css:
# Internal version: 1.0.0
# three: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three.min.js
# three_waves: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/three-waves.min.js
# canvas_lines: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/canvas_lines.min.js
# canvas_sphere: //cdn.jsdelivr.net/gh/theme-next/theme-next-three@1/canvas_sphere.min.js
three:
three_waves:
canvas_lines:
canvas_sphere:
# Internal version: 1.0.0
# canvas_ribbon: //cdn.jsdelivr.net/gh/theme-next/theme-next-canvas-ribbon@1/canvas-ribbon.js
canvas_ribbon:
# Assets
css: css
js: js
images: images
================================================
FILE: crowdin.yml
================================================
files:
- source: /languages/en.yml
translation: /languages/%two_letters_code%.%file_extension%
languages_mapping:
two_letters_code:
zh-CN: zh-CN
zh-TW: zh-TW
zh-HK: zh-HK
pt-BR: pt-BR
================================================
FILE: docs/AGPL3.md
================================================
# 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 Algolia Search
NexT provides Algolia search plugin for index your hexo website content. To use this feature, make sure that the version of NexT you are using is after the v5.1.0 release. What you should note here is that only turn on `enable` of `algolia_search` in `next/_config.yml` cannot let you use the algolia search correctly, you need to install corresponding [Hexo Algolia](https://github.com/oncletom/hexo-algolia) plugin to seach your website with Algolia. Follow the steps described below to complete the installation of Algolia search.
1. Register at [Algolia](https://www.algolia.com/), you can log in directly using GitHub or Google Account. Upon Customer’s initial sign-up for an Account, Customer will have a free, fourteen (14) day evaluation period (the “Evaluation Period”) for the Algolia Services commencing on the Effective Date, subject to the limitations on Algolia’s website. After that, Algolia offers a free, branded version for up to 10k records and 100k operations per month.
1. If a tutorial pops up, you can skip it. Go straight to create an `Index` which will be used later.
1. Go to the `API Keys` page and find your credentials. You will need the `Application ID` and the `Search-only API key` in the following sections. The `Admin API key` need to keep confidential. Never store your Admin API Key as apiKey in the` _config.yml` file: it would give full control of your Algolia index to others and you don't want to face the consequences.
1. In 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. In the `API Keys` page, click the `All API Keys` button to switch to the corresponding tab. Then click the `New API Key` button to activate a pop-up box where you can setup authorizations and restrictions with a great level of precision. Enter `addObject`, `deleteObject`, `listIndexes`, `deleteIndex` features in ACL permissions that will be allowed for the given API key. And then click the `Create` button. Copy this newly created key to the clipboard, we call it a `High-privilege API key`.
1. Algolia requires users to upload their search index data either manually or via provided APIs. Install and configure [Hexo Algolia](https://github.com/oncletom/hexo-algolia) in your Hexo directory. This plugin will index your site and upload selected data to Algolia.
```
$ cd hexo
$ npm install hexo-algolia
```
1. Run the following command to upload index data, keep a weather eye out the output of the command.
```
$ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Git Bash
# set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # Use Windows command line
$ hexo clean
$ hexo algolia
```
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"
```
1. If you want to use a different version from CDN, please follow the instructions below.
You need to **set vendors** in NexT `_config.yml` file:
```yml
vendors:
...
# Algolia Search
# algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
# instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
...
```
Known Issues
1. The latest version of the [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) plugin removes the content indexing feature, given Algolia's free account limitation.
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`
================================================
FILE: docs/AUTHORS.md
================================================
# «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 did some useful pulls/commits in original repository and you are not in the list, let us know and you will be added here.
================================================
FILE: docs/DATA-FILES.md
================================================
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 `/themes/next/_config.yml`. This approach is applicable, but has some drawbacks:
1. Configurations are splitted into two pieces
2. Users may be confused which place should be for options
In order to resolve this issue, NexT provides the following two solutions.
Option 1: Hexo-Way
With this way, all your configurations locate in main Hexo config file (`/_config.yml`), you don't need to touch `/themes/next/_config.yml` or create any new files. But you must preserve double spaces indents within `theme_config` option.
If there are any new options in new releases, you just need to copy those options from `/themes/next/_config.yml`, paste into `/_config.yml` and set their values to whatever you want.
### Usage
1. Please confirm that the `/source/_data/next.yml` file does not exist (delete it if exists).
2. Copy needed NexT theme options from theme's `/themes/next/_config.yml` into `/_config.yml`, then\
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 `/themes/next/_config.yml`.
But option may not accurately procces all hexo external libraries with their additional options (for example, `hexo-server` module options may be readed only in default hexo config).
If there are any new options in new releases, you just need to copy those options from `/themes/next/_config.yml`, paste into `/source/_data/next.yml` and set their values to whatever you want.
This method relies on Hexo [Data files](https://hexo.io/docs/data-files.html). Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature.
### Usage
1. Please ensure you are using Hexo 3 (or above).
2. Create an file named `next.yml` in site's `/source/_data` directory (create `_data` directory if it does not exist).
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 `/themes/next/_config.yml` into `/source/_data/next.yml`.
* **Variant 2: `override: true`**:
1. In `next.yml` set `override` option on `true`.
2. Copy **all** NexT theme options from theme's `/themes/next/_config.yml` into `/source/_data/next.yml`.
3. Then, in main site's `/_config.yml` need to define `theme: next` option (and if needed, `source_dir: source`).
4. Use standard parameters to start server, generate or deploy (`hexo clean && hexo g -d && hexo s`).
### Useful links
* [NexT Issue #328](https://github.com/iissnan/hexo-theme-next/issues/328)
================================================
FILE: docs/INSTALLATION.md
================================================
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
================================================
FILE: docs/LEANCLOUD-COUNTER-SECURITY.md
================================================
Fix LeanCloud Counter Plugin Security Vulnerability
Before you make the config, please upgrade your NexT version to v6.0.6 or greater.
Please note the difference between **site config file** and **theme config file**
---
# Sign up to LeanCloud and create an app
- Go to LeanCloud website [leancloud.app](https://leancloud.app) and sign up to LeanCloud. Then login.
- Click `1` to enter the console:
- Then click `1` to create an app:
- 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:
# Create Counter class and enable plugin in NexT
- Click `1` (app name) to enter the app manage page:
- then click `1` to create a class for counter:
- Type `Counter` in the pop up window in `1`, check `2`, then click `3`:
- Click `1` to enter the app setting, then click `2`:
- Paste `App ID` and `App Key` to **theme config file** `_config.yml` like this:
```yml
leancloud_visitors:
enable: true
app_id: #
app_key: #
# Required for apps from CN region
server_url: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
```
- Set domain whitelist: Click `1`, then type your domain into `2` (**protocol, domain and port should be exactly the same**):
# Deploy web engine to avoid your data being changed illegally
- Click `1 -> 2 -> 3` by order
- Click `1`:
- In the pop up window, click `1` to choose type `Hook`, then choose`beforeUpdate` in `2`, choose `Counter` in `3`. Paste code below into `4`, then click `5` to save it:
```javascript
var query = new AV.Query("Counter");
if (request.object.updatedKeys.includes('time')) {
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();
});
}
```
- Click `1` to deploy after the message in the red rect shows up:
- Click `1` in the pop up：
- Click `1` to close the pop up window after the message in the red rect shows up:
# 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: #
# Required for apps from CN region
server_url: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
```
- Open cmd then switch to **root path of site**, type commands to install `hexo-leancloud-counter-security` plugin:
```
npm install hexo-leancloud-counter-security
```
- 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):
- Click `1 -> 2 -> 3` by order:
- Click `1` (add_fields), then choose `2`: Do as below "create" setting(choose the user you create):
- click `1` (create), then choose `2`, type the username in `3`, then click `4 -> 5`:
Now your page should be similar to this img after finishing the step.
- Click `1` (delete), then choose `2`:
Now the bug is fixed.
---
See detailed version here: https://leaferx.online/2018/03/16/lc-security-en/
================================================
FILE: docs/LICENSE.txt
================================================
«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
================================================
FILE: docs/MATH.md
================================================
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 choose a render engine and turn on `enable` for it (located in `next/_config.yml`).
Notice: only turning on `enable` **cannot let you see the displayed equations correctly**, you need to install the **corresponding Hexo Renderer** to fully support the display of Math Equations. The corresponding Hexo Renderer per engine will be provided below.
Provided Render Engine
For now, NexT provides two Render Engines: [MathJax](https://www.mathjax.org/) and [Katex](https://khan.github.io/KaTeX/).
### MathJax
If you use MathJax to render Math Equations, you need to use one of them: [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) or [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) (Not recommended) as the renderer for Markdown.
Firstly, you need to uninstall the original renderer `hexo-renderer-marked`, and install **one of the renderer above**:
```sh
npm uninstall hexo-renderer-marked
npm install hexo-renderer-pandoc # or hexo-renderer-kramed
```
Secondly, in `next/_config.yml`, turn on `enable` of `mathjax`.
```yml
math:
...
mathjax:
enable: true
```
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}\label{eq1}
e=mc^2
\end{equation}$$
```
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}\label{eq2}
\begin{aligned}
a &= b + c \\
&= d + e + f + g \\
&= h + i
\end{aligned}
\end{equation}$$
```
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](https://docs.mathjax.org/en/latest/input/tex/eqnumbers.html). You can also visit this [post](https://theme-next.org/docs/third-party-services/math-equations) for more details.
### 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 uninstall hexo-renderer-marked
npm install hexo-renderer-markdown-it-plus
# or hexo-renderer-markdown-it
```
Secondly, in `next/_config.yml`, turn on `enable` option of `katex`.
```yml
math:
...
katex:
enable: true
```
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 install markdown-it-katex
```
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.11.1, some of those bugs might be caused by the outdated version of Katex we use.
But, as what is described in the beginning, the render of Math Equations relies on Hexo Renderer. Currently, Katex-related renderers only support Katex version until 0.11.1.
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 Formulas Render Support
math:
# Default (true) will load mathjax / katex script on demand.
# That is it only render those page which has `mathjax: true` in Front-matter.
# If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
per_page: true
# hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
mathjax:
enable: true
# See: https://mhchem.github.io/MathJax-mhchem/
mhchem: false
# hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
katex:
enable: false
# See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
copy_tex: false
```
### `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**.
================================================
FILE: docs/UPDATE-FROM-5.1.X.md
================================================
Update from NexT v5.1.x
NexT version 5 works fine with Hexo 3, but for frequent users, you maybe need to upgrade version 5 to 7 to get features and supports in new [Theme-Next](https://github.com/theme-next/hexo-theme-next) repository.
There are no hard breaking changes between 5.1.x and the latest version. It's change major version to 7 because:
1. Main repo was rebased from [iissnan's](https://github.com/iissnan/hexo-theme-next) profile to [theme-next](https://github.com/theme-next) organization.
2. Most libraries under the `next/source/lib` directory was moved out to [external repos under NexT organization](https://github.com/theme-next).
3. 3rd-party plugin [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) was replaced by [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) because `hexo-symbols-count-time` no have any external Node.js dependencies, no have [language filter](https://github.com/willin/hexo-wordcount/issues/7) which causes better performance on speed at site generation.
So, we suggest to update from version 5 to version 7 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 repo to any another directory instead of `next`. For example, in `next-reloaded` directory: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. So, you don't touch your old NexT 5.1.x directory and can work with new `next-reloaded` dir.
3. Go to Hexo main config and set theme parameter: `theme: next-reloaded`. So, your `next-reloaded` directory must loading with your generation. If you may see any bugs or you simply not like this version, you anytime can switch for 5.1.x version back.
4. Update language configuration (For Chinese)
Since v6.0.3, `zh-Hans` has been renamed to `zh-CN`: https://github.com/theme-next/hexo-theme-next/releases/tag/v6.0.3
Users upgrading to v6.0.3 and later need to explicitly modify the `language` configuration in the Hexo main config file `_config.yml`, otherwise the language display is incorrect.
5. Update Hexo and Hexo plugin
If after completing the above steps, an error occurs when executing `hexo s` or` hexo g`, it means that there may be a conflict between the old version of Hexo / Hexo plugin and the new version of the theme NexT. We recommend upgrading Hexo to versions 4.0 and higher and upgrading Hexo plugins to the latest version. You can run `npm outdated` to see all the upgradeable plugins.
And how to enable 3rd-party libraries see [here](https://github.com/theme-next/hexo-theme-next/blob/master/docs/INSTALLATION.md#plugins).
================================================
FILE: docs/ru/DATA-FILES.md
================================================
Дата Файлы
Обновление темы NexT через пулы проходит не слишком гладко. Часто происходит конфликтная ситуация при обновлении по команде `git pull`, хотя её и можно обойти, если смерджить настройки в файле конфигурации вручную.
На данный момент, пользователи хранят одни настройки в корневом `_config.yml` (Hexo), а другие настройки в конфиге темы `_config.yml` (NexT). И всё вроде бы ничего, но имеются некоторые недостатки:
1. Конфигурация разделяется на две части.
2. Пользователи могут запутаться, в каком файле какие должны быть настройки.
Во избежании проблемы, NexT предлагает два варианта.
Способ 1: Hexo-Путь
Используя этот способ, вся конфигурация будет раположена в корневом конфиге hexo (`/_config.yml`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`) или создавать какие-либо новые файлы. Но в этом случае необходимо сохранять двойные отступы внутри `theme_config` параметра.
Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `next/_config.yml` в редактируемый `/_config.yml` и настроить по своему усмотрению.
### Использование
1. Проверяем на существование `/source/_data/next.yml` файл (удаляем, если существует).
2. Копируем необходимые опции из конфига темы NexT `/themes/next/_config.yml` в `/_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`), благодаря чему нет необходимости изменять оригинальный конфиг темы (`/themes/next/_config.yml`).
Но с этим способом могут не корректно обрабатываться все внешние библиотеки hexo при использовании их дополнительных опций (например, опции модуля `hexo-server` могут быть считаны только из стандартного конфига hexo).
Если в новых версиях появятся какие-то новые настройки, нужно просто скопировать эти настройки из оригинального `/themes/next/_config.yml` во внешний `_data/next.yml` и настроить по своему усмотрению.
Этот метод опирается на Hexo [дата-файлов](https://hexo.io/docs/data-files.html). И т.к. дата-файлы были представлены в Hexo 3, необходимо обновиться до Hexo 3.0 (или выше) для использования этой возможности.
### Использование
1. Убеждаемся, что Hexo версии 3 (или выше).
2. Создаём файл под именем `next.yml` в корневой директории сайта — `/source/_data` (создаём директорию `_data`, если отсутствует).
И после этих шагов есть 2 варианта, нужно выбрать только 1 из них и продолжить следующие шаги.
* **Вариант 1: `override: false` (по-умолчанию)**:
1. Проверяем опцию `override` в стандартном конфиге NexT'а, должно быть установлено в `false`.\
В файле `next.yml` эта опция не должна быть вписана вовсе или вписана и установлена в `false`.
2. Копируем настройки из конфига темы NexT (`_config.yml`) и из корневого конфига сайта (`_config.yml`) в файл `/source/_data/next.yml`.
* **Вариант 2: `override: true`**:
1. В файле `next.yml` ставим опцию `override` в `true`.
2. Копируем **все** опции из оригинального конфига NexT'а `/themes/next/_config.yml` в `/source/_data/next.yml`.
3. Затем, в корневом конфиге сайта `/_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)
================================================
FILE: docs/ru/INSTALLATION.md
================================================
Установка
Шаг 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
================================================
FILE: docs/ru/README.md
================================================
# e x T
«NexT» — элегантная высококачественная тема под Hexo. Сделана с нуля, с любовью.
## Демо
💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
Больше примеров «NexT» здесь.
## Установка
Простейший вариант установки — склонировать весь репозиторий:
```sh
$ cd hexo
$ git clone https://github.com/theme-next/hexo-theme-next themes/next
```
Или предлагаю почитать [детальные инструкции по установке][docs-installation-url], если вариант выше не устраивает.
## Плагины
В конфиге NexT'а теперь можно найти зависимости на каждый модуль, который был вынесен во внешние репозитории, которые могут быть найдены по [ссылке основной организации][official-plugins-url].
Например, Вы хотите использовать `pjax` для своего сайта. Открываем конфиг NexT'а и находим:
```yml
# Easily enable fast Ajax navigation on your website.
# Dependencies: https://github.com/theme-next/theme-next-pjax
pjax: true
```
Затем включаем параметр `pjax` и переходим по ссылке «Dependencies» с дальнейшеми инструкциями по установке этого модуля.
## Обновление
NexT выпускает новые версии каждый месяц. Можно обновить до последней мастер-ветки следующей командой:
```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 на последней версиями, читаем [здесь][docs-update-5-1-x-url].**
## Обратная связь
* Посетите [Awesome NexT][awesome-next-url] список.
* Вступить в наши [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] чаты.
* [Добавить или улучшить перевод][i18n-url] за несколько секунд.
* Сообщить об ошибке в разделе [GitHub Issues][issues-bug-url].
* Запросить новую возможность на [GitHub][issues-feat-url].
* Голосовать за [популярные запросы возможностей][feat-req-vote-url].
## Содействие
[![][contributors-image]][contributors-url]
Приветсвуется любое содействие, не стесняйтесь сообщать «Баги», брать «Форки» и вливать «Пулы».
## Благодарности
«NexT» выражает особую благодарность этим замечательным сервисам, которые спонсируют нашу основную инфраструктуру:
GitHub позволяет нам хостить Git-репозиторий, Netlify позволяет нам деплоить документацию.
Crowdin позволяет нам удобно переводить документацию.
Codacy позволяет нам контролировать качество кода, Travis CI позволяет нам запускать набор тестов.
[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/INSTALLATION.md
[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md
[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/UPDATE-FROM-5.1.X.md
[t-news-url]: https://t.me/theme_next_news
[t-chat-url]: https://t.me/theme_next
[gitter-url]: https://gitter.im/theme-next
[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
[i18n-url]: https://i18n.theme-next.org
[awesome-next-url]: https://github.com/theme-next/awesome-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
[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/.github/CONTRIBUTING.md
[official-plugins-url]: https://github.com/theme-next
[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890
[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors
================================================
FILE: docs/ru/UPDATE-FROM-5.1.X.md
================================================
Обновление из-под NexT v5.1.x
Между версией 5.1.x и последней версиями нет жёстких изменений. Версия сменилась на мажорную 7 по следующим причинам:
1. Основной репозиторий перебазировался из профиля [iissnan'а](https://github.com/iissnan/hexo-theme-next) в [theme-next](https://github.com/theme-next) организацию.
2. Большинство библиотек в `next/source/lib` директории были вынесены в [отдельные репозитории под организацией NexT](https://github.com/theme-next).
3. 3rd-party плагин [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) был заменён на [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) т.к. `hexo-symbols-count-time` не имеет никаких сторонних Node.js зависимостей, не имеет [языкового фильтра](https://github.com/willin/hexo-wordcount/issues/7) что обеспечивает улучшенную производительность при генерации сайта.
Поэтому, я предлагаю обновиться с версии 5 на версию 7 следующим способом:
1. Вы не трогаете старую директорию `next`, а всего-лишь делаете резервные копии файлов NexT:\
1.1. `config.yml` или `next.yml` (если Вы использовали [дата-файлы](DATA-FILES.md)).\
1.2. Пользовательских CSS-стилей, которые расположены в `next/source/css/_custom/*` и `next/source/css/_variables/*` директориях.\
1.3. Пользовательских layout-стилей, которые расположены в `next/layout/_custom/*`.\
1.4. Любые другие всевозможные пользовательские изменения, которые могут быть найдены любым инструментом для сравнения файлов.
2. Склонировать новый репозиторий в любую другую директорию, отличную от `next`. Например, в директорию `next-reloaded`: `git clone https://github.com/theme-next/hexo-theme-next themes/next-reloaded`. Итак, нет необходимости трогать старую NexT 5.1.x директорию и можно работать с новой `next-reloaded`.
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).
================================================
FILE: docs/zh-CN/ALGOLIA-SEARCH.md
================================================
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 将在后面使用。
1. 在 `API Keys` 页面找到需要使用的一些配置的值，包括 `Application ID` 和 `Search-Only API Key`。注意，`Admin API Key` 需要保密保存，不要外泄。
1. 编辑 `站点配置文件`，新增以下配置，除了 `chunkSize` 字段，替换成在 Algolia 获取到的值：
```yml
algolia:
applicationID: 'Application ID'
apiKey: 'Search-Only API Key'
indexName: 'indexName'
chunkSize: 5000
```
1. 在 `API Keys` 页面，点击 `All API Keys` 切换到对应的页面中。接着点击 `New API Key` 按钮，来**编辑权限**。在弹出框中找到 ACL ，**输入 addObject、 deleteObject、listIndexes、deleteIndex 权限**，然后点击最下方的 `Create` 按钮。将这个新创建的 API Key 复制到剪贴板，我们称之为 `High-privilege API key`。
1. 在 Index 和 API Key 创建完成后，此时这个 Index 里未包含任何数据。接下来需要安装 [Hexo Algolia](https://github.com/oncletom/hexo-algolia) 扩展，这个扩展的功能是搜集站点的内容并通过 API 发送给 Algolia。前往站点根目录，执行命令安装：
```
$ cd hexo
$ npm install hexo-algolia
```
1. 当配置完成，在站点根目录下执行以下命令来更新上传 Index。请注意观察命令的输出。
```
$ export HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Git Bash
# set HEXO_ALGOLIA_INDEXING_KEY=High-privilege API key # 使用 Windows CMD 命令行
$ hexo clean
$ hexo algolia
```
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. 如果你需要通过 CDN 使用其它版本的 algolia-instant-search ，请根据以下步骤操作。
你需要在`主题配置文件`中的 vendors 字段进行设置：
```yml
vendors:
...
# Algolia Search
# algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
# instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
algolia_search: //cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js
instant_search: //cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js
...
```
已知的问题
1. 考虑到 Algolia 免费账户的限制，目前 [Hexo-Algolia](https://github.com/oncletom/hexo-algolia) 插件最新版本去掉了正文索引功能。
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`
================================================
FILE: docs/zh-CN/CODE_OF_CONDUCT.md
================================================
# 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) 社区中代码更新、问题交流、请求合并等行为。我们期望所有用户相互尊重，礼貌待人。任何违反这些规则的人都将不会被审核，并会在发现后立即被阻止和驱逐。
## 目录
- [我们的保证](#我们的保证)
- [我们的责任](#我们的责任)
- [我们的标准](#我们的标准)
- [使用范围](#使用范围)
- [强制执行](#强制执行)
- [联系项目维护者](#联系项目维护者)
- [来源](#来源)
## 我们的保证
作为此项目的贡献者和维护者，我们承诺尊重所有做出贡献的用户，这些贡献包括了报告问题、发布功能请求、更新文档、提交合并请求以及其他活动。
为了促进一个开放透明且友好的环境，我们作为贡献者和维护者保证：无论年龄、种族、民族、性别认同和表达（方式）、体型、身体健全与否、经验水平、国籍、个人表现、宗教或性别取向，参与者在我们项目和社区中都免于骚扰。
## 我们的责任
项目维护者有责任为「可接受的行为」标准做出诠释，有权利及责任去删除、编辑、拒绝与本行为标准有所违背的评论（comments）、提交（commits）、代码、wiki 编辑、问题（issues）和其他贡献，以及项目维护者可暂时或永久性的禁止任何他们认为有不适当、威胁、冒犯、有害行为的贡献者。
## 我们的标准
作为 GitHub 上的一个项目，本项目受到 [GitHub 社区准则](https://help.github.com/articles/github-community-guidelines/)的约束。 此外，作为 npm 托管的项目，[npm 公司的行为准则](https://www.npmjs.com/policies/conduct)也涵盖了本项目。
有助于创造正面环境的行为包括但不限于：
* 使用友好和包容性语言
* 尊重不同的观点和经历
* 耐心地接受建设性批评
* 关注对社区最有利的事情
* 友善对待其他社区成员
身为参与者不能接受的行为包括但不限于：
* 使用与性有关的言语或是图像，以及不受欢迎的性骚扰
* 捣乱/煽动/造谣的行为或进行侮辱/贬损的评论，人身攻击及政治攻击
* 公开或私下的骚扰
* 未经许可地发布他人的个人资料，例如住址或是电子地址
* 其他可以被合理地认定为不恰当或者违反职业操守的行为
## 使用范围
当一个人代表该项目或是其社区时，本行为标准适用于其项目社区和公共社区。
根据某人在本社区范围以外发生的违规情况，项目维护者可以认为其不受欢迎，并采取适当措施来保证所有成员的安全性和舒适性。
## 强制执行
如果您看到违反行为准则的行为，请按以下步骤操作：
1. 让这个人知道他所做的并不合适，并要求他停止或编辑他们的提交信息。该人应立即停止行为并纠正问题。
2. 如果该人没有纠正其行为，或者您不方便与其沟通，请[联系项目维护者](#联系项目维护者)。上报时，请尽可能多的提供详细信息，链接，截图，上下文或可用于更好地理解和解决情况的其他信息。
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)。
================================================
FILE: docs/zh-CN/CONTRIBUTING.md
================================================
# e x T
首先，非常感谢大家抽出宝贵时间来让我们的 NexT 主题越变越好。在这里，我们介绍一下 [NexT 主题及其子模块](https://github.com/theme-next) 的开源贡献指南。不过，我们希望大家不要局限于此，更欢迎大家随时进行补充。
## 目录
[如何为 NexT 做贡献](#如何为-next-做贡献)
* [你需要了解的](#你需要了解的)
* [阅读文档](#阅读文档)
* [快速调试指南](#快速调试指南)
* [反馈 Bug](#反馈-bug)
* [提交漏洞](#提交漏洞)
* [提交功能需求](#提交功能需求)
* [提交合并请求](#提交合并请求)
* [发布版本](#发布版本)
[规范](#规范)
* [行为规范](#行为规范)
* [编码规范](#编码规范)
* [标签规范](#标签规范)
* [提交信息规范](#提交信息规范)
## 如何为 NexT 做贡献
### 你需要了解的
#### 阅读文档
如果你在使用过程中遇到了问题，你可以查阅 [FAQs](https://theme-next.org/docs/faqs) 或者 [NexT 帮助文档](https://theme-next.org/docs/troubleshooting)。
另外，你也可以通过 [这里](https://github.com/theme-next/hexo-theme-next/search?q=&type=Issues&utf8=%E2%9C%93) 进行大致检索，有些问题已经得到解答，你可以自行解决。对于没有解决的 Issue，你也可以继续提问。
#### 快速调试指南
在 GitHub 上提交 Issue 前，请先通过以下方法 debug：
* 执行`hexo clean`，清除浏览器缓存，并禁用 CDN 服务（例如 Cloudflare Rocket Loader）；
* 切换到其它主题并检查 bug 是否仍然存在（例如使用默认主题 landscape）。换言之，证明这是 NexT 主题而非来自 Hexo 的 bug；
* 将 NexT 主题升级到最新版；
* 将 Hexo 和 Hexo 插件升级到最新版；
* 将 Node.js 和 `npm` 升级到最新版；
* 卸载不必要的 Hexo 插件，或重新通过 `npm install --save` 安装插件。
如果你得到了来自 Hexo 或浏览器控制台的报错信息，请在 Google / Stackoverflow / GitHub Issue 中搜寻，或在提交 Issue 时报告给我们。
如果你在使用过程中发现了 Bug，请再次确认 Bug 在 [最新发布版本](https://github.com/theme-next/hexo-theme-next/releases/latest) 中是否重现。如果 Bug 重现，欢迎你到我们的 [主题仓库](https://github.com/theme-next/hexo-theme-next) 中 [反馈 Bug](#reporting-bugs) 或者 [提交功能需求](#提交功能需求)，也更期待您 [提交合并请求](#提交合并请求)。
### 反馈 Bug
反馈 Bug 前，请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容，避免提交重复的 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 加密邮件）。
我们很乐意对任何提交漏洞的人予以特别感谢以便我们修复它。如果你想保持匿名性或使用笔名替代，请告诉我们。我们将充分尊重你的意愿。
### 提交功能需求
提交功能需求前，请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容，避免提交重复的 Issue。确定相关仓库后，创建 Issue 并按照 [模板](../../.github/ISSUE_TEMPLATE.md) 尽可能的详细填写相关信息。
请认真遵守如下指南，这样我们才能更好地理解和开发功能需求:pencil:：
* 在标题中清晰准确地描述你的功能需求。
* 详细描述目前所具有的功能和你所期待的功能，并解释为什么需要该功能。
* 提供功能需求的样例，如图像文件、在线演示网址等等。
### 提交合并请求
提交合并请求前，请再次确认您已经查看了 [你需要了解的](#你需要了解的) 内容，避免提交重复的合并请求。确定相关仓库后，创建合并请求。更多详细操作过程可以查看 [帮助文档](https://help.github.com/articles/creating-a-pull-request/)。
请认真遵守如下指南，这样我们才能更好地理解你的合并请求：
* 创建合并请求时，请遵守 [编码规范](#编码规范) 和 [提交信息规范](#提交信息规范)。
* 在标题中清晰准确地描述你的合并请求，不要加入 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)。
### 编码规范
我们使用 ESLint 和 Stylint 来识别和报告 JavaScript 和 Stylus 中的模式，目的是使代码更加一致并避免错误。编码时应遵循这些规范。
### 标签规范
为了方便维护人员和用户能够快速找到他们想要查看的问题，我们使用“标签”功能对 Pull requests 和 Issues 进行分类。
如果您不确定某个标签的含义，或者不知道将哪些标签应用于 PR 或 issue，千万别错过这个。
Issue 的标签：
- 类型
- `Bug`: 检测到需要进行确认的 Bug
- `Feature Request`: 提出了新功能请求的 Issue
- `Question`: 提出疑问的 Issue
- `Meta`: 表明使用条款变更的 Issue
- `Support`: 被标记为支持请求的 Issue
- `Polls`: 发起投票的 Issue
- 结果
- `Duplicate`: 重复提及的 Issue
- `Irrelevant`: 与 NexT 主题无关的 Issue
- `Invalid`: 无法复现的 Issue
- `Expected Behavior`: 与预期行为相符的 Issue
- `Need More Info`: 需要更多信息的 Issue
- `Verified`: 已经被确认的 Issue
- `Solved`: 已经解决的 Issue
- `Backlog`: 待解决的 Issue
- `Stale`: 由于长期无人回应被封存的 Issue
Pull Request 的标签：
- `Breaking Change`: 产生重大变动的 Pull Request
- `Bug Fix`: 修复相关 Bug 的 Pull Request
- `New Feature`: 添加了新功能的 Pull Request
- `Feature`: 为现有功能提供选项或加成的 Pull Request
- `i18n`: 更新了翻译的 Pull Request
- `Work in Progress`: 仍在进行改动和完善的 Pull Request
- `Skip Release`: 无需在 Release Note 中展现的 Pull Request
两者兼有：
- `Roadmap`: 与 NexT 主题发展相关的 Issue 或者 Pull Request
- `Help Wanted`: 需要帮助的 Issue 或者 Pull Request
- `Discussion`: 需要进行讨论的 Issue 或者 Pull Request
- `Improvement`: 需要改进的 Issue 或者改进了 NexT 主题的 Pull Request
- `Performance`: 提出性能问题的 Issue 或者提高了 NexT 主题性能的 Pull Request
- `Hexo`: 与 Hexo 和 Hexo 插件相关的 Issue 或者 Pull Request
- `Template Engine`: 与模版引擎相关的 Issue 或者 Pull Request
- `CSS`: 与 NexT 主题 CSS 文件相关的 Issue 或者 Pull Request
- `Fonts`: 与 NexT 主题字体相关的 Issue 或者 Pull Request
- `PJAX`: 与 PJAX 相关的 Issue 或者 Pull Request
- `3rd Party Plugin`: 与第三方插件和服务相关的 Issue 或者 Pull Request
- `Docs`: 与文档说明相关的 Issue 或者 Pull Request
- `Configurations`: 与 NexT 主题设置相关的 Issue 或者 Pull Request
### 提交信息规范
我们对项目的 git 提交信息格式进行统一格式约定，每条提交信息由 `type`+`subject` 组成，这将提升项目日志的可读性。
- `type` 用于表述此次提交信息的意义，首写字母大写，包括但不局限于如下类型：
* `Build`：基础构建系统或依赖库的变化
* `Ci`：CI 构建系统及其脚本变化
* `Docs`：文档内容变化
* `Feat`：新功能
* `Fix`：Bug 修复
* `Perf`：性能优化
* `Refactor`：重构（即不是新增功能，也不是修改 Bug 的代码变动）
* `Style`：格式（不影响代码运行的变动）
* `Revert`：代码回滚
* `Release`：版本发布
- `subject` 用于简要描述修改变更的内容，如 `Update code highlighting in readme.md`。
* 句尾不要使用符号。
* 使用现在时、祈使句语气。
================================================
FILE: docs/zh-CN/DATA-FILES.md
================================================
数据文件
目前，通过 pull 或下载新的 release 版本来更新 NexT 主题的体验并不平滑。当用户使用 `git pull` 更新 NexT 主题时经常需要解决冲突问题，而在手动下载 release 版本时也经常需要手动合并配置。
现在来说，NexT 推荐用户存储部分配置在 Hexo 站点配置文件（`/_config.yml`），而另一部分在主题配置文件（`/themes/next/_config.yml`）。这一方式固然可用，但也有一些缺点：
1. 配置项被分裂为两部分；
2. 用户难以弄清何处存放配置选项。
为了解决这一问题，NexT 提供了以下两种方案。
选择 1：Hexo 方式
使用这一方式，你的全部配置都将置于 Hexo 站点配置文件（`/_config.yml`），并且不需要修改 `/themes/next/_config.yml`，或者创建什么其他的文件。但是所有用到的主题选项必须放置在 `theme_config` 后，并全部增加两个空格的缩进。
如果在新的 release 中新增了选项，那么你只需要从 `/themes/next/_config.yml` 中将他们复制到 `/_config.yml` 中并将它们的值设置为你想要的。
### 用法
1. 请确认不存在 `/source/_data/next.yml` 文件（如果已存在，请删除）
2. 从主题的 `/themes/next/_config.yml` 文件中复制你需要的 NexT 配置项到 `/_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`），并且不需要修改 `/themes/next/_config.yml`。
但是可能无法让所有 Hexo 外部库都准确处理它们的附加选项（举个例子，`hexo-server` 模块只会从 Hexo 默认配置文件中读取选项）。
如果在新的 release 中出现了任何新的选项，那么你只需要从 `/themes/next/_config.yml` 中将他们复制到 `/source/_data/next.yml` 中并设置它们的值为你想要的选项。
这一方法依赖于 Hexo 的[数据文件](https://hexo.io/docs/data-files.html)特性。因为数据文件是在 Hexo 3 中被引入，所以你需要更新至 Hexo 3.0 以后的版本来使用这一特性。
### 用法
1. 请确认你的 Hexo 版本为 3.0 或更高。
2. 在你站点的 `/source/_data` 目录创建一个 `next.yml` 文件（如果 `_data` 目录不存在，请创建之）。
以上步骤之后有 两种选择，请任选其一然后继续后面的步骤。
* **选择 1：`override: false`（默认）**：
1. 检查默认 NexT 配置中的 `override` 选项，必须设置为 `false`。\
在 `next.yml` 文件中，也要设置为 `false`，或者不定义此选项。
2. 从站点配置文件（`/_config.yml`）与主题配置文件（`/themes/next/_config.yml`）中复制你需要的选项到 `/source/_data/next.yml` 中。
* **选择 2：`override: true`**：
1. 在 `next.yml` 中设置 `override` 选项为 `true`。
2. 从 `/themes/next/_config.yml` 配置文件中复制**所有**的 NexT 主题选项到 `/source/_data/next.yml` 中。
3. 然后，在站点的 `/_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)
================================================
FILE: docs/zh-CN/INSTALLATION.md
================================================
安装
步骤 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
================================================
FILE: docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md
================================================
修复 LeanCloud 统计插件安全漏洞
在配置前，请升级 NexT 至 **v6.0.6** 以上。
在配置过程中请注意**博客配置文件**和**主题配置文件**的区别。
---
# 注册 LeanCloud 并创建应用
- 首先，前往 LeanCloud 官网 [leancloud.cn](https://leancloud.cn) 进行注册，并登录。
请注意，目前华东节点和华北节点创建应用需要先在账号设置完成实名认证，并且官方表明“[在国内市场将只服务于可验证的商业客户](https://leancloudblog.com/domain-incident/)”；美国节点暂无上述要求，并且账号系统与华东节点和华北节点是独立的，如需使用请前往 LeanCloud 国际版官网 [leancloud.app](https://leancloud.app) 注册登录。
- 然后点击图示 `1` 处，进入控制台：
- 接着，点击图示 `1` 处，创建应用：
- 在弹出窗口 `1` 处输入应用名称（可随意输入，可更改，为演示方便取名为test），并选择 `2` 处“开发版”，然后点击 `3` 处创建：
到这里应用创建完成。
# 建立 Counter 类并在 NexT 中启用插件
- 点击 `1` 处应用名称进入应用管理界面：
- 如图，点击侧边栏 `1` 处创建 Class：
- 在弹出窗口 `1` 处填入 `Counter`，勾选 `2` 处无限制，并点击 `3` 处创建 Class：
- 此时类已创建完成。接下来点击图示 `1` 处进入设置，然后点击 `2` 处进入应用 Key：
- 粘贴 `App ID` 和 `App Key` 到 **NexT主题配置文件** `_config.yml` 对应位置。此时配置文件应如下：
```yml
leancloud_visitors:
enable: true
app_id: #
app_key: #
# Required for apps from CN region
server_url: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
```
- 设置Web安全域名确保域名调用安全。点击 `1` 处进入安全中心，然后在 `2` 处填写自己博客对应的域名（**注意协议、域名和端口号需严格一致**）：
到这里内容均与 Doublemine 的[为NexT主题添加文章阅读量统计功能](https://notes.wanghao.work/2015-10-21-%E4%B8%BANexT%E4%B8%BB%E9%A2%98%E6%B7%BB%E5%8A%A0%E6%96%87%E7%AB%A0%E9%98%85%E8%AF%BB%E9%87%8F%E7%BB%9F%E8%AE%A1%E5%8A%9F%E8%83%BD.html#%E9%85%8D%E7%BD%AELeanCloud)这篇文章相同，只不过截图为新版的Leancloud的界面。
# 部署云引擎以保证访客数量不被随意篡改
- 点击左侧 `1` 处云引擎，然后点击 `2` 处部署，再点击 `3` 处在线编辑：
- 点击 `1` 处创建函数：
- 在弹出窗口选择 `1` 处 `Hook` 类型，然后 `2` 处选择 `beforeUpdate`，`3` 处选择刚才建立的 `Counter` 类。在 `4` 中粘贴下方代码后，点 `5` 处保存。
```javascript
var query = new AV.Query("Counter");
if (request.object.updatedKeys.includes('time')) {
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();
});
}
```
如图所示：
- 点击保存后应出现类似红框处函数。此时点击 `1` 处部署：
- 在弹出窗口点击 `1` 处部署：
- 等待出现红框处的成功部署信息后，点击 `1` 处关闭：
至此云引擎已成功部署，任何非法的访客数量更改请求都将失败。
# 进一步设置权限
- 打开**NexT主题配置文件** `_config.yml`，将 `leancloud_visitors` 下的 `security` 设置为 `true`（如没有则新增）：
```yml
leancloud_visitors:
enable: true
app_id: #
app_key: #
# Required for apps from CN region
server_url: #
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security
security: true
```
- 打开 cmd 并切换至**博客根目录**，键入以下命令以安装 `hexo-leancloud-counter-security` 插件：
```
npm install hexo-leancloud-counter-security
```
- 打开**博客配置文件** `_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` 为例）：
- 点击 `1` 处进入 `Counter` 表，依次点击 `2` `3`，打开权限设置：
- 点击 `1` `add_field` 后选择 `2` 指定用户， 并将下两栏留空： 此处应与下条 `create` 设置相同（选择你所创建的用户）：
- 点击 `1` `create` 后选择 `2` 指定用户， 在 `3` 处键入用户名，点击 `4` 处后点击 `5` 处添加：
完成此步操作后，界面应与图示类似：
- 点击 `1` `delete` 后选择 `2` 指定用户， 并将下两栏留空：
至此权限已设置完成，数据库记录只能在本地增删。
每次运行 `hexo d` 部署的时候，插件都会扫描本地 `source/_posts` 下的文章并与数据库对比，然后在数据库创建没有录入数据库的文章记录。
如果在**博客配置文件**中留空 `username` 或 `password` ，则在部署过程中程序会要求输入。
---
原文链接：https://leaferx.online/2018/02/11/lc-security/
================================================
FILE: docs/zh-CN/MATH.md
================================================
数学公式
NexT 内部提供数学公式渲染的引擎，这样你就不需要自己手动在模板中引入 JS 或者 CSS；
只需要选择对应的渲染引擎，并在 `next/_config.yml` 中将其 `enable` 选项改为 `true` 即可。
需要注意的是，仅仅将 `enable` 打开**并不能让你看到数学公式**，你还需要**使用对应的 Hexo 渲染器(Renderer)** 才能真正在博客页面中显示出数学公式。引擎对应使用的 Hexo 渲染器会在引擎相关的部分介绍。
提供的渲染引擎
目前，NexT 提供两种数学公式渲染引擎，分别为 [MathJax](https://www.mathjax.org/) 和 [Katex](https://khan.github.io/KaTeX/)。
### MathJax
如果你选择使用 MathJax 进行数学公式渲染，你需要使用 [hexo-renderer-pandoc](https://github.com/wzpan/hexo-renderer-pandoc) 或者 [hexo-renderer-kramed](https://github.com/sun11/hexo-renderer-kramed) （不推荐）作为 Hexo 的 Markdown 渲染器。
首先，卸载原有的渲染器 `hexo-renderer-marked`，并安装这两种渲染器的**其中一个**：
```sh
npm uninstall hexo-renderer-marked
npm install hexo-renderer-pandoc # 或者 hexo-renderer-kramed
```
然后在 `next/_config.yml` 中将 `mathjax` 的 `enable` 打开。
```yml
math:
...
mathjax:
enable: true
```
执行 Hexo 生成，部署，或者启动服务器：
```sh
hexo clean && hexo g -d
# 或者 hexo clean && hexo s
```
#### 使用 MathJax 给公式编号并引用公式
在新版本的 NexT 主题中，我们加入了公式自动编号和引用功能。下面简要介绍一下如何使用这项功能。
为了使用这项功能，一般来说，你必须把所使用的 LaTeX 公式放在 `equation` 环境里面，采用旧的方法（也就是说，仅仅把公式的每一边用两个 $ 符号包含起来）是无效的。如何引用公式？你只需要在书写公式的时候给公式一个 `\label{}` 标记（tag），然后在正文中，可以使用 `\ref{}` 或者 `\eqref{}` 命令来引用对应的公式。使用 `\eqref{}` 是推荐的方式，因为如果你使用 `\ref{}`，公式在文中的引用编号将没有圆括号包围。下面介绍几种常见的公式编号例子。
对于简单的公式，使用下面的方式给公式一个标记，
```latex
$$\begin{equation}\label{eq1}
e=mc^2
\end{equation}$$
```
然后，在正文中，你可以轻松引用上述公式，一个简单的例子如下：
```
著名的质能方程 $\eqref{eq1}$ 由爱因斯坦提出 ...
```
对于多行公式，在 `equation` 环境中，你可以使用 `aligned` 环境把公式分成多行，
```latex
$$\begin{equation}\label{eq2}
\begin{aligned}
a &= b + c \\
&= d + e + f + g \\
&= h + i
\end{aligned}
\end{equation}$$
```
要对齐多个公式，我们需要使用 `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 关于公式编号的官方文档](https://docs.mathjax.org/en/latest/input/tex/eqnumbers.html)。同时，你也可以阅读 [这篇文档](https://theme-next.org/docs/third-party-services/math-equations) 来获取更多细节信息。
### 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 uninstall hexo-renderer-marked
npm install hexo-renderer-markdown-it-plus
# 或者 hexo-renderer-markdown-it
```
然后在 `next/_config.yml` 中将 `katex` 的 `enable` 打开。
```yml
math:
...
katex:
enable: true
```
执行 Hexo 生成，部署，或者启动服务器：
```sh
hexo clean && hexo g -d
# 或者 hexo clean && hexo s
```
#### 如果你使用 hexo-renderer-markdown-it
如果你使用 `hexo-renderer-markdown-it`，你还需要为其加上 `markdown-it-katex` 作为插件：
```
npm install markdown-it-katex
```
然后在 `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.11.1，这里面可能有某些问题是因为 Katex 版本老旧导致的；
但是，就像上面所说的，数学公式的渲染必须依靠渲染器来支持，目前的 Katex 相关的渲染器仅支持到 Katex 0.11.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 Formulas Render Support
math:
# Default (true) will load mathjax / katex script on demand.
# That is it only render those page which has `mathjax: true` in Front-matter.
# If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
per_page: true
# hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
mathjax:
enable: true
# See: https://mhchem.github.io/MathJax-mhchem/
mhchem: false
# hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin) required for full Katex support.
katex:
enable: false
# See: https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex
copy_tex: 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 来进行数学公式渲染。
================================================
FILE: docs/zh-CN/README.md
================================================
# e x T
«NexT» 是一款风格优雅的高质量 Hexo 主题，自点点滴滴中用爱雕琢而成。
## 即时预览
💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini
更多 «NexT» 的例子参见这里。
## 安装
最简单的安装方式是直接克隆整个仓库：
```sh
$ cd hexo
$ git clone https://github.com/theme-next/hexo-theme-next themes/next
```
此外，如果你想要使用其他方式，你也可以参见[详细安装步骤][docs-installation-url]。
## 插件
NexT 支持大量的第三方插件，它们可以被轻松地配置。
例如，你想要在你的站点中使用 `pjax` 插件，请进入 NexT 配置文件，启用 `pjax` 配置项：
```yml
# Easily enable fast Ajax navigation on your website.
# Dependencies: https://github.com/theme-next/theme-next-pjax
pjax: true
```
然后，打开它上面的 «Dependencies» 链接以查看它的安装步骤。
### 设置 CDN
如果你想要通过 CDN 来加载插件脚本，那么需要设置相关的 CDN 链接。
例如，你想要使用 `mediumzoom` 插件并通过 CDN 加载，进入 Next 配置文件并找到如下内容：
```yml
vendors:
# ...
# Some contents...
# ...
mediumzoom: # Set or update mediumzoom CDN URL.
```
## 更新
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 更新到最新版本，阅读[这篇文档][docs-update-5-1-x-url]。**
## 反馈
* 浏览 [Awesome NexT][awesome-next-url] 列表，与其它用户分享插件和教程。
* 加入我们的 [Telegram][t-chat-url] / [Gitter][gitter-url] / [Riot][riot-url] 聊天。
* 请花几秒钟来[添加或修正翻译][i18n-url]。
* 在 [GitHub Issues][issues-bug-url] 报告Bug。
* 在 [GitHub][issues-feat-url] 请求新的功能。
* 为 [受欢迎的 Feature request][feat-req-vote-url] 投票。
## 贡献你的代码
我们欢迎你加入 NexT 的开发，贡献出你的一份力量。请看[开源贡献指南][contributing-document-url]。 🤗
你也可以随时向我们的[官方插件][official-plugins-url]提交 Issue 或 Pull Request。
## 贡献者
[![][contributors-image]][contributors-url]
## 鸣谢
«NexT» 特别感谢这些支持我们核心基础设施的优质服务：
GitHub 容许我们托管 Git 仓库，Netlify 容许我们分发文档。
Crowdin 容许我们方便地翻译文档。
Codacy 容许我们监控代码质量，Travis CI 容许我们运行测试套件。
[docs-installation-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md
[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/DATA-FILES.md
[docs-update-5-1-x-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/UPDATE-FROM-5.1.X.md
[t-news-url]: https://t.me/theme_next_news
[t-chat-url]: https://t.me/theme_next_chinese
[gitter-url]: https://gitter.im/theme-next
[riot-url]: https://riot.im/app/#/room/#theme-next:matrix.org
[i18n-url]: https://i18n.theme-next.org
[awesome-next-url]: https://github.com/theme-next/awesome-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
[contributing-document-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/CONTRIBUTING.md
[official-plugins-url]: https://github.com/theme-next
[contributors-image]: https://opencollective.com/theme-next/contributors.svg?width=890
[contributors-url]: https://github.com/theme-next/hexo-theme-next/graphs/contributors
================================================
FILE: docs/zh-CN/UPDATE-FROM-5.1.X.md
================================================
从 NexT v5.1.x 更新
在使用 Hexo 3 时，NexT V5 版本仍然能够正常运行，但是如果你想获得更多的功能和帮助，还是建议您升级到 NexT V7+ 版本，并移步 [Theme-Next](https://github.com/theme-next/hexo-theme-next) 仓库。
在 5.1.x 版本和新版本之间没有很大的革命性改进。主版本号变更至 7 主要是因为：
1. 主仓库已从 [iissnan 名下](https://github.com/iissnan/hexo-theme-next) 迁移至 [theme-next](https://github.com/theme-next) 组织。
2. `next/source/lib` 目录下的绝大多数库被移出到了 [NexT 组织的外部仓库](https://github.com/theme-next)中。
3. 第三方插件 [`hexo-wordcount`](https://github.com/willin/hexo-wordcount) 被 [`hexo-symbols-count-time`](https://github.com/theme-next/hexo-symbols-count-time) 所取代，因为 `hexo-symbols-count-time` 没有任何外部 Node.js 依赖、也没有会导致生成站点时的性能问题 [language filter](https://github.com/willin/hexo-wordcount/issues/7)。
我们推荐通过如下步骤从 v5 升级到 v7：
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. 克隆新的仓库到任一异于 `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 及以后版本的用户，需要显式修改 Hexo 主配置文件 `_config.yml` 里的 `language` 配置，否则语言显示不正确。
5. 更新 Hexo 和 Hexo 插件
如果完成了以上步骤后，执行 `hexo s` 或 `hexo g` 出现错误，这意味着可能是旧版的 Hexo 和 Hexo 插件与新版的 NexT 主题产生了冲突。我们建议将 Hexo 升级至 4.0 以上的版本，将 Hexo 插件升级到最新版本。你可以执行 `npm outdated` 查看所有可以升级的插件。
关于第三方库的启用，参见[这里](https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/INSTALLATION.md#插件)。
================================================
FILE: gulpfile.js
================================================
const fs = require('fs');
const path = require('path');
const gulp = require('gulp');
const eslint = require('gulp-eslint');
const shell = require('gulp-shell');
const yaml = require('js-yaml');
gulp.task('lint', () => gulp.src([
'./source/js/**/*.js',
'./scripts/**/*.js'
]).pipe(eslint())
.pipe(eslint.format()));
gulp.task('lint:stylus', shell.task([
'npx stylint ./source/css/'
]));
gulp.task('validate:config', cb => {
const themeConfig = fs.readFileSync(path.join(__dirname, '_config.yml'));
try {
yaml.safeLoad(themeConfig);
return cb();
} catch (error) {
return cb(new Error(error));
}
});
gulp.task('validate:languages', cb => {
const languagesPath = path.join(__dirname, 'languages');
const languages = fs.readdirSync(languagesPath);
const errors = [];
languages.forEach(lang => {
const languagePath = path.join(languagesPath, lang);
try {
yaml.safeLoad(fs.readFileSync(languagePath), {
filename: path.relative(__dirname, languagePath)
});
} catch (error) {
errors.push(error);
}
});
return errors.length === 0 ? cb() : cb(errors);
});
gulp.task('default', gulp.series('lint', 'validate:config', 'validate:languages'));
================================================
FILE: languages/ar.yml
================================================
---
name: عربي
title:
archive: الأرشيف
category: تصنيف
tag: وسم
schedule: التقويم
menu:
home: Home
archives: الأرشيفات
categories: التصنيفات
tags: الوسوم
about: معلومات
search: بحث
schedule: التقويم
sitemap: خريطة الموقع
commonweal: Commonweal 404
sidebar:
overview: عام
toc: المحتويات
post:
posted: نُشر في
edited: عُدل في
created: أُنشأ
modified: عُدل
edit: تحرير هذا المقال
in: في
read_more: تابع القراءة
untitled: بدون عنوان
sticky: مثبت
views: مشاهدات
related_posts: مقالات مشابهة
copyright:
author: مؤلف المقال
link: رابط المقال
license_title: حقوق الملكية
license_content: "حميع المقالات في هذه المدوّنة منشورة تحت رخصة %s إلا عند التنويه بخلافه."
footer:
powered: "تطبيق الموقع %s"
total_views: إجمالي المشاهدات
total_visitors: إجمالي الزوار
counter:
tag_cloud:
zero: لا وسوم
one: وسمٌ واحدٌ
other: "%d وسماً بالمُجمل"
categories:
zero: لا تصنيفات
one: تصنيفٌ واحد
other: "%d تصنيفات بالمُجمل"
archive_posts:
zero: لا مقالات.
one: مقالٌ واحد.
other: "%d مقالاً بالمُجمل."
state:
posts: المقالات
tags: الوسوم
categories: التصنيفات
search:
placeholder: بحث...
cheers:
um: هِم..
ok: حسناً
nice: جميل
good: جيد
great: عظيم
excellent: ممتاز
keep_on: واصل الكتابة.
symbol:
comma: "، "
period: ". "
colon: ": "
reward:
donate: تبرّع
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: مرحباً بك حيثُ أنشر أيضاً
accessibility:
nav_toggle: تشغيل شريط التصفح
prev_page: الصفحة السابقة
next_page: الصفحة التالية
symbols_count_time:
count: عدد الحروف في المقال
count_total: مُجمل عدد الحروف
time: زمن القراءة
time_total: مُجمل زمن القراءة
time_minutes: دقائق.
================================================
FILE: languages/de.yml
================================================
---
name: Deutsch
title:
archive: Archiv
category: Kategorie
tag: Schlagwort
schedule: Zeitplan
menu:
home: Startseite
archives: Archiv
categories: Kategorien
tags: Schlagwörter
about: Über
search: Suche
schedule: Zeitplan
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Übersicht
toc: Inhaltsverzeichnis
post:
posted: Veröffentlicht am
edited: Bearbeitet am
created: Erstellt
modified: Geändert am
edit: Diesen Beitrag bearbeiten
in: in
read_more: Weiterlesen
untitled: Unbenannt
sticky: Angepinnt
views: Aufrufe
related_posts: Ähnliche Beiträge
copyright:
author: Beitragsautor
link: Beitragslink
license_title: Urheberrechtshinweis
license_content: "Alle Artikel in diesem Blog sind unter %s lizenziert, außer es wird anders angegeben."
footer:
powered: "Erstellt mit %s"
total_views: Alle Aufrufe
total_visitors: Alle Besucher
counter:
tag_cloud:
zero: Keine Schlagworte
one: Insgesamt ein Schlagwort
other: "Insgesamt %d Schlagwörter"
categories:
zero: Keine Kategorien
one: Insgesamt eine Kategorie
other: "Insgesamt %d Kategorien"
archive_posts:
zero: Keine Artikel vorhanden.
one: Ein Artikel.
other: "Insgesamt %d Artikel."
state:
posts: Artikel
tags: schlagwörter
categories: Kategorien
search:
placeholder: Suche...
cheers:
um: Öhm..
ok: OK
nice: Schön
good: Gut
great: Wunderbar
excellent: Exzellent
keep_on: Bleib dran.
symbol:
comma: ". "
period: ", "
colon: ": "
reward:
donate: Spenden
wechatpay: WeChat Bezahlung
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Navigationsleiste an/ausschalten
prev_page: Vorherige Seite
next_page: Nächste Seite
symbols_count_time:
count: Symbole im Artikel gezählt
count_total: Insgesamt gezählte Symbole
time: Lesezeit
time_total: Insgesamte Lesezeit
time_minutes: minuten.
================================================
FILE: languages/en.yml
================================================
name: English
title:
archive: Archive
category: Category
tag: Tag
schedule: Schedule
menu:
home: Home
archives: Archives
categories: Categories
tags: Tags
about: About
search: Search
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Overview
toc: Table of Contents
post:
posted: Posted on
edited: Edited on
created: Created
modified: Modified
edit: Edit this post
in: In
read_more: Read more
untitled: Untitled
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Powered by %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: No tags
one: 1 tag in total
other: "%d tags in total"
categories:
zero: No categories
one: 1 category in total
other: "%d categories in total"
archive_posts:
zero: No posts.
one: 1 post.
other: "%d posts in total."
state:
posts: posts
tags: tags
categories: categories
search:
placeholder: Searching...
cheers:
um: Um..
ok: OK
nice: Nice
good: Good
great: Great
excellent: Excellent
keep_on: Keep on posting.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Previous page
next_page: Next page
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/es.yml
================================================
---
name: Español
title:
archive: Archivo
category: Categoría
tag: Etiqueta
schedule: Calendario
menu:
home: Inicio
archives: Archivo
categories: Categorías
tags: Etiquetas
about: Sobre mi
search: Buscar
schedule: Calendario
sitemap: Mapa del sitio
commonweal: Commonweal 404
sidebar:
overview: Inicio
toc: Tabla de contenidos
post:
posted: Publicado el
edited: Editado el
created: Creado por
modified: Modificado por
edit: Editar esta entrada
in: En
read_more: Leer más
untitled: Sin título
sticky: Sticky
views: Visitas
related_posts: Entradas relacionadas
copyright:
author: Autor de la entrada
link: Enlace a la entrada
license_title: Copyright
license_content: "Todos los artículos de este blog están licenciados bajo %s a no ser que se especifique una licencia adicional."
footer:
powered: "Creado mediante %s"
total_views: Visitas totales
total_visitors: Visitantes totales
counter:
tag_cloud:
zero: Sin etiquetas
one: 1 etiqueta en total
other: "%d etiquetas en total"
categories:
zero: Sin categorías
one: 1 categoría en total
other: "%d categorías en total"
archive_posts:
zero: Sin entradas.
one: 1 entrada.
other: "%d entradas en total."
state:
posts: entradas
tags: tags
categories: categorías
search:
placeholder: Buscando...
cheers:
um: Um..
ok: Bueno
nice: Guai
good: Bien
great: Genial
excellent: Excelente
keep_on: Sigue posteando.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donar
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Cambiar a barra de navegación
prev_page: Página anterior
next_page: Página siguiente
symbols_count_time:
count: Cantidad de caracteres en el articulo
count_total: Cantidad total de caracteres
time: Tiempo de lectura
time_total: Tiempo total de lectura
time_minutes: minutos.
================================================
FILE: languages/fa.yml
================================================
---
name: فارسی
title:
archive: بایگانی
category: دسته بندی
tag: برچسب
schedule: زمان بندی
menu:
home: صفحه اصلی
archives: بایگانی
categories: دسته بندی ها
tags: برچسب ها
about: درباره
search: جستجو
schedule: زمان بندی
sitemap: نقشه سایت
commonweal: Commonweal 404
sidebar:
overview: نمای کلی
toc: فهرست مطالب
post:
posted: نوشته شده در
edited: ویرایش شده در
created: ایجاد شده
modified: تغییر یافته
edit: ویرایش این پست
in: در
read_more: ادامه مطلب
untitled: بدون عنوان
sticky: چسبنده
views: بازدیدها
related_posts: پست های مرتبط
copyright:
author: نویسنده پست
link: لینک پست
license_title: مقررات کپی رایت
license_content: "همه مقالات در این وبلاگ تحت %s مجاز می باشند مگر اینکه به طور اضافی بیان شوند."
footer:
powered: "قدرت گرفته از %s"
total_views: مجموع بازدیدها
total_visitors: تعداد بازدید کنندگان
counter:
tag_cloud:
zero: بدون برچسب
one: 1 برچسب در مجموع
other: "%d برچسب در مجموع"
categories:
zero: بدون دسته بندی
one: 1 دسته بندی در مجموع
other: "%d دسته بندی در مجموع"
archive_posts:
zero: بدون پست.
one: 1 پست.
other: "%d برچسب در مجموع."
state:
posts: پست ها
tags: برجسب ها
categories: دسته بندی ها
search:
placeholder: جستجو...
cheers:
um: ام...
ok: باشه
nice: زیبا
good: خوب
great: عالی
excellent: بسیار عالی
keep_on: به پست دادن ادامه دهید.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: کمک مالی
wechatpay: پرداخت WeChat
alipay: AliPay
paypal: PayPal
bitcoin: بیت کوین
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: تغییر ناوبری
prev_page: صفحه قبلی
next_page: صفحه بعدی
symbols_count_time:
count: تعداد نمادها در مقاله
count_total: تعداد کل نمادها
time: زمان خواندن
time_total: کل زمان خواندن
time_minutes: دقیقه.
================================================
FILE: languages/fr.yml
================================================
---
name: Français
title:
archive: Archive
category: Catégorie
tag: Mots clés
schedule: Plannifier
menu:
home: Accueil
archives: Archives
categories: Catégories
tags: Mots clés
about: À propos
search: Recherche
schedule: Plannifier
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Aperçu
toc: Table Des Matières
post:
posted: Posté le
edited: Édité le
created: Article créé le
modified: Mis à jour le
edit: Éditer cet article
in: dans
read_more: Lire la suite
untitled: Sans titre
sticky: Épingler
views: Vues
related_posts: Articles similaires
copyright:
author: Auteur de l'article
link: Lien de l'article
license_title: Droit d'auteur
license_content: "Tous les articles de ce blog sont sous licence %s, sauf mention contraire."
footer:
powered: "Propulsé par %s"
total_views: Vues totales
total_visitors: Total visiteurs
counter:
tag_cloud:
zero: Aucun tag
one: 1 tag au total
other: "%d tags au total"
categories:
zero: Aucune categorie
one: 1 catégorie au total
other: "%d catégories au total"
archive_posts:
zero: Aucun article.
one: 1 article.
other: "%d articles au total."
state:
posts: articles
tags: mots clé
categories: catégories
search:
placeholder: Recherche...
cheers:
um: Um..
ok: OK
nice: Jolie
good: Bien
great: Super
excellent: Excellent
keep_on: Continue comme ça.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donner
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Basculer la barre de navigation
prev_page: Page précédente
next_page: Page suivante
symbols_count_time:
count: Caractères dans l'article
count_total: Caractères total
time: Temps de lecture
time_total: Temps total de lecture
time_minutes: mins.
================================================
FILE: languages/hu.yml
================================================
---
name: magyar
title:
archive: Archive
category: Category
tag: Tag
schedule: Ütemterv
menu:
home: Home
archives: Archives
categories: Categories
tags: Tags
about: About
search: Search
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Overview
toc: Table of Contents
post:
posted: Posted on
edited: Edited on
created: Created
modified: Modified
edit: Edit this post
in: In
read_more: Read more
untitled: Untitled
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Powered by %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: No tags
one: 1 tag in total
other: "%d tags in total"
categories:
zero: No categories
one: 1 category in total
other: "%d categories in total"
archive_posts:
zero: No posts.
one: 1 post.
other: "%d posts in total."
state:
posts: posts
tags: tags
categories: categories
search:
placeholder: Searching...
cheers:
um: Um..
ok: OK
nice: Nice
good: Good
great: Great
excellent: Excellent
keep_on: Keep on posting.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Previous page
next_page: Next page
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/id.yml
================================================
---
name: Bahasa Indonesia
title:
archive: Arsip
category: Kategori
tag: Tag
schedule: Schedule
menu:
home: Beranda
archives: Arsip
categories: Kategori
tags: Tags
about: Tentang
search: Pencarian
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Ikhtisar
toc: Daftar Isi
post:
posted: Diposting di
edited: Edited on
created: Post created
modified: Updated at
edit: Edit this post
in: Di
read_more: Baca lebih
untitled: Tidak ada title
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Powered by %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: Tidak ada tags
one: 1 total tag
other: "%d total tags"
categories:
zero: Tidak ada kategori
one: 1 total categori
other: "%d total kategori"
archive_posts:
zero: Tidak ada posting.
one: 1 posting.
other: "%d total posting."
state:
posts: posting
tags: tags
categories: kategori
search:
placeholder: Searching...
cheers:
um: Um..
ok: OK
nice: Bagus
good: Bagus
great: Besar
excellent: Baik
keep_on: Terus Posting.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Halaman sebelumnya
next_page: Halaman selanjutnya
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/it.yml
================================================
---
name: Italiano
title:
archive: Archivio
category: Categoria
tag: Tag
schedule: Programma
menu:
home: Home
archives: Archivi
categories: Categorie
tags: Tags
about: Informazioni su
search: Cerca
schedule: Programma
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Panoramica
toc: Indice
post:
posted: Scritto il
edited: Edited on
created: Post creato
modified: Post modificato
edit: Edit this post
in: In
read_more: Leggi di più
untitled: Senza titolo
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Autore
link: Link
license_title: Copyright
license_content: "Tutti gli articoli in questo sito sono sotto licenza %s salvo disposizione contraria."
footer:
powered: "Powered by %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: Nessun tag
one: 1 tag in totale
other: "%d tags in totale."
categories:
zero: Nessuna categoria
one: 1 categoria in totale
other: "%d categorie in totale."
archive_posts:
zero: Nessun post.
one: 1 post.
other: "%d posts in totale."
state:
posts: posts
tags: tags
categories: categorie
search:
placeholder: Cerca...
cheers:
um: Mh..
ok: OK
nice: Bello
good: Buono
great: Ottimo
excellent: Eccellente
keep_on: Continua così.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Dona
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Pagina precedente
next_page: Pagina successiva
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/ja.yml
================================================
---
name: 日本語
title:
archive: アーカイブ
category: カテゴリ
tag: タグ
schedule: スケジュール
menu:
home: ホーム
archives: アーカイブ
categories: カテゴリ
tags: タグ
about: プロフィール
search: 検索
schedule: スケジュール
sitemap: サイトマップ
commonweal: 公益 404
sidebar:
overview: 概要
toc: 見出し
post:
posted: 投稿日
edited: 編集日
created: 作成日
modified: 修正日
edit: この記事を編集する
in: カテゴリ
read_more: 続きを読む
untitled: 無題
sticky: 固定
views: 閲覧数
related_posts: 関連記事
copyright:
author: 著者
link: 記事へのリンク
license_title: 著作権表示
license_content: "このブログ内のすべての記事は、特別な記載がない限り %s の下のライセンスで保護されています。"
footer:
powered: "Powered by %s"
total_views: 閲覧合計数
total_visitors: 合計閲覧者数
counter:
tag_cloud:
zero: タグなし
one: 全 1 タグ
other: "全 %d タグ"
categories:
zero: カテゴリなし
one: 全 1 カテゴリ
other: "全 %d カテゴリ"
archive_posts:
zero: ポストなし
one: 全 1 ポスト
other: "全 %d ポスト"
state:
posts: ポスト
tags: タグ
categories: カテゴリ
search:
placeholder: 検索…
cheers:
um: うーん
ok: はい
nice: まあまあ
good: いいね
great: すごい
excellent: 最高
keep_on: もっと書こう！
symbol:
comma: "、"
period: "。"
colon: "："
reward:
donate: 寄付
wechatpay: WeChat 支払う
alipay: Alipay
paypal: PayPal
bitcoin: ビットコイン
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: ナビゲーションバーの切り替え
prev_page: 前のページ
next_page: 次のページ
symbols_count_time:
count: 単語数
count_total: 単語の総数
time: 読書の時間
time_total: 読書の合計時間
time_minutes: 分
================================================
FILE: languages/ko.yml
================================================
---
name: 한국어
title:
archive: 아카이브
category: 카테고리
tag: 태그
schedule: Schedule
menu:
home: 홈
archives: 아카이브
categories: 카테고리
tags: 태그
about: About
search: 검색
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: 흝어보기
toc: 목차
post:
posted: 작성일
edited: Edited on
created: Post created
modified: Updated at
edit: Edit this post
in: In
read_more: 더 읽어보기
untitled: 제목 없음
sticky: 고정
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Powered by %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: 태그 없음
one: 1개의 태그
other: "총 %d개의 태그"
categories:
zero: 카테고리 없음
one: 1개의 카테고리
other: "총 %d개의 카테고리"
archive_posts:
zero: 포스트 없음
one: 1개의 포스트
other: "총 %d개의 포스트"
state:
posts: 포스트
tags: 태그
categories: 카테고리
search:
placeholder: Searching...
cheers:
um: 음..
ok: OK
nice: 잘했어요
good: 좋아요
great: 훌륭해요
excellent: 완벽해요
keep_on: 포스트를 마저 작성하세요
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: 이전 페이지
next_page: 다음 페이지
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/nl.yml
================================================
---
name: Niederländisch
title:
archive: Archief
category: Categorie
tag: Label
schedule: Rooster
menu:
home: Home
archives: Archieven
categories: Categorieën
tags: Labels
about: Over
search: Zoeken
schedule: Rooster
sitemap: Sitemap
commonweal: Gezond verstand 404
sidebar:
overview: Overzicht
toc: Inhoudsopgave
post:
posted: Geplaatst op
edited: Edited on
created: Post aangemaakt
modified: Post aangepast
edit: Edit this post
in: In
read_more: Lees meer
untitled: Naamloos
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post auteur
link: Post link
license_title: Copyright melding
license_content: "Alle artikelen op deze blog zijn gelicenseerd onder %s, mits niet anders aangegeven."
footer:
powered: "Mede mogelijk gemaakt door %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: Geen labels
one: 1 label in totaal
other: "%d labels in totaal"
categories:
zero: Geen categorieën
one: 1 categorie in totaal
other: "%d categorieën in totaal"
archive_posts:
zero: Geen posts.
one: 1 post.
other: "%d posts in totaal."
state:
posts: posts
tags: labels
categories: categorieën
search:
placeholder: Zoeken...
cheers:
um: Um..
ok: Oké
nice: Leuk
good: Goed
great: Geweldig
excellent: Uitstekend
keep_on: Blijf posten.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Doneer
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Vorige pagina
next_page: Volgende pagina
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/pt-BR.yml
================================================
---
name: Português
title:
archive: Arquivo
category: Categoria
tag: Tag
schedule: Schedule
menu:
home: Home
archives: Arquivos
categories: Categorias
tags: Tags
about: Sobre
search: Pesquisar
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Visão geral
toc: Tabela de conteúdo
post:
posted: Postado em
edited: Edited on
created: Post created
modified: Updated at
edit: Edit this post
in: Em
read_more: Leia mais
untitled: Sem título
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Feito com %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: Sem tags
one: 1 tag no total de
other: "%d tags no total de"
categories:
zero: Sem categoria
one: 1 categoria no total de
other: "%d categoria no total de"
archive_posts:
zero: Sem posts.
one: 1 post.
other: "%d posts no total."
state:
posts: Posts
tags: Tags
categories: Categorias
search:
placeholder: Searching...
cheers:
um: Uhmmmm...
ok: OK
nice: Bom
good: Muito Bom
great: Ótimo
excellent: Excelente
keep_on: Continuar no post.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Página anterior
next_page: Próxima página
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/pt.yml
================================================
---
name: Português
title:
archive: Arquivo
category: Categoria
tag: Tag
schedule: Schedule
menu:
home: Home
archives: Arquivos
categories: Categorias
tags: Tags
about: Sobre
search: Pesquisa
schedule: Schedule
sitemap: Sitemap
commonweal: Commonweal 404
sidebar:
overview: Visão Geral
toc: Tabela de Conteúdo
post:
posted: Postado em
edited: Edited on
created: Post created
modified: Updated at
edit: Edit this post
in: Em
read_more: Ler mais
untitled: Sem título
sticky: Sticky
views: Views
related_posts: Related Posts
copyright:
author: Post author
link: Post link
license_title: Copyright Notice
license_content: "All articles in this blog are licensed under %s unless stating additionally."
footer:
powered: "Desenvolvido com amor com %s"
total_views: Total Views
total_visitors: Total Visitors
counter:
tag_cloud:
zero: Sem tags
one: 1 tag no total
other: "%d tags no total"
categories:
zero: Sem categorias
one: 1 categoria no total
other: "%d categorias no total"
archive_posts:
zero: Sem publicações.
one: 1 post.
other: "%d publicações no total."
state:
posts: publicações
tags: tags
categories: categorias
search:
placeholder: Searching...
cheers:
um: Um..
ok: OK
nice: Legal
good: Bom
great: Grandioso
excellent: Excelente
keep_on: Mantenha-se publicando!
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Donate
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Toggle navigation bar
prev_page: Página anterior
next_page: Página seguinte
symbols_count_time:
count: Symbols count in article
count_total: Symbols count total
time: Reading time
time_total: Reading time total
time_minutes: mins.
================================================
FILE: languages/ru.yml
================================================
---
name: Русский
title:
archive: Архив
category: Категория
tag: Тэг
schedule: Календарь
menu:
home: Главная
archives: Архив
categories: Категории
tags: Тэги
about: О сайте
search: Поиск
schedule: Календарь
sitemap: Карта сайта
commonweal: Страница 404
sidebar:
overview: Обзор
toc: Содержание
post:
posted: Размещено
edited: Изменено
created: Создано
modified: Изменено
edit: Редактировать запись
in: в категории
read_more: Читать полностью
untitled: Без имени
sticky: Ссылка
views: Просмотров
related_posts: Похожие записи
copyright:
author: Автор записи
link: Ссылка на запись
license_title: Информация об авторских правах
license_content: "Все записи на этом сайте защищены лицензией %s, если не указано дополнительно."
footer:
powered: "Генератор — %s"
total_views: Всего просмотров
total_visitors: Всего посетителей
counter:
tag_cloud:
zero: Нет тэгов.
one: 1 тэг.
other: "%d тэгов всего."
categories:
zero: Нет категорий.
one: 1 категория.
other: "%d категорий всего."
archive_posts:
zero: Нет записей.
one: 1 запись.
other: "%d записей всего."
state:
posts: Архив
tags: Тэги
categories: Категории
search:
placeholder: Поиск...
cheers:
um: Эм..
ok: OK
nice: Неплохо
good: Хорошо
great: Замечательно
excellent: Великолепно
keep_on: Продолжаю писать.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Донат
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Добро пожаловать на другие мои издательские каналы
accessibility:
nav_toggle: Показать/скрыть меню
prev_page: Предыдущая страница
next_page: Следующая страница
symbols_count_time:
count: Кол-во символов в статье
count_total: Общее кол-во символов
time: Время чтения
time_total: Общее время чтения
time_minutes: мин.
================================================
FILE: languages/tr.yml
================================================
---
name: Türk
title:
archive: Arşiv
category: Kategori
tag: Etiket
schedule: Program
menu:
home: Ana Sayfa
archives: Arşivler
categories: Kategoriler
tags: Etiketler
about: Hakkımda
search: Ara
schedule: Program
sitemap: Site Haritası
commonweal: Hata 404
sidebar:
overview: Genel Bakış
toc: İçindekiler
post:
posted: Yayınlandı
edited: Düzenlendi
created: Oluşturuldu
modified: Değiştirildi
edit: Bu gönderiyi düzenle
in: İçinde
read_more: Daha fazla oku
untitled: Başlıksız
sticky: Sabit
views: Görünümler
related_posts: İlgili Gönderiler
copyright:
author: Gönderiyi yazan
link: Gönderi bağlantısı
license_title: Telif Hakkı Bildirimi
license_content: "Bu blogdaki tüm makaleler aksi belirtilmediği sürece %s altında lisanslıdır."
footer:
powered: "%s tarafından desteklenmektedir"
total_views: Toplam görüntülenme
total_visitors: Toplam Ziyaretçi
counter:
tag_cloud:
zero: Etiket yok
one: Toplam 1 etiket
other: "Toplamda %d etiket"
categories:
zero: Kategori yok
one: Toplamda 1 kategori
other: "Toplamda %d kategori"
archive_posts:
zero: Gönderi yok.
one: 1 gönderi.
other: "Toplamda %d gönderi."
state:
posts: gönderiler
tags: etiketler
categories: kategoriler
search:
placeholder: Aranıyor...
cheers:
um: Um..
ok: Tamam
nice: Güzel
good: İyi
great: Müthiş
excellent: Mükemmel
keep_on: Gönderiye devam.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Bağış
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Welcome to my other publishing channels
accessibility:
nav_toggle: Gezinti çubuğunu değiştir
prev_page: Önceki sayfa
next_page: Sonraki sayfa
symbols_count_time:
count: Makalede sayılan semboller
count_total: Sayılan toplam semboller
time: Okuma Süresi
time_total: Toplamda Okuma Süresi
time_minutes: dk.
================================================
FILE: languages/uk.yml
================================================
---
name: Український
title:
archive: Архів
category: Категорія
tag: Тег
schedule: Календар
menu:
home: Головна
archives: Архів
categories: Категорії
tags: Теги
about: Про сайт
search: Пошук
schedule: Календар
sitemap: Карта сайту
commonweal: Сторінка 404
sidebar:
overview: Огляд
toc: Зміст
post:
posted: Опубліковано
edited: Змінено
created: Створено
modified: Змінено
edit: Редагувати запис
in: в категорії
read_more: Читати повністю
untitled: Без імені
sticky: Посилання
views: Переглядів
related_posts: Схожі записи
copyright:
author: Автор запису
link: Посилання на запис
license_title: Інформація про авторські права
license_content: "Всі записи на цьому сайті захищені ліцензією %s, якщо не вказано додатково."
footer:
powered: "Генератор — %s"
total_views: Всього переглядів
total_visitors: Всього відвідувачів
counter:
tag_cloud:
zero: Немає тегів.
one: 1 тег.
other: "%d тегів всього."
categories:
zero: Немає категорій.
one: 1 категорія.
other: "%d категорій всього."
archive_posts:
zero: Немає записів.
one: 1 запис.
other: "%d записів всього."
state:
posts: Архів
tags: Теги
categories: Категорії
search:
placeholder: Пошук...
cheers:
um: Ем..
ok: ОК
nice: Не погано
good: Добре
great: Чудово
excellent: Прекрасно
keep_on: Продовжую писати.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Донат
wechatpay: WeChat Pay
alipay: Alipay
paypal: PayPal
bitcoin: Bitcoin
follow_me:
welcome: Мої інші видавничі канали
accessibility:
nav_toggle: Показати/приховати меню
prev_page: Попередня сторінка
next_page: Наступна сторінка
symbols_count_time:
count: К-сть символів в статті
count_total: Загальна к-сть символів
time: Час читання
time_total: Загальний час читання
time_minutes: хв.
================================================
FILE: languages/vi.yml
================================================
---
name: Tiếng Việt
title:
archive: Lưu Trữ
category: Phân Loại
tag: Thẻ
schedule: Danh Mục
menu:
home: Trang Chủ
archives: Lưu Trữ
categories: Đầu Mục
tags: Thẻ
about: Giới Thiệu
search: Tìm Kiếm
schedule: Danh Mục
sitemap: Bản đồ trang
commonweal: Commonwealth Act No. 404
sidebar:
overview: Tổng Quan
toc: Mục Lục
post:
posted: Tạo lúc
edited: Chỉnh sửa vào
created: Được tạo
modified: Được thay đổi
edit: Chính sửa bài viết này
in: Trong
read_more: Đọc tiếp
untitled: Không có tiêu đề
sticky: Đính
views: Lượt xem
related_posts: Các bài viết liên quan
copyright:
author: Người viết
link: Liên kết bài viết
license_title: Chú ý bản quyền
license_content: "Tất cả bài viết trong blog này được đăng ký bởi %s trừ khi có thông báo bổ sung."
footer:
powered: "Cung cấp bởi %s"
total_views: Tổng số người xem
total_visitors: Tổng số truy cập
counter:
tag_cloud:
zero: Không có thẻ nào
one: có 1 thẻ tất cả
other: "có %d thẻ tất cả"
categories:
zero: Không có trong mục nào
one: có 1 mục tất cả
other: "có %d mục tất cả"
archive_posts:
zero: Không có bài viết.
one: 1 bài viết.
other: "tổng số %d bài viết."
state:
posts: bài viết
tags: thẻ
categories: mục
search:
placeholder: Đang tìm...
cheers:
um: Um..
ok: Đồng Ý
nice: Hay
good: Tốt
great: Tuyệt vời
excellent: Tuyệt cú mèo
keep_on: Giữ tiến độ nha.
symbol:
comma: ", "
period: ". "
colon: ": "
reward:
donate: Tài trợ
wechatpay: WeChat Pay
alipay: Alipay
paypal: Paypal
bitcoin: Bitcoin
follow_me:
welcome: Xin chào mừng đến với các kênh khác của tôi
accessibility:
nav_toggle: Thanh điều hướng chuyển đổi
prev_page: Trang trước
next_page: Trang sau
symbols_count_time:
count: Số biểu tượng trong bài viết
count_total: Tổng số biểu tượng
time: Thời lượng đọc
time_total: Tổng thời lượng đọc
time_minutes: phút.
================================================
FILE: languages/zh-CN.yml
================================================
---
name: 简体中文
title:
archive: 归档
category: 分类
tag: 标签
schedule: 日程表
menu:
home: 首页
archives: 归档
categories: 分类
tags: 标签
about: 关于
search: 搜索
schedule: 日程表
sitemap: 站点地图
commonweal: 公益 404
sidebar:
overview: 站点概览
toc: 文章目录
post:
posted: 发表于
edited: 更新于
created: 创建时间
modified: 修改时间
edit: 编辑
in: 分类于
read_more: 阅读全文
untitled: 未命名
sticky: 置顶
views: 阅读次数
related_posts: 相关文章
copyright:
author: 本文作者
link: 本文链接
license_title: 版权声明
license_content: "本博客所有文章除特别声明外，均采用 %s 许可协议。转载请注明出处！"
footer:
powered: "由 %s 强力驱动"
total_views: 总访问量
total_visitors: 总访客量
counter:
tag_cloud:
zero: 暂无标签
one: 目前共计 1 个标签
other: "目前共计 %d 个标签"
categories:
zero: 暂无分类
one: 目前共计 1 个分类
other: "目前共计 %d 个分类"
archive_posts:
zero: 暂无日志。
one: 目前共计 1 篇日志。
other: "目前共计 %d 篇日志。"
state:
posts: 日志
tags: 标签
categories: 分类
search:
placeholder: 搜索...
cheers:
um: 嗯..
ok: 还行
nice: 不错
good: 很好
great: 非常好
excellent: 太棒了
keep_on: 继续努力。
symbol:
comma: "，"
period: "。"
colon: "："
reward:
donate: 打赏
wechatpay: 微信支付
alipay: 支付宝
paypal: 贝宝
bitcoin: 比特币
follow_me:
welcome: 欢迎关注我的其它发布渠道
accessibility:
nav_toggle: 切换导航栏
prev_page: 上一页
next_page: 下一页
symbols_count_time:
count: 本文字数
count_total: 站点总字数
time: 阅读时长
time_total: 站点阅读时长
time_minutes: 分钟
================================================
FILE: languages/zh-HK.yml
================================================
---
name: 繁體中文（香港）
title:
archive: 歸檔
category: 分類
tag: 標籤
schedule: 日程表
menu:
home: 首頁
archives: 歸檔
categories: 分類
tags: 標籤
about: 關於
search: 檢索
schedule: 日程表
sitemap: 站點地圖
commonweal: 公益 404
sidebar:
overview: 本站概覽
toc: 文章目錄
post:
posted: 發表於
edited: 更新於
created: 創建時間
modified: 修改時間
edit: 編輯
in: 分類於
read_more: 閱讀全文
untitled: 未命名
sticky: 置頂
views: 閱讀次數
related_posts: 相關文章
copyright:
author: 博主
link: 文章連結
license_title: 版權聲明
license_content: "本網誌所有文章除特別聲明外，均採用 %s 許可協議。轉載請註明出處！"
footer:
powered: "由 %s 強力驅動"
total_views: 總瀏覽次數
total_visitors: 訪客總數
counter:
tag_cloud:
zero: 暫無標籤
one: 目前共有 1 個標籤
other: "目前共有 %d 個標籤"
categories:
zero: 暫無分類
one: 目前共有 1 個分類
other: "目前共有 %d 個分類"
archive_posts:
zero: 暫無文章。
one: 目前共有 1 篇文章。
other: "目前共有 %d 篇文章。"
state:
posts: 文章
tags: 標籤
categories: 分類
search:
placeholder: 搜索...
cheers:
um: 嗯..
ok: 還行
nice: 好
good: 很好
great: 非常好
excellent: 太棒了
keep_on: 繼續努力。
symbol:
comma: "，"
period: "。"
colon: "："
reward:
donate: 打賞
wechatpay: 微信支付
alipay: 支付寶
paypal: PayPal
bitcoin: 比特幣
follow_me:
welcome: 歡迎關注我的其它發布渠道
accessibility:
nav_toggle: 切換導航欄
prev_page: 上一頁
next_page: 下一頁
symbols_count_time:
count: 本文字數
count_total: 站點總字數
time: 閱讀時長
time_total: 站點閱讀時長
time_minutes: 分鍾
================================================
FILE: languages/zh-TW.yml
================================================
---
name: 繁體中文
title:
archive: 歸檔
category: 分類
tag: 標籤
schedule: 時間表
menu:
home: 首頁
archives: 歸檔
categories: 分類
tags: 標籤
about: 關於
search: 搜尋
schedule: 時間表
sitemap: 網站地圖
commonweal: 公益 404
sidebar:
overview: 本站概要
toc: 文章目錄
post:
posted: 發表於
edited: 更新於
created: 創建時間
modified: 修改時間
edit: 編輯
in: 分類於
read_more: 閱讀全文
untitled: 未命名
sticky: 置頂
views: 閱讀次數
related_posts: 相關文章
copyright:
author: 作者
link: 文章連結
license_title: 版權聲明
license_content: "本網誌所有文章除特別聲明外，均採用 %s 許可協議。轉載請註明出處！"
footer:
powered: "由 %s 強力驅動"
total_views: 總瀏覽次數
total_visitors: 訪客總數
counter:
tag_cloud:
zero: 沒有標籤
one: 目前共有 1 個標籤
other: "目前共有 %d 個標籤"
categories:
zero: 沒有分類
one: 目前共有 1 個分類
other: "目前共有 %d 個分類"
archive_posts:
zero: 沒有文章。
one: 目前共有 1 篇文章。
other: "目前共有 %d 篇文章。"
state:
posts: 文章
tags: 標籤
categories: 分類
search:
placeholder: 搜尋...
cheers:
um: 嗯..
ok: 還行
nice: 好
good: 很好
great: 非常好
excellent: 太棒了
keep_on: 繼續努力。
symbol:
comma: "，"
period: "。"
colon: "："
reward:
donate: 捐贈
wechatpay: 微信支付
alipay: 支付寶
paypal: PayPal
bitcoin: 比特幣
follow_me:
welcome: 歡迎關注我的其它發布渠道
accessibility:
nav_toggle: 切換導航欄
prev_page: 上一頁
next_page: 下一頁
symbols_count_time:
count: 文章字數
count_total: 總字數
time: 所需閱讀時間
time_total: 所需總閱讀時間
time_minutes: 分鐘
================================================
FILE: layout/_layout.swig
================================================
{{ partial('_partials/head/head.swig', {}, {cache: theme.cache.enable}) }}
{% include '_partials/head/head-unique.swig' %}
{{- next_inject('head') }}
{% block title %}{% endblock %}
{{ partial('_third-party/analytics/index.swig', {}, {cache: theme.cache.enable}) }}
{{ partial('_scripts/noscript.swig', {}, {cache: theme.cache.enable}) }}
{% include '_partials/header/index.swig' %}
{{ partial('_partials/widgets.swig', {}, {cache: theme.cache.enable}) }}
{% include '_partials/header/sub-menu.swig' %}
{% block content %}{% endblock %}
{% include '_partials/comments.swig' %}
{%- if theme.sidebar.display !== 'remove' %}
{% block sidebar %}{% endblock %}
{%- endif %}
{{ partial('_scripts/index.swig', {}, {cache: theme.cache.enable}) }}
{{ partial('_third-party/index.swig', {}, {cache: theme.cache.enable}) }}
{%- if theme.pjax %}
{%- endif %}
{% include '_third-party/math/index.swig' %}
{% include '_third-party/quicklink.swig' %}
{{- next_inject('bodyEnd') }}
{%- if theme.pjax %}
{%- endif %}
================================================
FILE: layout/_macro/post-collapse.swig
================================================
{% macro render(posts) %}
{%- set current_year = '1970' %}
{%- for post in posts.toArray() %}
{%- set year = date(post.date, 'YYYY') %}
{%- if year !== current_year %}
{%- set current_year = year %}
{{ current_year }}
{%- endif %}
{%- if post.link %}{# Link posts #}
{%- set postTitleIcon = '' %}
{%- set postText = post.title or post.link %}
{{ next_url(post.link, postText + postTitleIcon, {class: 'post-title-link post-title-link-external', itemprop: 'url'}) }}
{% else %}
{{ post.title or __('post.untitled') }}
{%- endif %}
{%- endfor %}
{% endmacro %}
================================================
FILE: layout/_macro/post.swig
================================================
{##################}
{### POST BLOCK ###}
{##################}
{%- if post.header !== false %}
<{%- if is_index %}h2{% else %}h1{%- endif %} class="post-title{%- if post.direction and post.direction.toLowerCase() === 'rtl' %} rtl{%- endif %}" itemprop="name headline">
{# Link posts #}
{%- if post.link %}
{%- if post.sticky > 0 %}
{%- endif %}
{%- set postTitleIcon = '' %}
{%- set postText = post.title or post.link %}
{{ next_url(post.link, postText + postTitleIcon, {class: 'post-title-link post-title-link-external', itemprop: 'url'}) }}
{% elif is_index %}
{%- if post.sticky > 0 %}
{%- endif %}
{{ next_url(post.path, post.title or __('post.untitled'), {class: 'post-title-link', itemprop: 'url'}) }}
{%- else %}
{{- post.title }}
{{- post_edit(post.source) }}
{%- endif %}
{%- endif %}
{#################}
{### POST BODY ###}
{#################}
{# Gallery support #}
{%- if post.photos and post.photos.length %}
{%- for photo in post.photos %}
 }})
{%- endfor %}
{%- endif %}
{%- if is_index %}
{%- if post.description and theme.excerpt_description %}
{{ post.description }}
{%- if theme.read_more_btn %}
{%- endif %}
{% elif post.excerpt %}
{{ post.excerpt }}
{%- if theme.read_more_btn %}
{%- endif %}
{% else %}
{{ post.content }}
{%- endif %}
{% else %}
{{ post.content }}
{%- endif %}
{#####################}
{### END POST BODY ###}
{#####################}
{%- if theme.related_posts.enable and (theme.related_posts.display_in_home or not is_index) %}
{{ partial('_partials/post/post-related.swig') }}
{%- endif %}
{%- if not is_index %}
{{- next_inject('postBodyEnd') }}
{%- if post.reward_settings.enable %}
{{ partial('_partials/post/post-reward.swig') }}
{%- endif %}
{%- if theme.creative_commons.license and theme.creative_commons.post %}
{{ partial('_partials/post/post-copyright.swig') }}
{%- endif %}
{%- if theme.follow_me %}
{{ partial('_partials/post/post-followme.swig', {}, {cache: theme.cache.enable}) }}
{%- endif %}
{% else %}
{%- endif %}
{######################}
{### END POST BLOCK ###}
{######################}
================================================
FILE: layout/_macro/sidebar.swig
================================================
{% macro render(display_toc) %}
{% endmacro %}
================================================
FILE: layout/_partials/comments.swig
================================================
{%- if page.comments %}
{%- if theme.injects.comment.length == 1 %}
{%- set inject_item = theme.injects.comment[0] %}
{{ partial(inject_item.layout, inject_item.locals, inject_item.options) }}
{%- elif theme.injects.comment.length > 1 %}
{%- if theme.comments.style == 'buttons' %}
{%- for inject_item in theme.injects.comment %}
{{ partial(inject_item.layout, inject_item.locals, inject_item.options) }}
{%- endfor %}
(function() {
let commentButton = document.querySelectorAll('.comment-button');
commentButton.forEach(element => {
let commentClass = element.classList[2];
element.addEventListener('click', () => {
commentButton.forEach(rmActive => rmActive.classList.remove('active'));
element.classList.add('active');
document.querySelectorAll('.comment-position').forEach(rmActive => rmActive.classList.remove('active'));
document.querySelector(`.comment-position.${commentClass}`).classList.add('active');
if (CONFIG.comments.storage) {
localStorage.setItem('comments_active', commentClass);
}
});
});
let { activeClass } = CONFIG.comments;
if (CONFIG.comments.storage) {
activeClass = localStorage.getItem('comments_active') || activeClass;
}
if (activeClass) {
let activeButton = document.querySelector(`.comment-button.${activeClass}`);
if (activeButton) {
activeButton.click();
}
}
})();
{%- elif theme.comments.style == 'tabs' %}
{%- for inject_item in theme.injects.comment %}
{{ partial(inject_item.layout, inject_item.locals, inject_item.options) }}
{%- endfor %}
{%- endif %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_partials/footer.swig
================================================
{%- if theme.footer.beian.enable %}
{{- next_url('https://beian.miit.gov.cn', theme.footer.beian.icp + ' ') }}
{%- if theme.footer.beian.gongan_icon_url %}
 }})
{%- endif %}
{%- if theme.footer.beian.gongan_id and theme.footer.beian.gongan_num %}
{{- next_url('http://www.beian.gov.cn/portal/registerSystemInfo?recordcode=' + theme.footer.beian.gongan_id, theme.footer.beian.gongan_num + ' ') }}
{%- endif %}
{%- endif %}
{% set copyright_year = date(null, 'YYYY') %}
© {% if theme.footer.since and theme.footer.since != copyright_year %}{{ theme.footer.since }} – {% endif %}
{{ copyright_year }}
{%- if config.symbols_count_time.total_symbols %}
{%- if theme.symbols_count_time.item_text_total %}
{%- endif %}
{{ symbolsCountTotal(site) }}
{%- endif %}
{%- if config.symbols_count_time.total_time %}
{%- if theme.symbols_count_time.item_text_total %}
{%- endif %}
{{ symbolsTimeTotal(site, config.symbols_count_time.awl, config.symbols_count_time.wpm, __('symbols_count_time.time_minutes')) }}
{%- endif %}
{%- if theme.footer.powered %}
{%- set next_site = 'https://theme-next.org' %}
{%- if theme.scheme !== 'Gemini' %}
{%- set next_site = 'https://' + theme.scheme | lower + '.theme-next.org' %}
{%- endif %}
{{- __('footer.powered', next_url('https://hexo.io', 'Hexo', {class: 'theme-link'}) + ' & ' + next_url(next_site, 'NexT.' + theme.scheme, {class: 'theme-link'})) }}
{%- endif %}
{%- if theme.add_this_id %}
{%- endif %}
{{- next_inject('footer') }}
================================================
FILE: layout/_partials/head/head-unique.swig
================================================
{{ open_graph() }}
{{ canonical() }}
{# Exports some front-matter variables to Front-End #}
================================================
FILE: layout/_partials/head/head.swig
================================================
{%- if theme.favicon.apple_touch_icon %}
{%- endif %}
{%- if theme.favicon.medium %}
{%- endif %}
{%- if theme.favicon.small %}
{%- endif %}
{%- if theme.favicon.safari_pinned_tab %}
{%- endif %}
{%- if theme.favicon.android_manifest %}
{%- endif %}
{%- if theme.favicon.ms_browserconfig %}
{%- endif %}
{%- if theme.disable_baidu_transformation %}
{%- endif %}
{%- if theme.google_site_verification %}
{%- endif %}
{%- if theme.bing_site_verification %}
{%- endif %}
{%- if theme.yandex_site_verification %}
{%- endif %}
{%- if theme.baidu_site_verification %}
{%- endif %}
{{ next_font() }}
{%- set font_awesome_uri = theme.vendors.fontawesome or next_vendors('font-awesome/css/all.min.css') %}
{%- if theme.fancybox %}
{%- set fancybox_css_uri = theme.vendors.fancybox_css or next_vendors('//cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.css') %}
{%- endif %}
{%- if theme.pace.enable %}
{%- set pace_css_uri = theme.vendors.pace_css or next_vendors('pace/pace-theme-' + theme.pace.theme + '.min.css') %}
{%- set pace_js_uri = theme.vendors.pace or next_vendors('pace/pace.min.js') %}
{%- endif %}
{{ next_config() }}
================================================
FILE: layout/_partials/header/brand.swig
================================================
{%- if theme.custom_logo and theme.scheme === 'Muse' %}
{%- endif %}
{{ title }}
{%- if subtitle %}
{{ subtitle }}
{%- endif %}
{%- if theme.custom_logo and (theme.scheme === 'Gemini' or theme.scheme === 'Pisces') %}
{%- endif %}
{%- if theme.algolia_search.enable or theme.local_search.enable %}
{%- endif %}
================================================
FILE: layout/_partials/header/index.swig
================================================
{{ partial('_partials/header/brand.swig', {}, {cache: theme.cache.enable}) }}
{{ partial('_partials/header/menu.swig', {}, {cache: theme.cache.enable}) }}
{{ partial('_partials/search/index.swig', {}, {cache: theme.cache.enable}) }}
{{- next_inject('header') }}
================================================
FILE: layout/_partials/header/menu-item.swig
================================================
{% macro render(name, itemName, value) %}
{%- set itemURL = value.split('||')[0] | trim %}
{%- if not itemURL.startsWith('http') %}
{%- set itemURL = itemURL | replace('//', '/') %}
{%- endif %}
{%- set menuIcon = '' %}
{%- if theme.menu_settings.icons %}
{%- set menuIcon = '' %}
{%- endif %}
{%- set menuText = __('menu.' + name) | replace('menu.', '') %}
{%- set menuBadge = '' %}
{%- if theme.menu_settings.badges %}
{%- set badges = {
archives : site.posts.length,
categories: site.categories.length,
tags : site.tags.length
}
%}
{%- for menu, count in badges %}
{%- if name == menu %}
{%- set menuBadge = '' + count + '' %}
{%- endif %}
{%- endfor %}
{%- endif %}
{{ next_url(itemURL, menuIcon + menuText + menuBadge, {rel: 'section'}) }}
{% endmacro %}
================================================
FILE: layout/_partials/header/menu.swig
================================================
{% import 'menu-item.swig' as menu_item with context %}
================================================
FILE: layout/_partials/header/sub-menu.swig
================================================
{% import '_partials/header/menu-item.swig' as menu_item with context %}
{%- if theme.menu and is_page() %}
{# Submenu & Submenu-2 #}
{%- for name, value in theme.menu %}
{%- set respath = value %}
{%- if value == '[object Object]' %}
{# If current URL is value of parent submenu 'default' path #}
{%- set currentParentUrl = page.path.split('/')[0] | trim %}
{%- if currentParentUrl == value.default.split('||')[0] | trim | replace('/', '') %}
{# Submenu items #}
{# End Submenu items #}
{# Submenu-2 #}
{%- for name, value in theme.menu %}
{%- set respath = value %}
{%- if value == '[object Object]' %}
{%- for subname, subvalue in value %}
{%- set itemName = subname | lower %}
{%- if itemName == 'default' %}
{%- set parentValue = subvalue.split('||')[0] | trim %}
{%- endif %}
{%- if subvalue == '[object Object]' %}
{# If current URL is value of parent submenu 'default' path #}
{%- set paths = page.path.split('/') %}
{%- if paths.length > 2 %}
{%- if paths[1] == subvalue.default.split('||')[0] | trim | replace('/', '') %}
{# Submenu-2 items #}
{# End Submenu-2 items #}
{%- endif %}
{%- endif %}
{# End URL & path comparing #}
{%- endif %}
{%- endfor %}
{%- endif %}
{%- endfor %}
{# End Submenu-2 #}
{%- endif %}
{# End URL & path comparing #}
{%- endif %}
{%- endfor %}
{# End Submenu & Submenu-2 #}
{%- endif %}
================================================
FILE: layout/_partials/languages.swig
================================================
{%- if theme.language_switcher and languages.length > 1 %}
{%- endif %}
================================================
FILE: layout/_partials/page/breadcrumb.swig
================================================
{%- set paths = page.path.split('/') %}
{%- set count = paths.length %}
{%- if count > 2 %}
{%- set current = 0 %}
{%- set link = '' %}
{%- endif %}
================================================
FILE: layout/_partials/page/page-header.swig
================================================
{{- page.title }}
{{- post_edit(page.source) }}
================================================
FILE: layout/_partials/pagination.swig
================================================
{%- if page.prev or page.next %}
{%- endif %}
================================================
FILE: layout/_partials/post/post-copyright.swig
================================================
{%- set ccIcon = '' %}
{%- set ccText = theme.creative_commons.license | upper %}
-
{{ __('post.copyright.link') + __('symbol.colon') }}
{{ next_url(page.permalink, page.permalink, {title: page.title}) }}
-
{{ __('post.copyright.license_title') + __('symbol.colon') }}
{{- __('post.copyright.license_content', next_url(ccURL, ccIcon + ccText)) }}
================================================
FILE: layout/_partials/post/post-followme.swig
================================================
{%- if theme.follow_me %}
{{ __('follow_me.welcome') }}
{%- endif %}
================================================
FILE: layout/_partials/post/post-footer.swig
================================================
{%- if theme.rating.enable %}
{%- endif %}
================================================
FILE: layout/_partials/post/post-related.swig
================================================
{%- set popular_posts = popular_posts_json(theme.related_posts.params, page) %}
{%- if popular_posts.json and popular_posts.json.length > 0 %}
{{ theme.related_posts.title or __('post.related_posts') }}
{%- for popular_post in popular_posts.json %}
-
{%- if popular_post.date and popular_post.date != '' %}
{{ popular_post.date }}
{%- endif %}
{%- if popular_post.img and popular_post.img != '' %}
{%- endif %}
{%- if popular_post.excerpt and popular_post.excerpt != '' %}
{{ popular_post.excerpt }}
{%- endif %}
{%- endfor %}
{%- endif %}
================================================
FILE: layout/_partials/post/post-reward.swig
================================================
{{ page.reward_settings.comment }}
================================================
FILE: layout/_partials/search/algolia-search.swig
================================================
================================================
FILE: layout/_partials/search/index.swig
================================================
{%- if theme.algolia_search.enable or theme.local_search.enable %}
{%- endif %}
================================================
FILE: layout/_partials/search/localsearch.swig
================================================
================================================
FILE: layout/_partials/sidebar/site-overview.swig
================================================
{%- if theme.avatar.url %}
 }})
{%- endif %}
{{ description }}
{%- if theme.site_state %}
{%- endif %}
{%- if theme.chat.enable and theme.chat.service !== '' %}
{%- endif %}
{%- if theme.social %}
{%- endif %}
{%- if theme.creative_commons.license and theme.creative_commons.sidebar %}
{%- set ccImage = ' + ')
' %}
{{ next_url(ccURL, ccImage, {class: 'cc-opacity'}) }}
{%- endif %}
{# Blogroll #}
{%- if theme.links %}
{%- if theme.links_settings.icon %}{%- endif %}
{{ theme.links_settings.title }}
{%- for blogrollText, blogrollURL in theme.links %}
-
{{ next_url(blogrollURL, blogrollText, {title: blogrollURL}) }}
{%- endfor %}
{%- endif %}
================================================
FILE: layout/_partials/widgets.swig
================================================
{%- if theme.back2top.enable and not theme.back2top.sidebar %}
0%
{%- endif %}
{%- if theme.reading_progress.enable %}
{%- endif %}
{%- if theme.bookmark.enable %}
{%- endif %}
{%- if theme.github_banner.enable %}
{%- set github_URL = theme.github_banner.permalink %}
{%- set github_title = theme.github_banner.title %}
{%- set github_image = '' %}
{{ next_url(github_URL, github_image, {class: 'github-corner', title: github_title, "aria-label": github_title}) }}
{%- endif %}
================================================
FILE: layout/_scripts/index.swig
================================================
{% include 'vendors.swig' %}
{{- next_js('utils.js') }}
{%- if theme.motion.enable %}
{{- next_js('motion.js') }}
{%- endif %}
{%- set scheme_script = 'schemes/' + theme.scheme | lower + '.swig' %}
{% include scheme_script %}
{{- next_js('next-boot.js') }}
{%- if theme.bookmark.enable %}
{{- next_js('bookmark.js') }}
{%- endif %}
{%- if theme.pjax %}
{% include 'pjax.swig' %}
{%- endif %}
{% include 'three.swig' %}
================================================
FILE: layout/_scripts/noscript.swig
================================================
================================================
FILE: layout/_scripts/pages/schedule.swig
================================================
(function() {
// Initialization
var calendar = {
orderBy : 'startTime',
showLocation: false,
offsetMax : 72,
offsetMin : 4,
showDeleted : false,
singleEvents: true,
maxResults : 250
};
// Read config form theme config file
Object.assign(calendar, {{ theme.calendar | json }});
var now = new Date();
var timeMax = new Date();
var timeMin = new Date();
timeMax.setHours(now.getHours() + calendar.offsetMax);
timeMin.setHours(now.getHours() - calendar.offsetMin);
// Build URL
const params = {
key : calendar.api_key,
orderBy : calendar.orderBy,
timeMax : timeMax.toISOString(),
timeMin : timeMin.toISOString(),
showDeleted : calendar.showDeleted,
singleEvents: calendar.singleEvents,
maxResults : calendar.maxResults
};
var request_url = 'https://www.googleapis.com/calendar/v3/calendars/' + calendar.calendar_id + '/events?' + Object.entries(params).map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join('&');
fetchData();
var fetchDataTimer = setInterval(fetchData, 60000);
window.addEventListener('pjax:send', () => {
clearInterval(fetchDataTimer);
});
function fetchData() {
var eventList = document.querySelector('.event-list');
if (!eventList) return;
fetch(request_url).then(response => {
return response.json();
}).then(data => {
if (data.items.length === 0) {
eventList.innerHTML = '
';
return;
}
// Clean the event list
eventList.innerHTML = '';
var prevEnd = 0; // used to decide where to insert an
data.items.forEach(event => {
// Parse data
var utc = new Date().getTimezoneOffset() * 60000;
var start = event.start.dateTime = new Date(event.start.dateTime || (new Date(event.start.date).getTime() + utc));
var end = event.end.dateTime = new Date(event.end.dateTime || (new Date(event.end.date).getTime() + utc));
tense = judgeTense(now, start, end); // 0:now 1:future -1:past
if (tense === 1 && prevEnd < now) {
eventList.innerHTML += '
';
}
eventDOM = buildEventDOM(tense, event);
eventList.innerHTML += eventDOM;
prevEnd = end;
});
});
}
function getRelativeTime(current, previous) {
var msPerMinute = 60 * 1000;
var msPerHour = msPerMinute * 60;
var msPerDay = msPerHour * 24;
var msPerMonth = msPerDay * 30;
var msPerYear = msPerDay * 365;
var elapsed = current - previous;
var tense = elapsed > 0 ? 'ago' : 'later';
elapsed = Math.abs(elapsed);
if ( elapsed < msPerHour ) {
return Math.round(elapsed / msPerMinute) + ' minutes ' + tense;
}
else if ( elapsed < msPerDay ) {
return Math.round(elapsed / msPerHour) + ' hours ' + tense;
}
else if ( elapsed < msPerMonth ) {
return 'about ' + Math.round(elapsed / msPerDay) + ' days ' + tense;
}
else if ( elapsed < msPerYear ) {
return 'about ' + Math.round(elapsed / msPerMonth) + ' months ' + tense;
}
else {
return 'about' + Math.round(elapsed / msPerYear) + ' years' + tense;
}
}
function judgeTense(now, eventStart, eventEnd) {
if (eventEnd < now) { return -1; }
else if (eventStart > now) { return 1; }
else { return 0; }
}
function buildEventDOM(tense, event) {
var tenseClass = '';
var start = event.start.dateTime;
var end = event.end.dateTime;
switch(tense) {
case 0 : // now
tenseClass = 'event-now';
break;
case 1 : // future
tenseClass = 'event-future';
break;
case -1: // past
tenseClass = 'event-past';
break;
default:
throw 'Time data error';
}
var durationFormat = {
weekday: 'short',
hour : '2-digit',
minute : '2-digit'
};
var relativeTimeStr = (tense === 0) ? 'NOW' : getRelativeTime(now, start);
var durationStr = start.toLocaleTimeString([], durationFormat) + ' - ' + end.toLocaleTimeString([], durationFormat);
var locationDOM = '';
if (calendar.showLocation && event.location) {
locationDOM = '' + event.location + '';
}
var eventContent = `
${event.summary}
${relativeTimeStr}
${locationDOM}
${durationStr}
`;
return eventContent;
}
})();
================================================
FILE: layout/_scripts/pjax.swig
================================================
================================================
FILE: layout/_scripts/schemes/gemini.swig
================================================
{{- next_js('schemes/pisces.js') }}
================================================
FILE: layout/_scripts/schemes/mist.swig
================================================
{{- next_js('schemes/muse.js') }}
================================================
FILE: layout/_scripts/schemes/muse.swig
================================================
{{- next_js('schemes/muse.js') }}
================================================
FILE: layout/_scripts/schemes/pisces.swig
================================================
{{- next_js('schemes/pisces.js') }}
================================================
FILE: layout/_scripts/three.swig
================================================
{%- if theme.three.enable %}
{%- set three_uri = theme.vendors.three or next_vendors('three/three.min.js') %}
{%- if theme.three.three_waves %}
{%- set waves_uri = theme.vendors.three_waves or next_vendors('three/three-waves.min.js') %}
{%- endif %}
{%- if theme.three.canvas_lines %}
{%- set lines_uri = theme.vendors.canvas_lines or next_vendors('three/canvas_lines.min.js') %}
{%- endif %}
{%- if theme.three.canvas_sphere %}
{%- set sphere_uri = theme.vendors.canvas_sphere or next_vendors('three/canvas_sphere.min.js') %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_scripts/vendors.swig
================================================
{%- set js_vendors = {} %}
{%- set js_vendors = js_vendors | attr('anime', 'anime.min.js') %}
{%- if theme.pjax %}
{%- set js_vendors = js_vendors | attr('pjax', 'pjax/pjax.min.js') %}
{%- endif %}
{%- if theme.fancybox %}
{%- set js_vendors = js_vendors | attr('jquery', '//cdn.jsdelivr.net/npm/jquery@3/dist/jquery.min.js') %}
{%- set js_vendors = js_vendors | attr('fancybox', '//cdn.jsdelivr.net/gh/fancyapps/fancybox@3/dist/jquery.fancybox.min.js') %}
{%- endif %}
{%- if theme.mediumzoom %}
{%- set js_vendors = js_vendors | attr('mediumzoom', '//cdn.jsdelivr.net/npm/medium-zoom@1/dist/medium-zoom.min.js') %}
{%- endif %}
{%- if theme.lazyload %}
{%- set js_vendors = js_vendors | attr('lazyload', '//cdn.jsdelivr.net/npm/lozad@1/dist/lozad.min.js') %}
{%- endif %}
{%- if theme.pangu %}
{%- set js_vendors = js_vendors | attr('pangu', '//cdn.jsdelivr.net/npm/pangu@4/dist/browser/pangu.min.js') %}
{%- endif %}
{%- if theme.motion.enable %}
{%- set js_vendors = js_vendors | attr('velocity', 'velocity/velocity.min.js') %}
{%- set js_vendors = js_vendors | attr('velocity_ui', 'velocity/velocity.ui.min.js') %}
{%- endif %}
{%- if theme.canvas_nest.enable %}
{%- if theme.canvas_nest.onmobile %}
{%- set canvas_nest_uri = theme.vendors.canvas_nest or next_vendors('canvas-nest/canvas-nest.min.js') %}
{% else %}
{%- set canvas_nest_uri = theme.vendors.canvas_nest_nomobile or next_vendors('canvas-nest/canvas-nest-nomobile.min.js') %}
{%- endif %}
{%- endif %}
{%- if theme.canvas_ribbon.enable %}
{%- set canvas_ribbon_uri = theme.vendors.canvas_ribbon or next_vendors('canvas-ribbon/canvas-ribbon.js') %}
{%- endif %}
{%- for name, internal in js_vendors %}
{%- set internal_script = next_vendors(internal) %}
{%- endfor %}
================================================
FILE: layout/_third-party/analytics/baidu-analytics.swig
================================================
{%- if theme.baidu_analytics %}
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?{{ theme.baidu_analytics }}";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
{%- endif %}
================================================
FILE: layout/_third-party/analytics/google-analytics.swig
================================================
{%- if theme.google_analytics.tracking_id %}
{%- if not theme.google_analytics.only_pageview %}
if (CONFIG.hostname === location.hostname) {
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', '{{ theme.google_analytics.tracking_id }}');
}
{%- endif %}
{%- if theme.google_analytics.only_pageview %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_third-party/analytics/growingio.swig
================================================
{%- if theme.growingio_analytics %}
!function(e,t,n,g,i){e[i]=e[i]||function(){(e[i].q=e[i].q||[]).push(arguments)},n=t.createElement("script"),tag=t.getElementsByTagName("script")[0],n.async=1,n.src=('https:'==document.location.protocol?'https://':'http://')+g,tag.parentNode.insertBefore(n,tag)}(window,document,"script","assets.growingio.com/2.1/gio.js","gio");
gio('init', '{{ theme.growingio_analytics }}', {});
gio('send');
{%- endif %}
================================================
FILE: layout/_third-party/analytics/index.swig
================================================
{% include 'google-analytics.swig' %}
{% include 'baidu-analytics.swig' %}
{% include 'growingio.swig' %}
================================================
FILE: layout/_third-party/baidu-push.swig
================================================
{%- if theme.baidu_push %}
(function(){
var canonicalURL, curProtocol;
//Get the tag
var x=document.getElementsByTagName("link");
//Find the last canonical URL
if(x.length > 0){
for (i=0;i
{%- endif %}
================================================
FILE: layout/_third-party/chat/chatra.swig
================================================
{%- if theme.chatra.enable %}
{%- if theme.chatra.embed %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_third-party/chat/tidio.swig
================================================
{%- if theme.tidio.enable %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/changyan.swig
================================================
{%- if is_home() %}
{% elif page.comments %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/disqus.swig
================================================
{%- if theme.disqus.count %}
{%- endif %}
{%- if page.comments %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/disqusjs.swig
================================================
{%- if page.comments %}
{%- set disqusjs_css_uri = theme.vendors.disqusjs_css or '//cdn.jsdelivr.net/npm/disqusjs@1/dist/disqusjs.css' %}
{%- set disqusjs_js_uri = theme.vendors.disqusjs_js or '//cdn.jsdelivr.net/npm/disqusjs@1/dist/disqus.js' %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/gitalk.swig
================================================
{%- if page.comments %}
{%- set gitalk_css_uri = theme.vendors.gitalk_css or '//cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.css' %}
{%- set gitalk_js_uri = theme.vendors.gitalk_js or '//cdn.jsdelivr.net/npm/gitalk@1/dist/gitalk.min.js' %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/livere.swig
================================================
{%- if page.comments %}
{%- endif %}
================================================
FILE: layout/_third-party/comments/valine.swig
================================================
{%- set valine_uri = theme.vendors.valine or '//unpkg.com/valine/dist/Valine.min.js' %}
================================================
FILE: layout/_third-party/index.swig
================================================
{% include 'baidu-push.swig' %}
{% include 'rating.swig' %}
{%- if theme.algolia_search.enable %}
{% include 'search/algolia-search.swig' %}
{% elif theme.swiftype_key %}
{% include 'search/swiftype.swig' %}
{% elif theme.local_search.enable %}
{% include 'search/localsearch.swig' %}
{%- endif %}
{% include 'chat/chatra.swig' %}
{% include 'chat/tidio.swig' %}
{% include 'tags/pdf.swig' %}
{% include 'tags/mermaid.swig' %}
================================================
FILE: layout/_third-party/math/index.swig
================================================
{%- if theme.math.mathjax.enable or theme.math.katex.enable %}
{%- set is_index_has_math = false %}
{# At home, check if there has `mathjax: true` post #}
{%- if is_home() and theme.math.per_page %}
{%- for post in page.posts.toArray() %}
{%- if post.mathjax and not is_index_has_math %}
{%- set is_index_has_math = true %}
{%- endif %}
{%- endfor %}
{%- endif %}
{%- if not theme.math.per_page or is_index_has_math or page.mathjax %}
{%- if theme.math.mathjax.enable %}
{% include '_third-party/math/mathjax.swig' %}
{% elif theme.math.katex.enable %}
{% include '_third-party/math/katex.swig' %}
{%- endif %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_third-party/math/katex.swig
================================================
{%- set katex_uri = theme.vendors.katex or '//cdn.jsdelivr.net/npm/katex@0/dist/katex.min.css' %}
{%- if theme.math.katex.copy_tex %}
{%- set copy_tex_js_uri = theme.vendors.copy_tex_js or '//cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.js' %}
{%- set copy_tex_css_uri = theme.vendors.copy_tex_css or '//cdn.jsdelivr.net/npm/katex@0/dist/contrib/copy-tex.min.css' %}
{%- endif %}
================================================
FILE: layout/_third-party/math/mathjax.swig
================================================
{%- set mathjax_uri = theme.vendors.mathjax or '//cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' %}
================================================
FILE: layout/_third-party/quicklink.swig
================================================
{%- if page.quicklink.enable %}
{%- set quicklink_uri = theme.vendors.quicklink or next_vendors('//cdn.jsdelivr.net/npm/quicklink@1/dist/quicklink.umd.js') %}
{%- endif %}
================================================
FILE: layout/_third-party/rating.swig
================================================
{%- if theme.rating.enable %}
if (CONFIG.page.isPost) {
wpac_init = window.wpac_init || [];
wpac_init.push({
widget: 'Rating',
id : {{ theme.rating.id }},
el : 'wpac-rating',
color : '{{ theme.rating.color }}'
});
(function() {
if ('WIDGETPACK_LOADED' in window) return;
WIDGETPACK_LOADED = true;
var mc = document.createElement('script');
mc.type = 'text/javascript';
mc.async = true;
mc.src = '//embed.widgetpack.com/widget.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(mc, s.nextSibling);
})();
}
{%- endif %}
================================================
FILE: layout/_third-party/search/algolia-search.swig
================================================
{%- set algolia_search_uri = theme.vendors.algolia_search or next_vendors('//cdn.jsdelivr.net/npm/algoliasearch@4/dist/algoliasearch-lite.umd.js') %}
{%- set instant_search_uri = theme.vendors.instant_search or next_vendors('//cdn.jsdelivr.net/npm/instantsearch.js@4/dist/instantsearch.production.min.js') %}
{{- next_js('algolia-search.js') }}
================================================
FILE: layout/_third-party/search/localsearch.swig
================================================
{{- next_js('local-search.js') }}
================================================
FILE: layout/_third-party/search/swiftype.swig
================================================
================================================
FILE: layout/_third-party/statistics/busuanzi-counter.swig
================================================
{%- if theme.busuanzi_count.enable %}
{%- if theme.busuanzi_count.total_visitors %}
{%- endif %}
{%- if theme.busuanzi_count.total_visitors and theme.busuanzi_count.total_views %}
{%- endif %}
{%- if theme.busuanzi_count.total_views %}
{%- endif %}
{%- endif %}
================================================
FILE: layout/_third-party/statistics/cnzz-analytics.swig
================================================
{%- if theme.cnzz_siteid %}
{%- endif %}
================================================
FILE: layout/_third-party/statistics/firestore.swig
================================================
{%- if theme.firestore.enable %}
(function() {
var db = firebase.firestore();
var articles = db.collection('{{ theme.firestore.collection }}');
if (CONFIG.page.isPost) { // Is article page
var title = document.querySelector('.post-title').innerText.trim();
var doc = articles.doc(title);
var increaseCount = CONFIG.hostname === location.hostname;
if (localStorage.getItem(title)) {
increaseCount = false;
} else {
// Mark as visited
localStorage.setItem(title, true);
}
getCount(doc, increaseCount).then(appendCountTo(document.querySelector('.firestore-visitors-count')));
} else if (CONFIG.page.isHome) { // Is index page
var promises = [...document.querySelectorAll('.post-title')].map(element => {
var title = element.innerText.trim();
var doc = articles.doc(title);
return getCount(doc);
});
Promise.all(promises).then(counts => {
var metas = document.querySelectorAll('.firestore-visitors-count');
counts.forEach((val, idx) => {
appendCountTo(metas[idx])(val);
});
});
}
})();
{%- endif %}
================================================
FILE: layout/_third-party/statistics/index.swig
================================================
{% include 'busuanzi-counter.swig' %}
{% include 'cnzz-analytics.swig' %}
{% include 'firestore.swig' %}
{% include 'lean-analytics.swig' %}
================================================
FILE: layout/_third-party/statistics/lean-analytics.swig
================================================
{%- if theme.leancloud_visitors.enable and not theme.valine.visitor %}
(function() {
function leancloudSelector(url) {
url = encodeURI(url);
return document.getElementById(url).querySelector('.leancloud-visitors-count');
}
function addCount(Counter) {
var visitors = document.querySelector('.leancloud_visitors');
var url = decodeURI(visitors.id);
var title = visitors.dataset.flagTitle;
Counter('get', '/classes/Counter?where=' + encodeURIComponent(JSON.stringify({ url })))
.then(response => response.json())
.then(({ results }) => {
if (results.length > 0) {
var counter = results[0];
leancloudSelector(url).innerText = counter.time + 1;
Counter('put', '/classes/Counter/' + counter.objectId, { time: { '__op': 'Increment', 'amount': 1 } })
.catch(error => {
console.error('Failed to save visitor count', error);
});
} else {
{%- if theme.leancloud_visitors.security %}
leancloudSelector(url).innerText = 'Counter not initialized! More info at console err msg.';
console.error('ATTENTION! LeanCloud counter has security bug, see how to solve it here: https://github.com/theme-next/hexo-leancloud-counter-security. \n However, you can still use LeanCloud without security, by setting `security` option to `false`.');
{% else %}
Counter('post', '/classes/Counter', { title, url, time: 1 })
.then(response => response.json())
.then(() => {
leancloudSelector(url).innerText = 1;
})
.catch(error => {
console.error('Failed to create', error);
});
{%- endif %}
}
})
.catch(error => {
console.error('LeanCloud Counter Error', error);
});
}
function showTime(Counter) {
var visitors = document.querySelectorAll('.leancloud_visitors');
var entries = [...visitors].map(element => {
return decodeURI(element.id);
});
Counter('get', '/classes/Counter?where=' + encodeURIComponent(JSON.stringify({ url: { '$in': entries } })))
.then(response => response.json())
.then(({ results }) => {
for (let url of entries) {
let target = results.find(item => item.url === url);
leancloudSelector(url).innerText = target ? target.time : 0;
}
})
.catch(error => {
console.error('LeanCloud Counter Error', error);
});
}
let { app_id, app_key, server_url } = {{ theme.leancloud_visitors | json }};
function fetchData(api_server) {
var Counter = (method, url, data) => {
return fetch(`${api_server}/1.1${url}`, {
method,
headers: {
'X-LC-Id' : app_id,
'X-LC-Key' : app_key,
'Content-Type': 'application/json',
},
body: JSON.stringify(data)
});
};
if (CONFIG.page.isPost) {
if (CONFIG.hostname !== location.hostname) return;
addCount(Counter);
} else if (document.querySelectorAll('.post-title-link').length >= 1) {
showTime(Counter);
}
}
let api_server = app_id.slice(-9) !== '-MdYXbMMI' ? server_url : `https://${app_id.slice(0, 8).toLowerCase()}.api.lncldglobal.com`;
if (api_server) {
fetchData(api_server);
} else {
fetch('https://app-router.leancloud.cn/2/route?appId=' + app_id)
.then(response => response.json())
.then(({ api_server }) => {
fetchData('https://' + api_server);
});
}
})();
{%- endif %}
================================================
FILE: layout/_third-party/tags/mermaid.swig
================================================
{%- if theme.mermaid.enable %}
{%- set mermaid_uri = theme.vendors.mermaid or '//cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js' %}
if (document.querySelectorAll('pre.mermaid').length) {
NexT.utils.getScript('{{ mermaid_uri }}', () => {
mermaid.initialize({
theme : '{{ theme.mermaid.theme }}',
logLevel : 3,
flowchart: { curve : 'linear' },
gantt : { axisFormat: '%m/%d/%Y' },
sequence : { actorMargin: 50 }
});
}, window.mermaid);
}
{%- endif %}
================================================
FILE: layout/_third-party/tags/pdf.swig
================================================
{%- if theme.pdf.enable %}
{%- set pdf_uri = next_vendors('pdf/web/viewer.html') %}
document.querySelectorAll('.pdfobject-container').forEach(element => {
let url = element.dataset.target;
let pdfOpenParams = {
navpanes : 0,
toolbar : 0,
statusbar: 0,
pagemode : 'thumbs',
view : 'FitH'
};
let pdfOpenFragment = '#' + Object.entries(pdfOpenParams).map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join('&');
let fullURL = `{{ pdf_uri }}?file=${encodeURIComponent(url)}${pdfOpenFragment}`;
if (NexT.utils.supportsPDFs()) {
element.innerHTML = `