121 lines
6.5 KiB
Markdown
121 lines
6.5 KiB
Markdown
<h1 align="center">Установка</h1>
|
||
|
||
<h2 align="center">Шаг 1 → Идём в директорию Hexo</h2>
|
||
|
||
Меняем каталог на **корневой hexo**. Там должны находиться `node_modules`, `source`, `themes` и другие папки:
|
||
```sh
|
||
$ cd hexo
|
||
$ ls
|
||
_config.yml node_modules package.json public scaffolds source themes
|
||
```
|
||
|
||
<h2 align="center">Шаг 2 → Скачиваем NexT</h2>
|
||
|
||
<p align="center">Скачиваем тему с GitHub.</br>
|
||
Имеются <b>3 способа</b> как зделать это, нужно <b>выбрать только 1</b> из них.</p>
|
||
|
||
### Способ 1: Скачиваем [последнюю версию релиза][releases-latest-url]
|
||
|
||
В большинстве случаев **стабильна**. Рекомендуется для начинающих пользователей.
|
||
|
||
* Установка с помощью [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
|
||
```
|
||
Этим способом Вы скачаете **только последнюю версию релиза** (без директории `.git` внутри).\
|
||
Поэтому, в дальнейшем будет невозможно обновить эту версию через `git`.\
|
||
Зато всегда можно использовать отдельную конфигурацию (т.е. [дата-файлы][docs-data-files-url]) и скачивать новую версию перезаписывая старую (или создать новый каталог и переопределить параметр `theme` в конфиге Hexo), без потери старой конфигурации.
|
||
|
||
### Способ 2: Скачиваем [указанную версию релиза][releases-url]
|
||
|
||
В редких случаях полезно, но не рекомендуется.\
|
||
Необходимо указать версию. Замените `v6.0.0` на любую версию из [списка тэгов][tags-url].
|
||
|
||
* Вариант 1: Установка с помощью [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
|
||
```
|
||
То же, что и описано выше в способе `curl & tar & wget`, но скачает **только конкретную версию**.
|
||
|
||
* Вариант 2: Установка с помощью [git][git-url]:
|
||
|
||
```sh
|
||
$ git clone --branch v6.0.0 https://github.com/theme-next/hexo-theme-next themes/next
|
||
```
|
||
Этот вариант скачает **указанную версию релиза** (включая директорию `.git` внутри).\
|
||
И в любой момент Вы можете переключиться на любую весию тэга, но с лимитом до указанной версии.
|
||
|
||
### Способ 3: Скачиваем [последнюю мастер-ветку][download-latest-url]
|
||
|
||
Иногда может быть **нестабильна**, но включает самые последние нововведения. Рекомендуется для продвинутых пользователей и для разработчиков.
|
||
|
||
* Вариант 1: Установка с помощью [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
|
||
```
|
||
То же, что и описано выше в варианте `curl & tar & wget`, но скачает **только последнюю мастер-ветку**.\
|
||
В некоторых случаях полезно для разработчиков.
|
||
|
||
* Вариант 2: Установка с помощью [git][git-url]:
|
||
|
||
```sh
|
||
$ git clone https://github.com/theme-next/hexo-theme-next themes/next
|
||
```
|
||
|
||
Этот вариант скачает **весь репозиторий** (включая директорию `.git` внутри).\
|
||
И в любой момент Вы можете [обновить текущую версию через git][update-with-git-url] и переключиться на любую версию тэга или на последнюю мастер или любую другую ветку.\
|
||
В большинстве случаев полезно как для пользователей, так и для разработчиков.
|
||
|
||
Смотрим список тэгов:
|
||
|
||
```sh
|
||
$ cd themes/next
|
||
$ git tag -l
|
||
…
|
||
v6.0.0
|
||
v6.0.1
|
||
v6.0.2
|
||
```
|
||
|
||
Например, Вы хотите переключиться на [версию релиза][tags-url] `v6.0.1`. Вводим следующую команду:
|
||
|
||
```sh
|
||
$ git checkout tags/v6.0.1
|
||
Note: checking out 'tags/v6.0.1'.
|
||
…
|
||
HEAD is now at da9cdd2... Release v6.0.1
|
||
```
|
||
|
||
И если вы хотите переключиться обратно на [мастер-ветку][commits-url], вводим следующее:
|
||
|
||
```sh
|
||
$ git checkout master
|
||
```
|
||
|
||
<h2 align="center">Шаг 3 → Конфигурируем</h2>
|
||
|
||
Устанавливаем параметр темы в конфиге `_config.yml` **корневой директории hexo**:
|
||
|
||
```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/docs/ru/README.md#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0
|
||
[docs-data-files-url]: https://github.com/theme-next/hexo-theme-next/blob/master/docs/ru/DATA-FILES.md
|