2015-07-30 11:59:08 +02:00
|
|
|
# The build command
|
|
|
|
|
|
|
|
|
|
The build command is used to render your book:
|
|
|
|
|
|
2015-12-29 17:59:08 -05:00
|
|
|
```bash
|
2015-07-30 11:59:08 +02: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-24 22:19:14 +02:00
|
|
|
The rendered output will maintain the same directory structure as the source for
|
2015-07-30 11:59:08 +02:00
|
|
|
convenience. Large books will therefore remain structured when rendered.
|
|
|
|
|
|
|
|
|
|
#### Specify a directory
|
|
|
|
|
|
2015-09-24 22:19:14 +02:00
|
|
|
Like `init`, the `build` command can take a directory as argument to use instead of the
|
2015-07-30 11:59:08 +02:00
|
|
|
current working directory.
|
|
|
|
|
|
2015-12-29 17:59:08 -05:00
|
|
|
```bash
|
2015-07-30 11:59:08 +02:00
|
|
|
mdbook build path/to/book
|
|
|
|
|
```
|
|
|
|
|
|
2017-01-01 09: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 00:11:39 +00:00
|
|
|
#### --dest-dir
|
|
|
|
|
|
|
|
|
|
The `--dest-dir` (`-d`) option allows you to change the output directory for your book.
|
|
|
|
|
|
2015-07-30 11:59:08 +02:00
|
|
|
-------------------
|
|
|
|
|
|
2015-08-06 15:24:34 +02:00
|
|
|
***note:*** *make sure to run the build command in the root directory and not in the source directory*
|
