File tree 3 files changed +6
-3
lines changed 3 files changed +6
-3
lines changed Original file line number Diff line number Diff line change @@ -7,7 +7,8 @@ mdbook build
7
7
```
8
8
9
9
It will try to parse your ` SUMMARY.md ` file to understand the structure of your
10
- book and fetch the corresponding files.
10
+ book and fetch the corresponding files. Note that files mentioned in ` SUMMARY.md `
11
+ but not present will be created.
11
12
12
13
The rendered output will maintain the same directory structure as the source for
13
14
convenience. Large books will therefore remain structured when rendered.
Original file line number Diff line number Diff line change @@ -8,7 +8,8 @@ mdbook serve
8
8
```
9
9
10
10
The ` serve ` command watches the book's ` src ` directory for
11
- changes, rebuilding the book and refreshing clients for each change. A websocket
11
+ changes, rebuilding the book and refreshing clients for each change; this includes
12
+ re-creating deleted files still mentioned in ` SUMMARY.md ` ! A websocket
12
13
connection is used to trigger the client-side refresh.
13
14
14
15
*** Note:*** * The ` serve ` command is for testing a book's HTML output, and is not
Original file line number Diff line number Diff line change 3
3
The ` watch ` command is useful when you want your book to be rendered on every
4
4
file change. You could repeatedly issue ` mdbook build ` every time a file is
5
5
changed. But using ` mdbook watch ` once will watch your files and will trigger a
6
- build automatically whenever you modify a file.
6
+ build automatically whenever you modify a file; this includes re-creating
7
+ deleted files still mentioned in ` SUMMARY.md ` !
7
8
8
9
#### Specify a directory
9
10
You can’t perform that action at this time.
0 commit comments