mwandGitHub
887fe536d6
* **Remove Python SCSS compiler and development script** - Deleted `compile_scss.py` and `dev.sh` scripts to clean up unused SCSS compilation and local development workflow. - Streamlining project by removing legacy Python-based tooling. Clear shift toward alternative CSS build processes in workflows. * Migrate SCSS compilation to Python-based workflow and simplify Dockerfile - Replaced Node.js SCSS tools with libsass and introduced `scss_watcher.py` for automated SCSS compilation during development. - Updated Dockerfile to use Python-based dependencies and removed redundant npm configuration. - Cleaned up `package.json`, `requirements.txt`, and outdated scripts to streamline the project. - Enhanced development workflow with a lightweight Python-based approach. * Replace `python -m sass` with `pysassc` for SCSS compilation in development scripts * **Refactor and streamline MkDocs workflows, footer, and blog structure** - Removed outdated `deploy-preview-fix.yml` and `deploy-test.yml` workflows for cleanup. - Enhanced `deploy-preview.yml`: - Expanded branch triggers to include `build/**`, `test/**`, and `preview/**`. - Improved `site_url` logic by standardizing URL formatting. - Updated `mkdocs.yml` navigation to use consistent `index.md` file naming. - Simplified footer template to use relative paths for internal links (e.g., `impressum/`, `datenschutz/`). - Adjusted `mkdocs.sh` to ensure SCSS watcher includes `overrides`. - Deleted outdated `Sequential Thinking` blog and branch documentation for better maintenance. * Update to Python 3.13 and streamline MkDocs workflows - Upgraded Dockerfile base image to `python:3.13-slim-bullseye` for consistency with the latest Python version. - Consolidated MkDocs and plugin installation steps in `deploy-preview.yml`. - Replaced Node.js SCSS tools with Python `pysassc` for CSS build process, removing unnecessary npm steps. * Replace `mkdocs-lightbox` with `mkdocs-glightbox` and improve CSS build step in GitHub Actions workflow - Updated `deploy-preview.yml` to switch from `mkdocs-lightbox` to `mkdocs-glightbox` for better compatibility and features. - Enhanced CSS build logic to create the target directory (`docs/assets/css`) if it does not exist, ensuring a smoother workflow execution. * Streamline deploy workflows and enhance CSS build process - Added repository-specific condition to `deploy-live.yml` for improved workflow targeting. - Consolidated MkDocs and plugin installation steps in `deploy-live.yml` to remove redundant tasks. - Enhanced CSS build step to ensure target directory creation (`mkdir -p docs/assets/css`) in both workflows.
76 lines
2.1 KiB
YAML
76 lines
2.1 KiB
YAML
name: MkDocs Preview Deployment
|
|
|
|
on:
|
|
workflow_dispatch: # Allows manual triggering
|
|
push:
|
|
branches:
|
|
- 'feature/**'
|
|
- 'fix/**'
|
|
- 'blog/**'
|
|
- 'build/**'
|
|
- 'test/**'
|
|
- 'preview/**'
|
|
|
|
jobs:
|
|
deploy-preview:
|
|
runs-on: ubuntu-22.04
|
|
permissions:
|
|
contents: write
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.ref }}
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Setup Python
|
|
uses: actions/setup-python@v5
|
|
with:
|
|
python-version: '3.13'
|
|
|
|
- name: Install MkDocs and plugins
|
|
run: |
|
|
pip install --upgrade pip
|
|
pip install \
|
|
cairosvg \
|
|
libsass \
|
|
mkdocs-exclude \
|
|
mkdocs-git-revision-date-localized-plugin \
|
|
mkdocs-glightbox \
|
|
mkdocs-include-markdown-plugin \
|
|
mkdocs-literate-nav \
|
|
mkdocs-macros-plugin \
|
|
mkdocs-material==9.6.14 \
|
|
"mkdocs-material[imaging]" \
|
|
mkdocs-minify-plugin \
|
|
mkdocs-redirects \
|
|
mkdocs-rss-plugin \
|
|
mkdocs-snippets \
|
|
mkdocs-video \
|
|
watchdog
|
|
|
|
- name: Configure site_url for fork preview
|
|
run: |
|
|
# Extract GitHub username and repo name
|
|
GITHUB_USER=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 1)
|
|
REPO_NAME=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 2)
|
|
|
|
# Update site_url in mkdocs.yml for fork preview
|
|
if grep -q "^site_url:" mkdocs.yml; then
|
|
sed -i "s|^site_url:.*|site_url: https://${GITHUB_USER}.github.io/${REPO_NAME}/|" mkdocs.yml
|
|
else
|
|
echo "site_url: https://${GITHUB_USER}.github.io/${REPO_NAME}/" >> mkdocs.yml
|
|
fi
|
|
|
|
echo "Updated mkdocs.yml for preview deployment:"
|
|
cat mkdocs.yml
|
|
|
|
- name: Build css
|
|
run: |
|
|
mkdir -p docs/assets/css
|
|
pysassc overrides/assets/css/custom.scss docs/assets/css/custom.css
|
|
|
|
- name: Build static site
|
|
run: mkdocs build
|
|
|
|
- name: Deploy to GitHub Pages
|
|
run: mkdocs gh-deploy --force
|