Merge pull request #363 from Kijewski/pr-api-on-rtd

Add bleeding edge API documentation to rtd

Author: GuillaumeGomez

.readthedocs.yaml

@@ -6,6 +6,7 @@ build:
   os: ubuntu-lts-latest
   tools:
     python: "3.12"
+    rust: "latest"
   commands:
     # Generate "book/theme/index.hbs" as "skeleton" of the generated pages.
     - book/update-theme.py
@@ -18,3 +19,8 @@ build:
     - cat book/ethicalads-theme.css >> $READTHEDOCS_OUTPUT/html/css/general.css
     # We are done!
     - cp book/404.html $READTHEDOCS_OUTPUT/html
+
+    # Build and copy the API docs
+    - cargo install cargo-docs-rs
+    - RUSTC_BOOTSTRAP=1 cargo docs-rs -p askama
+    - cp -a -r -t $READTHEDOCS_OUTPUT/html/ target/x86_64-unknown-linux-gnu/doc/

book/.gitignore

@@ -1,2 +1,3 @@
-book
-.sass-cache
+/book
+/.sass-cache
+/src/doc

book/src/SUMMARY.md

@@ -11,3 +11,4 @@
 - [Web-frameworks](./frameworks.md)
 - [Performance](./performance.md)
 - [Upgrading](./upgrading.md)
+- [API documentation](./doc/askama/index.html)