2015-07-30 17:59:08 +08:00
|
|
|
# The build command
|
|
|
|
|
|
|
|
|
|
The build command is used to render your book:
|
|
|
|
|
|
2015-12-30 06:59:08 +08:00
|
|
|
```bash
|
2015-07-30 17:59:08 +08:00
|
|
|
mdbook build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
It will try to parse your `SUMMARY.md` file to understand the structure of your book
|
|
|
|
|
and fetch the corresponding files.
|
|
|
|
|
|
2015-09-25 04:19:14 +08:00
|
|
|
The rendered output will maintain the same directory structure as the source for
|
2015-07-30 17:59:08 +08:00
|
|
|
convenience. Large books will therefore remain structured when rendered.
|
|
|
|
|
|
|
|
|
|
#### Specify a directory
|
|
|
|
|
|
2018-02-18 15:04:04 +08:00
|
|
|
Like `init`, the `build` command can take a directory as an argument to use
|
|
|
|
|
instead of the current working directory.
|
2015-07-30 17:59:08 +08:00
|
|
|
|
2015-12-30 06:59:08 +08:00
|
|
|
```bash
|
2015-07-30 17:59:08 +08:00
|
|
|
mdbook build path/to/book
|
|
|
|
|
```
|
|
|
|
|
|
2017-01-02 01:42:47 +08:00
|
|
|
#### --open
|
|
|
|
|
|
|
|
|
|
When you use the `--open` (`-o`) option, mdbook will open the rendered book in
|
|
|
|
|
your default web browser after building it.
|
|
|
|
|
|
2017-01-17 08:11:39 +08:00
|
|
|
#### --dest-dir
|
|
|
|
|
|
|
|
|
|
The `--dest-dir` (`-d`) option allows you to change the output directory for your book.
|
|
|
|
|
|
2015-07-30 17:59:08 +08:00
|
|
|
-------------------
|
|
|
|
|
|
2015-08-06 21:24:34 +08:00
|
|
|
***note:*** *make sure to run the build command in the root directory and not in the source directory*
|
