Add MkDocs configuration and documentation structure

.github/workflows/docs.yml

@@ -0,0 +1,30 @@
+# https://github.com/mhausenblas/mkdocs-template?tab=readme-ov-file
+# https://github.com/marketplace/actions/deploy-mkdocs
+
+name: Publish docs via GitHub Pages
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+
+      - name: Deploy docs
+        uses: mhausenblas/mkdocs-deploy-gh-pages@master
+        # Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          CONFIG_FILE: mkdocs.yml
+          EXTRA_PACKAGES: build-base
+          # CUSTOM_DOMAIN: optionaldomain.com
+          # GITHUB_DOMAIN: github.myenterprise.com
+          # REQUIREMENTS: folder/requirements.txt

README.md

@@ -81,6 +81,8 @@ This template is designed with a primary focus on enabling individuals to set up
     ┃ ┣ 📜Version.h.in
     ┃ ┣ 📜clang-tidy.cmake
     ┃ ┗ 📜cppcheck.cmake
+    ┣ 📦docs
+    ┃ ┣ 📜index.md
     ┣ 📂include
     ┃ ┗ 📂ExampleProject
     ┃ ┃ ┗ 📜Version.h
@@ -95,7 +97,8 @@ This template is designed with a primary focus on enabling individuals to set up
     ┣ 📜.pre-commit-config.yaml
     ┣ 📜CMakeLists.txt
     ┣ 📜LICENSE
-    ┗ 📜README.md
+    ┣ 📜README.md
+    ┗ 📜mkdocs.yml
 ---
 
 ## 🚀 Getting Started
@@ -128,6 +131,6 @@ For any inquiries or support, please contact [email protected]
 ## ✅ TODO
 - [ ] Automatically detect CUDA and CUDA hardware.
 - [ ] ROS2 branch, for ROS2-based packages.
-- [ ] Project documentation template.
+- [x] Project documentation template (using mkdocs).
 - [ ] Option for direct use of Docker image including all major features.
 - [x] Add CI/CD pipeline for automated testing and deployment.

docs/index.md

@@ -0,0 +1,40 @@
+## Sample
+
+One more, finally. Or not? :)
+
+Now:
+
+```
+$ some
+```
+
+Look what she said:
+
+> This is it!
+
+### Subtitle
+
+And now this:
+
+- One
+- Two
+- Three
+
+
+#### As well
+
+#### As this
+
+### Another
+
+[a link](https://aws.com)
+
+More?
+
+
+Can we now have `the build`?
+
+NOW!
+
+
+Not gonna work, is it?

mkdocs.yml

@@ -0,0 +1,10 @@
+site_name: Test docs
+site_description: "A docs test"
+site_author: "timetravelCat"
+docs_dir: docs/
+repo_name: "timetravelCat/UPT"
+repo_url: "https://github.com/timetravelCat/UPT"
+nav:
+  - Home: index.md
+theme:
+  name: "material"