Add GitHub actions

Author: ltoenning

.github/workflows/build.yml

@@ -0,0 +1,27 @@
+# SPDX-FileCopyrightText: Copyright (C) swift Project Community / Contributors
+# SPDX-License-Identifier: CC0-1.0
+
+name: Build documentation
+
+on:
+  push:
+    branches:
+      - '**'
+      - '!main'
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Run REUSE lint
+        run: reuse lint
+      - name: Build
+        run: mkdocs build --strict

.github/workflows/deploy.yml

@@ -0,0 +1,44 @@
+# SPDX-FileCopyrightText: Copyright (C) swift Project Community / Contributors
+# SPDX-License-Identifier: CC0-1.0
+
+name: Build and deploy documentation
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Run REUSE lint
+        run: reuse lint
+      - uses: actions/configure-pages@v3
+      - name: Build
+        run: mkdocs build --strict
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v2
+        with:
+          path: "site/"
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-22.04
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v2

mkdocs.yml

@@ -1,7 +1,8 @@
 # SPDX-FileCopyrightText: Copyright (C) swift Project Community / Contributors
 # SPDX-License-Identifier: GFDL-1.3-only
 
-site_name: swift Documentation
+site_name: swift pilot client Documentation
+site_url: https://swift-project.github.io/docs
 
 # repo_url: https://github.com/swift-project/pilotclient
 

requirements.txt

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: Copyright (C) swift Project Community / Contributors
+# SPDX-License-Identifier: CC0-1.0
+
+Babel==2.13.0
+binaryornot==0.4.4
+boolean.py==4.0
+certifi==2023.7.22
+chardet==5.2.0
+charset-normalizer==3.3.0
+click==8.1.7
+colorama==0.4.6
+docopt==0.6.2
+ghp-import==2.1.0
+idna==3.4
+Jinja2==3.1.2
+license-expression==30.1.1
+Markdown==3.5
+MarkupSafe==2.1.3
+mergedeep==1.3.4
+mkdocs==1.5.3
+mkdocs-material==9.4.6
+mkdocs-material-extensions==1.3
+packaging==23.2
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.11.0
+Pygments==2.16.1
+pymdown-extensions==10.3.1
+python-dateutil==2.8.2
+python-debian==0.1.49
+PyYAML==6.0.1
+pyyaml_env_tag==0.1
+regex==2023.10.3
+requests==2.31.0
+reuse==2.1.0
+six==1.16.0
+urllib3==2.0.7
+watchdog==3.0.0
+yarg==0.1.9