aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGeckoEidechse <40122905+GeckoEidechse@users.noreply.github.com>2023-10-11 17:33:37 +0200
committerGitHub <noreply@github.com>2023-10-11 17:33:37 +0200
commit8913b2fdcd92d9fc01e9e6086c8506d36b55bc2e (patch)
tree66924433d1ae4a154f5626a06661f65528fba83f
parent7d3cf3969ef2a9c4cd76d631667a2e7b4a3f5741 (diff)
downloadNorthstarWiki-8913b2fdcd92d9fc01e9e6086c8506d36b55bc2e.tar.gz
NorthstarWiki-8913b2fdcd92d9fc01e9e6086c8506d36b55bc2e.zip
Add instructions for running mdbook linkcheck (#238)
* 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
-rw-r--r--README.md9
-rw-r--r--book.toml5
2 files changed, 14 insertions, 0 deletions
diff --git a/README.md b/README.md
index a5b2c9d..bf47242 100644
--- a/README.md
+++ b/README.md
@@ -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)
diff --git a/book.toml b/book.toml
index b788c8a..b4b3256 100644
--- a/book.toml
+++ b/book.toml
@@ -6,3 +6,8 @@ language = "en"
multilingual = false
src = "docs"
title = "Northstar Wiki"
+
+[output.html]
+
+[output.linkcheck]
+optional = true