feat: initial mkdocs-material setup

Signed-off-by: Luke Yue <lukedyue@gmail.com>

Author: dragonJACson

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: MkDocs CI 
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache 
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install mkdocs-material 
+      - run: mkdocs gh-deploy --force

docs/blog/index.md

@@ -0,0 +1,17 @@
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://www.mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs -h` - Print help message and exit.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

docs/index.md

@@ -0,0 +1,27 @@
+site_url: https://rdma-rust.github.io
+repo_url: https://github.com/RDMA-Rust/rdma-rust.github.io
+
+site_name: RDMA-Rust
+
+theme:
+  name: material
+  custom_dir: overrides
+  features:
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - toc.follow
+
+plugins:
+  - blog
+  - search
+  - git-committers:
+      repository: RDMA-Rust/rdma-rust.github.io
+      branch: main
+
+nav:
+  - Home: index.md
+  - Blog:
+    - blog/index.md

mkdocs.yml

@@ -0,0 +1,17 @@
+{% if page.file.src_uri.startswith('blog/posts') %}
+<script src="https://giscus.app/client.js"
+        data-repo="RDMA-Rust/rdma-rust.github.io"
+        data-repo-id="R_kgDON_6MMg"
+        data-category="Announcements"
+        data-category-id="DIC_kwDON_6MMs4CnZhW"
+        data-mapping="title"
+        data-strict="0"
+        data-reactions-enabled="1"
+        data-emit-metadata="1"
+        data-input-position="top"
+        data-theme="preferred_color_scheme"
+        data-lang="en"
+        crossorigin="anonymous"
+        async>
+</script>
+{% endif %}