Установка Hexo и размещение сайта на Github Pages

Это страница очень рекурсивна: это страница-пример выполнения инструкций на этой странице! Оригинал записи находится на lisakov.com.

Hexo — это генератор статических сайтов, подобный Jekyll, Pelican, Octopress, Hugo и т.д.

Что такое генераторы статических сайтов и зачем они нужны?

Сайт, который Вы читаете прямо сейчас — статический. Все странички здесь — это обычные html файлы. Большинство статических журналов создаются с помощью различных генераторов статических сайтов.

Зачем они нужны, эти генераторы? Ведь можно, например, написать самому CSS- и html-код для каждой страницы своего сайта. Но при добавлении, например, записи в журнал каждый раз придётся переделывать страницу со списком записей, ленту записей, ссылки под статьёй (на следующую и предыдущую статью) и пр. Всё это и многое другое автоматически умеют делать генераторы, обширный список которых можно найти тут: staticsitegenerators.net.

Пользуясь генератором, Вы создаёте обычные текстовые файлы для записей и страниц, html-кода в них нет. Очень популярным форматом (но не единственным) является язык разметки Markdown (по ссылке много понятных примеров). Когда Вы довольны структурой сайта и содержанием записей, Вы запускаете генератор. Он съедает ваши текстовые файлы и генерирует html-файлы, которые остаётся только выложить на сайт.

Все эти генераторы очень похожи один на другой, причём для пользователя совершенно неважно, на чём они работают: ruby, python, javascript, go или что-то ещё. Мне было интересно посмотреть на несколько генераторов, и я немного поигрался с Octopress, Hexo и Hugo. Из отличий я заметил только скорость генерации сайта. Октопрессу для того, чтобы сгенерировать мой сайт, нужно 2-3 секунды, Hexo — 1-2 секунды, а Hugo справляется за десятую долю секунды. Ещё легче всего было установить Hugo: для Ubuntu существует .deb пакет, который легко устанавливается через менеджер приложений. А по сути все эти генераторы одинаковые.

Сайт, который Вы сейчас читаете, был создан с нуля с помощью Hexo и размещён на Github Pages примерно за полчаса. Документация по Hexo на официальном сайте неплохая, но всё же там отсутствуют некоторые необходимые вещи, которые приходилось выискивать.

Итак, поехали. Устанавливаем генератор статических сайтов Hexo на Линукс и делаем сайт доступным по адресу имя_сайта.github.io. В результате выполнения действий, указанных ниже, Вы получите точно такой же сайт, как этот. Если всё пойдёт гладко, то меньше чем через час Вы уже сможете разослать ссылки на свой новый блог своим друзьям. Уже потом Вы наверняка захотите сменить тему, добавить комментарии, Google Analytics и прочее, руководствуясь инструкциями с официального сайта Hexo. Всё это делается довольно просто.

Read More

Моя первая запись. Пара примеров разметки Markdown.

Эта запись была сгенерирована из такого Markdown-файла:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
title: Моя первая запись. Пара примеров разметки Markdown.
date: 2015-06-16 11:49:05
tags:
- test
- Markdown
categories:
- Тестовые записи
- Первые записи
- Несметное богатство
---


# Это тестовая запись.
## Этот заголовок немного поменьше.
###### Заголовок.

К сожалению, *большинство* людей слишком легкомысленно относится к содержанию тестовых записей. Я не из их числа, но означает ли это, что я не **человек?**

Чтобы обновить `Ubuntu`, выполните команды

sudo apt-get update
sudo apt-get upgrade

Затем можно составить список дел на вчерашний вечер:

1. Раскачать лодку
1. Употребить жимолость внутрь.
1. Солнечная корона разогрета до полутора миллионов градусов по следующим причинам:
+ Подфотосферная турбулентная конвекция
+ диссипация энергии конвективных токов

Внимание, ссылка: [перейти к записи по установке Hexo](/2020/08/20/install-hexo/)

Не забудьте посмотреть на эту картинку на прощание:

![Изумительная картинка](http://lisakov.com/animation/tree.gif)

Подробнее о ней читайте на [lisakov.com](http://lisakov.com/blog/2014/11/25/rurik-pedigree/).

Это тестовая запись.

Этот заголовок немного поменьше.

Заголовок.

К сожалению, большинство людей слишком легкомысленно относится к содержанию тестовых записей. Я не из их числа, но означает ли это, что я не человек?

Чтобы обновить Ubuntu, выполните команды

sudo apt-get update
sudo apt-get upgrade

Затем можно составить список дел на вчерашний вечер:

  1. Раскачать лодку
  2. Употребить жимолость внутрь.
  3. Солнечная корона разогрета до полутора миллионов градусов по следующим причинам:
    • Подфотосферная турбулентная конвекция
    • диссипация энергии конвективных токов

Внимание, ссылка: перейти к записи по установке Hexo

Не забудьте посмотреть на эту картинку на прощание:

Изумительная картинка

Подробнее о ней читайте на lisakov.com.