summaryrefslogtreecommitdiffstats
path: root/lib/plugins/compatibility.js
blob: 7ad35a95b67443c21dd4157898f1cb171a752c9e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
var _ = require('lodash');
var error = require('../utils/error');

/*
    Return the context for a plugin.
    It tries to keep compatibilities with GitBook v2
*/
function pluginCtx(plugin) {
    var book = plugin.book;
    var ctx = {
        config: book.config,
        log: plugin.log,

        // Paths
        resolve: book.resolve
    };

    // Deprecation
    error.deprecateField(ctx, 'options', book.config.dump(), '"options" property is deprecated, use config.get(key) instead');

    // Loop for template filters/blocks
    error.deprecateField(ctx, 'book', ctx, '"book" property is deprecated, use "this" directly instead');

    return ctx;
}

// Call a function "fn" with a context of page similar to the one in GitBook v2
function pageHook(page, fn) {
    var ctx = {
        type: page.type,
        content: page.content,
        path: page.path,
        rawPath: page.rawPath
    };

    // Deprecate sections
    error.deprecateField(ctx, 'sections', [
        { content: ctx.content }
    ], '"sections" property is deprecated, use page.content instead');

    return fn(ctx)
    .then(function(result) {
        if (!result) return undefined;
        if (result.content) {
            return result.content;
        }

        if (result.sections) {
            return _.pluck(result.sections, 'content').join('\n');
        }
    });
}

module.exports = {
    pluginCtx: pluginCtx,
    pageHook: pageHook
};