Faq code subsections

README.md

@@ -7,7 +7,7 @@ An online version of the book is available at [godot-rust.github.io/book/](https
 The book is built with [mdBook](https://github.com/rust-lang-nursery/mdBook). To build the book locally, you can run:
 
 ```
-$ cargo install mdbook
+$ cargo install mdbook mdbook-toc
 $ mdbook build
 ```
 

book.toml

@@ -3,3 +3,8 @@ authors = ["The godot-rust developers"]
 multilingual = false
 src = "src"
 title = "The godot-rust Book"
+
+[preprocessor.toc]
+max-level = 2
+command = "mdbook-toc"
+renderer = ["html"]

src/faq/code.md

@@ -1,5 +1,8 @@
 # FAQ: Common code questions
 
+## Table of contents
+<!-- toc -->
+
 ## What is the `BorrowFailed` error and why do I keep getting it?
 
 In Rust, [there can only be *one* `&mut` reference to the same memory location at the same time](https://docs.rs/dtolnay/0.0.9/dtolnay/macro._02__reference_types.html). To enforce this while making simple use cases easier, the bindings make use of [interior mutability](https://doc.rust-lang.org/book/ch15-05-interior-mutability.html). This works like a lock: whenever a method with `&mut self` is called, it will try to obtain a lock on the `self` value, and hold it *until it returns*. As a result, if another method that takes `&mut self` is called in the meantime for whatever reason (e.g. signals), the lock will fail and an error (`BorrowFailed`) will be produced.

src/faq/community.md

@@ -1,5 +1,8 @@
 # FAQ: Community
 
+## Table of contents
+<!-- toc -->
+
 ## I need help, where can I ask?
 
 The godot-rust project uses several different sources for different kinds of information.

src/faq/configuration.md

@@ -1,5 +1,8 @@
 # FAQ: Configuration
 
+## Table of contents
+<!-- toc -->
+
 ## How do I create the library file for my GDNative binary?
 
 You can create .gdnlib files with either of the following methods.

src/faq/godot4.md

@@ -1,5 +1,8 @@
 # FAQ: Godot 4.0 Status
 
+## Table of contents
+<!-- toc -->
+
 ## What is the status of Godot 4 Support?
 
 Currently we are still in the planning phase of determining how to support Godot 4.0 and where we will focus our efforts in the future.

src/faq/multithreading.md

@@ -1,5 +1,8 @@
 # FAQ: Multithreading
 
+## Table of contents
+<!-- toc -->
+
 ## How do I use multithreading?
 
 Follow [Godot's thread safety guidelines](https://docs.godotengine.org/en/stable/tutorials/threads/index.html) and change your settings to "Multi-threaded" in "Project Settings > Rendering > Threading".

src/faq/support.md

@@ -1,5 +1,8 @@
 # FAQ: Versioning and supported platforms
 
+## Table of contents
+<!-- toc -->
+
 ## What does godot-rust's version mean?
 
 godot-rust follows [Cargo's semantic versioning](https://doc.rust-lang.org/cargo/reference/semver.html) for the API breaking changes.