Skip to content

docs(guide): bring the Turkish pages level with the English ones #6

docs(guide): bring the Turkish pages level with the English ones

docs(guide): bring the Turkish pages level with the English ones #6

Workflow file for this run

name: Pages
# The documentation site at https://aethrox.github.io/laneward/, built from
# docs/ with MkDocs Material and deployed by this workflow rather than by
# GitHub's own Jekyll build. The site needs plugins (mermaid through
# superfences, the bilingual guide through mkdocs-static-i18n, GitHub-style
# callouts), and none of those exist in the Pages Jekyll environment.
#
# configure-pages runs with `enablement: true` so the first successful run
# turns Pages on by itself. If the repository's Actions permissions refuse
# that, the one-time manual step is Settings -> Pages -> Source: GitHub
# Actions; nothing else in this file changes.
#
# `mkdocs build --strict` is the check: a broken internal link or a nav entry
# pointing at a file that does not exist fails the build rather than shipping a
# 404. There is no separate lint step because that is the lint step.
on:
push:
branches: [master]
paths:
- docs/**
- mkdocs.yml
- scripts/mkdocs_hooks.py
- .github/workflows/pages.yml
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
# One deployment at a time; a queued run supersedes the one waiting, but never
# cancels a deployment already in flight.
concurrency:
group: pages
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
cache: pip
cache-dependency-path: docs/requirements.txt
- run: pip install -r docs/requirements.txt
- run: mkdocs build --strict
- uses: actions/configure-pages@v5
with:
enablement: true
- uses: actions/upload-pages-artifact@v3
with:
path: site
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4