Bump version to 2.0.3

Add tests for it, fix #769

.editorconfig

@@ -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

AUTHORS.md

@@ -30,6 +30,8 @@ Translators
 	- Knut Melvær (@kmelve)
 - Persian (Farsi)
 	- Mohammad Hossein Mojtahedi (@mhm5000)
+- Polish
+	- Łukasz Szeremeta (@lszeremeta)
 - Portuguese
 	- Ryan O'Mullan (@RyanOM)
 - Spanish
@@ -40,3 +42,11 @@ Translators
 	- Hu Hao (@howiehu)
 - French
 	- Samy Pessé (@SamyPesse)
+- Romanian
+        - Iancu Aurel (@awrelll)
+- Finnish
+	- Tommi Savikko (@savikko)
+- Japanese
+	- Iancu Aurel (@awrelll)
+- Korean
+	- Iancu Aurel (@awrelll)

CHANGES.md

@@ -2,6 +2,56 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 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.0.0-beta.1
+- Fix windows incompatibility
+- Add support for rtl (enabled by default for `ar` and `fa`)
+- Escape code blocks in markdown parser
+- Add Persian/Farsi translation (`fa`)
+- Add Arabic translation (`ar`)
+- Add Bengali translation (`bn`)
+- Provide generator name in template context
+
 ## 2.0.0-alpha.9
 - Fix links in sidebar
 - Fix normalization of html link (README to index)

README.md

@@ -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

bin/gitbook.js

@@ -3,5 +3,5 @@
 var color = require('bash-color');
 
 console.log(color.red("You need to install 'gitbook-cli' to have access to the gitbook command anywhere on your system."));
-console.log(color.red("If you've installe this package globally, you need to uninstall it."));
+console.log(color.red("If you've installed this package globally, you need to uninstall it."));
 console.log(color.red(">> Run 'npm uninstall -g gitbook' then 'npm install -g gitbook-cli'"));

lib/configuration.js

@@ -60,14 +60,13 @@ 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 +74,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(
+                path.resolve(that.book.root, 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) {
@@ -111,7 +133,7 @@ Configuration.prototype.load = function() {
 
         // 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;
         }
 
@@ -139,7 +161,7 @@ Configuration.prototype.normalizeLanguage = function() {
 Configuration.DEFAULT = {
     // 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 +170,7 @@ Configuration.DEFAULT = {
     "isbn": null,
     "language": "en",
     "direction": null,
+    "author": null,
 
     // version of gitbook to use
     "gitbook": "*",

lib/generators/ebook.js

@@ -30,7 +30,7 @@ Generator.prototype.prepareTemplates = function() {
     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

lib/generators/index.js

@@ -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")
 };

lib/generators/website.js

@@ -6,7 +6,6 @@ var _ = require("lodash");
 var nunjucks = require("nunjucks");
 var AutoEscapeExtension = require("nunjucks-autoescape");
 var FilterExtension = require("nunjucks-filter");
-var I18nExtension = require("nunjucks-i18n");
 
 var fs = require("../utils/fs");
 var BaseGenerator = require("../generator");
@@ -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["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)
@@ -101,15 +100,11 @@ Generator.prototype.prepareTemplateEngine = function() {
         that.env.addFilter('lvl', function(lvl) {
             return lvl.split(".").length;
         });
+        that.env.addGlobal('__', that.book.i18n.bind(that.book));
 
         // 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"
-        }));
     });
 };
 
@@ -136,7 +131,7 @@ 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) || ".";
@@ -213,38 +208,38 @@ Generator.prototype._writeTemplate = function(tpl, options, output, interpolate)
     interpolate = interpolate || _.identity;
     return Q()
     .then(function(sections) {
-    	return that.env.render(
-    		tpl,
-    		_.extend({
+        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)
-	    );
+            }, options)
+        );
     })
     .then(interpolate)
     .then(function(html) {

lib/index.js

@@ -12,199 +12,199 @@ 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 = undefined;
 
-				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 files");
+                                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, kwargs) {
+                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, kwargs) {
+                return Book.init(args[0] || process.cwd())
+                .then(function(){
+                    console.log("");
+                    console.log(color.green("Done, without error"));
+                });
+            }
+        }
+    ])
 };

lib/plugin.js

@@ -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() {

lib/pluginslist.js

@@ -8,113 +8,113 @@ 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;
+    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) {
+    // Extract filters
+    _.each(plugin.getFilters(), function(filterFunc, filterName) {
         that.book.template.addFilter(filterName, filterFunc);
     });
 
     // Extract blocks
-	_.each(plugin.getBlocks(), function(block, blockName) {
+    _.each(plugin.getBlocks(), function(block, blockName) {
         that.book.template.addBlock(blockName, block);
     });
 
-	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 +123,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 +136,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,13 +144,13 @@ 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;
+    var defaultsPlugins = _.pluck(that.book.options.defaultsPlugins)
 
     // Remove defaults (no need to install)
     var plugins = _.filter(that.book.options.plugins, function(plugin) {
@@ -167,51 +167,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");

lib/template.js

@@ -2,9 +2,9 @@ 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");
@@ -12,31 +12,31 @@ var pkg = require("../package.json");
 
 // The loader should handle relative and git url
 var BookLoader = nunjucks.Loader.extend({
-	async: true,
+    async: true,
 
     init: function(book) {
-    	this.book = book;
+        this.book = book;
     },
 
     getSource: function(fileurl, callback) {
-    	var that = this;
+        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)
+        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);
+            //  Read file from absolute path
+            return fs.readFile(filepath)
+            .then(function(source) {
+                return {
+                    src: source.toString(),
+                    path: filepath
+                }
+            });
+        })
+        .nodeify(callback);
     },
 
     resolve: function(from, to) {
@@ -46,27 +46,27 @@ var BookLoader = nunjucks.Loader.extend({
 
 
 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 = [];
@@ -302,7 +302,7 @@ TemplateEngine.prototype.addBlock = function(name, block) {
 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),
+        escapeStringRegexp(shortcut.start) + "([\\s\\S]*?[^\\$])" + escapeStringRegexp(shortcut.end),
        'g'
     );
     return content.replace(regex, function(all, match) {
@@ -331,12 +331,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;
+    var that = this, context;
 
     return that.book.readFile(filename)
     .then(function(content) {

lib/utils/code.js

@@ -0,0 +1,36 @@
+var hljs = require('highlight.js');
+
+var MAP = {
+    'py': 'python',
+    'js': 'javascript',
+    'json': 'javascript',
+    'rb': 'ruby',
+    'csharp': 'cs',
+};
+
+function normalize(lang) {
+    if(!lang) { return null; }
+
+    var lower = lang.toLowerCase();
+    return MAP[lower] || lower;
+}
+
+function highlight(lang, code) {
+    if(!lang) return code;
+
+    // Normalize lang
+    lang = normalize(lang);
+
+    try {
+        return hljs.highlight(lang, code).value;
+    } catch(e) { }
+
+    return code;
+}
+
+// Exports
+module.exports = {
+    highlight: highlight,
+    normalize: normalize,
+    MAP: MAP
+};

lib/utils/git.js

@@ -15,7 +15,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 +25,88 @@ 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);
+    });
 };
 
 
 module.exports = {
-	checkUrl: checkGitUrl,
-	parseUrl: parseGitUrl,
-	resolveFile: resolveFileFromGit
+    checkUrl: checkGitUrl,
+    parseUrl: parseGitUrl,
+    resolveFile: resolveFileFromGit
 };

lib/utils/i18n.js

@@ -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());
-};
-
-var getByLanguage = function(lang) {
-	lang = normalizeLanguage(lang);
-	var locales = getLocales();
-	return locales[lang];
-};
+i18n.configure({
+    locales: LOCALES,
+    directory: I18N_PATH,
+    defaultLocale: DEFAULT_LANGUAGE,
+    updateFiles: false
+});
 
 var compareLocales = function(lang, locale) {
-	var langMain = _.first(lang.split("-"));
-	var langSecond = _.last(lang.split("-"));
+    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;
 });
 
-module.exports = {
-	getLocales: getLocales,
-	getLanguages: getLanguages,
-	getByLanguage: getByLanguage,
-	normalizeLanguage: normalizeLanguage
+var translate = function(locale, phrase) {
+    var args = Array.prototype.slice.call(arguments, 2);
+
+    return i18n.__.apply({}, [{
+        locale: locale,
+        phrase: phrase
+    }].concat(args));
+};
+
+var getCatalog = function(locale) {
+    locale = normalizeLanguage(locale);
+    return i18n.getCatalog(locale);
+};
+
+var getLocales = function() {
+    return LOCALES;
+};
+
+var hasLocale = function(locale) {
+    return _.contains(LOCALES, locale);
+}
+
+module.exports = {
+    __: translate,
+    normalizeLanguage: normalizeLanguage,
+    getCatalog: getCatalog,
+    getLocales: getLocales,
+    hasLocale: hasLocale
 };

lib/utils/images.js

@@ -7,14 +7,14 @@ var links = require("./links");
 
 // 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 command = shellescape(['svgexport', source, dest]);
     var child = spawn('svgexport', [source, dest]);
 
     child.on("error", function(error) {
@@ -30,10 +30,10 @@ var convertSVG = function(source, dest, options) {
         }
     });
 
-	return d.promise;
+    return d.promise;
 };
 
 module.exports = {
-	convertSVG: convertSVG,
-	INVALID: [".svg"]
+    convertSVG: convertSVG,
+    INVALID: [".svg"]
 };

lib/utils/logger.js

@@ -3,100 +3,100 @@ 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;

lib/utils/navigation.js

@@ -36,7 +36,7 @@ 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)
@@ -57,7 +57,9 @@ function navigation(summary, files) {
 
 
         return [current.path, {
+            index: i,
             title: current.title,
+            introduction: current.introduction,
             prev: prev,
             next: next,
             level: current.level,

lib/utils/page.js

@@ -11,6 +11,7 @@ var links = require('./links');
 var imgUtils = require('./images');
 var fs = require('./fs');
 var batch = require('./batch');
+var code = require('./code');
 
 // Render a cheerio dom as html
 var renderDom = function($, dom, options) {
@@ -183,6 +184,7 @@ function normalizeHtml(src, options) {
         $(this).attr("src", src);
     });
 
+    // Normalize links
     $("a").each(function() {
         var href = $(this).attr("href");
         if (!href) return;
@@ -190,17 +192,17 @@ 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);
             }
 
             // 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 +212,39 @@ function normalizeHtml(src, options) {
         $(this).attr("href", href);
     });
 
-    // Replace glossayr terms
+    // Highlight code blocks
+    $("code").each(function() {
+        // Extract language
+        var lang = _.chain(
+                ($(this).attr("class") || "").split(" ")
+            )
+            .map(function(cl) {
+                if (cl.search("lang-") === 0) return cl.slice("lang-".length);
+                return null;
+            })
+            .compact()
+            .first()
+            .value();
+
+        if (lang) {
+            var html = code.highlight(
+                lang,
+                $(this).text()
+            );
+
+            $(this).html(html);
+        }
+    });
+
+    // Replace glossary terms
     _.each(options.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"], this.name.toLowerCase())) return;
+
             replaceText($, this, r, function(match) {
                 // Add to files index in glossary
                 if (!includedInFiles) {

lib/utils/progress.js

@@ -7,10 +7,18 @@ var calculProgress = function(navigation, current) {
     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);

lib/utils/string.js

@@ -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)

lib/utils/watch.js

@@ -1,7 +1,7 @@
 var Q = require('q');
 var _ = require('lodash');
 var path = require('path');
-var Gaze = require('gaze').Gaze;
+var chokidar = require('chokidar');
 
 var parsers = require('gitbook-parsers')
 
@@ -17,17 +17,18 @@ function watch(dir) {
         toWatch.push("**/*"+ext);
     });
 
-    var gaze = new Gaze(toWatch, {
-        cwd: dir
+    var watcher = chokidar.watch(toWatch, {
+        cwd: dir,
+        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);
     });

package.json

@@ -1,27 +1,27 @@
 {
     "name": "gitbook",
-    "version": "2.0.0-beta.1",
+    "version": "2.0.3",
     "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",
+        "lodash": "3.5.0",
         "graceful-fs": "3.0.5",
         "resolve": "0.6.3",
         "fs-extra": "0.16.5",
         "fstream-ignore": "1.0.2",
-        "gitbook-parsers": "0.5.2",
-        "nunjucks": "git+https://github.com/mozilla/nunjucks.git#0f8b21b8df7e8e852b2e1889388653b7075f0d09",
+        "gitbook-parsers": "0.7.5",
+        "nunjucks": "1.3.0",
         "nunjucks-autoescape": "0.1.1",
         "nunjucks-filter": "0.1.0",
-        "nunjucks-i18n": "1.0.0",
+        "i18n": "0.5.0",
         "semver": "2.2.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.1",
         "send": "0.2.0",
         "tiny-lr": "0.1.5",
         "tmp": "0.0.24",
@@ -31,10 +31,13 @@
         "request": "2.51.0",
         "npm": "2.4.1",
         "dom-serializer": "0.1.0",
-        "spawn-cmd": "0.0.2"
+        "spawn-cmd": "0.0.2",
+        "highlight.js": "8.4.0",
+        "escape-string-regexp": "1.0.3"
     },
     "devDependencies": {
         "mocha": "2.2.1",
+        "should": "5.2.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"
     },

test/assertions.js

@@ -0,0 +1,54 @@
+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 || {}, {
+            count: 1,
+            attributes: {},
+            trim: false,
+            text: undefined
+        });
+
+        var $el = $(query);
+
+        // Test number of elements
+        $el.should.have.lengthOf(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);
+        });
+    });
+});

test/books/basic/README.md

@@ -0,0 +1,3 @@
+# Readme
+
+Default description for the book.

test/books/config-js/README.md

@@ -0,0 +1 @@
+# Readme

test/books/config-js/book.js

@@ -0,0 +1,3 @@
+module.exports = {
+    "title": "js-config"
+};

test/books/config-json/README.md

@@ -0,0 +1 @@
+# Readme

test/books/config-json/book.json

@@ -0,0 +1,3 @@
+{
+    "title": "json-config"
+}

test/books/conrefs/README.md

@@ -0,0 +1,10 @@
+# Readme
+
+### Relative
+
+<p id="t1">{% include "./hello.md" %}</p>
+
+### Git
+
+<p id="t2">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md" %}</p>
+<p id="t3">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test2.md" %}</p>

test/books/conrefs/SUMMARY.md

@@ -0,0 +1 @@
+# Summary

test/books/conrefs/hello.md

@@ -0,0 +1 @@
+Hello World

test/books/glossary/GLOSSARY.md

@@ -0,0 +1,9 @@
+# Glossary
+
+## test
+
+Just a simple and easy to understand test.
+
+## hakunamatata
+
+This word is not present in the content.

test/books/glossary/README.md

@@ -0,0 +1,8 @@
+# Readme
+
+The word test should be replaced by a glossary link.
+
+```
+But the word test should not be replaced in code blocks
+```
+

test/books/glossary/SUMMARY.md

@@ -0,0 +1,3 @@
+# Summary
+
+* [Page](folder/PAGE.md)

test/books/glossary/folder/PAGE.md

@@ -0,0 +1,3 @@
+# Page
+
+Just a page in a sub-directory to test relative link to glossary.

test/books/images/README.md

@@ -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)
+

test/books/images/SUMMARY.md

@@ -0,0 +1,3 @@
+# Summary
+
+* [Page](./folder/PAGE.md)

test/books/images/folder/PAGE.md

@@ -0,0 +1,3 @@
+### Images from other folder
+![test.svg](../test.svg)
+

test/books/images/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>
+

test/books/init/.gitignore

@@ -0,0 +1,3 @@
+*
+!SUMMARY.md
+!.gitignore

test/books/init/SUMMARY.md

@@ -0,0 +1,6 @@
+# Summary
+
+* [Hello](hello.md)
+* [Hello 2](hello2.md)
+* Hello 3
+    * [Hello 4](hello3/hello4.md)

test/books/languages/LANGS.md

@@ -0,0 +1,4 @@
+# Language
+
+* [English](en)
+* [French](fr)

test/books/languages/README.md

@@ -0,0 +1 @@
+# Readme

test/books/languages/en/README.md

@@ -0,0 +1 @@
+Hello

test/books/languages/en/SUMMARY.md

@@ -0,0 +1 @@
+# Summary

test/books/languages/fr/README.md

@@ -0,0 +1 @@
+Bonjour

test/books/languages/fr/SUMMARY.md

@@ -0,0 +1 @@
+# Summary

test/books/links/README.md

@@ -0,0 +1 @@
+# Readme

test/books/links/SUMMARY.md

@@ -0,0 +1,4 @@
+# Summary
+
+* [Folder1](folder1/README.md)
+* [Folder2](folder2/README.md)

test/books/links/folder1/README.md

@@ -0,0 +1,3 @@
+# Folder 1
+
+[Link to folder2](../folder2/README.md)

test/books/links/folder2/README.md

@@ -0,0 +1 @@
+# Folder 2

test/books/summary/PAGE1.md

@@ -0,0 +1 @@
+# Page 1

test/books/summary/README.md

@@ -0,0 +1 @@
+# Readme

test/books/summary/SUMMARY.md

@@ -0,0 +1,5 @@
+# Summary
+
+* [Page 1](./PAGE1.md)
+* [Page 2](./folder/PAGE2.md)
+* [Don't exists](./NOTFOUND.md)

test/books/summary/folder/PAGE2.md

@@ -0,0 +1 @@
+# Page 2

test/configuration.js

@@ -1,14 +1,32 @@
+var fs = require('fs');
 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");
+            });
     });
 });

test/conrefs.js

@@ -0,0 +1,43 @@
+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 git references', function() {
+        readme.should.be.html({
+            ".page-inner p#t2": {
+                count: 1,
+                text: "Hello from git",
+                trim: true
+            },
+            ".page-inner p#t3": {
+                count: 1,
+                text: "First Hello. Hello from git",
+                trim: true
+            }
+        });
+    });
+});

test/ebook.js

@@ -1,36 +1,24 @@
+var fs = require('fs');
 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");
+describe('eBook generator', function () {
+    describe('Basic Book', function() {
+        var book;
 
+        before(function() {
+            return books.generate("basic", "ebook")
+                .then(function(_book) {
+                    book = _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);
-    });
+        it('should correctly output a SUMMARY.html', function() {
+            book.should.have.file("SUMMARY.html");
+        });
 
-    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);
-
-                $("img").each(function() {
-                    var src = $(this).attr("src");
-                    assert(fs.existsSync(path.resolve(pageFolder, src)), src+" not found for page "+pageName);
-                })
-            });
-        }, done);
+        it('should correctly copy assets', function() {
+            book.should.have.file("gitbook");
+            book.should.have.file("gitbook/style.css");
+        });
     });
 });

test/fixtures/test0/GLOSSARY.md

@@ -1,6 +0,0 @@
-# Glossary
-
-## Description
-
-This is the dexcription of a description.
-

test/fixtures/test0/README.md

@@ -1,3 +0,0 @@
-# Other Title
-
-This is a description, it's simple, no ?

test/fixtures/test0/SUMMARY.md

@@ -1 +0,0 @@
-# Summary

test/fixtures/test0/book.json

@@ -1,3 +0,0 @@
-{
-	"title": "Test"
-}

test/fixtures/test0/styles/website.css

@@ -1,3 +0,0 @@
-body {
-	background: red;
-}

test/fixtures/test1/GLOSSARY.md

@@ -1,9 +0,0 @@
-
-# Test
-
-a test text
-
-# Test 2
-
-a second test
-

test/fixtures/test1/README.md

@@ -1,4 +0,0 @@
-# Test
-
-This file is not parsed by gitbook because the structure is defined in book.json.
-

test/fixtures/test1/SUMMARY.md

@@ -1,6 +0,0 @@
-# Summary
-
-* [Chapter 1](test.md)
-    * [Article 1](sub/test1.md)
-* [Chapter 2](test2.md)
-* [Google](https://www.google.com)

test/fixtures/test1/book.json

@@ -1,5 +0,0 @@
-{
-	"structure": {
-		"readme": "intro.md"
-	}
-}

test/fixtures/test1/intro.md

@@ -1,4 +0,0 @@
-# My Book
-
-Test description
-

test/fixtures/test1/sub/test1.md

@@ -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.
-

test/fixtures/test2/LANGS.md

@@ -1,4 +0,0 @@
-# Languages
-
-* [English](en/)
-* [French](fr/)

test/fixtures/test2/README.md

@@ -1,2 +0,0 @@
-# Multi-Languages test
-

test/fixtures/test2/en/README.md

@@ -1 +0,0 @@
-# English Book

test/fixtures/test2/fr/README.md

@@ -1 +0,0 @@
-# French Book

test/fixtures/test3/README.adoc

@@ -1,4 +0,0 @@
-= My Book
-
-Test description
-

test/fixtures/test3/SUMMARY.adoc

@@ -1,5 +0,0 @@
-= Summary
-
-. link:test.adoc[Chapter 1]
-.. link:test1.adoc[Article 1]
-. link:test2.adoc[Chapter 2]

test/fixtures/test4/README.md

@@ -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)

test/fixtures/test4/SUMMARY.md

@@ -1,3 +0,0 @@
-# Summary
-
-* [Page](sub/PAGE.md)

test/fixtures/test4/book.js

@@ -1,3 +0,0 @@
-module.exports = {
-	title: "Test 2"
-};

test/fixtures/test4/sub/PAGE.md

@@ -1,18 +0,0 @@
-##
-
-## Image from root page
-
-![test image to be converted](../test.svg)
-![test url](http://upload.wikimedia.org/wikipedia/commons/b/b0/NewTux.svg)
-
-## Inline svg
-
-{% html %}
-<svg xmlns="http://www.w3.org/2000/svg">
-    <path d="M97.008198003228,6.103238498249268A97.2,97.2 0 0,1 87.9491894996971,41.385747140125076L54.289623147961166,25.546757493904366A60,60 0 0,0 59.88160370569629,3.7674311717588074Z"></path>
-</svg>
-{% endhtml %}
-
-## Remote image
-
-![remote url](http://upload.wikimedia.org/wikipedia/commons/a/af/Tux.png)

test/fixtures/test4/test.svg

@@ -1,11 +0,0 @@
-<?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>
-

test/fixtures/test5/README.md

@@ -1,5 +0,0 @@
-# Test Content inclusion
-
-{% include "./test.md" %}
-Git1:{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md" %}
-Git2:{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test2.md" %}

test/fixtures/test5/test.md

@@ -1 +0,0 @@
-Hello World

test/git.js

@@ -1,32 +1,31 @@
-var path = require('path');
-var _ = require('lodash');
-var assert = require('assert');
-
-var fs = require("fs");
-var git = require("../lib/utils/git");
+var should = require('should');
+var git = require('../lib/utils/git');
 
 describe('GIT parser and getter', function () {
     it('should correctly parse an https url', function() {
         var parts = git.parseUrl("git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md");
-        assert(parts);
-        assert.equal(parts.host, "https://gist.github.com/69ea4542e4c8967d2fa7.git");
-        assert.equal(parts.ref, "master");
-        assert.equal(parts.filepath, "test.md");
+
+        should.exist(parts);
+        parts.host.should.be.equal("https://gist.github.com/69ea4542e4c8967d2fa7.git");
+        parts.ref.should.be.equal("master");
+        parts.filepath.should.be.equal("test.md");
     });
 
     it('should correctly parse an https url with a reference', function() {
         var parts = git.parseUrl("git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md#0.1.2");
-        assert(parts);
-        assert.equal(parts.host, "https://gist.github.com/69ea4542e4c8967d2fa7.git");
-        assert.equal(parts.ref, "0.1.2");
-        assert.equal(parts.filepath, "test.md");
+
+        should.exist(parts);
+        parts.host.should.be.equal("https://gist.github.com/69ea4542e4c8967d2fa7.git");
+        parts.ref.should.be.equal("0.1.2");
+        parts.filepath.should.be.equal("test.md");
     });
 
     it('should correctly parse an ssh url', function() {
         var parts = git.parseUrl("git+git@github.com:GitbookIO/gitbook.git/directory/README.md#e1594cde2c32e4ff48f6c4eff3d3d461743d74e1");
-        assert(parts);
-        assert.equal(parts.host, "git@github.com:GitbookIO/gitbook.git");
-        assert.equal(parts.ref, "e1594cde2c32e4ff48f6c4eff3d3d461743d74e1");
-        assert.equal(parts.filepath, "directory/README.md");
+
+        should.exist(parts);
+        parts.host.should.be.equal("git@github.com:GitbookIO/gitbook.git");
+        parts.ref.should.be.equal("e1594cde2c32e4ff48f6c4eff3d3d461743d74e1");
+        parts.filepath.should.be.equal("directory/README.md");
     });
 });

test/glossary.js

@@ -1,35 +1,78 @@
+var fs = require('fs');
 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");
+describe('Glossary', function () {
+    describe('Parsing', function() {
+        var book;
 
+        before(function() {
+            return books.parse("glossary")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
 
-describe('Glossary Generation', function () {
-    it('should correctly replace glossary terms', function(done) {
-        testGeneration(books[0], "website", function(output) {
-            var content = fs.readFileSync(path.join(output, "index.html"), { encoding: "utf8" });
-            var $ = cheerio.load(content);
-
-            var $body = $(".page-inner");
-            var $a = $("a[href='GLOSSARY.html#description']");
-            assert($a.length == 1);
-            assert($a.text() == "description");
-        }, done);
+        it('should correctly list items', function() {
+            book.should.have.property("glossary");
+            book.glossary.should.have.lengthOf(2);
+        });
     });
 
-    it('should correctly replace glossary terms in sub pages', function(done) {
-        testGeneration(books[1], "website", function(output) {
-            var content = fs.readFileSync(path.join(output, "sub/test1.html"), { encoding: "utf8" });
-            var $ = cheerio.load(content);
+    describe('Generation', function() {
+        var book;
 
-            var $body = $(".page-inner");
-            var $a = $("a[href='../GLOSSARY.html#test']");
-            assert($a.length == 1);
-            assert($a.text() == "test");
-            assert($a.attr("title") == "a test text");
-        }, done);
+        before(function() {
+            return books.generate("glossary", "website")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it('should correctly generate a GLOSSARY.html', function() {
+            book.should.have.file("GLOSSARY.html");
+        });
+
+        describe('Page Integration', function() {
+            var readme, page;
+
+            before(function() {
+                readme = fs.readFileSync(
+                    path.join(book.options.output, "index.html"),
+                    { encoding: "utf-8" }
+                );
+                page = fs.readFileSync(
+                    path.join(book.options.output, "folder/PAGE.html"),
+                    { encoding: "utf-8" }
+                );
+            });
+
+            it('should correctly replaced terms by links', function() {
+                readme.should.be.html({
+                    ".page-inner a[href='GLOSSARY.html#test']": {
+                        count: 1,
+                        text: "test",
+                        attributes: {
+                            title: "Just a simple and easy to understand test."
+                        }
+                    }
+                });
+            });
+
+            it('should correctly replaced terms by links (relative)', function() {
+                page.should.be.html({
+                    ".page-inner a[href='../GLOSSARY.html#test']": {
+                        count: 1
+                    }
+                });
+            });
+
+            it('should not replace terms in codeblocks', function() {
+                readme.should.be.html({
+                    ".page-inner code a": {
+                        count: 0
+                    }
+                });
+            });
+        });
     });
 });

test/helper.js

@@ -1,62 +1,68 @@
+var os = require('os');
 var path = require('path');
 var Q = require('q');
 var fs = require('fs');
 var _ = require('lodash');
+var should = require('should');
 
-var fsUtil = require("../lib/utils/fs");
+var fsUtil = require('../lib/utils/fs');
 var Book = require('../').Book;
 var LOG_LEVELS = require('../').LOG_LEVELS;
 
-// Nicety for mocha / Q
-global.qdone = function qdone(promise, done) {
-    return promise.then(function() {
-        return done();
-    }, function(err) {
-        return done(err);
-    }).done();
+require("./assertions");
+
+
+var BOOKS = {};
+var TMPDIR = os.tmpdir();
+
+
+// Generate and return a book
+function generateBook(bookId, test) {
+    return parseBook(bookId, test)
+    .then(function(book) {
+        return book.generate(test)
+        .thenResolve(book);
+    });
+}
+
+// Generate and return a book
+function parseBook(bookId, test) {
+    test = test || "website";
+    BOOKS[bookId] = BOOKS[bookId] || {};
+    if (BOOKS[bookId][test]) return Q(BOOKS[bookId][test]);
+
+    BOOKS[bookId][test] = new Book(path.resolve(__dirname, "books", bookId), {
+        logLevel: LOG_LEVELS.DISABLED,
+        config: {
+            output: path.resolve(TMPDIR, bookId+"-"+test)
+        }
+    });
+
+    return BOOKS[bookId][test].parse()
+    .then(function() {
+        return BOOKS[bookId][test];
+    });
+}
+
+
+global.books = {
+    parse: parseBook,
+    generate: generateBook
 };
 
-// Test generation of a book
-global.testGeneration = function(book, type, func, done) {
-    var OUTPUT_PATH = book.options.output;
-
-    qdone(
-        book.generate(type)
-            .then(function() {
-                func(OUTPUT_PATH);
-            })
-            .fin(function() {
-                return fsUtil.remove(OUTPUT_PATH);
-            }),
-        done);
-};
-
-// Books for testings
-var books = fs.readdirSync(path.join(__dirname, './fixtures/'));
-
-global.books = _.chain(books)
-    .sortBy()
-    .map(function(book) {
-        if (book.indexOf("test") !== 0) return null;
-        return new Book(path.join(__dirname, './fixtures/', book), {
-            logLevel: LOG_LEVELS.DISABLED
-        });
-    })
-    .compact()
-    .value();
-
-// Init before doing tests
-before(function(done) {
-
-    qdone(
-	    _.reduce(global.books, function(prev, book) {
+// Cleanup all tests
+after(function() {
+    return _.chain(BOOKS)
+        .map(function(types, bookId) {
+            return _.values(types);
+        })
+        .flatten()
+        .reduce(function(prev, book) {
             return prev.then(function() {
-                return fsUtil.remove(path.join(book.root, "_book"));
+                return fsUtil.remove(book.options.output);
             })
-            .then(function() {
-                return book.parse();
-            });
-        }, Q()),
-	    done
-	);
+        }, Q())
+        .value();
 });
+
+

test/images.js

@@ -0,0 +1,56 @@
+var fs = require('fs');
+var _ = require('lodash');
+var path = require('path');
+var cheerio = require('cheerio');
+
+describe('Images', function () {
+    var book, readme, $, $img, srcs;
+
+    before(function() {
+        return books.generate("images", "ebook")
+            .then(function(_book) {
+                book = _book;
+
+                readme = fs.readFileSync(
+                    path.join(book.options.output, "index.html"),
+                    { encoding: "utf-8" }
+                );
+                $ = cheerio.load(readme);
+                $img = $("img");
+                srcs = $img.map(function() { return $(this).attr("src"); })
+            });
+    });
+
+    it('should detect all images', function() {
+        _.uniq(srcs).should.have.lengthOf(4);
+    });
+
+    it('should keep image tags', function() {
+        srcs.should.have.lengthOf(5);
+    });
+
+    it('should not have .svg files', function() {
+        _.each(srcs, function(src) {
+            path.extname(src).should.not.equal(".svg");
+        });
+    });
+
+    it('should correctly convert svg images to png', function() {
+        _.each(srcs, function(src) {
+            book.should.have.file(src);
+        });
+    });
+
+    it('should handle relative paths', function() {
+        var PAGE = fs.readFileSync(
+            path.join(book.options.output, "folder/PAGE.html"),
+            { encoding: "utf-8" }
+        );
+
+        PAGE.should.be.html({
+            "img[src='../test.png']": {
+                count: 1
+            }
+        });
+    });
+});

test/init.js

@@ -0,0 +1,23 @@
+var fs = require('fs');
+var path = require('path');
+var should = require('should');
+
+var Book = require('../').Book;
+var LOG_LEVELS = require('../').LOG_LEVELS;
+
+describe('Init Books', function () {
+    var initRoot;
+
+    before(function() {
+        initRoot = path.resolve(__dirname, "books/init");
+        return Book.init(initRoot, {
+            logLevel: LOG_LEVELS.DISABLED,
+        });
+    });
+
+    it('should create all chapters', function() {
+        should(fs.existsSync(path.resolve(initRoot, "hello.md"))).be.ok;
+        should(fs.existsSync(path.resolve(initRoot, "hello2.md"))).be.ok;
+        should(fs.existsSync(path.resolve(initRoot, "hello3/hello4.md"))).be.ok;
+    });
+});

test/json.js

@@ -1,59 +1,92 @@
+var fs = require('fs');
 var path = require('path');
-var _ = require('lodash');
-var assert = require('assert');
-
-var fs = require("fs");
 
 describe('JSON generator', function () {
-    it('should correctly generate a book to json with glossary', function(done) {
-        testGeneration(books[0], "json", function(output) {
-            assert(fs.existsSync(path.join(output, "README.json")));
+    describe('Basic Book', function() {
+        var book;
 
-            var readme = JSON.parse(fs.readFileSync(path.join(output, "README.json")));
-            assert(readme.sections[0].content.indexOf('class="glossary-term"') > 0);
-        }, done);
+        before(function() {
+            return books.generate("basic", "json")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it('should correctly output a README.json', function() {
+            book.should.have.file("README.json");
+        });
+
+        it('should output a valid json', function() {
+            book.should.have.jsonfile("README.json");
+        });
+
+        describe('Page Format', function() {
+            var page;
+
+            before(function() {
+                page = JSON.parse(
+                    fs.readFileSync(
+                        path.join(book.options.output, "README.json"),
+                        { encoding: "utf-8" }
+                    )
+                );
+            });
+
+            it('should contains valid section', function() {
+                page.should.have.property("sections").with.lengthOf(1);
+                page.sections[0].should.have.property("content").which.is.a.String;
+                page.sections[0].should.have.property("type").which.is.a.String.which.equal("normal");
+            });
+
+            it('should contains valid progress', function() {
+                page.should.have.property("progress");
+                page.progress.should.have.property("chapters").with.lengthOf(1);
+                page.progress.should.have.property("current");
+            });
+
+            it('should contains no languages', function() {
+                page.should.have.property("langs").with.lengthOf(0);
+            });
+        });
     });
 
-    it('should correctly generate a book to json with sub folders', function(done) {
-    	testGeneration(books[1], "json", function(output) {
-            assert(fs.existsSync(path.join(output, "README.json")));
-            assert(fs.existsSync(path.join(output, "intro.json")));
-            assert(fs.existsSync(path.join(output, "sub/test1.json")));
+    describe('Multilingual Book', function() {
+        var book;
 
-            var test1 = JSON.parse(fs.readFileSync(path.join(output, "sub/test1.json")));
-            assert(test1.sections[0].content.indexOf("intro.html") > 0);
-        }, done);
-    });
+        before(function() {
+            return books.generate("languages", "json")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
 
-    it('should correctly generate a multilingual book to json', function(done) {
-    	testGeneration(books[2], "json", function(output) {
-            assert(fs.existsSync(path.join(output, "README.json")));
-            assert(fs.existsSync(path.join(output, "en/README.json")));
-            assert(fs.existsSync(path.join(output, "fr/README.json")));
-        }, done);
-    });
+        it('should correctly output READMEs', function() {
+            book.should.have.file("README.json");
+            book.should.have.file("en/README.json");
+            book.should.have.file("fr/README.json");
+        });
 
-    it('should correctly generate an asciidoc book to json', function(done) {
-        testGeneration(books[3], "json", function(output) {
-            assert(fs.existsSync(path.join(output, "README.json")));
-            assert(fs.existsSync(path.join(output, "test.json")));
-            assert(fs.existsSync(path.join(output, "test1.json")));
-            assert(fs.existsSync(path.join(output, "test2.json")));
-        }, done);
-    });
+        it('should output valid json', function() {
+            book.should.have.jsonfile("README.json");
+            book.should.have.jsonfile("en/README.json");
+            book.should.have.jsonfile("fr/README.json");
+        });
 
-    it('should correctly generate a book with local inclusion', function(done) {
-        testGeneration(books[5], "json", function(output) {
-            var readme = JSON.parse(fs.readFileSync(path.join(output, "README.json")));
-            assert(readme.sections[0].content.indexOf('Hello World') > 0);
-        }, done);
-    });
+        describe('Page Format', function() {
+            var page;
 
-    it('should correctly generate a book with external inclusion', function(done) {
-        testGeneration(books[5], "json", function(output) {
-            var readme = JSON.parse(fs.readFileSync(path.join(output, "README.json")));
-            assert(readme.sections[0].content.indexOf('Git1:Hello from git') > 0);
-            assert(readme.sections[0].content.indexOf('Git2:First Hello. Hello from git') > 0);
-        }, done);
+            before(function() {
+                page = JSON.parse(
+                    fs.readFileSync(
+                        path.join(book.options.output, "README.json"),
+                        { encoding: "utf-8" }
+                    )
+                );
+            });
+
+            it('should contains no languages', function() {
+                page.should.have.property("langs").with.lengthOf(2);
+            });
+        });
     });
 });

test/languages.js

@@ -0,0 +1,40 @@
+var fs = require('fs');
+var path = require('path');
+
+describe('Languages', function () {
+    describe('Parsing', function() {
+        var book;
+
+        before(function() {
+            return books.parse("languages")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it('should correctly list languages', function() {
+            book.should.have.property("books");
+            book.books.should.have.lengthOf(2);
+
+            book.books[0].options.language.should.be.equal("en");
+            book.books[1].options.language.should.be.equal("fr");
+        });
+    });
+
+    describe('Generation', function() {
+        var book;
+
+        before(function() {
+            return books.generate("languages", "website")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it('should correctly create books', function() {
+            book.should.have.file("index.html");
+            book.should.have.file("en/index.html");
+            book.should.have.file("fr/index.html");
+        });
+    });
+});

test/links.js

@@ -1,40 +1,65 @@
-var path = require('path');
+var should = require('should');
+var fs = require('fs');
 var _ = require('lodash');
-var assert = require('assert');
+var path = require('path');
+var cheerio = require('cheerio');
 
 var links = require("../lib/utils/links");
 
 describe('Links', function () {
     it('should correctly test external links', function() {
-        assert(links.isExternal("http://google.fr"));
-        assert(links.isExternal("https://google.fr"));
-        assert(!links.isExternal("test.md"));
-        assert(!links.isExternal("folder/test.md"));
-        assert(!links.isExternal("/folder/test.md"));
+        links.isExternal("http://google.fr").should.be.exactly(true);
+        links.isExternal("https://google.fr").should.be.exactly(true);
+        links.isExternal("test.md").should.be.exactly(false);
+        links.isExternal("folder/test.md").should.be.exactly(false);
+        links.isExternal("/folder/test.md").should.be.exactly(false);
     });
 
-    it('should correctly test anchor links', function() {
-        assert(links.isAnchor("#test"));
-        assert(links.isAnchor(" #test"));
-        assert(!links.isAnchor("https://google.fr#test"));
-        assert(!links.isAnchor("test.md#test"));
+    it('should correctly detect anchor links', function() {
+        links.isAnchor("#test").should.be.exactly(true);
+        links.isAnchor(" #test").should.be.exactly(true);
+        links.isAnchor("https://google.fr#test").should.be.exactly(false);
+        links.isAnchor("test.md#test").should.be.exactly(false);
     });
 
     describe('toAbsolute', function() {
         it('should correctly transform as absolute', function() {
-            assert.equal(links.toAbsolute("http://google.fr"), "http://google.fr");
-            assert.equal(links.toAbsolute("test.md", "./", "./"), "test.md");
-            assert.equal(links.toAbsolute("folder/test.md", "./", "./"), "folder/test.md");
+            links.toAbsolute("http://google.fr").should.be.equal("http://google.fr");
+            links.toAbsolute("test.md", "./", "./").should.be.equal("test.md");
+            links.toAbsolute("folder/test.md", "./", "./").should.be.equal("folder/test.md");
         });
 
         it('should correctly handle windows path', function() {
-            assert.equal(links.toAbsolute("folder\\test.md", "./", "./"), "folder/test.md");
+            links.toAbsolute("folder\\test.md", "./", "./").should.be.equal("folder/test.md");
         });
 
         it('should correctly handle absolute path', function() {
-            assert.equal(links.toAbsolute("/test.md", "./", "./"), "test.md");
-            assert.equal(links.toAbsolute("/test.md", "test", "test"), "../test.md");
-            assert.equal(links.toAbsolute("/sub/test.md", "test", "test"), "../sub/test.md");
+            links.toAbsolute("/test.md", "./", "./").should.be.equal("test.md");
+            links.toAbsolute("/test.md", "test", "test").should.be.equal("../test.md");
+            links.toAbsolute("/sub/test.md", "test", "test").should.be.equal("../sub/test.md");
         });
     });
+
+    describe('page', function() {
+        var book;
+
+        before(function() {
+            return books.generate("links", "website")
+                .then(function(_book) {
+                    book = _book;
+                });
+        });
+
+        it('should correctly replace relative links', function() {
+            var readme = fs.readFileSync(
+                path.join(book.options.output, "folder1/index.html"),
+                { encoding: "utf-8" }
+            );
+            var $ = cheerio.load(readme);
+            var $a = $(".page-inner a");
+
+            $a.attr('href').should.be.exactly("../folder2/index.html");
+        })
+    });
+
 });

test/parsing.js

@@ -1,82 +0,0 @@
-var path = require('path');
-var _ = require('lodash');
-var assert = require('assert');
-
-describe('Book parsing', function () {
-    it('should correctly parse the readme', function() {
-        assert.equal(books[1].options.title, 'My Book');
-    	assert.equal(books[1].options.description, 'Test description');
-    });
-
-    it('should correctly parse the readme with asciidoc', function() {
-        assert.equal(books[3].options.title, 'My Book');
-        assert.equal(books[3].options.description, 'Test description');
-    });
-
-    it('should correctly parse the summary', function() {
-        var LEXED = books[1].summary;
-
-        assert.equal(LEXED.chapters[0].path, 'intro.md');
-        assert.equal(LEXED.chapters[0].exists, true);
-        assert.equal(LEXED.chapters[0].introduction, true);
-        assert.equal(LEXED.chapters[0].external, false);
-
-    	assert.equal(LEXED.chapters[1].path, 'test.md');
-        assert.equal(LEXED.chapters[1].exists, false);
-        assert.equal(LEXED.chapters[1].introduction, false);
-        assert.equal(LEXED.chapters[1].external, false);
-
-        assert.equal(LEXED.chapters[2].path, 'test2.md');
-        assert.equal(LEXED.chapters[2].exists, false);
-        assert.equal(LEXED.chapters[2].introduction, false);
-        assert.equal(LEXED.chapters[2].external, false);
-
-        assert.equal(LEXED.chapters[3].path, 'https://www.google.com');
-        assert.equal(LEXED.chapters[3].exists, true);
-        assert.equal(LEXED.chapters[3].introduction, false);
-        assert.equal(LEXED.chapters[3].external, true);
-    });
-
-    it('should correctly parse the glossary', function() {
-        var LEXED = books[1].glossary;
-
-        assert.equal(LEXED[0].id, "test");
-        assert.equal(LEXED[0].name, "Test");
-        assert.equal(LEXED[0].description, "a test text");
-
-        assert.equal(LEXED[1].id, "test_2");
-        assert.equal(LEXED[1].name, "Test 2");
-        assert.equal(LEXED[1].description, "a second test");
-    });
-
-    it('should correctly parse list of files', function() {
-        var FILES = books[1].files;
-
-        assert.deepEqual(FILES, [ 'README.md', 'intro.md', 'sub/', 'sub/test1.md' ]);
-    });
-
-    it('should correctly parse the languages', function() {
-        assert.equal(books[2].books.length, 2);
-        assert(books[2].isMultilingual());
-
-        assert.equal(books[2].books[0].options.language, "en");
-        assert.equal(books[2].books[0].options.title, "English Book");
-
-        assert.equal(books[2].books[1].options.language, "fr");
-        assert.equal(books[2].books[1].options.title, "French Book");
-    });
-
-    it('should correctly parse the navigation', function() {
-        var NAVIGATION = books[1].navigation;
-
-        assert.equal(_.size(NAVIGATION), 2);
-        assert(NAVIGATION["intro.md"])
-        assert.equal(NAVIGATION["intro.md"].title, "Introduction");
-        assert.equal(NAVIGATION["intro.md"].prev, null);
-        assert.equal(NAVIGATION["intro.md"].next.title, "Article 1");
-
-        assert.equal(NAVIGATION["sub/test1.md"].title, "Article 1");
-        assert.equal(NAVIGATION["sub/test1.md"].prev.title, "Introduction");
-        assert.equal(NAVIGATION["sub/test1.md"].next, null);
-    });
-});