Renderização

Existem dois métodos para renderizar arquivos ou strings no Hexo: o método assíncrono hexo.render.render e o método síncrono hexo.render.renderSync. Os dois métodos são bastante semelhantes, desta forma, apenas o método hexo.render.render assíncrono será um pouco mais discutido nos parágrafos abaixo.

Renderizar uma String

Ao renderizar uma string, você deve especificar uma engine para permitir que o Hexo conheça o mecanismo de renderização que deverá ser usado.

hexo.render.render({text: 'example', engine: 'swig'}).then(function(result){
  // ...
});

Renderizar um Arquivo

Ao renderizar um arquivo, não é necessário especificar uma engine porque o Hexo detectará automaticamente o mecanismo de renderização mais apropriado com base na extensão do arquivo. Mas se for a caso, você também pode definir explicitamente a engine.

hexo.render.render({path: 'path/to/file.swig'}).then(function(result){
  // ...
});

Opções de Renderização

Você pode passar um conjunto de opções em formato de objeto no segundo argumento.

hexo.render.render({text: ''}, {foo: 'foo'}).then(function(result){
  // ...
});

Filtros after_render

Quando a renderização estiver completa, o Hexo executará os filtros after_render correspondentes. Por exemplo, podemos usar este recurso para implementar um minificador para arquivos JavaScript.

var UglifyJS = require('uglify-js');

hexo.extend.filter.register('after_render:js', function(str, data){
  var result = UglifyJS.minify(str);
  return result.code;
});

Verificar se um Arquivo é Renderizável

Você pode usar o método isRenderable ou isRenderableSync para verificar se um caminho de arquivo é renderizável. O retorno do método será true apenas se um renderizador correspondente for registrado.

hexo.render.isRenderable('layout.swig') // true
hexo.render.isRenderable('image.png') // false

Obter a Extensão de Saída

Use o método getOutput para obter a extensão da saída renderizada. Se um arquivo não foi renderizado, o método retornará uma string vazia.

hexo.render.getOutput('layout.swig') // html
hexo.render.getOutput('image.png') // '''

Disable Nunjucks tags

If you are not using a tag plugin and want to use {{ }} or {% %} in your post without using content escaping, you can disable processing of Nunjucks tag in existing renderer by:

// following example only applies to '.md' file extension
// you may need to cover other extensions, e.g. '.markdown', '.mkd', etc
const renderer = hexo.render.renderer.get('md')
if (renderer) {
  renderer.disableNunjucks = true
  hexo.extend.renderer.register('md', 'html', renderer)
}