INSTALLATION.md 6.5 KB

Установка

Шаг 1 → Идём в директорию Hexo

Меняем каталог на корневой hexo. Там должны находиться node_modules, source, themes и другие папки:

$ cd hexo
$ ls
_config.yml  node_modules  package.json  public  scaffolds  source  themes

Шаг 2 → Скачиваем NexT

Скачиваем тему с GitHub.
Имеются 3 способа как зделать это, нужно выбрать только 1 из них.

Способ 1: Скачиваем последнюю версию релиза

В большинстве случаев стабильна. Рекомендуется для начинающих пользователей.

  • Установка с помощью 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
    

    Этим способом Вы скачаете только последнюю версию релиза (без директории .git внутри).\ Поэтому, в дальнейшем будет невозможно обновить эту версию через git.\ Зато всегда можно использовать отдельную конфигурацию (т.е. дата-файлы) и скачивать новую версию перезаписывая старую (или создать новый каталог и переопределить параметр theme в конфиге Hexo), без потери старой конфигурации.

    Способ 2: Скачиваем указанную версию релиза

    В редких случаях полезно, но не рекомендуется.\ Необходимо указать версию. Замените v6.0.0 на любую версию из списка тэгов.

    • Вариант 1: Установка с помощью 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
    

    То же, что и описано выше в способе curl & tar & wget, но скачает только конкретную версию.

  • Вариант 2: Установка с помощью git:

     $ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next
    

    Этот вариант скачает указанную версию релиза (включая директорию .git внутри).\ И в любой момент Вы можете переключиться на любую весию тэга, но с лимитом до указанной версии.

    Способ 3: Скачиваем последнюю мастер-ветку

    Иногда может быть нестабильна, но включает самые последние нововведения. Рекомендуется для продвинутых пользователей и для разработчиков.

    • Вариант 1: Установка с помощью 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
    

    То же, что и описано выше в варианте curl & tar & wget, но скачает только последнюю мастер-ветку.\ В некоторых случаях полезно для разработчиков.

  • Вариант 2: Установка с помощью git:

     $ git clone https://github.com/theme-next/hexo-theme-next themes/next
    

    Этот вариант скачает весь репозиторий (включая директорию .git внутри).\ И в любой момент Вы можете обновить текущую версию через git и переключиться на любую версию тэга или на последнюю мастер или любую другую ветку.\ В большинстве случаев полезно как для пользователей, так и для разработчиков.

    Смотрим список тэгов:

     $ cd themes/next
     $ git tag -l
     …
     v6.0.0
     v6.0.1
     v6.0.2
    

    Например, Вы хотите переключиться на версию релиза v6.0.1. Вводим следующую команду:

     $ git checkout tags/v6.0.1
     Note: checking out 'tags/v6.0.1'.
     …
     HEAD is now at da9cdd2... Release v6.0.1
    

    И если вы хотите переключиться обратно на мастер-ветку, вводим следующее:

     $ git checkout master
    

Шаг 3 → Конфигурируем

Устанавливаем параметр темы в конфиге _config.yml корневой директории hexo:

theme: next