レンダラー

レンダラーは、コンテンツをレンダリングします。

概要

hexo.extend.renderer.register(name, output, function(data, options){
  // ...
}, sync);

引数	説明
name	入力ファイルの拡張子（小文字、先頭の.なし）
output	出力ファイルの拡張子（小文字、先頭の.なし）
sync	同期モード

レンダリング関数には3つの引数が渡されます:

引数	説明
data	ファイルパスpathとファイルコンテンツtextの2つの属性を含みます。pathは必ず存在するとは限りません。
option	オプション
callback	err, valueの2つのパラメータを持つコールバック関数。

例

非同期モード

var stylus = require('stylus');

// Callback
hexo.extend.renderer.register('styl', 'css', function(data, options, callback){
  stylus(data.text).set('filename', data.path).render(callback);
});

// Promise
hexo.extend.renderer.register('styl', 'css', function(data, options){
  return new Promise(function(resolve, reject){
    resolve('test');
  });
});

同期モード

var ejs = require('ejs');

hexo.extend.renderer.register('ejs', 'html', function(data, options){
  options.filename = data.path;
  return ejs.render(data.text, options);
}, true);

Nunjucksタグを無効にする

Nunjucksタグ{{ }}や{% %}（タグプラグインで使用される）はデフォルトで処理されますが、次の方法で無効にできます:

function lessFn(data, options) {
  // do something
}

lessFn.disableNunjucks = true

hexo.extend.renderer.register('less', 'css', lessFn);