Skip to content

Latest commit

 

History

History
121 lines (87 loc) · 4.54 KB

INSTALLATION.md

File metadata and controls

121 lines (87 loc) · 4.54 KB

Installation

Step 1 → Go to Hexo dir

Change dir to Hexo root directory. There must be node_modules, source, themes and other directories:

$ 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

At most cases stable. Recommended for beginners.

  • Install with curl & tar & wget:

    $ 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) 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

In rare cases useful, but not recommended.
You must define version. Replace v6.0.0 with any version from tags list.

  • Variant 1: Install with curl & tar:

    $ 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 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

May be unstable, but includes latest features. Recommended for advanced users and for developers.

  • Variant 1: Install with curl & tar:

    $ 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 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 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:

    $ 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. Input the following command:

    $ 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, input this command:

    $ git checkout master

Step 3 → Set it up

Set theme in main Hexo root config _config.yml file:

theme: next