Fix/local development (#101)

* **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.
This commit is contained in:
mw
2025-06-02 14:03:20 +02:00
committed by GitHub
parent 4afa183364
commit 887fe536d6
15 changed files with 205 additions and 721 deletions
+43 -12
View File
@@ -1,12 +1,43 @@
FROM squidfunk/mkdocs-material:9.6.14
RUN pip install mkdocs-macros-plugin
RUN pip install mkdocs-glightbox
RUN pip install mkdocs-include-markdown-plugin
RUN pip install mkdocs-video
RUN pip install mkdocs-rss-plugin
RUN pip install mkdocs-snippets
RUN pip install mkdocs-exclude
RUN pip install mkdocs-git-revision-date-localized-plugin
RUN pip install mkdocs-redirects
RUN pip install mkdocs-literate-nav
RUN pip install mkdocs-minify-plugin
# Use a Python image based on Debian (Ubuntu is derived from Debian)
FROM python:3.13-slim-bullseye
# Set the working directory inside the container
WORKDIR /docs
# Set locale to avoid potential issues with C/C++ libraries
ENV LANG C.UTF-8
ENV LC_ALL C.UTF-8
# Install system dependencies and Python packages in a single layer
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential \
curl \
git \
libcairo2 \
libffi-dev \
libgdk-pixbuf2.0-0 \
libpango-1.0-0 \
libpangocairo-1.0-0 \
shared-mime-info \
&& rm -rf /var/lib/apt/lists/* \
&& pip install --no-cache-dir \
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
# No need for WORKDIR /docs or COPY package.json ./ or npm install related steps anymore
# as we're using libsass and not Node.js/npm.