36 lines
920 B
YAML
36 lines
920 B
YAML
name: Generate HTML docs
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
paths:
|
|
- "docs/fish-config.md"
|
|
|
|
jobs:
|
|
build-html-docs:
|
|
runs-on: preferred
|
|
steps:
|
|
- name: Checkout
|
|
uses: actions/checkout@v4
|
|
with:
|
|
token: ${{ secrets.GITEA_TOKEN }}
|
|
|
|
- name: Install pandoc
|
|
run: sudo apt-get update -qq && sudo apt-get install -y pandoc
|
|
|
|
- name: Generate chunked HTML docs
|
|
run: |
|
|
pandoc -f gfm -t chunkedhtml --split-level=1 --toc -V toc=true \
|
|
docs/fish-config.md \
|
|
-o docs/html/
|
|
|
|
- name: Commit HTML docs
|
|
run: |
|
|
git config user.name "Gitea Actions"
|
|
git config user.email "actions@gitea"
|
|
git add docs/html/
|
|
git diff --cached --quiet && echo "No changes to commit" && exit 0
|
|
git commit -m "chore(docs): regenerate offline HTML docs"
|
|
git push
|