From 78405dfa8a262b3a9ae6cbf9b73cec3e6f58ce3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=B0=D0=BD=D0=B8=D0=B8=D0=BB=20=D0=93=D1=80=D0=B0?=
 =?UTF-8?q?=D0=B1=D0=B0=D1=80=D1=8C?= <grabardm@ml-dev.ru>
Date: Thu, 18 Jun 2026 06:01:48 +0300
Subject: [PATCH] feat: add GitHub Actions workflows for documentation
 deployment and building

---
 .github/workflows/docs.yml   | 43 ++++++++++++++++++++++++++++++++++++
 .gitverse/workflows/docs.yml | 40 +++++++++++++++++++++++++++++++++
 doc/lwc-doc/mkdocs.yml       |  1 +
 3 files changed, 84 insertions(+)
 create mode 100644 .github/workflows/docs.yml
 create mode 100644 .gitverse/workflows/docs.yml

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 0000000..518be92
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,43 @@
+name: Документация
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: write
+
+jobs:
+  deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install system dependencies (WeasyPrint/PDF)
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y \
+            libcairo2 libpango-1.0-0 libpangoft2-1.0-0 \
+            libgdk-pixbuf-2.0-0 libffi-dev \
+            fontconfig fonts-dejavu
+
+      - name: Install MkDocs
+        run: pip install mkdocs-material mkdocs-with-pdf
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force
+        working-directory: doc/lwc-doc
diff --git a/.gitverse/workflows/docs.yml b/.gitverse/workflows/docs.yml
new file mode 100644
index 0000000..40dcea4
--- /dev/null
+++ b/.gitverse/workflows/docs.yml
@@ -0,0 +1,40 @@
+name: Документация
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install system dependencies (WeasyPrint/PDF)
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y \
+            libcairo2 libpango-1.0-0 libpangoft2-1.0-0 \
+            libgdk-pixbuf-2.0-0 libffi-dev \
+            fontconfig fonts-dejavu
+
+      - name: Install MkDocs
+        run: pip install mkdocs-material mkdocs-with-pdf
+
+      - name: Build Documentation
+        run: mkdocs build
+        working-directory: doc/lwc-doc
+
+      - name: Upload site as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-site
+          path: doc/lwc-doc/site/
+          retention-days: 30
diff --git a/doc/lwc-doc/mkdocs.yml b/doc/lwc-doc/mkdocs.yml
index aede180..6f05cf0 100644
--- a/doc/lwc-doc/mkdocs.yml
+++ b/doc/lwc-doc/mkdocs.yml
@@ -1,4 +1,5 @@
 site_name: Документация LWC
+site_url: https://daniel-robotic.github.io/lightweight-cobot/
 site_description: Документация по использованию коллаборативного робота KUKA LBR iiwa 7 и его программированию в среде ROS 2.
 site_author: Даниил Грабарь