Создаём блог с Zola

Так как я не разобрался как пользоваться Hugo, напишу от том как я использовал Zola.

Что такое Zola

Zola - это генератор статичных сайтов написанный на rust. Из особенностей можно выделить отсутствие зависимостей, всё что вам нужно это один бинарный файл. Быстрая скорость работы, сайт генерируется менее чем за секунду. Легкость в использовании, CLI инструмент имеет всего четыре команды. Для написания постов используется язык разметки markdown.

Установка

С чего начинаются подобные инструкции? Правильно с установки. Так как Zola есть в AUR, то выполняем следующую команду:

            
                pacaur -S zola-bin

Как установить на другие дистрибутивы или ОС можно прочитать здесь.

Создание сайта

Теперь нам необходимо создать наш сайт. Вводим следующее:

            
                zola init cool_blog

Где cool_blog это название директории в которой будет находится наш сайт.

После чего у вас спросят несколько вопросов. На них можете ответить всё что угодно, т.к. чуть позже всё это мы настроим в конфигурационном файле.

Установка темы

После чего установим тему. У меня установлена тема after-dark.

            
                cd cool_blog/themes
                git clone https://github.com/getzola/after-dark.git

Копируем директории content, sass, templates и файл config.toml из cool_blog/themes/after-dark в cool_blog/ с заменой.

            
                cd ..
                cp -r themes/after-dark/content/ .
                cp -r themes/after-dark/sass/ .
                cp -r themes/after-dark/templates/ .
                cp themes/after-dark/config.toml config.toml

На вопрос о перезаписи отвечаем положительно.

Настройки

Настройки у нас хранятся в двух местах cool_blog/content/_index.md и cool_blog/config.toml.

Начнём с основных настроек, с файла cool_blog/config.toml. Ниже представлен мой файл полностью.

            
                base_url = "https://pages.codeberg.org/RaZZlom/"
                title = "RaZZlom Blog"
                description = ""
                default_language = "ru"
                theme = "after-dark"
                highlight_code = true
                highlight_theme = "gruvbox-dark"
                generate_feed = true
                feed_filename = "rss.xml"

                taxonomies = [
                    {name = "categories", rss = true},
                    {name = "categories", lang = "en"},
                    {name = "tags", rss = true},
                    {name = "tags", lang = "en"},
                ]

                languages = [
                    {code = "en", feed = true},
                ]

                compile_sass = true

                [extra]
                author = "RaZZlom"

                after_dark_menu = [
                    {url = "$BASE_URL", name = "Home"},
                    {url = "$BASE_URL/categories", name = "Categories"},
                    {url = "$BASE_URL/tags", name = "Tags"},
                    {url = "$BASE_URL/en", name = "🇺🇸EN"},
                ]

                after_dark_title = "RaZZlom blog"

base_url = "" - Единственный обязательно необходимый параметр. Адрес на котором будет размещён ваш сайт. Заменяете на свой.
title = "" - Название вашего сайта. Будет отображаться в названии окна и вкладки браузера.
description = ""- Описание вашего сайта.
default_language = ""- Основной язык на котором вы будете публиковать ваши посты.
theme = ""- Название установленной темы.
highlight_code = true- Подсветка исходного кода.
highlight_theme = ""- Тема подсветки исходного кода.
generate_feed = true- Нужно ли генерировать RSS ленту.
feed_filename = ""- Название файла RSS ленты. Может быть atom.xml или rss.xml.
taxonomies = []- Не знаю как перевести слово taxonomies, но эти настройки необходимы если вы будете использовать категории и тэги на вашем сайте.
languages = []- В добавок к основному языку, установленному в default_language, можно добавить ещё языки на которых вы будете писать посты.
compile_sass = true- Необходимо для компиляции файлов в директории sass.
author = ""- Ваше имя или никнейм под которым вы будете публиковать ваши посты.
after_dark_menu = []- Настройки верхнего меню.

Быстренько взглянем на cool_blog/content/_index.md.

            
                +++
                sort_by = "date"
                paginate_by = 5
                +++

sort_by = "date"- сортировка записей по дате, от новых к старым.
paginate_by = 5- количество записей на одной странице. Необходимая настройка для используемой темы.

Пишем первый пост

Для того чтобы добавить новый пост создаём cool_blog/content/first-post.md. Открываем его для редактирования и первым делом пишем следующее:

            
                +++
                title = "Создаём блог с Zola"
                date = 2020-06-06

                [taxonomies]
                categories = ["IT"]
                tags = ["zola", "configure", "guide", "rust", "web"]
                +++

title = ""- название вашего поста.
date = 2020-06-06- дата создания.
categories = ["IT"]- категория в которой вы хотите его разместить.
tags = []- все необходимые теги.

Далее пишем вступление:

            
                Так как я не разобрался как пользоваться Hugo, напишу от том как
                я использую Zola.

                !-- more --

                ## Что такое Zola

                ...

Всё что перед !-- more --> будет видно в списке постов. Далее идёт ваш текст.

Для проверки того как выглядит наш сайт введём следующую команду:

            
                zola serve --open

Если нет никаких ошибок, то откроется веб браузер с нашим сайтом.

Сборка

И последнее что нам остаётся это сделать

            
                zola build

и загрузить готовый сайт из cool_blog/public в ваш pages репозиторий.

Ссылки

Официальный сайт Zola - https://www.getzola.org/
Документация Zola - https://www.getzola.org/documentation/
Темы для вашего сайта - https://www.getzola.org/themes/