Hexo: руководство для начинающих (три) — статьи и черновики

Статьи

Введите в командной строке:

$ hexo new "new article"

После этого в каталоге source/_posts появится файл new-article.md.

Открыв его, вы увидите:

title: new article
date: 2014-11-01 20:10:33
tags:
---

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

Текст статьи поддерживает формат markdown, рекомендуется сначала изучить его синтаксис. Markdown не похож на html с множеством тегов, он очень прост и содержит всего несколько символов.

После создания, удаления или изменения статьи нет необходимости перезапускать hexo server, достаточно обновить страницу для предварительного просмотра.

Атрибуты

Статья может иметь следующие атрибуты:

В динамическом блоге эти атрибуты устанавливаются через страницу публикации статей. В hexo они задаются следующим образом.

Категории и теги

Например:

categories:
- 日记
tags:
- Hexo
- node.js

Резюме

Как и в wordpress, содержимое над является резюме.

Макет

Если вы изменили макет, в папке scaffolds должен быть соответствующий шаблонный файл, иначе будет использоваться шаблон по умолчанию.

Имя файла

Имя файла можно настроить в конфигурационном файле new_post_name, по умолчанию оно равно:title, то есть имени, которое вы ввели в командной строке.

Имя файла может быть любой комбинацией следующих переменных и строковых констант:

Черновики

Черновики похожи на «приватные статьи», которые есть во многих блогах.

$ hexo new draft "new draft"

Создаст файл new-draft.md в каталоге source/_drafts. Однако этот файл не отображается на странице, и ссылки на него недоступны. То есть, если вы хотите скрыть статью, но не удалять её, можно переместить её в каталог _drafts.

Чтобы принудительно просмотреть черновик, измените конфигурацию:

render_drafts: true

Или запустите сервер следующим образом:

$ hexo server --drafts

Следующая команда может превратить черновик в статью или страницу:

$ hexo publish [layout] <filename>