主题开发:添加自定义句柄栏助手

时间:2014-08-06 14:18:04

标签: ghost-blog

对于techno theme,我想让用户可以使用自定义hb助手和配置。为此,我将覆盖应用于[ghost root] /index.js。

下面的代码在当前主题文件夹中搜索index.js并运行它。

var ghost = require('./core'),
    errors = require('./core/server/errorHandling');

ghost()
.then(function (param) {

    var settings = require('./core/server/api').settings;

    settings
        .read({key: 'activeTheme', context: {internal: true}})
        .then(function (result) {

            try {
                require('./content/themes/' + result.value + '/index')();
            }
            catch (e) {
                //No custom index found, or it wasn't a proper module.
            }

        });
})
.otherwise(function (err) {
    errors.logErrorAndExit(err, err.context, err.help);
});

主题级别index.js注入自定义博客变量(来自配置文件)和hb助手。

var hbs = require('express-hbs'),
    _ = require('lodash'),
    downsize = require('downsize'),
    blogVariable = require('../../../core/server/config/theme');

module.exports = function() {

    //This block allows configuration to be available in the hb templates.
    var blogConfig = blogVariable();
    var config = require('./config') || {};
    blogConfig.theme = config;
    //console.log(JSON.stringify(blogConfig));

    ////Custom hb helpers////

    hbs.registerHelper('excerpt', function (options) {

        ...

        return new hbs.handlebars.SafeString(excerpt);
    });

    ...

};

下面是使用自定义博客变量的示例。

<ul class="list-inline">
    <li><a href="{{@blog.theme.author.github}}" class="btn-social btn-outline" data-toggle="tooltip" data-placement="top" title="Github"><i class="fa fa-fw fa-github"></i></a>
    </li>
...

在Ghost 0.4.2中有更好的方法吗?我不喜欢让用户覆盖ghost core index.js文件。

2 个答案:

答案 0 :(得分:5)

有一篇博客文章解释了如何仅通过修改config.js文件并将文件添加到根目录来执行此操作。我同意作者的观点,这更有可能是更新证明。 http://zackehh.com/safely-creating-custom-handlebars-helpers/

添加:

require('./helpers')();

config.js

的顶部

并将助手添加到helpers.js文件中,如下所示:

var hbs = require('express-hbs');

module.exports = function(){  
    hbs.registerHelper('json', function(context) {
      return JSON.stringify(context);
    });
};

答案 1 :(得分:0)

不幸的是,不久前在论坛上有一篇关于这个的帖子,但是你可以将你自己的helpers.js文件添加到核心文件夹中,例如......

var hbs = require('express-hbs')

// quick function for an example
registerHelper = function(){

    hbs.registerHelper('ifNthItem', function(nthItem, currentCount, offset, options) {
        if((currentCount+ offset)%(nthItem) == 0) {
            return options.fn(this);
        } else {
            return options.inverse(this);
        }
    });
};

module.exports = registerHelper;

然后将其链接到index.js

var when      = require('when'),
    bootstrap = require('./bootstrap'),
    scopa = require('./helpers');

    scopa();

至少这样你不修改核心index.js而是修改helpers.js。