Skip to content

πŸ“š Documentation builder #144

πŸ“š Documentation builder

πŸ“š Documentation builder #144

Workflow file for this run

name: πŸ“š Documentation builder
concurrency:
group: docs-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true
on:
push:
branches:
- main
paths:
- docs/**
- '.github/workflows/docs-builder.yml'
pull_request:
branches:
- main
paths:
- docs/**
- '.github/workflows/docs-builder.yml'
schedule:
- cron: "30 04 * * *"
workflow_dispatch:
jobs:
datamodel-documentation:
uses: ./.github/workflows/datamodel-create-dumps.yml
build:
needs: datamodel-documentation
runs-on: ubuntu-22.04
steps:
- name: Checkout
uses: actions/checkout@v4
- name: install requirements
working-directory: docs
run: |
pip install -r requirements.txt
sudo apt-get install -y gettext
curl -OL https://github.com/transifex/cli/releases/download/v1.6.10/tx-linux-amd64.tar.gz
tar -xvzf tx-linux-amd64.tar.gz
make gettext
- name: tx pull
if: ${{ github.event.pull_request.head.repo.full_name == 'teksi/district_heating' || github.event_name == 'push' && github.ref == 'refs/heads/main' || github.event_name == 'schedule' }}
env:
TX_TOKEN: ${{ secrets.TX_TOKEN }}
working-directory: docs
run: make transifex_pull
- name: tx push
env:
TX_TOKEN: ${{ secrets.TX_TOKEN }}
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
working-directory: docs
run: make transifex_sync
- name: copy datamodel documentation
uses: actions/download-artifact@v4
with:
name: datamodel-schemaspy
path: docs/_static/datamodel
- name: build documentation
working-directory: docs
run: |
make html
touch build/html/.nojekyll
- uses: actions/upload-artifact@v4
with:
name: documentation
path: docs/build/html
if-no-files-found: error
- name: Deploy πŸš€
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' || github.event_name == 'schedule' }}
uses: JamesIves/github-pages-deploy-action@v4
with:
branch: gh-pages
folder: docs/build/html