Re-add fs-summary and toc to pre-processors

Signed-off-by: Danil Grigorev <[email protected]>

Author: Danil-Grigorev

docs/book/Makefile

@@ -22,10 +22,11 @@ TABULATE := $(TOOLS_BIN_DIR)/mdbook-tabulate
 EMBED := $(TOOLS_BIN_DIR)/mdbook-embed
 RELEASELINK := $(TOOLS_BIN_DIR)/mdbook-releaselink
 MDBOOK := $(TOOLS_BIN_DIR)/bin/mdbook
+FS_SUMMARY := $(TOOLS_BIN_DIR)/bin/mdbook-fs-summary
 
 export PATH := $(abspath $(TOOLS_BIN_DIR)/bin):$(PATH)
 
-BOOK_DEPS := $(MDBOOK) $(TABULATE) $(EMBED) $(RELEASELINK)
+BOOK_DEPS := $(MDBOOK) $(TABULATE) $(EMBED) $(RELEASELINK) $(FS_SUMMARY)
 
 $(TOOLS_BIN_DIR)/%: $(TOOLS_DIR_DEPS)
 	make -C $(TOOLS_DIR) $(subst $(TOOLS_DIR)/,,$@)

docs/book/book.toml

@@ -5,6 +5,19 @@ src = "src"
 title = "Cluster API Operator"
 description = "Cluster API Operator"
 
+[preprocessor.toc]
+command = "mdbook-toc"
+marker = "[[_TOC_]]"
+
+[preprocessor.fs-summary]
+# (default: true)
+clean-paths = false
+
+# other preprocessors will naturally need to
+# run after the summary has been generated
+[preprocessor.links]
+after = ["fs-summary"]
+
 [output.html]
 mathjax-support = true
 git-repository-url = "https://github.com/kubernetes-sigs/cluster-api-operator"
@@ -22,4 +35,4 @@ command = "./util-tabulate.sh"
 command = "./util-embed.sh"
 
 [preprocessor.releaselink]
-command = "./util-releaselink.sh"
+command = "./util-releaselink.sh"

scripts/ci-install-mdbook.sh

@@ -30,3 +30,5 @@ curl https://sh.rustup.rs -sSf | sh -s -- -y
 
 # Install mdbook and dependencies
 cargo install mdbook --version "$VERSION" --root "$OUTPUT_PATH"
+cargo install mdbook-fs-summary --root "$OUTPUT_PATH"
+cargo install mdbook-toc --root "$OUTPUT_PATH"