add admonishments and pagetoc

Author: wade-cheng

.github/workflows/mdbook.yml

@@ -32,12 +32,13 @@ jobs:
       MDBOOK_VERSION: 0.4.36
     steps:
       - uses: actions/checkout@v4
-      - name: Install mdBook and mdbook-admonish
+      - name: Install mdBook and preprocessors
         run: |
           curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh
           rustup update
           cargo install --version ${MDBOOK_VERSION} mdbook
-          # cargo install mdbook-admonish
+          cargo install mdbook-admonish
+          cargo install mdbook-pagetoc
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5

.gitignore

@@ -1,4 +1,8 @@
 /.idea
 
+# ignored generated pagetoc files from mdbook-pagetoc
+theme/pagetoc.css
+theme/pagetoc.js
+
 # for local testing
 book

book.toml

@@ -4,7 +4,10 @@ language = "en"
 multilingual = false
 src = "src"
 
+[preprocessor.pagetoc]
 [output.html]
+additional-css = ["theme/pagetoc.css"]
+additional-js  = ["theme/pagetoc.js"]
 no-section-label = true
 git-repository-url = "https://github.com/pygame-web/pygame-web.github.io"
 git-repository-icon = "fa-github"