Generating the HTML documentation
Prerequisites
- Install mdBook;
- Install mdbook-linkcheck.
HTML Documentation
Build the HTML documentation with:
$ make docs
mdbook build docs
2023-11-05 16:19:04 [INFO] (mdbook::book): Book building has started
2023-11-05 16:19:04 [INFO] (mdbook::book): Running the html backend
The generated website will be located under docs/book/html
.
Live-reload server
Start mdBook
's live-reload server with:
$ make live-docs
mdbook serve docs
2023-11-05 16:19:25 [INFO] (mdbook::book): Book building has started
2023-11-05 16:19:25 [INFO] (mdbook::book): Running the html backend
2023-11-05 16:19:25 [INFO] (mdbook::cmd::serve): Serving on: http://localhost:3000
2023-11-05 16:19:25 [INFO] (mdbook::cmd::watch): Listening for changes...
2023-11-05 16:19:25 [INFO] (warp::server): Server::run; addr=[::1]:3000
2023-11-05 16:19:25 [INFO] (warp::server): listening on http://[::1]:3000
- The generated website will be located under
docs/book/html
; - The live server can be accessed by opening http://localhost:3000 in a Web browser.