Bump version to 2.4.2

Improve installation of plugins to not install default ones
Merge branch 'fix/inline_code_html'
2026-09-26 12:18:01 +00:00 · 2015-09-22 23:30:42 +02:00 · 2015-09-22 23:25:15 +02:00 · 2015-09-22 22:46:19 +02:00 · 2015-09-22 22:45:55 +02:00 · 2015-09-22 22:41:13 +02:00
188 changed files with 3552 additions and 2608 deletions
@@ -0,0 +1,10 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
@@ -0,0 +1,7 @@
+{
+    "strict": false,
+    "browser": false,
+    "quotmark": true,
+    "node": true,
+    "mocha": true
+}
@@ -21,22 +21,37 @@ Translators
 ------------

 - German
-	- Winnie (@winniehell)
+    - Winnie (@winniehell)
 - Italian
-	- Giulio Bonanome (@gbonanome)
+    - Giulio Bonanome (@gbonanome)
 - Russian
-	- Andrey Akinshin (@AndreyAkinshin)
+    - Andrey Akinshin (@AndreyAkinshin)
 - Norwegian
-	- Knut Melvær (@kmelve)
+    - Knut Melvær (@kmelve)
 - Persian (Farsi)
-	- Mohammad Hossein Mojtahedi (@mhm5000)
+    - Mohammad Hossein Mojtahedi (@mhm5000)
+- Polish
+    - Łukasz Szeremeta (@lszeremeta)
 - Portuguese
-	- Ryan O'Mullan (@RyanOM)
+    - Ryan O'Mullan (@RyanOM)
 - Spanish
-	- Ryan O'Mullan (@RyanOM)
+    - Ryan O'Mullan (@RyanOM)
 - Simplifiled Chinese
-	- Hu Hao (@howiehu)
+    - Hu Hao (@howiehu)
 - Traditional Chinese
-	- Hu Hao (@howiehu)
+    - Hu Hao (@howiehu)
 - French
-	- Samy Pessé (@SamyPesse)
+    - Samy Pessé (@SamyPesse)
+- Romanian
+        - Iancu Aurel (@awrelll)
+- Finnish
+    - Tommi Savikko (@savikko)
+- Japanese
+    - Iancu Aurel (@awrelll)
+- Korean
+    - Iancu Aurel (@awrelll)
+    - SangYeob Yu (@deminoth)
+- Vietnamese
+    - Hong Nguyen (@nghong)
+- Hebrew
+    - @a-moses
@@ -2,6 +2,104 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).

+## 2.4.2
+- Default plugins should not be installed by `gitbook install`
+- Limit search index size to avoid crash during generation
+- Fix code highlighting for html without language specified
+- Fix warning message for gitbook version when building a multilingual book
+
+## 2.4.1
+- Fix disabling of default plugins, ex: `-highlight`
+
+## 2.4.0
+- Fix page being updated when user wants to open a link in a new tab
+- Plugins can now replaced default code highlighter
+- Add semantic information for screen readers (web version)
+- Content references accept absolute paths, resolved to book folder
+- Improve overall reliability
+
+## 2.3.3
+- Fix bug in SUMMARY parsing preventing multiple entries without filenames
+
+## 2.3.2
+- Fix blocks (like maths) in Asciidoc
+- Fix error when checking gitbook version
+
+## 2.3.1
+- Fix black font color for ebooks (mobi, pdf and epub)
+- Fix ISO code for korean language
+- Fix korean translation
+- Fix syntax highlighting for asciidoc
+- Fix inline html escaping in markdown
+- Add warning for file outside SUMMARY
+- Force SUMMARY entries to be unique by filename
+
+## 2.3.0
+- Fix nunjucks issue with multiple `{% raw %}` blocks
+- Fix crash when git conref failed
+- Fix crash when failed to download remote image (better error message)
+- Fix flicking effect when changing page (big UX improvement)
+- Add Hebrew translation (`he`)
+- Add utility method `book.config.get` for plugins
+- Hooks `page:before` and `page` are no longer deprecated
+- Remove webfonts to make website lighter
+- Make glossary's order case insensitive
+
+## 2.2.0
+- Fix direction in code blocks (always LTR)
+- Add options `chapterMark` and `pageBreaksBefore` for PDF
+- Update code highlighting library
+- `book.json` accessible as `config` in templating syntax
+- Add Vietnamese translation (`vi`)
+
+## 2.1.0
+- Fix error in calcul of `levels` in table of contents, error introduced a few versions ago
+- Add optional `styles/print.css` to replace `print.css` used in ebook
+
+## 2.0.4
+- Fix `{% raw %}`, got confused with "fake" variable declarations
+- Fix title of language chooser
+- Fix the X-UA-Compatible meta tag
+- Move style sheets to the <head> section
+
+## 2.0.3
+- Fix `gitbook init` for SUMMARY with empty entries
+- Fix escaping of code blocks in markdown
+
+## 2.0.2
+- Fix relative links in windows
+- Improve watcher in serve command (switch to chokidar)
+- Add Romanian translation (`ro`)
+- Add Finish translation (`fi`)
+- Add Japanese translation (`jp`)
+- Add Korean translation (`kr`)
+
+## 2.0.1
+- Improve error logging (display file, line and column)
+- Add back support for `options.originalInput`
+- Don't process math in markdown parser (delegated to `mathjax` plugin)
+- Fix some cases of code blocks escaping
+- Fix i18n for introduction title in json format
+- Fix reload when book configuration is updated
+- Fix backslashes in url when building on windows
+
+## 2.0.0
+- Fix page title of introduction
+- Ignore codeblocks when replacing glossary terms
+- Improve Unit Tests
+- Fix scrolling position in website when preparing page
+
+## 2.0.0-beta.5
+- Fix progress order in json format
+
+## 2.0.0-beta.4
+- Fix default generator for use programmatically
+- Add option "author" for html meta tags
+- Fix links normalization (content and hash)
+
+## 2.0.0-beta.3
+- Fix odd cases with code blocks escaping
+
 ## 2.0.0-beta.2
 - Fix definition of entry point title using SUMMARY.md

@@ -2,12 +2,12 @@ GitBook
 =======

 [![NPM version](https://badge.fury.io/js/gitbook.svg)](http://badge.fury.io/js/gitbook)
-[![Build Status](https://travis-ci.org/GitbookIO/gitbook.png?branch=master)](https://travis-ci.org/GitbookIO/gitbook)
-[![Windows Build Status](https://ci.appveyor.com/api/projects/status/github/GitbookIO/gitbook?branch=master&svg=true)](https://ci.appveyor.com/project/SamyPesse/gitbook)
+[![Linux Build Status](https://travis-ci.org/GitbookIO/gitbook.png?branch=master)](https://travis-ci.org/GitbookIO/gitbook)
+[![Windows Build status](https://ci.appveyor.com/api/projects/status/63nlflxcwmb2pue6?svg=true)](https://ci.appveyor.com/project/GitBook/gitbook)

 GitBook is a command line tool (and Node.js library) for building beautiful books using GitHub/Git and Markdown (or AsciiDoc). Here is an example: [Learn Javascript](https://www.gitbook.com/book/GitBookIO/javascript).

-You can publish and host book easily online using [gitbook.com](https://www.gitbook.com), a web-editor is [also available](https://www.gitbook.com/editor).
+You can publish and host book easily online using [gitbook.com](https://www.gitbook.com), a desktop editor is [also available](https://www.gitbook.com/editor).

 Stay updated by following [@GitBookIO](https://twitter.com/GitBookIO) on Twitter or [GitBook](https://www.facebook.com/gitbookcom) on Facebook.

@@ -32,13 +32,13 @@ $ gitbook init
 You can serve a repository as a book using:

 ```
-$ gitbook serve ./repository
+$ gitbook serve
 ```

 Or simply build the static website using:

 ```
-$ gitbook build ./repository ./outputFolder
+$ gitbook build
 ```

 ## Features
@@ -50,7 +50,7 @@ $ gitbook build ./repository ./outputFolder
 * [AsciiDoc Support](http://help.gitbook.com/format/asciidoc.html)
 * [Variables and Templating](http://help.gitbook.com/format/templating.html)
 * [Content References](http://help.gitbook.com/format/conrefs.html)
-* [Plugins](http://help.gitbook.com/plugins/index.html)
+* [Plugins](http://help.gitbook.com/format/plugins.html)
 * Interractive reader website:
    * Search
    * Font Settings (Serif, Sans Serif)
@@ -0,0 +1,11 @@
+var _ = require('lodash');
+
+module.exports = {
+    // Return non-parsed html
+    // since blocks are by default non-parsable, a simple identity method works fine
+    html: _.identity,
+
+    // Highlight a code block
+    // This block can be extent by plugins
+    code: _.identity
+};
@@ -1,17 +1,30 @@
 var _ = require("lodash");
 var Q = require("q");
 var path = require("path");
-var semver = require('semver');
+var semver = require("semver");

-var pkg = require('../package.json');
-var fs = require("./utils/fs");
+var pkg = require("../package.json");
 var i18n = require("./utils/i18n");

 // Default plugins added to each books
-var defaultsPlugins = [];
+var DEFAULT_PLUGINS = ["highlight"];
+
+// Check if a plugin is a default plugin
+// Plugin should be in the list
+// And version from book.json specified for this plugin should be satisfied
+function isDefaultPlugin(name, version) {
+    if (!_.contains(DEFAULT_PLUGINS, name)) return false;
+
+    try {
+        var pluginPkg = require('gitbook-plugin-'+name+'/package.json');
+        return semver.satisfies(pluginPkg.version, version || '*');
+    } catch(e) {
+        return false;
+    }
+}

 // Normalize a list of plugins to use
-function normalizePluginsList(plugins) {
+function normalizePluginsList(plugins, addDefaults) {
    // Normalize list to an array
    plugins = _.isString(plugins) ? plugins.split(",") : (plugins || []);

@@ -23,10 +36,13 @@ function normalizePluginsList(plugins) {
        if (plugin.name) return plugin;

        var parts = plugin.split("@");
+        var name = parts[0];
+        var version = parts[1];
        return {
-            'name': parts[0],
-            'version': parts[1] // optional
-        }
+            "name": name,
+            "version": version, // optional
+            "isDefault": isDefaultPlugin(name, version)
+        };
    });

    // List plugins to remove
@@ -40,34 +56,37 @@ function normalizePluginsList(plugins) {
    .value();

    // Merge with defaults
-    plugins = _.chain(plugins)
-    .concat(_.map(defaultsPlugins, function(plugin) {
-        return { 'name': plugin }
-    }))
-    .uniq()
-    .value();
+    if (addDefaults !== false) {
+        _.each(DEFAULT_PLUGINS, function(plugin) {
+            if (_.find(plugins, { name: plugin })) {
+                return;
+            }

-    // Build final list
+            plugins.push({
+                "name": plugin,
+                "isDefault": true
+            });
+        });
+    }
+
+    // Remove plugin that start with '-'
    plugins = _.filter(plugins, function(plugin) {
        return !_.contains(toremove, plugin.name) && !(plugin.name.length > 0 && plugin.name[0] == "-");
    });

+    // Remove duplicates
+    plugins = _.uniq(plugins, 'name');
+
    return plugins;
 }

-// Normalize a list of plugin name to use
-function normalizePluginsNames(plugins) {
-    return _.pluck(normalizePluginsList(plugins), "name");
-};
-
-
 var Configuration = function(book, options) {
    var that = this;

-	this.book = book;
+    this.book = book;

    this.options = _.cloneDeep(Configuration.DEFAULT);
-	this.options = _.merge(this.options, options || {});
+    this.options = _.merge(this.options, options || {});

    // options.input == book.root
    Object.defineProperty(this.options, "input", {
@@ -75,19 +94,42 @@ var Configuration = function(book, options) {
            return that.book.root;
        }
    });
+
+    // options.originalInput == book.parent.root
+    Object.defineProperty(this.options, "originalInput", {
+        get: function () {
+            return that.book.parent? that.book.parent.root : undefined;
+        }
+    });
+
+    // options.originalOutput == book.parent.options.output
+    Object.defineProperty(this.options, "originalOutput", {
+        get: function () {
+            return that.book.parent? that.book.parent.options.output : undefined;
+        }
+    });
 };

 // Read and parse the configuration
 Configuration.prototype.load = function() {
-	var that = this;
+    var that = this;

-	return Q()
+    return Q()
    .then(function() {
+        var configPath, _config;
+
        try {
-            var _config = require(path.resolve(that.book.root, that.options.configFile));
+            configPath = require.resolve(
+                that.book.resolve(that.options.configFile)
+            );
+
+            // Invalidate node.js cache for livreloading
+            delete require.cache[configPath];
+
+            _config = require(configPath);
            that.options = _.merge(
-            	that.options,
-            	_.omit(_config, 'configFile', 'defaultsPlugins', 'generator', 'extension')
+                that.options,
+                _.omit(_config, "configFile", "defaultsPlugins", "generator", "extension")
            );
        }
        catch(err) {
@@ -96,22 +138,24 @@ Configuration.prototype.load = function() {
        }
    })
    .then(function() {
-        if (!semver.satisfies(pkg.version, that.options.gitbook)) {
-            throw "GitBook version doesn't satisfy version required by the book: "+that.options.gitbook;
-        }
-        if (that.options.gitbook == "*") {
-            that.book.log.warn.ln("you should specify a gitbook version to use in your book.json, for example: "+(_.first(pkg.version.split("."))+".x.x"));
+        if (!that.book.isSubBook()) {
+            if (!semver.satisfies(pkg.version, that.options.gitbook)) {
+                throw new Error("GitBook version doesn't satisfy version required by the book: "+that.options.gitbook);
+            }
+            if (that.options.gitbook != "*" && !semver.satisfies(semver.inc(pkg.version, "patch"), that.options.gitbook)) {
+                that.book.log.warn.ln("gitbook version specified in your book.json might be too strict for future patches, \""+(_.first(pkg.version.split("."))+".x.x")+"\" is more adequate");
+            }
        }

-        that.options.output = path.resolve(that.options.output || path.join(that.book.root, "_book"));
+        that.options.output = path.resolve(that.options.output || that.book.resolve("_book"));
        that.options.plugins = normalizePluginsList(that.options.plugins);
-        that.options.defaultsPlugins = normalizePluginsList(that.options.defaultsPlugins || "");
+        that.options.defaultsPlugins = normalizePluginsList(that.options.defaultsPlugins || "", false);
        that.options.plugins = _.union(that.options.plugins, that.options.defaultsPlugins);
        that.options.plugins = _.uniq(that.options.plugins, "name");

        // Default value for text direction (from language)
        if (!that.options.direction) {
-            var lang = i18n.getByLanguage(that.options.language);
+            var lang = i18n.getCatalog(that.options.language);
            if (lang) that.options.direction = lang.direction;
        }

@@ -134,12 +178,16 @@ Configuration.prototype.normalizeLanguage = function() {
    return i18n.normalizeLanguage(this.options.language);
 };

+// Return a configuration
+Configuration.prototype.get = function(key, def) {
+    return _.get(this.options, key, def);
+};

 // Default configuration
 Configuration.DEFAULT = {
-    // Options that can't be extend
+    // Options that can"t be extend
    "configFile": "book",
-    "generator": "site",
+    "generator": "website",
    "extension": null,

    // Book metadats (somes are extracted from the README by default)
@@ -148,6 +196,7 @@ Configuration.DEFAULT = {
    "isbn": null,
    "language": "en",
    "direction": null,
+    "author": null,

    // version of gitbook to use
    "gitbook": "*",
@@ -163,6 +212,7 @@ Configuration.DEFAULT = {
    // CSS Styles
    "styles": {
        "website": "styles/website.css",
+        "print": "styles/print.css",
        "ebook": "styles/ebook.css",
        "pdf": "styles/pdf.css",
        "mobi": "styles/mobi.css",
@@ -185,9 +235,9 @@ Configuration.DEFAULT = {
    "variables": {},

    // Set another theme with your own layout
-    // It's recommended to use plugins or add more options for default theme, though
+    // It"s recommended to use plugins or add more options for default theme, though
    // See https://github.com/GitbookIO/gitbook/issues/209
-    "theme": path.resolve(__dirname, '../theme'),
+    "theme": path.resolve(__dirname, "../theme"),

    // Links in template (null: default, false: remove, string: new value)
    "links": {
@@ -222,6 +272,14 @@ Configuration.DEFAULT = {
        // Choices are [u’a0’, u’a1’, u’a2’, u’a3’, u’a4’, u’a5’, u’a6’, u’b0’, u’b1’, u’b2’, u’b3’, u’b4’, u’b5’, u’b6’, u’legal’, u’letter’]
        "paperSize": "a4",

+        // How to mark detected chapters.
+        // Choices are “pagebreak”, “rule”, "both" or “none”.
+        "chapterMark" : "pagebreak",
+
+        // An XPath expression. Page breaks are inserted before the specified elements.
+        // To disable use the expression: "/"
+        "pageBreaksBefore": "/",
+
        // Margin (in pts)
        // Note: 72 pts equals 1 inch
        "margin": {
@@ -0,0 +1,63 @@
+var path = require("path");
+var nunjucks = require("nunjucks");
+
+var git = require("./utils/git");
+var fs = require("./utils/fs");
+var pathUtil = require("./utils/path");
+
+// The loader should handle relative and git url
+var BookLoader = nunjucks.Loader.extend({
+    async: true,
+
+    init: function(book) {
+        this.book = book;
+    },
+
+    getSource: function(fileurl, callback) {
+        var that = this;
+
+        git.resolveFile(fileurl)
+        .then(function(filepath) {
+            // Is local file
+            if (!filepath) filepath = path.resolve(fileurl);
+            else that.book.log.debug.ln("resolve from git", fileurl, "to", filepath);
+
+            //  Read file from absolute path
+            return fs.readFile(filepath)
+            .then(function(source) {
+                return {
+                    src: source.toString(),
+                    path: filepath
+                };
+            });
+        })
+        .nodeify(callback);
+    },
+
+    resolve: function(from, to) {
+        // If origin is in the book, we enforce result file to be in the book
+        if (this.book.fileIsInBook(from)) {
+            return this.book.resolve(
+                this.book.relative(path.dirname(from)),
+                to
+            );
+        }
+
+        // If origin is in a git repository, we resolve file in the git repository
+        var gitRoot = git.resolveRoot(from);
+        if (gitRoot) {
+            return pathUtil.resolveInRoot(gitRoot, to);
+        }
+
+        // If origin is not in the book (include from a git content ref)
+        return path.resolve(path.dirname(from), to);
+    },
+
+    // Handle all files as relative, so that nunjucks pass responsability to "resolve"
+    // Only git urls are considered as absolute
+    isRelative: function(filename) {
+        return !git.checkUrl(filename);
+    }
+});
+
+module.exports = BookLoader;
@@ -3,8 +3,6 @@ var path = require("path");
 var Q = require("q");
 var fs = require("./utils/fs");

-var Plugin = require("./plugin");
-
 var BaseGenerator = function(book) {
    this.book = book;

@@ -36,7 +34,7 @@ BaseGenerator.prototype.convertFile = function(input) {
 // Copy file to the output (non parsable)
 BaseGenerator.prototype.transferFile = function(input) {
    return fs.copy(
-        path.join(this.book.root, input),
+        this.book.resolve(input),
        path.join(this.options.output, input)
    );
 };
@@ -53,8 +51,8 @@ BaseGenerator.prototype.copyCover = function() {
    var that = this;

    return Q.all([
-        fs.copy(path.join(that.book.root, "cover.jpg"), path.join(that.options.output, "cover.jpg")),
-        fs.copy(path.join(that.book.root, "cover_small.jpg"), path.join(that.options.output, "cover_small.jpg"))
+        fs.copy(that.book.resolve("cover.jpg"), path.join(that.options.output, "cover.jpg")),
+        fs.copy(that.book.resolve("cover_small.jpg"), path.join(that.options.output, "cover_small.jpg"))
    ])
    .fail(function() {
        // If orignaly from multi-lang, try copy from parent
@@ -65,7 +63,7 @@ BaseGenerator.prototype.copyCover = function() {
            fs.copy(path.join(that.book.parentRoot(), "cover_small.jpg"), path.join(that.options.output, "cover_small.jpg"))
        ]);
    })
-    .fail(function(err) {
+    .fail(function() {
        return Q();
    });
 };
@@ -2,7 +2,7 @@ var util = require("util");
 var path = require("path");
 var Q = require("q");
 var _ = require("lodash");
-var exec = require('child_process').exec;
+var exec = require("child_process").exec;

 var fs = require("../utils/fs");
 var stringUtils = require("../utils/string");
@@ -18,7 +18,7 @@ var Generator = function(book, format) {
    this.namespace = "ebook";

    // Styles to use
-    this.styles = _.compact(["ebook", this.ebookFormat]);
+    this.styles = _.compact(["print", "ebook", this.ebookFormat]);

    // Convert images (svg -> png)
    this.convertImages = true;
@@ -26,11 +26,11 @@ var Generator = function(book, format) {
 util.inherits(Generator, BaseGenerator);

 Generator.prototype.prepareTemplates = function() {
-    this.templates["page"] = this.book.plugins.template("ebook:page") || path.resolve(this.options.theme, 'templates/ebook/page.html');
-    this.templates["summary"] = this.book.plugins.template("ebook:summary") || path.resolve(this.options.theme, 'templates/ebook/summary.html');
-    this.templates["glossary"] = this.book.plugins.template("ebook:glossary") || path.resolve(this.options.theme, 'templates/ebook/glossary.html');
+    this.templates.page = this.book.plugins.template("ebook:page") || path.resolve(this.options.theme, "templates/ebook/page.html");
+    this.templates.summary = this.book.plugins.template("ebook:summary") || path.resolve(this.options.theme, "templates/ebook/summary.html");
+    this.templates.glossary = this.book.plugins.template("ebook:glossary") || path.resolve(this.options.theme, "templates/ebook/glossary.html");

-	return Q();
+    return Q();
 };

 // Generate table of contents
@@ -38,7 +38,7 @@ Generator.prototype.writeSummary = function() {
    var that = this;

    that.book.log.info.ln("write SUMMARY.html");
-    return this._writeTemplate(this.templates["summary"], {}, path.join(this.options.output, "SUMMARY.html"));
+    return this._writeTemplate(this.templates.summary, {}, path.join(this.options.output, "SUMMARY.html"));
 };

 Generator.prototype.finish = function() {
@@ -52,12 +52,12 @@ Generator.prototype.finish = function() {
    .then(function() {
        if (!that.ebookFormat) return Q();

-        var d = Q.defer();
-
        if (!that.options.cover && fs.existsSync(path.join(that.options.output, "cover.jpg"))) {
            that.options.cover = path.join(that.options.output, "cover.jpg");
        }

+        var d = Q.defer();
+
        var _options = {
            "--cover": that.options.cover,
            "--title": that.options.title,
@@ -68,8 +68,6 @@ Generator.prototype.finish = function() {
            "--book-producer": "GitBook",
            "--publisher": "GitBook",
            "--chapter": "descendant-or-self::*[contains(concat(' ', normalize-space(@class), ' '), ' book-chapter ')]",
-            "--chapter-mark": "pagebreak",
-            "--page-breaks-before": "/",
            "--level1-toc": "descendant-or-self::*[contains(concat(' ', normalize-space(@class), ' '), ' book-chapter-1 ')]",
            "--level2-toc": "descendant-or-self::*[contains(concat(' ', normalize-space(@class), ' '), ' book-chapter-2 ')]",
            "--level3-toc": "descendant-or-self::*[contains(concat(' ', normalize-space(@class), ' '), ' book-chapter-3 ')]",
@@ -82,6 +80,8 @@ Generator.prototype.finish = function() {
            var pdfOptions = that.options.pdf;

            _.extend(_options, {
+                "--chapter-mark": String(pdfOptions.chapterMark),
+                "--page-breaks-before": String(pdfOptions.pageBreaksBefore),
                "--margin-left": String(pdfOptions.margin.left),
                "--margin-right": String(pdfOptions.margin.right),
                "--margin-top": String(pdfOptions.margin.top),
@@ -108,7 +108,7 @@ Generator.prototype.finish = function() {

        that.book.log.info("start conversion to", that.ebookFormat, "....");

-        var child = exec(command, function (error, stdout, stderr) {
+        var child = exec(command, function (error, stdout) {
            if (error) {
                that.book.log.info.fail();

@@ -124,11 +124,11 @@ Generator.prototype.finish = function() {
            d.resolve();
        });

-        child.stdout.on('data', function (data) {
+        child.stdout.on("data", function (data) {
            that.book.log.debug(data);
        });

-        child.stderr.on('data', function (data) {
+        child.stderr.on("data", function (data) {
            that.book.log.debug(data);
        });

@@ -2,10 +2,10 @@ var _ = require("lodash");
 var EbookGenerator = require("./ebook");

 module.exports = {
-	json: require("./json"),
-	website: require("./website"),
-	ebook: EbookGenerator,
-	pdf: _.partialRight(EbookGenerator, "pdf"),
-	mobi: _.partialRight(EbookGenerator, "mobi"),
-	epub: _.partialRight(EbookGenerator, "epub")
+    json: require("./json"),
+    website: require("./website"),
+    ebook: EbookGenerator,
+    pdf: _.partialRight(EbookGenerator, "pdf"),
+    mobi: _.partialRight(EbookGenerator, "mobi"),
+    epub: _.partialRight(EbookGenerator, "epub")
 };
@@ -13,7 +13,7 @@ var Generator = function() {
 util.inherits(Generator, BaseGenerator);

 // Ignore some methods
-Generator.prototype.transferFile = function(input) { };
+Generator.prototype.transferFile = function() { };

 // Convert an input file
 Generator.prototype.convertFile = function(input) {
@@ -44,7 +44,7 @@ Generator.prototype.finish = function() {
 // Write README.json
 Generator.prototype.writeReadme = function() {
    var that = this;
-    var mainlang, langs;
+    var mainLang, langs, readme;

    return Q()
    .then(function() {
@@ -4,14 +4,12 @@ var Q = require("q");
 var _ = require("lodash");

 var nunjucks = require("nunjucks");
-var AutoEscapeExtension = require("nunjucks-autoescape");
-var FilterExtension = require("nunjucks-filter");
-var I18nExtension = require("nunjucks-i18n");
+var AutoEscapeExtension = require("nunjucks-autoescape")(nunjucks);
+var FilterExtension = require("nunjucks-filter")(nunjucks);

 var fs = require("../utils/fs");
 var BaseGenerator = require("../generator");
 var links = require("../utils/links");
-var pageUtil = require("../utils/page");
 var i18n = require("../utils/i18n");

 var pkg = require("../../package.json");
@@ -51,12 +49,13 @@ Generator.prototype.prepareStyles = function() {
    this.styles = _.chain(this.styles)
        .map(function(style) {
            var stylePath = that.options.styles[style];
-            if (fs.existsSync(path.resolve(that.book.root, stylePath))) {
-                return stylePath;
+            if (stylePath && fs.existsSync(that.book.resolve(stylePath))) {
+                return [style, stylePath];
            }
            return null;
        })
        .compact()
+        .object()
        .value();

    return Q();
@@ -64,11 +63,11 @@ Generator.prototype.prepareStyles = function() {

 // Prepare templates
 Generator.prototype.prepareTemplates = function() {
-	this.templates["page"] = this.book.plugins.template("site:page") || path.resolve(this.options.theme, 'templates/website/page.html');
-    this.templates["langs"] = this.book.plugins.template("site:langs") || path.resolve(this.options.theme, 'templates/website/langs.html');
-    this.templates["glossary"] = this.book.plugins.template("site:glossary") || path.resolve(this.options.theme, 'templates/website/glossary.html');
+    this.templates.page = this.book.plugins.template("site:page") || path.resolve(this.options.theme, "templates/website/page.html");
+    this.templates.langs = this.book.plugins.template("site:langs") || path.resolve(this.options.theme, "templates/website/langs.html");
+    this.templates.glossary = this.book.plugins.template("site:glossary") || path.resolve(this.options.theme, "templates/website/glossary.html");

-	return Q();
+    return Q();
 };

 // Prepare template engine
@@ -79,8 +78,8 @@ Generator.prototype.prepareTemplateEngine = function() {
    .then(function() {
        var language = that.book.config.normalizeLanguage();

-        if (!i18n.getByLanguage(language) && language != "en") {
-            that.book.log.warn.ln("Language '"+language+"' is not available as a layout locales (en, "+i18n.getLanguages().join(", ")+")");
+        if (!i18n.hasLocale(language)) {
+            that.book.log.warn.ln("Language '"+language+"' is not available as a layout locales (en, "+i18n.getLocales().join(", ")+")");
        }

        var folders = _.chain(that.templates)
@@ -98,18 +97,13 @@ Generator.prototype.prepareTemplateEngine = function() {

        // Add filter
        that.env.addFilter("contentLink", that.book.contentLink.bind(that.book));
-        that.env.addFilter('lvl', function(lvl) {
+        that.env.addFilter("lvl", function(lvl) {
            return lvl.split(".").length;
        });

        // Add extension
-        that.env.addExtension('AutoEscapeExtension', new AutoEscapeExtension(that.env));
-        that.env.addExtension('FilterExtension', new FilterExtension(that.env));
-        that.env.addExtension('I18nExtension', new I18nExtension({
-            env: that.env,
-            translations: i18n.getLocales(),
-            locale: "language"
-        }));
+        that.env.addExtension("AutoEscapeExtension", new AutoEscapeExtension(that.env));
+        that.env.addExtension("FilterExtension", new FilterExtension(that.env));
    });
 };

@@ -119,7 +113,7 @@ Generator.prototype.finish = function() {
    .then(this.copyCover)
    .then(this.writeGlossary)
    .then(this.writeSearchIndex)
-    .then(this.writeLangsIndex)
+    .then(this.writeLangsIndex);
 };

 // Convert an input file
@@ -136,15 +130,15 @@ Generator.prototype.convertFile = function(input) {
        }
    })
    .then(function(page) {
-        var relativeOutput = that.book.contentLink(page.path);
+        var relativeOutput = that.book.contentPath(page.path);
        var output = path.join(that.options.output, relativeOutput);

        var basePath = path.relative(path.dirname(output), that.options.output) || ".";
-        if (process.platform === 'win32') basePath = basePath.replace(/\\/g, '/');
+        if (process.platform === "win32") basePath = basePath.replace(/\\/g, "/");

        that.book.log.debug.ln("write parsed file", page.path, "to", relativeOutput);

-        return that._writeTemplate(that.templates["page"], {
+        return that._writeTemplate(that.templates.page, {
            progress: page.progress,

            _input: page.path,
@@ -158,27 +152,23 @@ Generator.prototype.convertFile = function(input) {

 // Write the index for langs
 Generator.prototype.writeLangsIndex = function() {
-    var that = this;
    if (!this.book.langs.length) return Q();
-    return this._writeTemplate(this.templates["langs"], {
+
+    return this._writeTemplate(this.templates.langs, {
        langs: this.book.langs
    }, path.join(this.options.output, "index.html"));
 };

 // Write glossary
 Generator.prototype.writeGlossary = function() {
-    var that = this;
-
    // No glossary
-    if (this.book.glossary.length == 0) return Q();
+    if (this.book.glossary.length === 0) return Q();

-    return this._writeTemplate(this.templates["glossary"], {}, path.join(this.options.output, "GLOSSARY.html"));
+    return this._writeTemplate(this.templates.glossary, {}, path.join(this.options.output, "GLOSSARY.html"));
 };

 // Write the search index
 Generator.prototype.writeSearchIndex = function() {
-    var that = this;
-
    return fs.writeFile(
        path.join(this.options.output, "search_index.json"),
        JSON.stringify(this.book.searchIndex)
@@ -212,39 +202,41 @@ Generator.prototype._writeTemplate = function(tpl, options, output, interpolate)

    interpolate = interpolate || _.identity;
    return Q()
-    .then(function(sections) {
-    	return that.env.render(
-    		tpl,
-    		_.extend({
+    .then(function() {
+        return that.env.render(
+            tpl,
+            _.extend({
                gitbook: {
                    version: pkg.version
                },

-	            styles: that.styles,
+                styles: that.styles,

-	            revision: that.revision,
+                revision: that.revision,

-	            title: that.options.title,
-	            description: that.options.description,
+                title: that.options.title,
+                description: that.options.description,
                language: that.book.config.normalizeLanguage(),

-	            glossary: that.book.glossary,
+                glossary: that.book.glossary,

-	            summary: that.book.summary,
-	            allNavigation: that.book.navigation,
+                summary: that.book.summary,
+                allNavigation: that.book.navigation,

-	            plugins: {
+                plugins: {
                    resources: that.book.plugins.resources(that.namespace)
                },
-	            pluginsConfig: JSON.stringify(that.options.pluginsConfig),
-	            htmlSnippet: _.partial(_.partialRight(that.book.plugins.html, that, options), that.namespace),
+                pluginsConfig: JSON.stringify(that.options.pluginsConfig),
+                htmlSnippet: _.partial(_.partialRight(that.book.plugins.html, that, options), that.namespace),

-	            options: that.options,
+                options: that.options,

                basePath: ".",
                staticBase: path.join(".", "gitbook"),
-	        }, options)
-	    );
+
+                "__": that.book.i18n.bind(that.book)
+            }, options)
+        );
    })
    .then(interpolate)
    .then(function(html) {
@@ -1,210 +1,209 @@
 var Q = require("q");
 var _ = require("lodash");
 var path = require("path");
-var tinylr = require('tiny-lr');
-var color = require('bash-color');
+var tinylr = require("tiny-lr");
+var color = require("bash-color");

 var Book = require("./book");
-var Plugin = require("./plugin");
 var Server = require("./utils/server");
 var stringUtils = require("./utils/string");
 var watch = require("./utils/watch");
 var logger = require("./utils/logger");

 var LOG_OPTION = {
-	name: "log",
-	description: "Minimum log level to display",
-	values: _.chain(logger.LEVELS).keys().map(stringUtils.toLowerCase).value(),
-	defaults: "info"
+    name: "log",
+    description: "Minimum log level to display",
+    values: _.chain(logger.LEVELS).keys().map(stringUtils.toLowerCase).value(),
+    defaults: "info"
 };

 var FORMAT_OPTION = {
-	name: "format",
-	description: "Format to build to",
-	values: ["website", "json", "ebook"],
-	defaults: "website"
+    name: "format",
+    description: "Format to build to",
+    values: ["website", "json", "ebook"],
+    defaults: "website"
 };

 module.exports = {
-	Book: Book,
-	LOG_LEVELS: logger.LEVELS,
+    Book: Book,
+    LOG_LEVELS: logger.LEVELS,

-	commands: _.flatten([
-		{
-			name: "build [book] [output]",
-			description: "build a book",
-			options: [
-				FORMAT_OPTION,
-				LOG_OPTION
-			],
-			exec: function(args, kwargs) {
-				var input = args[0] || process.cwd();
-				var output = args[1] || path.join(input, "_book");
+    commands: _.flatten([
+        {
+            name: "build [book] [output]",
+            description: "build a book",
+            options: [
+                FORMAT_OPTION,
+                LOG_OPTION
+            ],
+            exec: function(args, kwargs) {
+                var input = args[0] || process.cwd();
+                var output = args[1] || path.join(input, "_book");

-				var book = new Book(input, _.extend({}, {
-					'config': {
-						'output': output
-					},
-					'logLevel': kwargs.log
-				}));
+                var book = new Book(input, _.extend({}, {
+                    "config": {
+                        "output": output
+                    },
+                    "logLevel": kwargs.log
+                }));

-				return book.parse()
-				.then(function() {
-					return book.generate(kwargs.format);
-				})
-				.then(function(){
-					console.log("");
-					console.log(color.green("Done, without error"));
-				});
-			}
-		},
+                return book.parse()
+                .then(function() {
+                    return book.generate(kwargs.format);
+                })
+                .then(function(){
+                    console.log("");
+                    console.log(color.green("Done, without error"));
+                });
+            }
+        },

-		_.map(["pdf", "epub", "mobi"], function(ebookType) {
-			return {
-				name: ebookType+" [book] [output]",
-				description: "build a book to "+ebookType,
-				options: [
-					LOG_OPTION
-				],
-				exec: function(args, kwargs) {
-					var input = args[0] || process.cwd();
-					var output = args[1];
+        _.map(["pdf", "epub", "mobi"], function(ebookType) {
+            return {
+                name: ebookType+" [book] [output]",
+                description: "build a book to "+ebookType,
+                options: [
+                    LOG_OPTION
+                ],
+                exec: function(args, kwargs) {
+                    var input = args[0] || process.cwd();
+                    var output = args[1];

-					var book = new Book(input, _.extend({}, {
-						'logLevel': kwargs.log
-					}));
+                    var book = new Book(input, _.extend({}, {
+                        "logLevel": kwargs.log
+                    }));

-					return book.parse()
-					.then(function() {
-						return book.generateFile(output, {
-							ebookFormat: ebookType
-						});
-					})
-					.then(function(){
-						console.log("");
-						console.log(color.green("Done, without error"));
-					});
-				}
-			};
-		}),
+                    return book.parse()
+                    .then(function() {
+                        return book.generateFile(output, {
+                            ebookFormat: ebookType
+                        });
+                    })
+                    .then(function(){
+                        console.log("");
+                        console.log(color.green("Done, without error"));
+                    });
+                }
+            };
+        }),

-		{
-			name: "serve [book]",
-			description: "Build then serve a gitbook from a directory",
-			options: [
-				{
-					name: "port",
-					description: "Port for server to listen on",
-					defaults: 4000
-				},
-				{
-					name: "lrport",
-					description: "Port for livereload server to listen on",
-					defaults: 35729
-				},
-				{
-					name: "watch",
-					description: "Enable/disable file watcher",
-					defaults: true
-				},
-				FORMAT_OPTION,
-				LOG_OPTION
-			],
-			exec: function(args, kwargs) {
-				var input = args[0] || process.cwd();
-				var server = new Server();
+        {
+            name: "serve [book]",
+            description: "Build then serve a gitbook from a directory",
+            options: [
+                {
+                    name: "port",
+                    description: "Port for server to listen on",
+                    defaults: 4000
+                },
+                {
+                    name: "lrport",
+                    description: "Port for livereload server to listen on",
+                    defaults: 35729
+                },
+                {
+                    name: "watch",
+                    description: "Enable/disable file watcher",
+                    defaults: true
+                },
+                FORMAT_OPTION,
+                LOG_OPTION
+            ],
+            exec: function(args, kwargs) {
+                var input = args[0] || process.cwd();
+                var server = new Server();

-				// Init livereload server
-				var lrServer = tinylr({});
-				var lrPath = undefined;
+                // Init livereload server
+                var lrServer = tinylr({});
+                var lrPath;

-				var generate = function() {
-			        if (server.isRunning()) console.log("Stopping server");
+                var generate = function() {
+                    if (server.isRunning()) console.log("Stopping server");

-			        return server.stop()
-			        .then(function() {
-			        	var book = new Book(input, _.extend({}, {
-							'config': {
-								'defaultsPlugins': ["livereload"]
-							},
-							'logLevel': kwargs.log
-						}));
+                    return server.stop()
+                    .then(function() {
+                        var book = new Book(input, _.extend({}, {
+                            "config": {
+                                "defaultsPlugins": ["livereload"]
+                            },
+                            "logLevel": kwargs.log
+                        }));

-						return book.parse()
-						.then(function() {
-							return book.generate(kwargs.format);
-						})
-						.thenResolve(book);
-			        })
-			        .then(function(book) {
-			            console.log();
-			            console.log('Starting server ...');
-			            return server.start(book.options.output, kwargs.port)
-			            .then(function() {
-			                console.log('Serving book on http://localhost:'+kwargs.port);
+                        return book.parse()
+                        .then(function() {
+                            return book.generate(kwargs.format);
+                        })
+                        .thenResolve(book);
+                    })
+                    .then(function(book) {
+                        console.log();
+                        console.log("Starting server ...");
+                        return server.start(book.options.output, kwargs.port)
+                        .then(function() {
+                            console.log("Serving book on http://localhost:"+kwargs.port);

-			                if (lrPath) {
-			                	// trigger livereload
-			                	lrServer.changed({
-			                		body: {
-			                			files: [lrPath]
-			                		}
-			                	});
-			                }
+                            if (lrPath) {
+                                // trigger livereload
+                                lrServer.changed({
+                                    body: {
+                                        files: [lrPath]
+                                    }
+                                });
+                            }

-			                if (!kwargs.watch) return;
+                            if (!kwargs.watch) return;

-			                return watch(book.root)
-			                .then(function(filepath) {
-			                    // set livereload path
-			                    lrPath = filepath;
-			                    console.log("Restart after change in files");
-			                    console.log('');
-			                    return generate();
-			                })
-			            })
-			        });
-			    };
+                            return watch(book.root)
+                            .then(function(filepath) {
+                                // set livereload path
+                                lrPath = filepath;
+                                console.log("Restart after change in file", filepath);
+                                console.log("");
+                                return generate();
+                            });
+                        });
+                    });
+                };

-				return Q.nfcall(lrServer.listen.bind(lrServer), kwargs.lrport)
-				.then(function() {
-					console.log('Live reload server started on port:', kwargs.lrport);
-					console.log('Press CTRL+C to quit ...');
-    				console.log('')
-					return generate();
-				});
-			}
-		},
+                return Q.nfcall(lrServer.listen.bind(lrServer), kwargs.lrport)
+                .then(function() {
+                    console.log("Live reload server started on port:", kwargs.lrport);
+                    console.log("Press CTRL+C to quit ...");
+                    console.log("");
+                    return generate();
+                });
+            }
+        },

-		{
-			name: "install [book]",
-			description: "install plugins dependencies",
-			exec: function(args, kwargs) {
-				var input = args[0] || process.cwd();
+        {
+            name: "install [book]",
+            description: "install plugins dependencies",
+            exec: function(args) {
+                var input = args[0] || process.cwd();

-				var book = new Book(input);
+                var book = new Book(input);

-				return book.config.load()
-				.then(function() {
-					return book.plugins.install();
-				})
-				.then(function(){
-					console.log("");
-					console.log(color.green("Done, without error"));
-				});
-			}
-		},
+                return book.config.load()
+                .then(function() {
+                    return book.plugins.install();
+                })
+                .then(function(){
+                    console.log("");
+                    console.log(color.green("Done, without error"));
+                });
+            }
+        },

-		{
-			name: "init [directory]",
-			description: "create files and folders based on contents of SUMMARY.md",
-			exec: function(args, kwargs) {
-				return Book.init(args[0] || process.cwd())
-				.then(function(){
-					console.log("");
-					console.log(color.green("Done, without error"));
-				});
-			}
-		}
-	])
+        {
+            name: "init [directory]",
+            description: "create files and folders based on contents of SUMMARY.md",
+            exec: function(args) {
+                return Book.init(args[0] || process.cwd())
+                .then(function(){
+                    console.log("");
+                    console.log(color.green("Done, without error"));
+                });
+            }
+        }
+    ])
 };
@@ -4,7 +4,7 @@ var semver = require("semver");
 var path = require("path");
 var url = require("url");
 var fs = require("./utils/fs");
-var resolve = require('resolve');
+var resolve = require("resolve");

 var pkg = require("../package.json");

@@ -33,8 +33,8 @@ var Plugin = function(book, name) {
 // Type of plugins resources
 Plugin.RESOURCES = ["js", "css"];
 Plugin.HOOKS = [
-    "init", "finish", "finish:before"
-]
+    "init", "finish", "finish:before", "page", "page:before"
+];

 // Load from a name
 Plugin.prototype.load = function(name, baseDir) {
@@ -77,7 +77,7 @@ Plugin.prototype._getResources = function(base) {
    var book = this.infos[base];

    // Compatibility with version 1.x.x
-    if (base == "website") book = book || this.infos["book"];
+    if (base == "website") book = book || this.infos.book;

    // Nothing specified, fallback to default
    if (!book) {
@@ -155,7 +155,7 @@ Plugin.prototype.callHook = function(name, data) {
    if (!hookFunc) return Q(data);

    this.book.log.debug.ln("call hook", name);
-    if (!_.contains(Plugin.HOOKS, name)) this.book.log.warn.ln("hook '"+name+"' used by plugin '"+this.name+"' is deprecated, and will be remove in the coming versions");
+    if (!_.contains(Plugin.HOOKS, name)) this.book.log.warn.ln("hook '"+name+"' used by plugin '"+this.name+"' is deprecated, and will be removed in the coming versions");

    return Q()
    .then(function() {
@@ -168,7 +168,7 @@ Plugin.prototype.copyAssets = function(out, base) {
    var that = this;

    return this.getResources(base)
-    .get('assets')
+    .get("assets")
    .then(function(assets) {
        // Assets are undefined
        if(!assets) return false;
@@ -1,120 +1,116 @@
 var _ = require("lodash");
 var Q = require("q");
-var npmi = require('npmi');
-var npm = require('npm');
-var semver = require('semver');
+var npmi = require("npmi");
+var npm = require("npm");
+var semver = require("semver");

 var Plugin = require("./plugin");
 var pkg = require("../package.json");

 var initNPM = _.memoize(function() {
-	return Q.nfcall(npm.load, { silent: true, loglevel: 'silent' });
+    return Q.nfcall(npm.load, { silent: true, loglevel: "silent" });
 });


 var PluginsList = function(book, plugins) {
-	this.book = book;
-	this.log = this.book.log;
+    this.book = book;
+    this.log = this.book.log;

-	// List of Plugin objects
-	this.list = [];
+    // List of Plugin objects
+    this.list = [];

-	// List of names of failed plugins
-	this.failed = [];
+    // List of names of failed plugins
+    this.failed = [];

-	// Namespaces
-	this.namespaces = _.chain(["website", "ebook"])
-		.map(function(namespace) {
-			return [
-				namespace,
-				{
-					html: {},
-					resources: _.chain(Plugin.RESOURCES)
-						.map(function(type) {
-							return [type, []];
-						})
-						.object()
-						.value()
-				}
-			];
-		})
-		.object()
-		.value();
+    // Namespaces
+    this.namespaces = _.chain(["website", "ebook"])
+        .map(function(namespace) {
+            return [
+                namespace,
+                {
+                    html: {},
+                    resources: _.chain(Plugin.RESOURCES)
+                        .map(function(type) {
+                            return [type, []];
+                        })
+                        .object()
+                        .value()
+                }
+            ];
+        })
+        .object()
+        .value();

-	// Bind methods
-	_.bindAll(this);
+    // Bind methods
+    _.bindAll(this);

-	if (plugins) this.load(plugins);
+    if (plugins) this.load(plugins);
 };

 // return count of plugins
 PluginsList.prototype.count = function() {
-	return this.list.length;
+    return this.list.length;
 };

 // Add and load a plugin
-PluginsList.prototype.load = function(plugin, options) {
-	var that = this;
+PluginsList.prototype.load = function(plugin) {
+    var that = this;

-	if (_.isArray(plugin)) {
-		return _.reduce(plugin, function(prev, p) {
-			return prev.then(function() {
-				return that.load(p);
-			});
-		}, Q());
-	}
-	if (_.isObject(plugin) && !(plugin instanceof Plugin)) plugin = plugin.name;
-	if (_.isString(plugin)) plugin = new Plugin(this.book, plugin);
+    if (_.isArray(plugin)) {
+        return _.reduce(plugin, function(prev, p) {
+            return prev.then(function() {
+                return that.load(p);
+            });
+        }, Q());
+    }
+    if (_.isObject(plugin) && !(plugin instanceof Plugin)) plugin = plugin.name;
+    if (_.isString(plugin)) plugin = new Plugin(this.book, plugin);

-	that.log.info("load plugin", plugin.name, "....");
-	if (!plugin.isValid()) {
-    	that.log.info.fail();
-    	that.failed.push(plugin.name);
-    	return Q();
+    that.log.info("load plugin", plugin.name, "....");
+    if (!plugin.isValid()) {
+        that.log.info.fail();
+        that.failed.push(plugin.name);
+        return Q();
    } else {
-    	that.log.info.ok();
+        that.log.info.ok();

-    	// Push in the list
-    	that.list.push(plugin);
+        // Push in the list
+        that.list.push(plugin);
    }

-	// Extract filters
-	_.each(plugin.getFilters(), function(filterFunc, filterName) {
-        that.book.template.addFilter(filterName, filterFunc);
-    });
+    // Extract filters
+    that.book.template.addFilters(plugin.getFilters());

    // Extract blocks
-	_.each(plugin.getBlocks(), function(block, blockName) {
-        that.book.template.addBlock(blockName, block);
-    });
+    that.book.template.addBlocks(plugin.getBlocks());

-	return _.reduce(_.keys(that.namespaces), function(prev, namespaceName) {
-		return prev.then(function() {
-			return plugin.getResources(namespaceName)
-			.then(function(plResources) {
-				var namespace = that.namespaces[namespaceName];
+    return _.reduce(_.keys(that.namespaces), function(prev, namespaceName) {
+        return prev.then(function() {
+            return plugin.getResources(namespaceName)
+            .then(function(plResources) {
+                var namespace = that.namespaces[namespaceName];

-				// Extract js and css
-				_.each(Plugin.RESOURCES, function(resourceType) {
-					namespace.resources[resourceType] = (namespace.resources[resourceType] || []).concat(plResources[resourceType] || []);
-				});
+                // Extract js and css
+                _.each(Plugin.RESOURCES, function(resourceType) {
+                    namespace.resources[resourceType] = (namespace.resources[resourceType] || []).concat(plResources[resourceType] || []);
+                });

-		        // Map of html resources by name added by each plugin
-		        _.each(plResources.html || {}, function(value, tag) {
-		        	// Turn into function if not one already
-		           	if (!_.isFunction(value)) value = _.constant(value);
+                // Map of html resources by name added by each plugin
+                _.each(plResources.html || {}, function(value, tag) {
+                    // Turn into function if not one already
+                    if (!_.isFunction(value)) value = _.constant(value);

-		        	namespace.html[tag] = namespace.html[tag] || [];
-		        	namespace.html[tag].push(value);
-		        });
-			})
-		});
-	}, Q());
+                    namespace.html[tag] = namespace.html[tag] || [];
+                    namespace.html[tag].push(value);
+                });
+            });
+        });
+    }, Q());
 };

 // Call a hook
 PluginsList.prototype.hook = function(name, data) {
-	return _.reduce(this.list, function(prev, plugin) {
+    return _.reduce(this.list, function(prev, plugin) {
        return prev.then(function(ret) {
            return plugin.callHook(name, ret);
        });
@@ -123,7 +119,7 @@ PluginsList.prototype.hook = function(name, data) {

 // Return a template from a plugin
 PluginsList.prototype.template = function(name) {
-	var withTpl = _.find(this.list, function(plugin) {
+    var withTpl = _.find(this.list, function(plugin) {
        return (
            plugin.infos.templates &&
            plugin.infos.templates[name]
@@ -136,7 +132,7 @@ PluginsList.prototype.template = function(name) {

 // Return an html snippet
 PluginsList.prototype.html = function(namespace, tag, context, options) {
-	var htmlSnippets = this.namespaces[namespace].html[tag];
+    var htmlSnippets = this.namespaces[namespace].html[tag];
    return _.map(htmlSnippets || [], function(code) {
        return code.call(context, options);
    }).join("\n");
@@ -144,17 +140,16 @@ PluginsList.prototype.html = function(namespace, tag, context, options) {

 // Return a resources map for a namespace
 PluginsList.prototype.resources = function(namespace) {
-	return this.namespaces[namespace].resources;
+    return this.namespaces[namespace].resources;
 };

 // Install plugins from a book
 PluginsList.prototype.install = function() {
-	var that = this;
-	var defaultsPlugins = _.pluck(that.book.options.defaultsPlugins)
+    var that = this;

    // Remove defaults (no need to install)
-    var plugins = _.filter(that.book.options.plugins, function(plugin) {
-        return !_.contains(defaultsPlugins, plugin.name);
+    var plugins = _.reject(that.book.options.plugins, {
+        isDefault: true
    });

    // Install plugins one by one
@@ -167,51 +162,51 @@ PluginsList.prototype.install = function() {

            // Resolve version if needed
            .then(function() {
-            	if (plugin.version) return plugin.version;
+                if (plugin.version) return plugin.version;

-            	that.book.log.info.ln("No version specified, resolve plugin", plugin.name);
-            	return initNPM()
-            	.then(function() {
-            		return Q.nfcall(npm.commands.view, [fullname+"@*", "engines"], true);
-            	})
-            	.then(function(versions) {
-            		return _.chain(versions)
-            			.pairs()
-            			.map(function(v) {
-            				return {
-            					version: v[0],
-            					gitbook: (v[1].engines || {})["gitbook"]
-            				}
-            			})
-            			.filter(function(v) {
-            				return v.gitbook && semver.satisfies(pkg.version, v.gitbook);
-            			})
-            			.sort(function(v1, v2) {
-            				return semver.lt(v1.version, v2.version)? 1 : -1;
-            			})
-            			.pluck("version")
-            			.first()
-            			.value();
-            	});
+                that.book.log.info.ln("No version specified, resolve plugin", plugin.name);
+                return initNPM()
+                .then(function() {
+                    return Q.nfcall(npm.commands.view, [fullname+"@*", "engines"], true);
+                })
+                .then(function(versions) {
+                    return _.chain(versions)
+                        .pairs()
+                        .map(function(v) {
+                            return {
+                                version: v[0],
+                                gitbook: (v[1].engines || {}).gitbook
+                            };
+                        })
+                        .filter(function(v) {
+                            return v.gitbook && semver.satisfies(pkg.version, v.gitbook);
+                        })
+                        .sort(function(v1, v2) {
+                            return semver.lt(v1.version, v2.version)? 1 : -1;
+                        })
+                        .pluck("version")
+                        .first()
+                        .value();
+                });
            })

            // Install the plugin with the resolved version
            .then(function(version) {
-            	if (!version) {
-            		throw "Found no satisfactory version for plugin "+plugin.name;
-            	}
+                if (!version) {
+                    throw "Found no satisfactory version for plugin "+plugin.name;
+                }

-            	that.book.log.info.ln("install plugin", plugin.name, "from npm ("+fullname+") with version", version);
-	            return Q.nfcall(npmi, {
-	                'name': fullname,
-	                'version': version,
-	                'path': that.book.root,
-	                'npmLoad': {
-	                    'loglevel': 'silent',
-	                    'loaded': true,
-	                    'prefix': that.book.root
-	                }
-	            });
+                that.book.log.info.ln("install plugin", plugin.name, "from npm ("+fullname+") with version", version);
+                return Q.nfcall(npmi, {
+                    "name": fullname,
+                    "version": version,
+                    "path": that.book.root,
+                    "npmLoad": {
+                        "loglevel": "silent",
+                        "loaded": true,
+                        "prefix": that.book.root
+                    }
+                });
            })
            .then(function() {
                that.book.log.info.ok("plugin", plugin.name, "installed with success");
@@ -220,6 +215,4 @@ PluginsList.prototype.install = function() {
    }, Q());
 };

-
-
 module.exports = PluginsList;
@@ -1,119 +1,88 @@
 var _ = require("lodash");
 var Q = require("q");
-var path = require("path");
 var nunjucks = require("nunjucks");
+var escapeStringRegexp = require("escape-string-regexp");

-var git = require("./utils/git");
-var stringUtils = require("./utils/string");
-var fs = require("./utils/fs");
 var batch = require("./utils/batch");
 var pkg = require("../package.json");
+var defaultBlocks = require("./blocks");
+var BookLoader = require("./conrefs_loader");

-
-// The loader should handle relative and git url
-var BookLoader = nunjucks.Loader.extend({
-	async: true,
-
-    init: function(book) {
-    	this.book = book;
-    },
-
-    getSource: function(fileurl, callback) {
-    	var that = this;
-
-		git.resolveFile(fileurl)
-		.then(function(filepath) {
-			// Is local file
-			if (!filepath) filepath = path.resolve(that.book.root, fileurl);
-			else that.book.log.debug.ln("resolve from git", fileurl, "to", filepath)
-
-			//  Read file from absolute path
-			return fs.readFile(filepath)
-    		.then(function(source) {
-    			return {
-    				src: source.toString(),
-    				path: filepath
-    			}
-    		});
-		})
-		.nodeify(callback);
-    },
-
-    resolve: function(from, to) {
-        return path.resolve(path.dirname(from), to);
-    }
-});
+// Normalize result from a block
+function normBlockResult(blk) {
+    if (_.isString(blk)) blk = { body: blk };
+    return blk;
+}


 var TemplateEngine = function(book) {
-	this.book = book;
+    this.book = book;
    this.log = this.book.log;

-	// Nunjucks env
-	this.env = new nunjucks.Environment(
-		new BookLoader(book),
-		{
-			// Escaping is done after by the markdown parser
-			autoescape: false,
+    // Nunjucks env
+    this.env = new nunjucks.Environment(
+        new BookLoader(book),
+        {
+            // Escaping is done after by the markdown parser
+            autoescape: false,

-			// Tags
-			tags: {
-				blockStart: '{%',
-				blockEnd: '%}',
-				variableStart: '{{',
-				variableEnd: '}}',
-				commentStart: '{###',
-				commentEnd: '###}'
-			}
-		}
-	);
+            // Tags
+            tags: {
+                blockStart: "{%",
+                blockEnd: "%}",
+                variableStart: "{{",
+                variableEnd: "}}",
+                commentStart: "{###",
+                commentEnd: "###}"
+            }
+        }
+    );

    // List of tags shortcuts
    this.shortcuts = [];

-    // Map of blocks
+    // Map of blocks bodies (that requires post-processing)
+    this.blockBodies = {};
+
+    // Map of added blocks
    this.blocks = {};

    // Bind methods
    _.bindAll(this);

-    // Default block "html" that return html not parsed
-    this.addBlock("html", {
-        process: _.identity
-    });
+    // Add default blocks
+    this.addBlocks(defaultBlocks);
 };

-// Process a block in a context
+// Process the result of block in a context
 TemplateEngine.prototype.processBlock = function(blk) {
-    if (_.isString(blk)) blk = { body: blk };
-
    blk = _.defaults(blk, {
        parse: false,
        post: undefined
    });
    blk.id = _.uniqueId("blk");

-    var toAdd = (!blk.parse) || (blk.post != undefined);
+    var toAdd = (!blk.parse) || (blk.post !== undefined);

    // Add to global map
-    if (toAdd) this.blocks[blk.id] = blk;
+    if (toAdd) this.blockBodies[blk.id] = blk;

    //Parsable block, just return it
    if (blk.parse) {
        return blk.body;
    }

-    // Return it as a macro
-    return "%+%"+blk.id+"%+%";
+    // Return it as a position marker
+    return "@%@"+blk.id+"@%@";
 };

-// Replace blocks by body after processing
-// This is done to avoid that markdown processer parse the block content
+// Replace position markers of blocks by body after processing
+// This is done to avoid that markdown/asciidoc processer parse the block content
 TemplateEngine.prototype.replaceBlocks = function(content) {
    var that = this;

-    return content.replace(/\%\+\%([\s\S]+?)\%\+\%/g, function(match, key) {
-        var blk = that.blocks[key];
+    return content.replace(/\@\%\@([\s\S]+?)\@\%\@/g, function(match, key) {
+        var blk = that.blockBodies[key];
        if (!blk) return match;

        var body = blk.body;
@@ -141,11 +110,11 @@ TemplateEngine.prototype.bindContext = function(func) {
 TemplateEngine.prototype.addFilter = function(filterName, func) {
    try {
        this.env.getFilter(filterName);
-        this.log.warn.ln("conflict in filters, '"+filterName+"' is already set");
+        this.log.warn.ln("conflict in filters, \""+filterName+"\" is already set");
        return false;
    } catch(e) {}

-    this.log.debug.ln("add filter '"+filterName+"'");
+    this.log.debug.ln("add filter \""+filterName+"\"");
    this.env.addFilter(filterName, this.bindContext(function() {
        var ctx = this;
        var args = Array.prototype.slice.apply(arguments);
@@ -160,9 +129,41 @@ TemplateEngine.prototype.addFilter = function(filterName, func) {
    return true;
 };

+// Add multiple filters
+TemplateEngine.prototype.addFilters = function(filters) {
+    _.each(filters, function(filter, name) {
+        this.addFilter(name, filter);
+    }, this);
+};
+
+// Return nunjucks extension name of a block
+TemplateEngine.prototype.blockExtName = function(name) {
+    return "Block"+name+"Extension";
+};
+
+// Test if a block is defined
+TemplateEngine.prototype.hasBlock = function(name) {
+    return this.env.hasExtension(this.blockExtName(name));
+};
+
+// Remove a block
+TemplateEngine.prototype.removeBlock = function(name) {
+    if (!this.hasBlock(name)) return;
+
+    // Remove nunjucks extension
+    this.env.removeExtension(this.blockExtName(name));
+
+    // Cleanup shortcuts
+    this.shortcuts = _.reject(this.shortcuts, {
+        block: name
+    });
+};
+
 // Add a block
 TemplateEngine.prototype.addBlock = function(name, block) {
-    var that = this;
+    var that = this, Ext, extName;
+
+    if (_.isFunction(block)) block = { process: block };

    block = _.defaults(block || {}, {
        shortcuts: [],
@@ -171,18 +172,22 @@ TemplateEngine.prototype.addBlock = function(name, block) {
        blocks: []
    });

-    var extName = 'Block'+name+'Extension';
-    if (this.env.getExtension(extName)) {
-        this.log.warn.ln("conflict in blocks, '"+name+"' is already defined");
-        return false;
+    extName = this.blockExtName(name);
+
+    if (this.hasBlock(name) && !defaultBlocks[name]) {
+        this.log.warn.ln("conflict in blocks, \""+name+"\" is already defined");
    }

-    this.log.debug.ln("add block '"+name+"'");
+    // Cleanup previous block
+    this.removeBlock(name);

-    var Ext = function () {
+    this.log.debug.ln("add block \""+name+"\"");
+    this.blocks[name] = block;
+
+    Ext = function () {
        this.tags = [name];

-        this.parse = function(parser, nodes, lexer) {
+        this.parse = function(parser, nodes) {
            var body = null;
            var lastBlockName = null;
            var lastBlockArgs = null;
@@ -223,7 +228,7 @@ TemplateEngine.prototype.addBlock = function(name, block) {
            var bodies = [body];
            _.each(block.blocks, function(blockName) {
                subbodies[blockName] = subbodies[blockName] || [];
-                if (subbodies[blockName].length == 0) {
+                if (subbodies[blockName].length === 0) {
                    subbodies[blockName].push({
                        args: new nodes.NodeList(),
                        body: new nodes.NodeList()
@@ -233,7 +238,7 @@ TemplateEngine.prototype.addBlock = function(name, block) {
                bodies.push(subbodies[blockName][0].body);
            });

-            return new nodes.CallExtensionAsync(this, 'run', args, bodies);
+            return new nodes.CallExtensionAsync(this, "run", args, bodies);
        };

        this.run = function(context) {
@@ -250,7 +255,7 @@ TemplateEngine.prototype.addBlock = function(name, block) {

            // Extract main body and kwargs
            var body = args.pop();
-            var kwargs = args.pop() || {};
+            var kwargs = _.isObject(_.last(args))? args.pop() : {};

            // Extract blocks body
            var _blocks =  _.map(block.blocks, function(blockName, i){
@@ -260,33 +265,31 @@ TemplateEngine.prototype.addBlock = function(name, block) {
                };
            });

-            var func = that.bindContext(block.process);
-
            Q()
            .then(function() {
-                return func.call(context, {
+                return that.applyBlock(name, {
                    body: body(),
                    args: args,
                    kwargs: kwargs,
                    blocks: _blocks
-                });
+                }, context);
            })

            // process the block returned
            .then(that.processBlock)
-            .nodeify(callback)
+            .nodeify(callback);
        };
    };

-
    // Add the Extension
    this.env.addExtension(extName, new Ext());

    // Add shortcuts
    if (!_.isArray(block.shortcuts)) block.shortcuts = [block.shortcuts];
    _.each(block.shortcuts, function(shortcut) {
-        this.log.debug.ln("add template shortcut from '"+shortcut.start+"' to block '"+name+"' for parsers ", shortcut.parsers);
+        this.log.debug.ln("add template shortcut from \""+shortcut.start+"\" to block \""+name+"\" for parsers ", shortcut.parsers);
        this.shortcuts.push({
+            block: name,
            parsers: shortcut.parsers,
            start: shortcut.start,
            end: shortcut.end,
@@ -298,12 +301,46 @@ TemplateEngine.prototype.addBlock = function(name, block) {
    }, this);
 };

+// Add multiple blocks
+TemplateEngine.prototype.addBlocks = function(blocks) {
+    _.each(blocks, function(block, name) {
+        this.addBlock(name, block);
+    }, this);
+};
+
+// Apply a block to some content
+// This method result depends on the type of block (async or sync)
+TemplateEngine.prototype.applyBlock = function(name, blk, ctx) {
+    var func, block, r;
+
+    block = this.blocks[name];
+    if (!block) throw new Error("Block not found \""+name+"\"");
+    if (_.isString(blk)) {
+        blk = {
+            body: blk
+        };
+    }
+
+    blk = _.defaults(blk, {
+        args: [],
+        kwargs: {},
+        blocks: []
+    });
+
+    // Bind and call block processor
+    func = this.bindContext(block.process);
+    r = func.call(ctx || {}, blk);
+
+    if (Q.isPromise(r)) return r.then(normBlockResult);
+    else return normBlockResult(r);
+};
+
 // Apply a shortcut to a string
 TemplateEngine.prototype._applyShortcut = function(parser, content, shortcut) {
    if (!_.contains(shortcut.parsers, parser)) return content;
    var regex = new RegExp(
-        stringUtils.escapeRegex(shortcut.start) + "([\\s\\S]*?[^\\$])" + stringUtils.escapeRegex(shortcut.end),
-       'g'
+        escapeStringRegexp(shortcut.start) + "([\\s\\S]*?[^\\$])" + escapeStringRegexp(shortcut.end),
+       "g"
    );
    return content.replace(regex, function(all, match) {
        return "{% "+shortcut.tag.start+" %}"+ match + "{% "+shortcut.tag.end+" %}";
@@ -312,10 +349,13 @@ TemplateEngine.prototype._applyShortcut = function(parser, content, shortcut) {

 // Render a string from the book
 TemplateEngine.prototype.renderString = function(content, context, options) {
-    var context = _.extend({}, context, {
+    context = _.extend({}, context, {
        // Variables from book.json
        book: this.book.options.variables,

+        // Complete book.json
+        config: this.book.options,
+
        // infos about gitbook
        gitbook: {
            version: pkg.version,
@@ -331,12 +371,18 @@ TemplateEngine.prototype.renderString = function(content, context, options) {
    // Replace shortcuts
    content = _.reduce(this.shortcuts, _.partial(this._applyShortcut.bind(this), options.type), content);

-    return Q.nfcall(this.env.renderString.bind(this.env), content, context, options);
+    return Q.nfcall(this.env.renderString.bind(this.env), content, context, options)
+    .fail(function(err) {
+        if (_.isString(err)) err = new Error(err);
+        err.message = err.message.replace(/^Error: /, "");
+
+        throw err;
+    });
 };

 // Render a file from the book
-TemplateEngine.prototype.renderFile = function(filename, options) {
-	var that = this, context;
+TemplateEngine.prototype.renderFile = function(filename) {
+    var that = this;

    return that.book.readFile(filename)
    .then(function(content) {
@@ -348,11 +394,11 @@ TemplateEngine.prototype.renderFile = function(filename, options) {

 // Render a page from the book
 TemplateEngine.prototype.renderPage = function(page) {
-    var that = this, context;
+    var that = this;

    return that.book.statFile(page.path)
    .then(function(stat) {
-       context = {
+       var context = {
            // infos about the file
            file: {
                path: page.path,
@@ -374,7 +420,7 @@ TemplateEngine.prototype.postProcess = function(content) {
    return Q(content)
    .then(that.replaceBlocks)
    .then(function(_content) {
-        return batch.execEach(that.blocks, {
+        return batch.execEach(that.blockBodies, {
            max: 20,
            fn: function(blk, blkId) {
                return Q()
@@ -383,7 +429,7 @@ TemplateEngine.prototype.postProcess = function(content) {
                    return blk.post();
                })
                .then(function() {
-                    delete that.blocks[blkId];
+                    delete that.blockBodies[blkId];
                });
            }
        })
@@ -3,12 +3,12 @@ var _ = require("lodash");

 // Execute a method for all element
 function execEach(items, options) {
-    if (_.size(items) == 0) return Q();
+    if (_.size(items) === 0) return Q();
    var concurrents = 0, d = Q.defer(), pending = [];

    options = _.defaults(options || {}, {
        max: 100,
-        fn: function(item) {}
+        fn: function() {}
    });


@@ -29,7 +29,7 @@ function execEach(items, options) {
            // Next pending
            var next = pending.shift();

-            if (concurrents == 0 && !next) {
+            if (concurrents === 0 && !next) {
                d.resolve();
            } else if (next) {
                startItem.apply(null, next);
@@ -38,7 +38,7 @@ function execEach(items, options) {
        .fail(function(err) {
            pending = [];
            d.reject(err);
-        })
+        });
    }

    _.each(items, startItem);
@@ -9,10 +9,10 @@ var Ignore = require("fstream-ignore");
 var fsUtils = {
    tmp: {
        file: function(opt) {
-            return Q.nfcall(tmp.file.bind(tmp), opt).get(0)
+            return Q.nfcall(tmp.file.bind(tmp), opt).get(0);
        },
        dir: function() {
-            return Q.nfcall(tmp.dir.bind(tmp)).get(0)
+            return Q.nfcall(tmp.dir.bind(tmp)).get(0);
        }
    },
    list: listFiles,
@@ -34,14 +34,14 @@ var fsUtils = {
    readFileSync: fs.readFileSync.bind(fs),
    clean: cleanFolder,
    getUniqueFilename: getUniqueFilename,
-}
+};

 // Write a file
 function writeFile(filename, data, options) {
    var d = Q.defer();

    try {
-        fs.writeFileSync(filename, data, options)
+        fs.writeFileSync(filename, data, options);
    } catch(err) {
        d.reject(err);
    }
@@ -57,10 +57,14 @@ function writeStream(filename, st) {

    var wstream = fs.createWriteStream(filename);

-    wstream.on('finish', function () {
+    wstream.on("finish", function () {
        d.resolve();
    });
-    wstream.on('error', function (err) {
+    wstream.on("error", function (err) {
+        d.reject(err);
+    });
+
+    st.on("error", function(err) {
        d.reject(err);
    });

@@ -111,20 +115,20 @@ function listFiles(root, options) {
    });

    // Add extra rules to ignore common folders
-    ig.addIgnoreRules(options.ignoreRules, '__custom_stuff');
+    ig.addIgnoreRules(options.ignoreRules, "__custom_stuff");

    // Push each file to our list
-    ig.on('child', function (c) {
+    ig.on("child", function (c) {
        files.push(
-            c.path.substr(c.root.path.length + 1) + (c.props.Directory === true ? '/' : '')
+            c.path.substr(c.root.path.length + 1) + (c.props.Directory === true ? "/" : "")
        );
    });

-    ig.on('end', function() {
+    ig.on("end", function() {
        // Normalize paths on Windows
-        if(process.platform === 'win32') {
+        if(process.platform === "win32") {
            return d.resolve(files.map(function(file) {
-                return file.replace(/\\/g, '/');
+                return file.replace(/\\/g, "/");
            }));
        }

@@ -132,7 +136,7 @@ function listFiles(root, options) {
        return d.resolve(files);
    });

-    ig.on('error', d.reject);
+    ig.on("error", d.reject);

    return d.promise;
 }
@@ -146,8 +150,8 @@ function cleanFolder(root) {
        ignoreFiles: [],
        ignoreRules: [
            // Skip Git and SVN stuff
-            '.git/',
-            '.svn/'
+            ".git/",
+            ".svn/"
        ]
    })
    .then(function(files) {
@@ -1,11 +1,10 @@
 var  Q = require("q");
 var _ = require("lodash");
-var url = require("url");
-var tmp = require("tmp");
 var path = require("path");
 var crc = require("crc");
 var exec = Q.denodeify(require("child_process").exec);
 var URI = require("URIjs");
+var pathUtil = require("./path");

 var fs = require("./fs");

@@ -15,7 +14,7 @@ var GIT_TMP = null;

 // Check if an url is a git dependency url
 function checkGitUrl(giturl) {
-	return (giturl.indexOf(GIT_PREFIX) === 0);
+    return (giturl.indexOf(GIT_PREFIX) === 0);
 }

 // Validates a SHA in hexadecimal
@@ -25,88 +24,104 @@ function validateSha(str) {

 // Parse and extract infos
 function parseGitUrl(giturl) {
-	var ref, uri, fileParts, filepath;
+    var ref, uri, fileParts, filepath;

-	if (!checkGitUrl(giturl)) return null;
-	giturl = giturl.slice(GIT_PREFIX.length);
+    if (!checkGitUrl(giturl)) return null;
+    giturl = giturl.slice(GIT_PREFIX.length);

-	uri = new URI(giturl);
-	ref = uri.fragment() || "master";
-	uri.fragment(null);
+    uri = new URI(giturl);
+    ref = uri.fragment() || "master";
+    uri.fragment(null);

-	// Extract file inside the repo (after the .git)
-	fileParts =uri.path().split(".git");
-	filepath = fileParts.length > 1? fileParts.slice(1).join(".git") : "";
-	if (filepath[0] == "/") filepath = filepath.slice(1);
+    // Extract file inside the repo (after the .git)
+    fileParts =uri.path().split(".git");
+    filepath = fileParts.length > 1? fileParts.slice(1).join(".git") : "";
+    if (filepath[0] == "/") filepath = filepath.slice(1);

-	// Recreate pathname without the real filename
-	uri.path(_.first(fileParts)+".git");
+    // Recreate pathname without the real filename
+    uri.path(_.first(fileParts)+".git");

-	return {
-		host: uri.toString(),
-		ref: ref || "master",
-		filepath: filepath
-	};
+    return {
+        host: uri.toString(),
+        ref: ref || "master",
+        filepath: filepath
+    };
 }

 // Clone a git repo from a specific ref
 function cloneGitRepo(host, ref) {
-	var isBranch = false;
+    var isBranch = false;

-	ref = ref || "master";
-	if (!validateSha(ref)) isBranch = true;
+    ref = ref || "master";
+    if (!validateSha(ref)) isBranch = true;

-	return Q()
+    return Q()

-	// Create temporary folder to store git repos
-	.then(function() {
-		if (GIT_TMP) return;
-		return fs.tmp.dir()
-			.then(function(_tmp) {
-				GIT_TMP = _tmp;
-			});
-	})
+    // Create temporary folder to store git repos
+    .then(function() {
+        if (GIT_TMP) return;
+        return fs.tmp.dir()
+            .then(function(_tmp) {
+                GIT_TMP = _tmp;
+            });
+    })

-	// Return or clone the git repo
-	.then(function() {
-		// Unique ID for repo/ref combinaison
-		var repoId = crc.crc32(host+"#"+ref).toString(16);
+    // Return or clone the git repo
+    .then(function() {
+        // Unique ID for repo/ref combinaison
+        var repoId = crc.crc32(host+"#"+ref).toString(16);

-		// Absolute path to the folder
-		var repoPath = path.resolve(GIT_TMP, repoId);
+        // Absolute path to the folder
+        var repoPath = path.resolve(GIT_TMP, repoId);

-		return fs.exists(repoPath)
-			.then(function(doExists) {
-				if (doExists) return;
+        return fs.exists(repoPath)
+            .then(function(doExists) {
+                if (doExists) return;

-				// Clone repo
-				return exec("git clone "+host+" "+repoPath)
-				.then(function() {
-					return exec("git checkout "+ref, { cwd: repoPath });
-				})
-			})
-			.thenResolve(repoPath);
-	});
+                // Clone repo
+                return exec("git clone "+host+" "+repoPath)
+                .then(function() {
+                    return exec("git checkout "+ref, { cwd: repoPath });
+                });
+            })
+            .thenResolve(repoPath);
+    });
 }

-
 // Get file from a git repo
 function resolveFileFromGit(giturl) {
-	if (_.isString(giturl)) giturl = parseGitUrl(giturl);
-	if (!giturl) return Q(null);
+    if (_.isString(giturl)) giturl = parseGitUrl(giturl);
+    if (!giturl) return Q(null);

-	// Clone or get from cache
-	return cloneGitRepo(giturl.host, giturl.ref)
-	.then(function(repo) {
+    // Clone or get from cache
+    return cloneGitRepo(giturl.host, giturl.ref)
+    .then(function(repo) {

-		// Resolve relative path
-		return path.resolve(repo, giturl.filepath);
-	});
-};
+        // Resolve relative path
+        return path.resolve(repo, giturl.filepath);
+    });
+}
+
+// Return root of git repo from a filepath
+function resolveGitRoot(filepath) {
+    var relativeToGit, repoId;
+
+    // No git repo cloned, or file is not in a git repository
+    if (!GIT_TMP || !pathUtil.isInRoot(GIT_TMP, filepath)) return null;
+
+    // Extract first directory (is the repo id)
+    relativeToGit = path.relative(GIT_TMP, filepath);
+    repoId = _.first(relativeToGit.split(path.sep));
+    if (!repoId) return;
+
+    // Return an absolute file
+    return path.resolve(GIT_TMP, repoId);
+}


 module.exports = {
-	checkUrl: checkGitUrl,
-	parseUrl: parseGitUrl,
-	resolveFile: resolveFileFromGit
+    checkUrl: checkGitUrl,
+    parseUrl: parseGitUrl,
+    resolveFile: resolveFileFromGit,
+    resolveRoot: resolveGitRoot
 };
@@ -2,71 +2,79 @@ var _ = require("lodash");
 var path = require("path");
 var fs = require("fs");

-var I18N_PATH = path.resolve(__dirname, "../../theme/i18n/")
+var i18n = require("i18n");

-var getLocales = _.memoize(function() {
-	var locales = fs.readdirSync(I18N_PATH);
-	return _.chain(locales)
-        .map(function(local) {
-            local = path.basename(local, ".json");
-            return [local, _.extend({
-            	direction: "ltr"
-            }, require(path.join(I18N_PATH, local)), {
-            	id: local
-            })];
-        })
-        .object()
-        .value();
+var I18N_PATH = path.resolve(__dirname, "../../theme/i18n/");
+var DEFAULT_LANGUAGE = "en";
+var LOCALES = _.map(fs.readdirSync(I18N_PATH), function(lang) {
+    return path.basename(lang, ".json");
 });

-var getLanguages = function() {
-	return _.keys(getLocales());
-};
+i18n.configure({
+    locales: LOCALES,
+    directory: I18N_PATH,
+    defaultLocale: DEFAULT_LANGUAGE,
+    updateFiles: false
+});

-var getByLanguage = function(lang) {
-	lang = normalizeLanguage(lang);
-	var locales = getLocales();
-	return locales[lang];
-};
+function compareLocales(lang, locale) {
+    var langMain = _.first(lang.split("-"));
+    var langSecond = _.last(lang.split("-"));

-var compareLocales = function(lang, locale) {
-	var langMain = _.first(lang.split("-"));
-	var langSecond = _.last(lang.split("-"));
+    var localeMain = _.first(locale.split("-"));
+    var localeSecond = _.last(locale.split("-"));

-	var localeMain = _.first(locale.split("-"));
-	var localeSecond = _.last(locale.split("-"));
-
-	if (locale == lang) return 100;
-	if (localeMain == langMain) return 50;
-	if (localeSecond == langSecond) return 20;
-	return 0;
-};
+    if (locale == lang) return 100;
+    if (localeMain == langMain) return 50;
+    if (localeSecond == langSecond) return 20;
+    return 0;
+}

 var normalizeLanguage = _.memoize(function(lang) {
-	var locales = getLocales();
-	var language = _.chain(locales)
-		.values()
-		.map(function(locale) {
-			locale = locale.id;
-
-			return {
-				locale: locale,
-				score: compareLocales(lang, locale)
-			}
-		})
-		.filter(function(lang) {
-			return lang.score > 0;
-		})
-		.sortBy("score")
-		.pluck("locale")
-		.last()
-		.value();
-	return language || lang;
+    var language = _.chain(LOCALES)
+        .values()
+        .map(function(locale) {
+            return {
+                locale: locale,
+                score: compareLocales(lang, locale)
+            };
+        })
+        .filter(function(lang) {
+            return lang.score > 0;
+        })
+        .sortBy("score")
+        .pluck("locale")
+        .last()
+        .value();
+    return language || lang;
 });

+function translate(locale, phrase) {
+    var args = Array.prototype.slice.call(arguments, 2);
+
+    return i18n.__.apply({}, [{
+        locale: locale,
+        phrase: phrase
+    }].concat(args));
+}
+
+function getCatalog(locale) {
+    locale = normalizeLanguage(locale);
+    return i18n.getCatalog(locale);
+}
+
+function getLocales() {
+    return LOCALES;
+}
+
+function hasLocale(locale) {
+    return _.contains(LOCALES, locale);
+}
+
 module.exports = {
-	getLocales: getLocales,
-	getLanguages: getLanguages,
-	getByLanguage: getByLanguage,
-	normalizeLanguage: normalizeLanguage
+    __: translate,
+    normalizeLanguage: normalizeLanguage,
+    getCatalog: getCatalog,
+    getLocales: getLocales,
+    hasLocale: hasLocale
 };
@@ -1,39 +1,37 @@
 var _ = require("lodash");
 var Q = require("q");
 var fs = require("./fs");
-var spawn = require('spawn-cmd').spawn;
-
-var links = require("./links");
+var spawn = require("spawn-cmd").spawn;

 // Convert a svg file
 var convertSVG = function(source, dest, options) {
-	if (!fs.existsSync(source)) return Q.reject(new Error("File doesn't exist: "+source));
-	var d = Q.defer();
+    if (!fs.existsSync(source)) return Q.reject(new Error("File doesn't exist: "+source));
+    var d = Q.defer();

-	options = _.defaults(options || {}, {
+    options = _.defaults(options || {}, {

-	});
+    });

-	//var command = shellescape(['svgexport', source, dest]);
-    var child = spawn('svgexport', [source, dest]);
+    //var command = shellescape(["svgexport", source, dest]);
+    var child = spawn("svgexport", [source, dest]);

    child.on("error", function(error) {
-        if (error.code == "ENOENT") error = new Error("Need to install 'svgexport' using 'npm install svgexport -g'");
+        if (error.code == "ENOENT") error = new Error("Need to install \"svgexport\" using \"npm install svgexport -g\"");
        return d.reject(error);
    });

    child.on("close", function(code) {
-        if (code == 0 && fs.existsSync(dest)) {
+        if (code === 0 && fs.existsSync(dest)) {
            d.resolve();
        } else {
            d.reject(new Error("Error converting "+source+" into "+dest));
        }
    });

-	return d.promise;
+    return d.promise;
 };

 module.exports = {
-	convertSVG: convertSVG,
-	INVALID: [".svg"]
+    convertSVG: convertSVG,
+    INVALID: [".svg"]
 };
@@ -1,5 +1,5 @@
-var url = require('url');
-var path = require('path');
+var url = require("url");
+var path = require("path");

 // Is the link an external link
 var isExternal = function(href) {
@@ -33,7 +33,7 @@ var isAnchor = function(href) {

 // Normalize a path to be a link
 var normalizeLink = function(s) {
-    return s.replace(/\\/g, '/');
+    return s.replace(/\\/g, "/");
 };

 // Relative to absolute path
@@ -43,7 +43,7 @@ var normalizeLink = function(s) {
 var toAbsolute = function(_href, dir, outdir) {
    if (isExternal(_href)) return _href;

-    // Path '_href' inside the base folder
+    // Path "_href" inside the base folder
    var hrefInRoot = path.normalize(path.join(dir, _href));
    if (_href[0] == "/") hrefInRoot = path.normalize(_href.slice(1));

@@ -1,102 +1,102 @@
-var _ = require('lodash');
-var util = require('util');
-var color = require('bash-color');
+var _ = require("lodash");
+var util = require("util");
+var color = require("bash-color");

 var LEVELS = {
-	DEBUG: 0,
-	INFO: 1,
-	WARN: 2,
-	ERROR: 3,
-	DISABLED: 10
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+    DISABLED: 10
 };

 var COLORS = {
-	DEBUG: color.purple,
-	INFO: color.cyan,
-	WARN: color.yellow,
-	ERROR: color.red
+    DEBUG: color.purple,
+    INFO: color.cyan,
+    WARN: color.yellow,
+    ERROR: color.red
 };

 module.exports = function(_write, logLevel) {
-	var logger = {};
-	var lastChar = '\n';
-	if (_.isString(logLevel)) logLevel = LEVELS[logLevel.toUpperCase()];
+    var logger = {};
+    var lastChar = "\n";
+    if (_.isString(logLevel)) logLevel = LEVELS[logLevel.toUpperCase()];

-	// Write a simple message
-	logger.write = function(msg) {
-		msg = msg.toString();
-		lastChar = _.last(msg);
-		return _write(msg);
-	};
+    // Write a simple message
+    logger.write = function(msg) {
+        msg = msg.toString();
+        lastChar = _.last(msg);
+        return _write(msg);
+    };

-	// Format a message
-	logger.format = function() {
-		return util.format.apply(util, arguments);
-	};
+    // Format a message
+    logger.format = function() {
+        return util.format.apply(util, arguments);
+    };

-	// Write a line
-	logger.writeLn = function(msg) {
-		return this.write((msg || "")+"\n");
-	};
+    // Write a line
+    logger.writeLn = function(msg) {
+        return this.write((msg || "")+"\n");
+    };

-	// Write a message with a certain level
-	logger.log = function(level) {
-		if (level < logLevel) return;
+    // Write a message with a certain level
+    logger.log = function(level) {
+        if (level < logLevel) return;

-		var levelKey = _.findKey(LEVELS, function(v) { return v == level; });
-		var args = Array.prototype.slice.apply(arguments, [1]);
-		var msg = logger.format.apply(logger, args);
+        var levelKey = _.findKey(LEVELS, function(v) { return v == level; });
+        var args = Array.prototype.slice.apply(arguments, [1]);
+        var msg = logger.format.apply(logger, args);

-		if (lastChar == '\n') {
-			msg = COLORS[levelKey](levelKey.toLowerCase()+":")+" "+msg;
-		}
+        if (lastChar == "\n") {
+            msg = COLORS[levelKey](levelKey.toLowerCase()+":")+" "+msg;
+        }

-		return logger.write(msg);
-	};
-	logger.logLn = function() {
-		if (lastChar != '\n') logger.write("\n");
+        return logger.write(msg);
+    };
+    logger.logLn = function() {
+        if (lastChar != "\n") logger.write("\n");

-		var args = Array.prototype.slice.apply(arguments);
-		args.push("\n");
-		logger.log.apply(logger, args);
-	};
+        var args = Array.prototype.slice.apply(arguments);
+        args.push("\n");
+        logger.log.apply(logger, args);
+    };

-	// Write a OK
-	logger.ok = function(level) {
-		var args = Array.prototype.slice.apply(arguments, [1]);
-		var msg = logger.format.apply(logger, args);
-		if (arguments.length > 1) {
-			logger.logLn(level, color.green('>> ') + msg.trim().replace(/\n/g, color.green('\n>> ')));
-		} else {
-			logger.log(level, color.green("OK"), "\n");
-		}
-	};
+    // Write a OK
+    logger.ok = function(level) {
+        var args = Array.prototype.slice.apply(arguments, [1]);
+        var msg = logger.format.apply(logger, args);
+        if (arguments.length > 1) {
+            logger.logLn(level, color.green(">> ") + msg.trim().replace(/\n/g, color.green("\n>> ")));
+        } else {
+            logger.log(level, color.green("OK"), "\n");
+        }
+    };

-	// Write an "FAIL"
-	logger.fail = function(level) {
-		return logger.log(level, color.red("ERROR")+"\n");
-	};
+    // Write an "FAIL"
+    logger.fail = function(level) {
+        return logger.log(level, color.red("ERROR")+"\n");
+    };

-	_.each(_.omit(LEVELS, 'DISABLED'), function(level, levelKey) {
-		levelKey = levelKey.toLowerCase();
+    _.each(_.omit(LEVELS, "DISABLED"), function(level, levelKey) {
+        levelKey = levelKey.toLowerCase();

-		logger[levelKey] = _.partial(logger.log, level);
-		logger[levelKey].ln = _.partial(logger.logLn, level);
-		logger[levelKey].ok = _.partial(logger.ok, level);
-		logger[levelKey].fail = _.partial(logger.fail, level);
-		logger[levelKey].promise = function(p) {
-			return p.
-			then(function(st) {
-				logger[levelKey].ok();
-				return st;
-			}, function(err) {
-				logger[levelKey].fail();
-				throw err;
-			});
-		}
-	});
+        logger[levelKey] = _.partial(logger.log, level);
+        logger[levelKey].ln = _.partial(logger.logLn, level);
+        logger[levelKey].ok = _.partial(logger.ok, level);
+        logger[levelKey].fail = _.partial(logger.fail, level);
+        logger[levelKey].promise = function(p) {
+            return p.
+            then(function(st) {
+                logger[levelKey].ok();
+                return st;
+            }, function(err) {
+                logger[levelKey].fail();
+                throw err;
+            });
+        };
+    });

-	return logger;
+    return logger;
 };
 module.exports.LEVELS = LEVELS;
 module.exports.COLORS = COLORS;
@@ -1,9 +1,9 @@
-var _ = require('lodash');
+var _ = require("lodash");

 // Cleans up an article/chapter object
-// remove 'articles' attributes
+// remove "articles" attributes
 function clean(obj) {
-    return obj && _.omit(obj, ['articles']);
+    return obj && _.omit(obj, ["articles"]);
 }

 function flattenChapters(chapters) {
@@ -27,7 +27,7 @@ function navigation(summary, files) {
    files = _.isArray(files) ? files : (_.isString(files) ? [files] : null);

    // List of all navNodes
-    // Flatten chapters, then add in default README node if needed etc ...
+    // Flatten chapters
    var navNodes = flattenChapters(summary.chapters);

    // Mapping of prev/next for a give path
@@ -36,11 +36,10 @@ function navigation(summary, files) {
        var prev = null, next = null;

        // Skip if no path
-        if(!current.path) return null;
+        if(!current.exists) return null;

        // Find prev
-        prev = _.chain(navNodes)
-            .slice(0, i)
+        prev = _.chain(navNodes.slice(0, i))
            .reverse()
            .find(function(node) {
                return node.exists && !node.external;
@@ -48,16 +47,16 @@ function navigation(summary, files) {
            .value();

        // Find next
-        next = _.chain(navNodes)
-            .slice(i+1)
+        next = _.chain(navNodes.slice(i+1))
            .find(function(node) {
                return node.exists && !node.external;
            })
            .value();

-
        return [current.path, {
+            index: i,
            title: current.title,
+            introduction: current.introduction,
            prev: prev,
            next: next,
            level: current.level,
@@ -1,16 +1,18 @@
-var Q = require('q');
-var _ = require('lodash');
-var url = require('url');
-var path = require('path');
-var cheerio = require('cheerio');
-var domSerializer = require('dom-serializer');
-var request = require('request');
+var Q = require("q");
+var _ = require("lodash");
+var url = require("url");
+var path = require("path");
+var cheerio = require("cheerio");
+var domSerializer = require("dom-serializer");
+var request = require("request");
 var crc = require("crc");

-var links = require('./links');
-var imgUtils = require('./images');
-var fs = require('./fs');
-var batch = require('./batch');
+var links = require("./links");
+var imgUtils = require("./images");
+var fs = require("./fs");
+var batch = require("./batch");
+
+var parsableExtensions = require("gitbook-parsers").extensions;

 // Render a cheerio dom as html
 var renderDom = function($, dom, options) {
@@ -38,7 +40,8 @@ function replaceText($, el, search, replace, text_only ) {
        if ( node ) {

            // Loop over all childNodes.
-            do {
+            while (node) {
+
                // Only process text nodes.
                if ( node.nodeType === 3 ) {

@@ -56,7 +59,7 @@ function replaceText($, el, search, replace, text_only ) {
                            // robust way.
                            $(node).before( new_val );

-                            // Don't remove the node yet, or the loop will lose its place.
+                            // Don"t remove the node yet, or the loop will lose its place.
                            remove.push( node );
                        } else {
                            // The new value contains no HTML, so it can be set in this
@@ -66,17 +69,18 @@ function replaceText($, el, search, replace, text_only ) {
                    }
                }

-            } while ( node = node.nextSibling );
+                node = node.nextSibling;
+            }
        }

        // Time to remove those elements!
-        remove.length && $(remove).remove();
+        if (remove.length) $(remove).remove();
    });
-};
+}

 function pregQuote( str ) {
-    return (str+'').replace(/([\\\.\+\*\?\[\^\]\$\(\)\{\}\=\!\<\>\|\:])/g, "\\$1");
-};
+    return (str+"").replace(/([\\\.\+\*\?\[\^\]\$\(\)\{\}\=\!\<\>\|\:])/g, "\\$1");
+}


 // Adapt an html snippet to be relative to a base folder
@@ -105,15 +109,16 @@ function normalizeHtml(src, options) {
            // Generate filename
            dest = "/"+fs.getUniqueFilename(outputRoot, dest);

-            svgContent[dest] = '<?xml version="1.0" encoding="UTF-8"?>'+content;
+            svgContent[dest] = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"+content;
            $(this).replaceWith($("<img>").attr("src", dest));
        });
    }

    // Find images to normalize
    $("img").each(function() {
-        var origin = undefined;
+        var origin;
        var src = $(this).attr("src");
+
        if (!src) return;
        var isExternal = links.isExternal(src);

@@ -148,7 +153,7 @@ function normalizeHtml(src, options) {
                    dest = links.join(path.dirname(srcAbs), path.basename(srcAbs, ext)+".png");
                    dest = dest[0] == "/"? dest.slice(1) : dest;

-                    // Get a name that doesn't exists
+                    // Get a name that doesn"t exists
                    dest = fs.getUniqueFilename(outputRoot, dest);

                    options.book.log.debug.ln("detect invalid image (will be converted to png):", srcAbs);
@@ -183,6 +188,7 @@ function normalizeHtml(src, options) {
        $(this).attr("src", src);
    });

+    // Normalize links
    $("a").each(function() {
        var href = $(this).attr("href");
        if (!href) return;
@@ -190,17 +196,25 @@ function normalizeHtml(src, options) {
        if (links.isAnchor(href)) {
            // Keep it as it is
        } else if (links.isRelative(href)) {
-            var parts = url.parse(path.join(options.base, href));
-            var absolutePath = parts.pathname;
-            var anchor = parts.hash;
+            var parts = url.parse(href);
+            var absolutePath = links.join(options.base, parts.pathname);
+            var anchor = parts.hash || "";
+

            // If is in navigation relative: transform as content
            if (options.navigation[absolutePath]) {
-                href = options.book.contentLink(href);
+                absolutePath = options.book.contentLink(absolutePath);
+            }
+
+            // If md/adoc/rst files is not in summary
+            // or for ebook, signal all files that are outside the summary
+            else if (_.contains(parsableExtensions, path.extname(absolutePath)) ||
+            _.contains(["epub", "pdf", "mobi"], options.book.options.generator)) {
+                options.book.log.warn.ln("page", options.input, "contains an hyperlink to resource outside spine \""+href+"\"");
            }

            // Transform as absolute
-            href = links.toAbsolute(href, options.base, options.output)+anchor;
+            href = links.toAbsolute("/"+absolutePath, options.base, options.output)+anchor;
        } else {
            // External links
            $(this).attr("target", "_blank");
@@ -210,12 +224,50 @@ function normalizeHtml(src, options) {
        $(this).attr("href", href);
    });

-    // Replace glossayr terms
-    _.each(options.glossary, function(term) {
-        var r =  new RegExp( "\\b(" + pregQuote(term.name.toLowerCase()) + ")\\b" , 'gi' );
+    // Highlight code blocks
+    $("code").each(function() {
+        // Normalize language
+        var lang = _.chain(
+                ($(this).attr("class") || "").split(" ")
+            )
+            .map(function(cl) {
+                // Markdown
+                if (cl.search("lang-") === 0) return cl.slice("lang-".length);
+
+                // Asciidoc
+                if (cl.search("language-") === 0) return cl.slice("language-".length);
+
+                return null;
+            })
+            .compact()
+            .first()
+            .value();
+
+        var source = $(this).text();
+        var blk = options.book.template.applyBlock("code", {
+            body: source,
+            kwargs: {
+                language: lang
+            }
+        });
+
+        if (blk.html === false) $(this).text(blk.body);
+        else $(this).html(blk.body);
+    });
+
+    // Replace glossary terms
+    var glossary = _.sortBy(options.glossary, function(term) {
+        return -term.name.length;
+    });
+
+    _.each(glossary, function(term) {
+        var r =  new RegExp( "\\b(" + pregQuote(term.name.toLowerCase()) + ")\\b" , "gi" );
        var includedInFiles = false;

        $("*").each(function() {
+            // Ignore codeblocks
+            if (_.contains(["code", "pre", "a"], this.name.toLowerCase())) return;
+
            replaceText($, this, r, function(match) {
                // Add to files index in glossary
                if (!includedInFiles) {
@@ -223,7 +275,7 @@ function normalizeHtml(src, options) {
                    term.files = term.files || [];
                    term.files.push(options.navigation[options.input]);
                }
-                return "<a href='"+links.toAbsolute("/GLOSSARY.html", options.base, options.output)+"#"+term.id+"' class='glossary-term' title='"+_.escape(term.description)+"'>"+match+"</a>";
+                return "<a href=\""+links.toAbsolute("/GLOSSARY.html", options.base, options.output) + "#" + term.id+"\" class=\"glossary-term\" title=\""+_.escape(term.description)+"\">"+match+"</a>";
            });
        });
    });
@@ -232,7 +284,7 @@ function normalizeHtml(src, options) {
        html: renderDom($),
        images: toConvert
    };
-};
+}

 // Convert svg images to png
 function convertImages(images, options) {
@@ -253,7 +305,13 @@ function convertImages(images, options) {
                if (!image.origin && !_.contains(downloaded, image.origin)) return;
                options.book.log.debug("download image", image.origin, "...");
                downloaded.push(image.origin);
-                return options.book.log.debug.promise(fs.writeStream(imgin, request(image.origin)));
+                return options.book.log.debug.promise(fs.writeStream(imgin, request(image.origin)))
+                .fail(function(err) {
+                    if (!_.isError(err)) err = new Error(err);
+
+                    err.message = "Fail downloading "+image.origin+": "+err.message;
+                    throw err;
+                });
            })

            // Write svg if content
@@ -274,8 +332,7 @@ function convertImages(images, options) {
    .then(function() {
        options.book.log.debug.ok(images.length+" images converted with success");
    });
-};
-
+}

 // Adapt page content to be relative to a base folder
 function normalizePage(sections, options) {
@@ -308,7 +365,7 @@ function normalizePage(sections, options) {
    sections = _.map(sections, function(section) {
        if (section.type != "normal") return section;

-        var out = normalizeHtml(section.content, options);;
+        var out = normalizeHtml(section.content, options);

        toConvert = toConvert.concat(out.images);
        section.content = out.html;
@@ -317,11 +374,11 @@ function normalizePage(sections, options) {

    return Q()
    .then(function() {
-        toConvert = _.uniq(toConvert, 'source');
+        toConvert = _.uniq(toConvert, "source");
        return convertImages(toConvert, options);
    })
    .thenResolve(sections);
-};
+}

 // Extract text from sections
 function extractText(sections) {
@@ -335,7 +392,7 @@ function extractText(sections) {

        return prev;
    }, "");
-};
+}

 module.exports = {
    normalize: normalizePage,
@@ -0,0 +1,40 @@
+var _ = require("lodash");
+var path = require("path");
+
+// Return true if file path is inside a folder
+function isInRoot(root, filename) {
+    filename = path.normalize(filename);
+    return (filename.substr(0, root.length) === root);
+}
+
+// Resolve paths in a specific folder
+// Throw error if file is outside this folder
+function resolveInRoot(root) {
+    var input, result, err;
+
+    input = _.chain(arguments)
+        .toArray()
+        .slice(1)
+        .reduce(function(current, p) {
+            // Handle path relative to book root ("/README.md")
+            if (p[0] == "/" || p[0] == "\\") return p.slice(1);
+
+            return current? path.join(current, p) : path.normalize(p);
+        }, "")
+        .value();
+
+    result = path.resolve(root, input);
+
+    if (!isInRoot(root, result)) {
+        err = new Error("EACCESS: \"" + result + "\" not in \"" + root + "\"");
+        err.code = "EACCESS";
+        throw err;
+    }
+
+    return result;
+}
+
+module.exports = {
+    isInRoot: isInRoot,
+    resolveInRoot: resolveInRoot
+};
@@ -1,16 +1,24 @@
 var _ = require("lodash");

 // Returns from a navigation and a current file, a snapshot of current detailed state
-var calculProgress = function(navigation, current) {
+function calculProgress(navigation, current) {
    var n = _.size(navigation);
    var percent = 0, prevPercent = 0, currentChapter = null;
    var done = true;

    var chapters = _.chain(navigation)
+
+    // Transform as array
    .map(function(nav, path) {
        nav.path = path;
        return nav;
    })
+
+    // Sort entries
+    .sortBy(function(nav) {
+        return nav.index;
+    })
+
    .map(function(nav, i) {
        // Calcul percent
        nav.percent = (i * 100) / Math.max((n - 1), 1);
@@ -1,11 +1,9 @@
-var Q = require('q');
-var _ = require('lodash');
-
-var events = require('events');
-var http = require('http');
-var send = require('send');
-var util = require('util');
-var url = require('url');
+var Q = require("q");
+var events = require("events");
+var http = require("http");
+var send = require("send");
+var util = require("util");
+var url = require("url");

 var Server = function() {
    this.running = null;
@@ -17,7 +15,7 @@ util.inherits(Server, events.EventEmitter);

 // Return true if the server is running
 Server.prototype.isRunning = function() {
-    return this.running != null;
+    return !!this.running;
 };

 // Stop the server
@@ -57,25 +55,25 @@ Server.prototype.start = function(dir, port) {
                res.end(err.message);
            }

-            // Redirect to directory's index.html
+            // Redirect to directory"s index.html
            function redirect() {
                res.statusCode = 301;
-                res.setHeader('Location', req.url + '/');
-                res.end('Redirecting to ' + req.url + '/');
+                res.setHeader("Location", req.url + "/");
+                res.end("Redirecting to " + req.url + "/");
            }

            // Send file
            send(req, url.parse(req.url).pathname)
            .root(dir)
-            .on('error', error)
-            .on('directory', redirect)
+            .on("error", error)
+            .on("directory", redirect)
            .pipe(res);
        });

-        that.running.on('connection', function (socket) {
+        that.running.on("connection", function (socket) {
            that.sockets.push(socket);
            socket.setTimeout(4000);
-            socket.on('close', function () {
+            socket.on("close", function () {
                that.sockets.splice(that.sockets.indexOf(socket), 1);
            });
        });
@@ -91,6 +89,6 @@ Server.prototype.start = function(dir, port) {

        return d.promise;
    });
-}
+};

 module.exports = Server;
@@ -1,7 +1,7 @@
 var _ = require("lodash");

 function escapeShellArg(arg) {
-    var ret = '';
+    var ret = "";

    ret = arg.replace(/"/g, '\\"');

@@ -11,7 +11,7 @@ function escapeShellArg(arg) {
 function optionsToShellArgs(options) {
    return _.chain(options)
    .map(function(value, key) {
-        if (value == null || value === false) return null;
+        if (value === null || value === undefined || value === false) return null;
        if (value === true) return key;
        return key+"="+escapeShellArg(value);
    })
@@ -20,12 +20,7 @@ function optionsToShellArgs(options) {
    .join(" ");
 }

-function escapeRegex(str) {
-    return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&");
-}
-
 module.exports = {
-    escapeRegex: escapeRegex,
    escapeShellArg: escapeShellArg,
    optionsToShellArgs: optionsToShellArgs,
    toLowerCase: String.prototype.toLowerCase.call.bind(String.prototype.toLowerCase)
@@ -1,9 +1,9 @@
-var Q = require('q');
-var _ = require('lodash');
-var path = require('path');
-var Gaze = require('gaze').Gaze;
+var Q = require("q");
+var _ = require("lodash");
+var path = require("path");
+var chokidar = require("chokidar");

-var parsers = require('gitbook-parsers')
+var parsers = require("gitbook-parsers");

 function watch(dir) {
    var d = Q.defer();
@@ -17,17 +17,19 @@ function watch(dir) {
        toWatch.push("**/*"+ext);
    });

-    var gaze = new Gaze(toWatch, {
-        cwd: dir
+    var watcher = chokidar.watch(toWatch, {
+        cwd: dir,
+        ignored: "_book/**",
+        ignoreInitial: true
    });

-    gaze.once("all", function(e, filepath) {
-        gaze.close();
+    watcher.once("all", function(e, filepath) {
+        watcher.close();

        d.resolve(filepath);
    });
-    gaze.once("error", function(err) {
-        gaze.close();
+    watcher.once("error", function(err) {
+        watcher.close();

        d.reject(err);
    });
@@ -1,27 +1,28 @@
 {
    "name": "gitbook",
-    "version": "2.0.0-beta.2",
+    "version": "2.4.2",
    "homepage": "https://www.gitbook.com",
    "description": "Library and cmd utility to generate GitBooks",
    "main": "lib/index.js",
    "dependencies": {
        "q": "1.0.1",
-        "lunr": "0.5.7",
-        "lodash": "3.2.0",
+        "lunr": "0.5.12",
+        "lodash": "3.10.1",
        "graceful-fs": "3.0.5",
        "resolve": "0.6.3",
        "fs-extra": "0.16.5",
        "fstream-ignore": "1.0.2",
-        "gitbook-parsers": "0.5.3",
-        "nunjucks": "git+https://github.com/mozilla/nunjucks.git#0f8b21b8df7e8e852b2e1889388653b7075f0d09",
-        "nunjucks-autoescape": "0.1.1",
-        "nunjucks-filter": "0.1.0",
-        "nunjucks-i18n": "1.0.0",
-        "semver": "2.2.1",
+        "gitbook-parsers": "0.8.2",
+        "gitbook-plugin-highlight": "1.0.3",
+        "nunjucks": "mozilla/nunjucks#dc89bf91611a2101731c2c06afcf5c32160b4dc9",
+        "nunjucks-autoescape": "1.0.0",
+        "nunjucks-filter": "1.0.0",
+        "i18n": "0.5.0",
+        "semver": "5.0.1",
        "npmi": "0.1.1",
-        "cheerio": "0.18.0",
+        "cheerio": "0.19.0",
        "gitbook-plugin-livereload": "0.0.1",
-        "gaze": "~0.5.1",
+        "chokidar": "~1.0.5",
        "send": "0.2.0",
        "tiny-lr": "0.1.5",
        "tmp": "0.0.24",
@@ -31,10 +32,12 @@
        "request": "2.51.0",
        "npm": "2.4.1",
        "dom-serializer": "0.1.0",
-        "spawn-cmd": "0.0.2"
+        "spawn-cmd": "0.0.2",
+        "escape-string-regexp": "1.0.3"
    },
    "devDependencies": {
-        "mocha": "2.2.1",
+        "mocha": "2.3.2",
+        "should": "7.1.0",
        "grunt": "~0.4.2",
        "grunt-cli": "0.1.11",
        "grunt-contrib-copy": "0.5.0",
@@ -43,7 +46,7 @@
        "grunt-bower-install-simple": "0.9.2"
    },
    "scripts": {
-        "test": "node_modules/.bin/mocha --reporter list --timeout 15000"
+        "test": "node_modules/.bin/mocha --reporter spec --timeout 15000"
    },
    "repository": {
        "type": "git",
@@ -58,7 +61,7 @@
        "gitbook"
    ],
    "author": "FriendCode Inc. <contact@gitbook.com>",
-    "license": "Apache 2",
+    "license": "Apache-2.0",
    "bugs": {
        "url": "https://github.com/GitbookIO/gitbook/issues"
    },
@@ -0,0 +1,67 @@
+var _ = require("lodash");
+var fs = require("fs");
+var path = require("path");
+var should = require("should");
+var cheerio = require("cheerio");
+
+should.Assertion.add("file", function(file, description) {
+    this.params = { actual: this.obj.toString(), operator: "have file " + file, message: description };
+
+    this.obj.should.have.property("options").which.is.an.Object();
+    this.obj.options.should.have.property("output").which.is.a.String();
+    this.assert(fs.existsSync(path.resolve(this.obj.options.output, file)));
+});
+
+should.Assertion.add("jsonfile", function(file, description) {
+    this.params = { actual: this.obj.toString(), operator: "have valid jsonfile " + file, message: description };
+
+    this.obj.should.have.property("options").which.is.an.Object();
+    this.obj.options.should.have.property("output").which.is.a.String();
+    this.assert(JSON.parse(fs.readFileSync(path.resolve(this.obj.options.output, file), { encoding: "utf-8" })));
+});
+
+should.Assertion.add("html", function(rules, description) {
+    this.params = { actual: "HTML string", operator: "valid html", message: description };
+    var $ = cheerio.load(this.obj);
+
+    _.each(rules, function(validations, query) {
+        validations = _.defaults(validations || {}, {
+            // Select a specific element in the list of matched elements
+            index: null,
+
+            // Check that there is the correct count of elements
+            count: 1,
+
+            // Check attribute values
+            attributes: {},
+
+            // Trim inner text
+            trim: false,
+
+            // Check inner text
+            text: undefined
+        });
+
+        var $el = $(query);
+
+        // Select correct element
+        if (_.isNumber(validations.index)) $el = $($el.get(validations.index));
+
+        // Test number of elements
+        $el.length.should.be.equal(validations.count);
+
+        // Test text
+        if (validations.text !== undefined) {
+            var text = $el.text();
+            if (validations.trim) text = text.trim();
+            text.should.be.equal(validations.text);
+        }
+
+        // Test attributes
+        _.each(validations.attributes, function(value, name) {
+            var attr = $el.attr(name);
+            should(attr).be.ok();
+            attr.should.be.equal(value);
+        });
+    });
+});
@@ -0,0 +1,3 @@
+# Readme
+
+Default description for the book.
@@ -0,0 +1 @@
+# Readme
@@ -0,0 +1,3 @@
+module.exports = {
+    "title": "js-config"
+};
@@ -0,0 +1 @@
+# Readme
@@ -0,0 +1,3 @@
+{
+    "title": "json-config"
+}
@@ -0,0 +1,12 @@
+# Readme
+
+### Relative
+
+<p id="t1">{% include "./hello.md" %}</p>
+<p id="t2">{% include "/hello.md" %}</p>
+
+### Git
+
+<p id="t3">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md" %}</p>
+<p id="t4">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test2.md" %}</p>
+<p id="t5">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test3.md" %}</p>
@@ -0,0 +1 @@
+# Summary
@@ -0,0 +1 @@
+Hello World
@@ -0,0 +1,13 @@
+# Glossary
+
+## test
+
+Just a simple and easy to understand test.
+
+## hakunamatata
+
+This word is not present in the content.
+
+## test long
+
+This is a test with a longer text that the first entry to test order.
@@ -0,0 +1,10 @@
+# Readme
+
+The word test should be replaced by a glossary link.
+
+```
+But the word test should not be replaced in code blocks
+```
+
+The two words test long should be replaced by the correct glossary links.
+
@@ -0,0 +1,3 @@
+# Summary
+
+* [Page](folder/PAGE.md)
@@ -0,0 +1,3 @@
+# Page
+
+Just a page in a sub-directory to test relative link to glossary.
@@ -0,0 +1,16 @@
+# Readme
+
+Block without language
+
+```
+test 1
+```
+
+Block with a language
+
+```lang
+test 2
+```
+
+Inline code: `test 3`
+Inline code with html: `<test>`
@@ -0,0 +1 @@
+# Summary
@@ -0,0 +1,18 @@
+# Tests for Images
+
+# SVG relative image
+
+
+### Convert SVG to PNG
+![test.svg](test.svg)
+
+### Should only convert it once
+![test.svg](test.svg)
+
+### Download remote images
+![remote image](http://upload.wikimedia.org/wikipedia/commons/b/b0/NewTux.svg)
+
+### Remote images with same filename
+![youtube1](http://img.youtube.com/vi/9bZkp7q19f0/0.jpg)
+![youtube2](http://img.youtube.com/vi/IkV2HQLAKHY/0.jpg)
+
@@ -0,0 +1,3 @@
+# Summary
+
+* [Page](./folder/PAGE.md)
@@ -0,0 +1,3 @@
+### Images from other folder
+![test.svg](../test.svg)
+
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1 Tiny//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd">
+<svg version="1.1" baseProfile="tiny" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="svg-root" width="100%" height="100%" viewBox="0 0 480 360">
+    <title id="test-title">basic SVG tiny doc</title>
+    <g id="test-body-content">
+        <text font-family="Arial" font-size="14" text-anchor="middle" x="225" y="25">hello world</text>
+    </g>
+    <text id="revision" x="10" y="340" font-size="40" stroke="none" fill="black">Revision: 1.1</text>
+    <rect id="test-frame" x="1" y="1" width="478" height="358" fill="none" stroke="#000000"/>
+</svg>
+
@@ -0,0 +1,3 @@
+*
+!SUMMARY.md
+!.gitignore
@@ -0,0 +1,9 @@
+# Summary
+
+* [Hello](hello.md)
+* [Hello 2](hello2.md)
+* Hello 3
+    * [Hello 4](hello3/hello4.md)
+    * Hello 5
+        * [Hello 6](hello3/hello5/hello6.md)
+
@@ -0,0 +1,4 @@
+# Language
+
+* [English](en)
+* [French](fr)
@@ -0,0 +1 @@
+# Readme
@@ -0,0 +1 @@
+Hello
@@ -0,0 +1 @@
+# Summary
@@ -0,0 +1 @@
+Bonjour
@@ -0,0 +1 @@
+# Summary
@@ -0,0 +1 @@
+# Readme
@@ -0,0 +1,4 @@
+# Summary
+
+* [Folder1](folder1/README.md)
+* [Folder2](folder2/README.md)
@@ -0,0 +1,3 @@
+# Folder 1
+
+[Link to folder2](../folder2/README.md)
@@ -0,0 +1 @@
+# Folder 2
@@ -0,0 +1,3 @@
+# Readme
+
+Default description for the book.
@@ -0,0 +1 @@
+# Summary
@@ -0,0 +1,3 @@
+body {
+    color: red;
+}
@@ -0,0 +1 @@
+# Page 1
@@ -0,0 +1 @@
+# Readme
@@ -0,0 +1,5 @@
+# Summary
+
+* [Page 1](./PAGE1.md)
+* [Page 2](./folder/PAGE2.md)
+* [Don't exists](./NOTFOUND.md)
@@ -0,0 +1 @@
+# Page 2
@@ -0,0 +1,65 @@
+var path = require("path");
+var fs = require("fs");
+
+var Plugin = require("../lib/plugin");
+var PLUGINS_ROOT = path.resolve(__dirname, "plugins");
+
+describe("Code Highlighting", function () {
+    var book, PAGE;
+
+    before(function() {
+        return books.generate("highlight", "website", {
+            prepare: function(_book) {
+                book = _book;
+
+                var plugin = new Plugin(book, "replace_highlight");
+                plugin.load("./replace_highlight", PLUGINS_ROOT);
+
+                book.plugins.load(plugin);
+            }
+        })
+        .then(function() {
+            PAGE = fs.readFileSync(
+                path.join(book.options.output, "index.html"),
+                { encoding: "utf-8" }
+            );
+        });
+    });
+
+    it("should correctly replace highlighting", function() {
+        PAGE.should.be.html({
+            "code": {
+                index: 0,
+                text: "code_test 1\n_code"
+            }
+        });
+    });
+
+    it("should correctly replace highlighting with language", function() {
+        PAGE.should.be.html({
+            "code": {
+                index: 1,
+                text: "lang_test 2\n_lang"
+            }
+        });
+    });
+
+    it("should correctly replace highlighting for inline code", function() {
+        PAGE.should.be.html({
+            "code": {
+                index: 2,
+                text: "code_test 3_code"
+            }
+        });
+    });
+
+    it("should correctly replace highlighting for inline code with html tags", function() {
+        PAGE.should.be.html({
+            "code": {
+                index: 3,
+                text: "code_<test>_code"
+            }
+        });
+    });
+});
+
@@ -1,14 +1,37 @@
-var path = require('path');
-var assert = require('assert');
-
-var Book = require('../').Book;
-
-describe('Configuration parsing', function () {
-    it('should correctly load from json', function() {
-        assert(books[0].options.title == "Test");
+describe("Configuration", function () {
+    it("should extract default title from README", function() {
+        return books.parse("basic")
+            .then(function(book) {
+                book.options.title.should.be.equal("Readme");
+            });
    });

-    it('should correctly load from javascript', function() {
-        assert(books[4].options.title == "Test 2");
+    it("should extract default description from README", function() {
+        return books.parse("basic")
+            .then(function(book) {
+                book.options.description.should.be.equal("Default description for the book.");
+            });
+    });
+
+    it("should correctly load from json (book.json)", function() {
+        return books.parse("config-json")
+            .then(function(book) {
+                book.options.title.should.be.equal("json-config");
+            });
+    });
+
+    it("should correctly load from JavaScript (book.js)", function() {
+        return books.parse("config-js")
+            .then(function(book) {
+                book.options.title.should.be.equal("js-config");
+            });
+    });
+
+    it("should provide configuration on book.config.get", function() {
+        return books.parse("basic")
+            .then(function(book) {
+                book.config.get("description").should.be.equal("Default description for the book.");
+                book.getConfig("description").should.be.equal("Default description for the book.");
+            });
    });
 });
@@ -0,0 +1,68 @@
+var fs = require("fs");
+var path = require("path");
+
+describe("ConRefs", function () {
+    var book, readme;
+
+    before(function() {
+        return books.generate("conrefs", "website")
+            .then(function(_book) {
+                book = _book;
+
+                readme = fs.readFileSync(
+                    path.join(book.options.output, "index.html"),
+                    { encoding: "utf-8" }
+                );
+            });
+    });
+
+    it("should handle local references", function() {
+        readme.should.be.html({
+            ".page-inner p#t1": {
+                count: 1,
+                text: "Hello World",
+                trim: true
+            }
+        });
+    });
+
+    it("should handle local references with absolute paths", function() {
+        readme.should.be.html({
+            ".page-inner p#t2": {
+                count: 1,
+                text: "Hello World",
+                trim: true
+            }
+        });
+    });
+
+    it("should correctly include file from git reference", function() {
+        readme.should.be.html({
+            ".page-inner p#t3": {
+                count: 1,
+                text: "Hello from git",
+                trim: true
+            }
+        });
+    });
+
+    it("should correctly handle deep include in git reference", function() {
+        readme.should.be.html({
+            ".page-inner p#t4": {
+                count: 1,
+                text: "First Hello. Hello from git",
+                trim: true
+            }
+        });
+    });
+
+    it("should correctly handle absolute include in git reference", function() {
+        readme.should.be.html({
+            ".page-inner p#t5": {
+                count: 1,
+                text: "First Hello. Hello from git",
+                trim: true
+            }
+        });
+    });
+});
@@ -1,36 +1,66 @@
-var path = require('path');
-var _ = require('lodash');
-var assert = require('assert');
-var cheerio = require('cheerio');
-
 var fs = require("fs");
-var fsUtil = require("../lib/utils/fs");
+var path = require("path");

+describe("eBook generator", function () {
+    describe("Basic Book", function() {
+        var book;

-describe('eBook Generator', function () {
-    it('should correctly generate ebook pages', function(done) {
-        testGeneration(books[1], "ebook", function(output) {
-            assert(fs.existsSync(path.join(output, "SUMMARY.html")));
-        }, done);
+        before(function() {
+            return books.generate("basic", "ebook")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it("should correctly output a SUMMARY.html", function() {
+            book.should.have.file("SUMMARY.html");
+        });
+
+        it("should correctly copy assets", function() {
+            book.should.have.file("gitbook");
+            book.should.have.file("gitbook/style.css");
+        });
    });

-    it('should correctly convert svg images to png', function(done) {
-        testGeneration(books[4], "ebook", function(output) {
-            // Check that all images exists
-            _.each([
-                "index.html",
-                "sub/PAGE.html"
-            ], function(pageName) {
-                var pageFile = path.join(output, pageName);
-                var pageFolder = path.dirname(pageFile);
-                var pageContent = fs.readFileSync(pageFile, {encoding: "utf8"});
-                var $ = cheerio.load(pageContent);
+    describe("Custom styles", function() {
+        var book;

-                $("img").each(function() {
-                    var src = $(this).attr("src");
-                    assert(fs.existsSync(path.resolve(pageFolder, src)), src+" not found for page "+pageName);
-                })
+        before(function() {
+            return books.generate("style-print", "ebook")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it("should remove default print.css", function() {
+            var PAGE = fs.readFileSync(
+                path.join(book.options.output, "index.html"),
+                { encoding: "utf-8" }
+            );
+
+            // There are 2 styles (one from plugin-highlight and the new style)
+            PAGE.should.be.html({
+                "link": {
+                    count: 2
+                }
            });
-        }, done);
+
+            PAGE.should.be.html({
+                "link[href=\"./styles/print.css\"]": {
+                    count: 1
+                }
+            });
+
+            PAGE.should.be.html({
+                "link[href=\"gitbook/plugins/gitbook-plugin-highlight/ebook.css\"]": {
+                    count: 1
+                }
+            });
+        });
+
+        it("should correctly print.css", function() {
+            book.should.have.file("styles");
+            book.should.have.file("styles/print.css");
+        });
    });
 });
@@ -1,6 +0,0 @@
-# Glossary
-
-## Description
-
-This is the dexcription of a description.
-
@@ -1,3 +0,0 @@
-# Other Title
-
-This is a description, it's simple, no ?
@@ -1 +0,0 @@
-# Summary
@@ -1,3 +0,0 @@
-{
-	"title": "Test"
-}
@@ -1,3 +0,0 @@
-body {
-	background: red;
-}
@@ -1,9 +0,0 @@
-
-# Test
-
-a test text
-
-# Test 2
-
-a second test
-
@@ -1,4 +0,0 @@
-# Test
-
-This file is not parsed by gitbook because the structure is defined in book.json.
-
@@ -1,6 +0,0 @@
-# Summary
-
-* [Chapter 1](test.md)
-    * [Article 1](sub/test1.md)
-* [Chapter 2](test2.md)
-* [Google](https://www.google.com)
@@ -1,5 +0,0 @@
-{
-	"structure": {
-		"readme": "intro.md"
-	}
-}
@@ -1,4 +0,0 @@
-# My Book
-
-Test description
-
@@ -1,8 +0,0 @@
-# This file is used to etst links transformations:
-
-This is a relative link [test](../intro.md).
-
-![image](../image.png)
-
-This is a glossary link.
-
@@ -1,4 +0,0 @@
-# Languages
-
-* [English](en/)
-* [French](fr/)
@@ -1,2 +0,0 @@
-# Multi-Languages test
-
@@ -1 +0,0 @@
-# English Book
@@ -1 +0,0 @@
-# French Book
@@ -1,4 +0,0 @@
-= My Book
-
-Test description
-
@@ -1,5 +0,0 @@
-= Summary
-
-. link:test.adoc[Chapter 1]
-.. link:test1.adoc[Article 1]
-. link:test2.adoc[Chapter 2]
@@ -1,11 +0,0 @@
-# Other Title
-
-A description
-
-![test image to be converted](./test.svg)
-![test url](http://upload.wikimedia.org/wikipedia/commons/b/b0/NewTux.svg)
-![test image to be converted, second use](./test.svg)
-
-# Test with youtube videos that have the same filename:
-![youtube1](http://img.youtube.com/vi/9bZkp7q19f0/0.jpg)
-![youtube2](http://img.youtube.com/vi/IkV2HQLAKHY/0.jpg)
@@ -1,3 +0,0 @@
-# Summary
-
-* [Page](sub/PAGE.md)
--- a/Show More
+++ b/Show More