NexT v6.0.0 here :triangular_flag_on_post:
NexT
NexT 是一个高质量并且优雅的Hexo 主题。这是精心制作做出来的 hexo 主题。
[](https://gitter.im/iissnan/hexo-theme-next?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![mnt-image]][commits-url]
[![travis-image]][travis-url]
[![rel-image]][releases-url]
[![hexo-image]][hexo-url]
[![lic-image]](LICENSE)
* NexT 使用文档 | [English Documentation](README.md)
## 实时预览 Live Preview
* :heart_decoration: Muse 方案: [LEAFERx](https://leaferx.online) | [XiaMo](https://notes.wanghao.work) | [OAwan](https://oawan.me)
* :six_pointed_star: Mist 方案: [Jeff](https://blog.zzbd.org) | [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com)
* :pisces: Pisces 方案: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Rainy](https://rainylog.com)
* :gemini: Gemini 方案: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me)
更多 NexT 例子点击 [这里](https://github.com/iissnan/hexo-theme-next/issues/119).
## 安装 Installation
**1.** 在终端切换到**hexo 根**目录. 在hexo目录下一定有 `node_modules`, `source`, `themes` 和其他文件夹:
```sh
$ cd hexo
$ ls
_config.yml node_modules package.json public scaffolds source themes
```
**2.** 从 github 上获取主题 。这里有几种方式来获取主题:
### 下载[最新发布的版本][releases-latest-url] Download tagged release version
在大多数情况下 **稳定**。 推荐用户下载这个。
[![curl-tar-wget-image]][curl-tar-wget-url]
```sh
$ mkdir themes/next
$ curl -s https://api.github.com/repos/iissnan/hexo-theme-next/releases/latest | grep tarball_url | cut -d '"' -f 4 | wget -i - -O- | tar -zx -C themes/next --strip-components=1
```
### 下载[标签发布版本][releases-url] Download tagged release version
您必须定义版本。从[标签列表][tags-url]里选择版本替换`v5.1.2`。
[![curl-tar-image]][curl-tar-url]
```sh
$ mkdir themes/next
$ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball/v5.1.2 | tar -zxv -C themes/next --strip-components=1
```
[![git-image]][git-url]
```sh
$ git clone --branch v5.1.2 https://github.com/iissnan/hexo-theme-next themes/next
```
### 下载[最新的 master 分支][download-latest-url] Download latest master branch
可能会 **不稳定**, 但是包含最新的特色，推荐开发者下载.
[![curl-tar-image]][curl-tar-url]
```sh
$ mkdir themes/next
$ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1
```
[![git-image]][git-url]
```sh
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
```
使用克隆命令，你将得到**整个存储库**。而且在任何时候你都可以切换到任何标签发布版本。
获取标签列表：
```sh
$ cd themes/next
$ git tag -l
…
v5.0.0
v5.0.1
v5.1.0
v5.1.1
v5.1.2
```
例如, 你想要切换到`v5.1.0` [标签发布版本][tags-url]. 输入以下命令:
```sh
$ git checkout tags/v5.1.0
Note: checking out 'tags/v5.1.0'.
…
HEAD now on 1f72f68... CSS: Remove global list-style setting of ul
```
如果你想切换回 [master 分支][commits-url]的话, 输入这个命令:
```sh
$ git checkout master
```
**3.** 在 **hexo 根目录下** 的配置文件`_config.yml`里设置主题:
theme: next
### Bugs
对于那些遇到 **Error: Cannot find module 'hexo-util'** [问题](https://github.com/iissnan/hexo-theme-next/issues/1490)的人, 请检查你的NPM 版本.
- `版本 > 3`: 如果仍然不行的话，请移除 `node_modules` 文件 然后重新安装，使用 `npm install`命令。
- `版本 < 3`: 请通过`npm install --save-dev hexo-util`命令添加`hexo-util`到你的站点包依赖里
## 更新 Update
```sh
$ cd themes/next
$ git pull
```
### Bugs
> 提交您的更改或存储它们，然后才能合并。
您必须提交，存储或放弃本地更改. 看 [here](https://stackoverflow.com/a/15745424/5861495) 是如何做的。
### 使用Hexo data files([#328](https://github.com/iissnan/hexo-theme-next/issues/328))配置主题 Theme configurations using Hexo data files #328
目前升级 NexT 主题的时候并不是非常的流畅。若使用 `git pull` 的方式，很多时候可能会产生冲突；而下载新版本覆盖安装的方式又需要手动合并主题的 `_config.yml` 文件。
在此修改之前， NexT 建议将配置分离，一部分在 站点的配置文件中，另外一部分在主题的配置文件中。将需要自定的选项放置在 站点配置文件中，从而脱离避免更新主题时可能遇到的麻烦。这种方式是可行，但是有一些缺点：
1. 配置分离成了两个部分
2. 用户可能会疑惑一些选项该放置在哪里比较合适
为了解决这个问题， NexT 将会使用 Hexo 的 [Data Files](https://hexo.io/docs/data-files.html) 。然而由于 Data Files 是在 Hexo 3 版本时引进的，所以要使用这个特性，需要 Hexo 的版本不低于 3。
若你比较喜欢 Hexo 2.x 版本，可以继续使用原先的配置方式。 NexT 保持着向下兼容。
#### 特性 Benefits
通过这个特性，你可以将所有的主题配置放置在站点的 `source/_data/next.yml` 文件中。原先放置在 站点配置文件 中的选项可以迁移到新的位置，同时，主题配置文件可以不用做任何修改。若后续版本有配置相关的改动时，你仅需在 `next.yml` 中做相应调整即可
#### 如何使用这个特性 How to use this feature
1. 请先确保你所使用的 Hexo 版本在 3 以上
2. 在站点的 `source/_data` 目录下新建 `next.yml` 文件（`_data`目录可能需要新建）
3. 迁移站点配置文件和主题配置文件中的配置到 `next.yml` 中
4. 使用 `--config source/_data/next.yml` 参数启动服务器, 生成或者部署。\
例如: `hexo clean --config source/_data/next.yml && hexo g --config source/_data/next.yml`。
## 特色 Features
### 支持多国语言, 包括:
:cn: 简体中文 & 繁体中文
:us: 英语
:ru: 俄语
:fr: 法语
:de: 德语
:jp: 日语
:indonesia: 印度尼西亚语
:portugal: 葡萄牙语 (巴西)
:kr: 朝鲜语
:it: 意大利语
:netherlands: 荷兰语
默认语言是英语。
```yml
language: en
# language: zh-Hans
# language: zh-hk
# language: zh-tw
# language: ru
# language: fr-FR
# language: de
# language: ja
# language: id
# language: pt
# language: pt-BR
# language: ko
# language: it
# language: nl-NL
```
在站点配置文件`_config.yml`中可以将语言切换成中文
```yml
language: zh-Hans
```
### 评论支持 Comment support
NexT 已经原生支持 `多说` and `Disqus` 评论系统。
添加以下代码到你的主题配置文件 `_config.yml`:
```yml
duoshuo:
enable: true
shortname: your-duoshuo-shortname
```
或者
```yml
disqus_shortname: your-disqus-shortname
```
### 标签页 Tags page
> 添加一个标签页面，里面包含您网站中的所有标签。
- 创建一个名为 `tags` 页面
hexo new page "tags"
- 编辑标签页, 设置页面类型为`tags`.
title: All tags
date: 2014-12-22 12:39:04
type: "tags"
- 添加 `tags` 到主题配置文件 `_config.yml` 里:
menu:
home: /
archives: /archives
tags: /tags
### 分类页 Categories page
> 添加一个分类页面，里面包含您网站中的所有分类。
- 创建一个名为 `categories` 页面
hexo new page "categories"
- 编辑分类页, 设置页面类型为 `categories`.
title: All categories
date: 2014-12-22 12:39:04
type: "categories"
- 添加 `categories` 到主题配置文件 `_config.yml` 里:
menu:
home: /
archives: /archives
categories: /categories
### 社交媒体 Social Media
NexT 可以自动添加链接到您的社交媒体帐户里:
```yml
social:
GitHub: your-github-url
Twitter: your-twitter-url
Weibo: your-weibo-url
DouBan: your-douban-url
ZhiHu: your-zhihu-url
```
### Feed 链接 Feed link
> 显示 feed 链接。
在主题配置文件`_config.yml`里设置`rss` , 如下所示:
1. `rss: false` 会禁用 feed 链接。
2. `rss: ` 使用站点 feed 链接。这是默认的选项。
按照插件[hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed)的README中的安装说明进行操作。在完成这个插件的配置后，Feed链接也生成好了
3. `rss: http://your-feed-url` 设置你的 feed 链接.
### 内置5种代码高亮主题 Up to 5 code highlight themes built-in
NexT 使用的是 [Tomorrow 主题](https://github.com/chriskempson/tomorrow-theme) ，一共有5种主题供你选择。
Next 默认使用 `normal`. 下面是 `normal` 和 `night` 主题的预览:
查看更多信息点击[Tomorrow 主题](https://github.com/chriskempson/tomorrow-theme)。
## 配置 Configuration
NexT 的配置很少
```yml
# Menu configuration.
menu:
home: /
archives: /archives
# Favicon
favicon: /favicon.ico
# Avatar (put the image into next/source/images/)
# can be any image format supported by web browsers (JPEG,PNG,GIF,SVG,..)
avatar: /default_avatar.png
# Code highlight theme
# available: normal | night | night eighties | night blue | night bright
highlight_theme: normal
# Fancybox for image gallery
fancybox: true
# Specify the date when the site was setup
since: 2013
```
## 浏览器支持 Browser support
[](https://www.browserstack.com/)
>**BrowserStack** is a cloud-based cross-browser testing tool that enables developers to test their websites across various browsers on different operating systems and mobile devices, without requiring users to install virtual machines, devices or emulators.
## 贡献 Contributing
接受各种形式的贡献，包括不限于提交问题与需求，修复代码。等待您的`Pull Request`。
Any types of contribution are welcome. Thanks.
**ATTENTION! Contributors on Chinese docs needed!**\
Need to translate from [English docs](README.md) to Chinese docs.\
Any help wanted!\
Thank's a lot!
## 开发 Development
NexT 主旨在于简洁优雅且易于使用，所以首先要尽量确保 NexT 的简洁易用性。
NexT is built for easily use with elegant appearance. First things first, always keep things simple.
## [开发历史 Changelog](https://github.com/iissnan/hexo-theme-next/wiki/Changelog)
[browser-image]: https://img.shields.io/badge/browser-%20chrome%20%7C%20firefox%20%7C%20opera%20%7C%20safari%20%7C%20ie%20%3E%3D%209-lightgrey.svg
[browser-url]: https://www.browserstack.com
[gitter-image]: https://badges.gitter.im/Join%20Chat.svg
[gitter-url]: https://gitter.im/iissnan/hexo-theme-next?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
[travis-image]: https://travis-ci.org/iissnan/hexo-theme-next.svg?branch=master
[travis-url]: https://travis-ci.org/iissnan/hexo-theme-next?branch=master "Travis CI"
[hexo-image]: https://img.shields.io/badge/hexo-%3E%3D%203.0-blue.svg
[hexo-url]: http://hexo.io
[mnt-image]: https://img.shields.io/maintenance/yes/2017.svg
[rel-image]: https://img.shields.io/github/release/iissnan/hexo-theme-next.svg
[lic-image]: https://img.shields.io/dub/l/vibe-d.svg
[git-image]: https://img.shields.io/badge/install%20with%20-git-blue.svg
[curl-tar-image]: https://img.shields.io/badge/install%20with%20-curl%20%7C%20tar-blue.svg
[curl-tar-wget-image]: https://img.shields.io/badge/install%20with%20-curl%20%7C%20tar%20%7C%20wget-blue.svg
[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
[download-latest-url]: https://github.com/iissnan/hexo-theme-next/archive/master.zip
[releases-latest-url]: https://github.com/iissnan/hexo-theme-next/releases/latest
[releases-url]: https://github.com/iissnan/hexo-theme-next/releases
[tags-url]: https://github.com/iissnan/hexo-theme-next/tags
[commits-url]: https://github.com/iissnan/hexo-theme-next/commits/master