Skip to content

Commit

Permalink
Add instructions for running mdbook linkcheck (#238)
Browse files Browse the repository at this point in the history
* Update config to support linkcheck

Allows checking if all relative links inside the mdBook are valid.
Especially useful for ensuring updated links when moving content around.


* Add section explaining link check to readme
  • Loading branch information
GeckoEidechse authored Oct 11, 2023
1 parent 7d3cf39 commit 8913b2f
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 0 deletions.
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,12 @@ To install mdBook use the following link if:

- [you have Rust toolchain installed](https://rust-lang.github.io/mdBook/guide/installation.html#build-from-source-using-rust)
- [you **DON'T** have Rust toolchain installed](https://rust-lang.github.io/mdBook/guide/installation.html#pre-compiled-binaries)

#### mdBook-linkcheck
Additionally there's a community-made package that you can use alongside mdBook to show you some potentially broken links in markdown files called [mdBook-linkcheck](https://github.com/Michael-F-Bryan/mdbook-linkcheck)

Although not required, you may find it helpful to use alongside mdBook to ensure you've linked things properly

To install mdBook-linkcheck use the following link if:
- [you have Rust toolchain installed](https://github.com/Michael-F-Bryan/mdbook-linkcheck#getting-started)
- [you DON'T have Rust toolchain installed](https://github.com/Michael-F-Bryan/mdbook-linkcheck/releases/latest) (add `mdBook-linkcheck.exe` to the same folder `mdBook.exe` is located)
5 changes: 5 additions & 0 deletions book.toml
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,8 @@ language = "en"
multilingual = false
src = "docs"
title = "Northstar Wiki"

[output.html]

[output.linkcheck]
optional = true

0 comments on commit 8913b2f

Please sign in to comment.