Escrevendo

Para criar uma nova postagem ou uma nova página, você pode rodar o seguinte comando:

$ hexo new [layout] <title>

O layout padrão é o post, mas você pode fornecer o seu próprio. Você pode alterar o layout padrão editando a configuração default_layout em _config.yml.

Layout

Existem três layouts padrões no Hexo: post, page e draft. Os arquivos criados por cada um deles são salvos em um caminho diferente. As postagens criadas recentemente são salvas no diretório source/_posts.

Layout	Caminho
post	source/_posts
page	source
draft	source/_drafts

Disabling layout

If you don’t want an article (post/page) to be processed with a theme, set layout: false in its front-matter. Refer to this section for more details.

Nome de Arquivo

Por padrão, o Hexo usa o título da postagem como seu nome de arquivo. Você pode editar a configuração new_post_name em _config.yml para alterar o nome do arquivo padrão. Por exemplo, :year-:month-:day-:title.md prefixará nomes de arquivos com a data de criação de postagem. Você pode usar os seguintes placeholders:

Placeholder	Descrição
:title	Título do post (minúsculas, com espaços substituídos por hifens)
:year	Ano de criação, ex: 2015
:month	Mês de criação (com zero à esquerda), ex: 04
:i_month	Mês de criação (sem zero à esquerda), ex: 4
:day	Dia de criação (com zero à esquerda), ex: 07
:i_day	Dia de criação (sem zero à esquerda), ex: 7

Drafts

Anteriormente, mencionamos um layout especial no Hexo: draft. As postagens inicializadas com este layout são salvas no diretório source/_drafts. Você pode usar o comando publish para mover os rascunhos para o diretório source/_posts. O comando publish funciona de forma semelhante ao comando new.

$ hexo publish [layout] <title>

Os rascunhos não são exibidos por padrão. Você pode adicionar a opção --draft ao executar o Hexo ou habilitar a configuração render_drafts em _config.yml para renderizar rascunhos.

Scaffolds

Ao criar postagens, o Hexo irá construir arquivos com base no arquivo correspondente no diretório scaffolds. Por exemplo:

$ hexo new photo "My Gallery"

Quando você executa este comando, o Hexo tentará encontrar photo.md no diretório scaffolds e criar a postagem com base nele. Os seguintes placeholders estão disponíveis em scaffolds:

Placeholder	Descrição
layout	Layout
title	Título
date	Data de criação do arquivo

Supported Formats

Hexo support posts written in any format, as long as the corresponding renderer plugin is installed.

For example, Hexo has hexo-renderer-marked and hexo-renderer-ejs installed by default, so you can write your posts in markdown or in ejs. If you have hexo-renderer-pug installed, then you can even write your post in pug template language.

You can rename your posts and change to file extension from .md to .ejs, then Hexo will use hexo-renderer-ejs to render that file, so do the other formats.