use mdbook-legacy as a workaround for compatibility issues

Ref: #840
Ref: #841

Author: classabbyamp

.github/workflows/ci.yaml

@@ -51,7 +51,7 @@ jobs:
         run: |
           xbps-install -Syu || xbps-install -Syu xbps
           xbps-install -yu
-          xbps-install -y mdbook-linkcheck bash git
+          xbps-install -y mdBook-legacy mdbook-linkcheck bash git
       - name: Checkout
         id: checkout
         uses: classabbyamp/treeless-checkout-action@v1

CONTRIBUTING.md

@@ -327,7 +327,7 @@ You can then edit the repository files as appropriate.
 
 ### Making changes
 
-To serve the docs locally and view your changes, run `mdbook serve` from the
+To serve the docs locally and view your changes, run `mdbook-legacy serve` from the
 root of the repository.
 
 Once you're satisfied with your changes, run the `check.sh` script provided in

Makefile

@@ -1,5 +1,6 @@
 PREFIX := /usr/local
 
+MDBOOK := /usr/bin/mdbook-legacy
 SOURCES = $(shell find src -not -path 'src/theme*' -type f -name '*.md')
 MANPAGES = $(subst src/,book/mandoc/,$(patsubst %.md,%.7,$(SOURCES)))
 UTILS = book/void-docs book/void-docs.1
@@ -25,7 +26,7 @@ $(UTILS): book/%: res/%.in book
 	sed -e "s,@PREFIX@,$(PREFIX)," $< >$@
 
 void-book: $(SOURCES) book/typst/handbook-cover.svg
-	mdbook build
+	$(MDBOOK) build
 
 book/typst/handbook-cover.svg: res/handbook-cover.svg book/typst
 	cp -a $< $@

README.md

@@ -10,7 +10,7 @@ the same protocol as the packages tree. For details, please read
 The `Makefile` builds HTML, roff and PDF versions of the Void documentation and
 the `void-docs.1` man page. It requires the following Void packages:
 
-- `mdBook`
+- `mdBook-legacy`
 - `findutils`
 - `lowdown` (version 0.8.1 or greater)
 - `mdbook-typst`

check.sh

@@ -60,9 +60,9 @@ fi
 
 vmdfmt -l -w src/
 
-if command -v mdbook >/dev/null 2>&1; then
+if command -v mdbook-legacy >/dev/null 2>&1; then
     echo "Building book and checking links with mdbook ..."
-    mdbook build
+    mdbook-legacy build
 else
     echo "Checking links with mdbook-linkcheck ..."
     mdbook-linkcheck -s