From ffb22c5a3b60800c30965121136006b38d7f8b9c Mon Sep 17 00:00:00 2001 From: Mathieu David Date: Wed, 29 Jul 2015 14:02:05 +0200 Subject: [PATCH] Update README.md --- README.md | 45 +++++++++++++++++++++++++++++++++------------ 1 file changed, 33 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index bc2d1e38..a34f8295 100644 --- a/README.md +++ b/README.md @@ -2,18 +2,39 @@ Personal implementation of Gitbook in Rust -**This is a work in progress, it's far from being usable at the moment...** +**This is still a work in progress...** -### Progress +### cli tool -- [x] `mdbook init` creates boilerplate directory structure and files to start with.
Could be tweaked a little bit for improvements, but it works -- [x] Parses `SUMMARY.md` and constructs a book data structure.
Supports nested levels, empty links. Does not support other lines than list elements, does not suppport plain text. (Does not support = ignore) -- [x] Create JSon data from book -- [x] render handlebars template to html -- [x] create one `html` file for every entry in `SUMMARY.md` that is not an empty link
Respecting original directory structure -- [x] page layout -- [x] show content on page rendered from markdown -- [x] construct sidebar table of contents -- [ ] support config file +#### init -For more information about progress and what is still on my to-do list, check [this issue](../../issues/1) +If you run `mdbook init` in a directory, it will create a couple of folders and files you can start with. +This is the strucutre it creates at the moment: +``` +book-test/ +├── book +└── src + ├── chapter_1.md + └── SUMMARY.md +``` +`book` and `src` are both directories. `src` contains the markdown files that will be used to render the ouput to the `book` directory. + +You can also pass a directory to `mdbook init` to use instead of the current directory: +``` +mdbook init path/to/my/book +``` + +**Not implemented yet:** using `--theme` flag will create a theme folder with the default theme in `src` so that you can customize it. + +#### build + +Use `mdbook build` in the directory to render the book. You can also give a path as argument to use instead of the current directory. + + +### lib + +Aside the command-line tool, this crate can also be used as a library. + +------------------------------------------------------- + +For more information about what is left on my to-do list, check the issue tracker