You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
NOTE: macOS users will need to install mdbook via cargo since mdbook
does not distribute macOS binaries. See mdbook#installation for more
information.
Build the book
To build the book run the following from the repository's root:
$ mdbook build
The output will be in the build/html/ subdirectory.
Using mdbook watch will build the book automatically each time a Markdown file in the src directory is changed.
View the built book
Open it in your web browser of choice:
Firefox:
$ firefox build/html/index.html # Linux
$ open -a "Firefox" build/html/index.html # OS X
$ Start-Process "firefox.exe" .\build\html\index.html # Windows (PowerShell)
$ start firefox.exe .\build\html\index.html # Windows (Cmd)
Chrome:
$ google-chrome build/html/index.html # Linux
$ open -a "Google Chrome" build/html/index.html # OS X
$ Start-Process "chrome.exe" .\build\html\index.html # Windows (PowerShell)
$ start chrome.exe .\build\html\index.html # Windows (Cmd)
Serving the book locally
When serving the book, pages will automatically be updated when the associated
source files are written to.
You can run mdbook help serve for serve-specific options such as changing
the port used.
Contributing
We'd love your help!
Review in-progress work
Our open pull requests are new chapters or edits that we're currently working
on. We would love if you would read through those and make comments for any
suggestions or corrections!