{"id":13430446,"url":"https://github.com/iissnan/hexo-theme-next","last_synced_at":"2026-02-22T15:02:17.802Z","repository":{"id":23998465,"uuid":"27382163","full_name":"iissnan/hexo-theme-next","owner":"iissnan","description":"Elegant theme for Hexo. ","archived":false,"fork":false,"pushed_at":"2022-11-10T06:22:41.000Z","size":13366,"stargazers_count":15857,"open_issues_count":89,"forks_count":3642,"subscribers_count":443,"default_branch":"master","last_synced_at":"2024-04-14T14:17:00.652Z","etag":null,"topics":["hexo","hexo-theme","theme-next"],"latest_commit_sha":null,"homepage":"http://notes.iissnan.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iissnan.png","metadata":{"files":{"readme":"README.cn.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-12-01T14:07:07.000Z","updated_at":"2024-04-14T14:17:00.653Z","dependencies_parsed_at":"2022-07-13T15:59:41.921Z","dependency_job_id":null,"html_url":"https://github.com/iissnan/hexo-theme-next","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iissnan%2Fhexo-theme-next","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iissnan%2Fhexo-theme-next/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iissnan%2Fhexo-theme-next/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iissnan%2Fhexo-theme-next/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iissnan","download_url":"https://codeload.github.com/iissnan/hexo-theme-next/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830912,"owners_count":20354848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hexo","hexo-theme","theme-next"],"created_at":"2024-07-31T02:00:53.774Z","updated_at":"2025-10-22T20:39:50.407Z","avatar_url":"https://github.com/iissnan.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Content","其他","CSS"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e本项目已停止维护。:warning:\u003c/h1\u003e\n\u003ch2 align=\"center\"\u003e社区维护的版本请移步这里：\u003ca href=\"https://github.com/theme-next/hexo-theme-next\"\u003eNexT v6 and v7 :triangular_flag_on_post:\u003c/a\u003e\u003c/h2\u003e\n\n\u003ch1 align=\"center\"\u003eNexT\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eNexT 是一个高质量并且优雅的\u003ca href=\"http://hexo.io\"\u003eHexo\u003c/a\u003e 主题。这是精心制作做出来的 hexo 主题。\u003c/p\u003e\n\n[![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\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![mnt-image]][commits-url]\n[![travis-image]][travis-url]\n[![rel-image]][releases-url]\n[![hexo-image]][hexo-url]\n[![lic-image]](LICENSE)\n\n* \u003ca href=\"http://theme-next.iissnan.com\" target=\"_blank\"\u003eNexT 使用文档\u003c/a\u003e |  [English Documentation](README.md)\n\n## 实时预览 Live Preview\n\n\n* :heart_decoration: Muse 方案: [LEAFERx](https://leaferx.online) | [XiaMo](https://notes.wanghao.work) | [OAwan](https://oawan.me)\n* :six_pointed_star: Mist 方案: [Jeff](https://blog.zzbd.org) | [uchuhimo](http://uchuhimo.me) | [xirong](http://www.ixirong.com)\n* :pisces: Pisces 方案: [Vi](http://notes.iissnan.com) | [Acris](https://acris.me) | [Rainy](https://rainylog.com)\n* :gemini: Gemini 方案: [Ivan.Nginx](https://almostover.ru) | [Raincal](https://raincal.com) | [Dandy](https://dandyxu.me)\n\n\n更多 NexT 例子点击 [这里](https://github.com/iissnan/hexo-theme-next/issues/119).\n\n## 安装 Installation\n\n**1.** 在终端切换到**hexo 根**目录. 在hexo目录下一定有 `node_modules`, `source`, `themes` 和其他文件夹:\n   ```sh\n   $ cd hexo\n   $ ls\n   _config.yml  node_modules  package.json  public  scaffolds  source  themes\n   ```\n\n**2.** 从 github 上获取主题 。这里有几种方式来获取主题:\n\n### 下载[最新发布的版本][releases-latest-url]  Download tagged release version\n   在大多数情况下 **稳定**。 推荐用户下载这个。\n\n   [![curl-tar-wget-image]][curl-tar-wget-url]\n\n   ```sh\n   $ mkdir themes/next\n   $ 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\n   ```\n\n### 下载[标签发布版本][releases-url]  Download tagged release version\n   您必须定义版本。从[标签列表][tags-url]里选择版本替换`v5.1.2`。\n\n   [![curl-tar-image]][curl-tar-url]\n\n   ```sh\n   $ mkdir themes/next\n   $ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball/v5.1.2 | tar -zxv -C themes/next --strip-components=1\n   ```\n\n   [![git-image]][git-url]\n\n   ```sh\n   $ git clone --branch v5.1.2 https://github.com/iissnan/hexo-theme-next themes/next\n   ```\n\n### 下载[最新的 master 分支][download-latest-url]  Download latest master branch\n  可能会 **不稳定**, 但是包含最新的特色，推荐开发者下载.\n\n   [![curl-tar-image]][curl-tar-url]\n\n   ```sh\n   $ mkdir themes/next\n   $ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1\n   ```\n\n   [![git-image]][git-url]\n\n   ```sh\n   $ git clone https://github.com/iissnan/hexo-theme-next themes/next\n   ```\n\n  使用克隆命令，你将得到**整个存储库**。而且在任何时候你都可以切换到任何标签发布版本。\n  获取标签列表：\n\n   ```sh\n   $ cd themes/next\n   $ git tag -l\n   …\n   v5.0.0\n   v5.0.1\n   v5.1.0\n   v5.1.1\n   v5.1.2\n   ```\n\n   例如, 你想要切换到`v5.1.0` [标签发布版本][tags-url]. 输入以下命令:\n\n   ```sh\n   $ git checkout tags/v5.1.0\n   Note: checking out 'tags/v5.1.0'.\n   …\n   HEAD now on 1f72f68... CSS: Remove global list-style setting of ul\n   ```\n\n   如果你想切换回 [master 分支][commits-url]的话, 输入这个命令:\n\n   ```sh\n   $ git checkout master\n   ```\n\n**3.** 在 **hexo 根目录下** 的配置文件`_config.yml`里设置主题:\n\n    theme: next\n\n### Bugs\n对于那些遇到 **Error: Cannot find module 'hexo-util'** [问题](https://github.com/iissnan/hexo-theme-next/issues/1490)的人, 请检查你的NPM 版本.\n\n- `版本 \u003e 3`: 如果仍然不行的话，请移除 `node_modules` 文件 然后重新安装，使用 `npm install`命令。\n- `版本 \u003c 3`: 请通过`npm install --save-dev hexo-util`命令添加`hexo-util`到你的站点包依赖里\n\n## 更新 Update\n\n```sh\n$ cd themes/next\n$ git pull\n```\n\n### Bugs\n\n\u003e 提交您的更改或存储它们，然后才能合并。\n\n您必须提交，存储或放弃本地更改. 看 [here](https://stackoverflow.com/a/15745424/5861495) 是如何做的。\n\n### 使用Hexo data files([#328](https://github.com/iissnan/hexo-theme-next/issues/328))配置主题  Theme configurations using Hexo data files #328\n\n\n目前升级 NexT 主题的时候并不是非常的流畅。若使用 `git pull` 的方式，很多时候可能会产生冲突；而下载新版本覆盖安装的方式又需要手动合并主题的 `_config.yml` 文件。\n\n在此修改之前， NexT 建议将配置分离，一部分在 站点的配置文件中，另外一部分在主题的配置文件中。将需要自定的选项放置在 站点配置文件中，从而脱离避免更新主题时可能遇到的麻烦。这种方式是可行，但是有一些缺点：\n\n1. 配置分离成了两个部分\n2. 用户可能会疑惑一些选项该放置在哪里比较合适\n\n为了解决这个问题， NexT 将会使用 Hexo 的 [Data Files](https://hexo.io/docs/data-files.html) 。然而由于 Data Files 是在 Hexo 3 版本时引进的，所以要使用这个特性，需要 Hexo 的版本不低于 3。\n\n若你比较喜欢 Hexo 2.x 版本，可以继续使用原先的配置方式。 NexT 保持着向下兼容。\n\n\n#### 特性 Benefits\n\n通过这个特性，你可以将所有的主题配置放置在站点的 `source/_data/next.yml` 文件中。原先放置在 站点配置文件 中的选项可以迁移到新的位置，同时，主题配置文件可以不用做任何修改。若后续版本有配置相关的改动时，你仅需在 `next.yml` 中做相应调整即可\n\n\n#### 如何使用这个特性 How to use this feature\n\n1. 请先确保你所使用的 Hexo 版本在 3 以上\n2. 在站点的 `source/_data` 目录下新建 `next.yml` 文件（`_data`目录可能需要新建）\n3. 迁移站点配置文件和主题配置文件中的配置到 `next.yml` 中\n4. 使用 `--config source/_data/next.yml` 参数启动服务器, 生成或者部署。\\\n   例如: `hexo clean --config source/_data/next.yml \u0026\u0026 hexo g --config source/_data/next.yml`。\n\n## 特色 Features\n\n### 支持多国语言, 包括:\n:cn: 简体中文 \u0026 繁体中文\u003cbr\u003e\n:us: 英语\u003cbr\u003e\n:ru: 俄语\u003cbr\u003e\n:fr: 法语\u003cbr\u003e\n:de: 德语\u003cbr\u003e\n:jp: 日语\u003cbr\u003e\n:indonesia: 印度尼西亚语\u003cbr\u003e\n:portugal: 葡萄牙语 (巴西)\u003cbr\u003e\n:kr: 朝鲜语\u003cbr\u003e\n:it: 意大利语\u003cbr\u003e\n:netherlands: 荷兰语\n\n默认语言是英语。\n\n```yml\nlanguage: en\n# language: zh-Hans\n# language: zh-hk\n# language: zh-tw\n# language: ru\n# language: fr-FR\n# language: de\n# language: ja\n# language: id\n# language: pt\n# language: pt-BR\n# language: ko\n# language: it\n# language: nl-NL\n```\n\n在站点配置文件`_config.yml`中可以将语言切换成中文\n\n```yml\nlanguage: zh-Hans\n```\n\n### 评论支持 Comment support\n\nNexT 已经原生支持 `多说` and `Disqus` 评论系统。\n\n添加以下代码到你的主题配置文件 `_config.yml`:\n\n```yml\nduoshuo:\n  enable: true\n  shortname: your-duoshuo-shortname\n```\n\n或者\n\n```yml\ndisqus_shortname: your-disqus-shortname\n```\n\n### 标签页 Tags page\n\n\u003e 添加一个标签页面，里面包含您网站中的所有标签。\n\n- 创建一个名为 `tags` 页面\n\n        hexo new page \"tags\"\n\n- 编辑标签页, 设置页面类型为`tags`.\n\n        title: All tags\n        date: 2014-12-22 12:39:04\n        type: \"tags\"\n\n- 添加 `tags` 到主题配置文件 `_config.yml` 里:\n\n        menu:\n          home: /\n          archives: /archives\n          tags: /tags\n\n### 分类页 Categories page\n\n\u003e 添加一个分类页面，里面包含您网站中的所有分类。\n\n- 创建一个名为 `categories` 页面\n\n        hexo new page \"categories\"\n\n- 编辑分类页, 设置页面类型为 `categories`.\n\n        title: All categories\n        date: 2014-12-22 12:39:04\n        type: \"categories\"\n\n- 添加 `categories` 到主题配置文件 `_config.yml` 里:\n\n        menu:\n          home: /\n          archives: /archives\n          categories: /categories\n\n### 社交媒体 Social Media\n\nNexT 可以自动添加链接到您的社交媒体帐户里:\n\n```yml\nsocial:\n  GitHub: your-github-url\n  Twitter: your-twitter-url\n  Weibo: your-weibo-url\n  DouBan: your-douban-url\n  ZhiHu: your-zhihu-url\n```\n\n### Feed 链接 Feed link\n\n\u003e 显示 feed 链接。\n\n在主题配置文件`_config.yml`里设置`rss` , 如下所示:\n\n1. `rss: false` 会禁用 feed 链接。\n2. `rss:  ` 使用站点 feed 链接。这是默认的选项。\n\n    按照插件[hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed)的README中的安装说明进行操作。在完成这个插件的配置后，Feed链接也生成好了\n\n3. `rss: http://your-feed-url` 设置你的 feed 链接.\n\n### 内置5种代码高亮主题 Up to 5 code highlight themes built-in\n\nNexT 使用的是 [Tomorrow 主题](https://github.com/chriskempson/tomorrow-theme) ，一共有5种主题供你选择。\nNext 默认使用 `normal`. 下面是 `normal` 和 `night` 主题的预览:\n\n![Tomorrow Normal Preview](http://iissnan.com/nexus/next/tomorrow-normal.png)\n![Tomorrow Night Preview](http://iissnan.com/nexus/next/tomorrow-night.png)\n\n查看更多信息点击[Tomorrow 主题](https://github.com/chriskempson/tomorrow-theme)。\n\n## 配置 Configuration\n\nNexT 的配置很少\n\n```yml\n\n# Menu configuration.\nmenu:\n  home: /\n  archives: /archives\n\n# Favicon\nfavicon: /favicon.ico\n\n# Avatar (put the image into next/source/images/)\n# can be any image format supported by web browsers (JPEG,PNG,GIF,SVG,..)\navatar: /default_avatar.png\n\n# Code highlight theme\n# available: normal | night | night eighties | night blue | night bright\nhighlight_theme: normal\n\n# Fancybox for image gallery\nfancybox: true\n\n# Specify the date when the site was setup\nsince: 2013\n\n```\n\n\n## 浏览器支持 Browser support\n\n![Browser support](http://iissnan.com/nexus/next/browser-support.png)\n\n[![Browser Stack](.github/browserstack_logo.png)](https://www.browserstack.com/)\n\u003e**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.\n\n## 贡献 Contributing\n\n接受各种形式的贡献，包括不限于提交问题与需求，修复代码。等待您的`Pull Request`。\n\nAny types of contribution are welcome. Thanks.\n\n**ATTENTION! Contributors on Chinese docs needed!**\\\nNeed to translate from [English docs](README.md) to Chinese docs.\\\nAny help wanted!\\\nThank's a lot!\n\n## 开发 Development\n\nNexT 主旨在于简洁优雅且易于使用，所以首先要尽量确保 NexT 的简洁易用性。\n\nNexT is built for easily use with elegant appearance. First things first, always keep things simple.\n\n## [开发历史 Changelog](https://github.com/iissnan/hexo-theme-next/wiki/Changelog)\n\n\n\n[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\n[browser-url]: https://www.browserstack.com\n\n[gitter-image]: https://badges.gitter.im/Join%20Chat.svg\n[gitter-url]: https://gitter.im/iissnan/hexo-theme-next?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\n\n[travis-image]: https://travis-ci.org/iissnan/hexo-theme-next.svg?branch=master\n[travis-url]: https://travis-ci.org/iissnan/hexo-theme-next?branch=master \"Travis CI\"\n\n[hexo-image]: https://img.shields.io/badge/hexo-%3E%3D%203.0-blue.svg\n[hexo-url]: http://hexo.io\n\n[mnt-image]: https://img.shields.io/maintenance/yes/2017.svg\n[rel-image]: https://img.shields.io/github/release/iissnan/hexo-theme-next.svg\n\u003c!--[lic-image]: https://img.shields.io/npm/l/hexo-theme-next.svg--\u003e\n[lic-image]: https://img.shields.io/dub/l/vibe-d.svg\n\n[git-image]: https://img.shields.io/badge/install%20with%20-git-blue.svg\n[curl-tar-image]: https://img.shields.io/badge/install%20with%20-curl%20%7C%20tar-blue.svg\n[curl-tar-wget-image]: https://img.shields.io/badge/install%20with%20-curl%20%7C%20tar%20%7C%20wget-blue.svg\n[git-url]: http://lmgtfy.com/?q=linux+git+install\n[curl-tar-url]: http://lmgtfy.com/?q=linux+curl+tar+install\n[curl-tar-wget-url]: http://lmgtfy.com/?q=linux+curl+tar+wget+install\n\n[download-latest-url]: https://github.com/iissnan/hexo-theme-next/archive/master.zip\n[releases-latest-url]: https://github.com/iissnan/hexo-theme-next/releases/latest\n[releases-url]: https://github.com/iissnan/hexo-theme-next/releases\n[tags-url]: https://github.com/iissnan/hexo-theme-next/tags\n[commits-url]: https://github.com/iissnan/hexo-theme-next/commits/master\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiissnan%2Fhexo-theme-next","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiissnan%2Fhexo-theme-next","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiissnan%2Fhexo-theme-next/lists"}