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 layoutIf you don’t want an article (post/page) to be processed with a theme, set
layout: falsein 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.