iissnan / hexo-theme-next

This repository is no longer maintained! :warning: The community-maintained version is here: NexT v6 and v7 :triangular_flag_on_post: NexT NexT is a high quality elegant Hexo theme. It is crafted from scratch, with love. [![gitter-image]][gitter-url] [![mnt-image]](https://github.com/theme-next/hexo-theme-next) [![travis-image]][travis-url] [![rel-image]][releases-url] [![hexo-image]][hexo-url] [![lic-image]](LICENSE) • Chinese Documentation Live Preview • :heart_decoration: Muse scheme: LEAFERx | XiaMo | OAwan • :six_pointed_star: Mist scheme: Jeff | uchuhimo | xirong • :pisces: Pisces scheme: Vi | Acris | Rainy • :gemini: Gemini scheme: Ivan.Nginx | Raincal | Dandy More NexT examples here. Installation **1.** Change dir to **hexo root** directory. There must be , , and other directories: **2.** Get theme from GitHub. There are several variants to do it: Download [latest release version][releases-latest-url]. At most cases **stable**. Recommended for most users. [![curl-tar-wget-image]][curl-tar-wget-url] Download [tagged release version][releases-url]. You must define version. Replace with any version from [tags list][tags-url]. [![curl-tar-image]][curl-tar-url] [![git-image]][git-url] Download [latest master branch][download-latest-url]. May be **unstable**, but includes latest features. Recommended for developers. [![curl-tar-image]][curl-tar-url] [![git-image]][git-url] Clone command will give you the **whole repository**. And in any time you can switch to any tagged release.\ Get tags list: For example, you want to switch on [tagged release version][tags-url]. Input the following command: And if you want to switch back on [master branch][commits-url], input this command: **3.** Set theme in main **hexo root config** file: theme: next Bugs For those who also encounter **Error: Cannot find module 'hexo-util'** issue, please check your NPM version. • : Still not work. Please remove directory and reinstall using . • : Please add explicitly via to you site package deps. Update Bugs > Commit your changes or stash them before you can merge You must Commit, Stash or Discard local changes. See here how to do it. Theme configurations using Hexo data files (#328) 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 , or need to merge configurations manually when upgrading to new releases. At present, NexT encourages users to store some options in site's and other options in theme's . This approach is applicable, but has some drawbacks: • Configurations are splited into two pieces • Users maybe confuse which place should be for options In order to resolve this issue, NexT will take advantage of Hexo Data files. Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature. If you prefer Hexo 2.x, you can still use the old approach for configurations. NexT is still compatible with Hexo 2.x. Benefits With this feature, now you can put all your configurations into one place ( ), you don't need to touch . If there are any new options in new releases, you just need to copy those options from , paste into and set their values to whatever you want. How to use this feature • Please ensure you are using Hexo 3 (or above) • Create an file named in site's directory (create directory if it did not exist) • Copy NexT theme options both in site's and theme's into . • Use parameter to start server, generate or deploy.\ For example: . Features Multiple languages support, including: :cn: Simplified Chinese & Traditional Chinese. :us: English :ru: Russian :fr: French :de: German :jp: Japanese :indonesia: Indonesian :portugal: Portuguese (Brazil) :kr: Korean :it: Italian :netherlands: Dutch :vietnam: Vietnamese Default language is English. Set field as following in site to change to Chinese. Comment support. NexT has native support for and comment systems. Add the following snippets to your : OR Tags page. > Add a tags page contains all tags in your site. • Create a page named hexo new page "tags" • Edit tags page, set page type to . title: All tags date: 2014-12-22 12:39:04 type: "tags" • Add to theme : menu: home: / archives: /archives tags: /tags Categories page. > Add a categories page contains all categories in your site. • Create a page named hexo new page "categories" • Edit categories page, set page type to . title: All categories date: 2014-12-22 12:39:04 type: "categories" • Add to theme : menu: home: / archives: /archives categories: /categories Social Media NexT can automatically add links to your Social Media accounts: Feed link. > Show a feed link. Set field in theme's , as the following value: • will totally disable feed link. • use sites' feed link. This is the default option. Follow the installation instruction in the plugin's README. After the configuration is done for this plugin, the feed link is ready too. • set specific feed link. Up to 5 code highlight themes built-in. NexT uses Tomorrow Theme with 5 themes for you to choose from. Next use by default. Have a preview about and : Head over to Tomorrow Theme for more details. Configuration NexT comes with few configurations. Browser support ![browser-image] >**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 Contribution is welcome, feel free to open an issue and fork. Waiting for your pull request. [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://git…