Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iissnan/hexo-theme-next

Elegant theme for Hexo.
https://github.com/iissnan/hexo-theme-next

hexo hexo-theme theme-next

Last synced: about 2 months ago
JSON representation

Elegant theme for Hexo.

Host: GitHub
URL: https://github.com/iissnan/hexo-theme-next
Owner: iissnan
License: mit
Created: 2014-12-01T14:07:07.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2022-11-10T06:22:41.000Z (almost 2 years ago)
Last Synced: 2024-04-14T14:17:00.652Z (5 months ago)
Topics: hexo, hexo-theme, theme-next
Language: JavaScript
Homepage: http://notes.iissnan.com
Size: 12.7 MB
Stars: 15,857
Watchers: 443
Forks: 3,642
Open Issues: 89
Metadata Files:
- Readme: README.cn.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-hexo-themes - iissnan/hexo-theme-next
my-awesome - hexo-theme-next - Elegant theme for Hexo. (CSS)
awesome-github-star - hexo-theme-next

README

本项目已停止维护。:warning:

社区维护的版本请移步这里：NexT v6 and v7 :triangular_flag_on_post:

NexT 是一个高质量并且优雅的Hexo 主题。这是精心制作做出来的 hexo 主题。

[![Join the chat at https://gitter.im/iissnan/hexo-theme-next](https://badges.gitter.im/Join%20Chat.svg)](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 Normal Preview](http://iissnan.com/nexus/next/tomorrow-normal.png)
![Tomorrow Night Preview](http://iissnan.com/nexus/next/tomorrow-night.png)

查看更多信息点击[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

![Browser support](http://iissnan.com/nexus/next/browser-support.png)

[![Browser Stack](.github/browserstack_logo.png)](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