New documentation based on mkdocstrings

.github/workflows/ci.yml

@@ -47,9 +47,6 @@ jobs:
         run: |
           cmake -DCMAKE_CXX_FLAGS='-DIMGUI_USE_WCHAR32' .
           cmake --build . -j4
-      - name: Build docs
-        run: |
-          tools/build_docs.sh
       - name: Set up environment
         if: runner.os != 'Windows'
         working-directory: ./cimgui
@@ -68,11 +65,6 @@ jobs:
       - name: Build demo
         run: |
           crystal build --cross-compile examples/demo_sfml.cr
-      - name: Deploy docs to gh-pages
-        if: github.event_name == 'push' && github.ref == 'refs/heads/master' && runner.os == 'Linux'
-        uses: oprypin/push-to-gh-pages@v3
-        with:
-          publish_dir: ./docs
       - name: Check formatting
         if: matrix.crystal == 'latest'
         run: |

.github/workflows/deploy-docs.yml

@@ -0,0 +1,27 @@
+name: Deploy docs
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: '0 6 * * 6'
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download source
+        uses: actions/checkout@v2
+      - name: Install Crystal
+        uses: oprypin/install-crystal@v1
+      - name: Install Python
+        uses: actions/setup-python@v2
+      - name: Install dependencies
+        run: pip install --no-deps -r docs/requirements.txt
+      - name: Build site
+        run: mkdocs build
+      - name: Deploy to gh-pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+        uses: oprypin/push-to-gh-pages@v3
+        with:
+          publish_dir: site
+          commit_message: 'Generate docs: '

.gitignore

@@ -1,4 +1,4 @@
-/docs/
+/site/
 lib/
 /bin/
 /.shards/

docs/css/mkdocstrings.css

@@ -0,0 +1,14 @@
+/* https://mkdocstrings.github.io/crystal/styling.html#recommended-styles */
+
+/* Indent and distinguish sub-items */
+div.doc-contents {
+  padding-left: 15px;
+  border-left: 4px solid rgba(230, 230, 230);
+}
+
+.doc-heading {
+  background-color: var(--md-code-bg-color);
+}
+h4.doc-heading {
+  font-weight: initial;
+}