Installation

Step 1 → Go to Hexo dir

Change dir to **hexo root** directory. There must be `node_modules`, `source`, `themes` and other directories: ```sh $ cd hexo $ ls _config.yml node_modules package.json public scaffolds source themes ```

Step 2 → Get NexT

Download theme from GitHub.
There are 3 options to do it, need to choose only one of them.

### Option 1: Download [latest release version][releases-latest-url] At most cases **stable**. Recommended for beginners. * Install with [curl & tar & wget][curl-tar-wget-url]: ```sh $ mkdir themes/next $ curl -s https://api.github.com/repos/theme-next/hexo-theme-next/releases/latest | grep tarball_url | cut -d '"' -f 4 | wget -i - -O- | tar -zx -C themes/next --strip-components=1 ``` This variant will give to you **only latest release version** (without `.git` directory inside).\ So, there is impossible to update this version with `git` later.\ Instead you always can use separate configuration (e.g. [data-files][docs-data-files-url]) and download new version inside old directory (or create new directory and redefine `theme` in Hexo config), without losing your old configuration. ### Option 2: Download [tagged release version][releases-url] In rare cases useful, but not recommended.\ You must define version. Replace `v6.0.0` with any version from [tags list][tags-url]. * Variant 1: Install with [curl & tar][curl-tar-url]: ```sh $ mkdir themes/next $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball/v6.0.0 | tar -zxv -C themes/next --strip-components=1 ``` Same as above under `curl & tar & wget` variant, but will download **only concrete version**. * Variant 2: Install with [git][git-url]: ```sh $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next ``` This variant will give to you the **defined release version** (with `.git` directory inside).\ And in any time you can switch to any tagged release, but with limit to defined version. ### Option 3: Download [latest master branch][download-latest-url] May be **unstable**, but includes latest features. Recommended for advanced users and for developers. * Variant 1: Install with [curl & tar][curl-tar-url]: ```sh $ mkdir themes/next $ curl -L https://api.github.com/repos/theme-next/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1 ``` Same as above under `curl & tar & wget` variant, but will download **only latest master branch version**.\ At some cases useful for developers. * Variant 2: Install with [git][git-url]: ```sh $ git clone https://github.com/theme-next/hexo-theme-next themes/next ``` This variant will give to you the **whole repository** (with `.git` directory inside).\ And in any time you can [update current version with git][update-with-git-url] and switch to any tagged release or on latest master or any other branch.\ At most cases useful as for users and for developers. Get tags list: ```sh $ cd themes/next $ git tag -l … v6.0.0 v6.0.1 v6.0.2 ``` For example, you want to switch on `v6.0.1` [tagged release version][tags-url]. Input the following command: ```sh $ git checkout tags/v6.0.1 Note: checking out 'tags/v6.0.1'. … HEAD is now at da9cdd2... Release v6.0.1 ``` And if you want to switch back on [master branch][commits-url], input this command: ```sh $ git checkout master ```

Step 3 → Set it up

Set theme in main **hexo root config** `_config.yml` file: ```yml theme: next ``` [download-latest-url]: https://github.com/theme-next/hexo-theme-next/archive/master.zip [releases-latest-url]: https://github.com/theme-next/hexo-theme-next/releases/latest [releases-url]: https://github.com/theme-next/hexo-theme-next/releases [tags-url]: https://github.com/theme-next/hexo-theme-next/tags [commits-url]: https://github.com/theme-next/hexo-theme-next/commits/master [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 [update-with-git-url]: https://github.com/theme-next/hexo-theme-next/blob/master/README.md#update [docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/DATA-FILES.md