mirror of
https://github.com/next-theme/hexo-theme-next.git
synced 2026-01-18 18:33:42 +00:00
166 lines
7.2 KiB
Markdown
166 lines
7.2 KiB
Markdown
<div align="right">
|
||
语言:
|
||
<a title="英语" href="../../README.md">🇺🇸</a>
|
||
🇨🇳
|
||
<a title="俄语" href="../ru/README.md">🇷🇺</a>
|
||
</div>
|
||
|
||
|
||
|
||
<a title="NexT 网站" href="https://theme-next.js.org"><img align="right" alt="NexT logo" width="100" height="100" src="https://raw.githubusercontent.com/next-theme/hexo-theme-next/master/source/images/logo.svg"></a>
|
||
|
||
# NexT
|
||
|
||
> «NexT» 是一款风格优雅的高质量 [Hexo](https://hexo.io) 主题，自点点滴滴中用爱雕琢而成。
|
||
|
||
[](https://www.npmjs.com/package/hexo-theme-next)
|
||
[](https://hexo.io)
|
||
[](https://github.com/next-theme/hexo-theme-next/blob/master/LICENSE.md)
|
||
[](https://lgtm.com/projects/g/next-theme/hexo-theme-next/)
|
||
[](https://github.com/next-theme/hexo-theme-next/actions?query=workflow%3ALinter)
|
||
[](https://github.com/next-theme/hexo-theme-next/actions?query=workflow%3ATester)
|
||
|
||
## 即时预览
|
||
|
||
<p align="center">
|
||
💟 <a href="https://theme-next.js.org/muse/">Muse</a> | 🔯 <a href="https://theme-next.js.org/mist/">Mist</a> | ♓️ <a href="https://theme-next.js.org/pisces/">Pisces</a> | ♊️ <a href="https://theme-next.js.org">Gemini</a>
|
||
<br>
|
||
<br>
|
||
更多 «NexT» 的例子参见<a href="https://github.com/next-theme/awesome-next#live-preview">这里</a>。
|
||
</p>
|
||
|
||
## 安装
|
||
|
||
如果你在使用 Hexo 5.0 或更新版本，最简单的安装方式是通过 npm：
|
||
|
||
```sh
|
||
$ cd hexo-site
|
||
$ npm install hexo-theme-next
|
||
```
|
||
|
||
你也可以直接克隆整个仓库：
|
||
|
||
```sh
|
||
$ cd hexo-site
|
||
$ git clone https://github.com/next-theme/hexo-theme-next themes/next
|
||
```
|
||
|
||
此外，如果你想要使用其他方式，请参见[详细安装步骤][docs-installation-url]。
|
||
|
||
安装完成后，在 Hexo 配置文件中将 `theme` 设置为 `next`。
|
||
|
||
```yml
|
||
theme: next
|
||
```
|
||
|
||
## 配置
|
||
|
||
目前 NexT 鼓励用户使用 [Alternate Theme Config][docs-configuration-url] 进行配置。并且可以轻松地通过 [Custom Files][docs-custom-files-url] 自定义主题的布局和样式。
|
||
|
||
不推荐直接修改 NexT 主题的文件。因为这可能导致错误（例如 git merge 冲突），并且在升级主题时修改的文件可能丢失。
|
||
|
||
然而你也可以通过提交（`Commit`）、贮藏（`Stash`）或忽视（`Discard`）本地更改以绕过这种更新错误 (例如 **«Commit your changes or stash them before you can merge»**)。具体方法请参考[这里](https://stackoverflow.com/a/15745424/5861495)。
|
||
|
||
## 插件
|
||
|
||
插件丰富和拓展了 NexT 的功能。这些插件分为两种：核心插件和第三方插件。核心插件被 NexT 的基础功能所依赖。第三方插件提供了大量的可选功能。
|
||
|
||
配置这些插件非常简单。例如，你想要在你的站点中使用 `pjax` 插件，请进入 NexT 配置文件，启用 `pjax` 配置项：
|
||
|
||
```yml
|
||
# Easily enable fast Ajax navigation on your website.
|
||
# For more information: https://github.com/next-theme/pjax
|
||
pjax: true
|
||
```
|
||
|
||
### 设置 CDN
|
||
|
||
第三方插件默认通过 [jsDelivr](https://www.jsdelivr.com) CDN 服务加载。我们也提供了其它的 CDN 服务供选择，包括著名的 [UNPKG](https://unpkg.com) 和 [CDNJS](https://cdnjs.com)。
|
||
|
||
例如，你想要使用 `unpkg` 代替 `jsdelivr` 作为默认的 CDN 提供商，你需要在 NexT 配置文件中进行如下设置：
|
||
|
||
```yml
|
||
vendors:
|
||
# ...
|
||
# Some contents...
|
||
# ...
|
||
plugins: unpkg
|
||
```
|
||
|
||
## 更新
|
||
|
||
NexT 每个月都会发布新版本。你可以通过如下命令更新 NexT。
|
||
|
||
通过 npm 安装最新版本：
|
||
|
||
```sh
|
||
$ cd hexo-site
|
||
$ npm update hexo-theme-next
|
||
```
|
||
|
||
或者通过 git 更新到最新的 master 分支：
|
||
|
||
```sh
|
||
$ cd themes/next
|
||
$ git pull
|
||
```
|
||
|
||
**如果你想要从 v5.x / v7.x 更新到最新版本，阅读[这篇文档][docs-update-5-1-x-url]。**
|
||
|
||
## 反馈
|
||
|
||
* 浏览 [Awesome NexT][awesome-next-url] 列表，与其它用户分享插件和教程。
|
||
* 加入我们的 [Gitter][gitter-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][contributors-image]][contributors-url]
|
||
|
||
## 鸣谢
|
||
|
||
«NexT» 特别感谢这些支持我们核心基础设施的优质服务：
|
||
|
||
<a href="https://github.com"><img height="40" src="https://github.githubassets.com/images/modules/logos_page/GitHub-Logo.png"></a>
|
||
|
||
> GitHub 容许我们托管 Git 仓库及运行测试。
|
||
|
||
<a href="https://www.netlify.com"><img height="40" src="https://www.netlify.com/img/press/logos/full-logo-light.svg"></a>
|
||
|
||
> Netlify 容许我们发布文档。
|
||
|
||
<a href="https://crowdin.com"><img height="40" src="https://support.crowdin.com/assets/logos/crowdin-logo-small-black.svg"></a>
|
||
|
||
> Crowdin 容许我们方便地翻译文档。
|
||
|
||
<a href="https://www.jsdelivr.com"><img height="40" src="https://raw.githubusercontent.com/jsdelivr/jsdelivr-media/master/default/svg/jsdelivr-logo-horizontal.svg"></a>
|
||
|
||
> jsDelivr 提供了 CDN 服务。
|
||
|
||
[docs-installation-url]: https://theme-next.js.org/docs/getting-started/installation.html
|
||
[docs-configuration-url]: https://theme-next.js.org/docs/getting-started/configuration.html
|
||
[docs-custom-files-url]: https://theme-next.js.org/docs/theme-settings/custom-files.html
|
||
[docs-update-5-1-x-url]: https://theme-next.js.org/docs/getting-started/update-from-v5.html
|
||
|
||
[gitter-url]: https://gitter.im/hexo-next
|
||
[i18n-url]: https://crowdin.com/project/hexo-theme-next
|
||
|
||
[awesome-next-url]: https://github.com/next-theme/awesome-next
|
||
[issues-bug-url]: https://github.com/next-theme/hexo-theme-next/issues/new?assignees=&labels=Bug&template=bug-report.md
|
||
[issues-feat-url]: https://github.com/next-theme/hexo-theme-next/issues/new?assignees=&labels=Feature+Request&template=feature-request.md
|
||
[feat-req-vote-url]: https://github.com/next-theme/hexo-theme-next/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22
|
||
|
||
[contributing-document-url]: https://github.com/next-theme/hexo-theme-next/blob/master/docs/zh-CN/CONTRIBUTING.md
|
||
[official-plugins-url]: https://github.com/next-theme
|
||
[contributors-image]: https://raw.githubusercontent.com/next-theme/contributors/master/contributors.svg
|
||
[contributors-url]: https://github.com/next-theme/hexo-theme-next/blob/master/docs/AUTHORS.md
|