mirror of
https://github.com/ostreedev/ostree.git
synced 2024-12-22 17:35:55 +03:00
49 lines
1.4 KiB
YAML
49 lines
1.4 KiB
YAML
---
|
|
name: Docs
|
|
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
pull_request:
|
|
branches: [main]
|
|
|
|
permissions:
|
|
# This workflow pushes to the gh-pages branch, so the token needs write
|
|
# privileges for repo contents.
|
|
contents: write
|
|
|
|
jobs:
|
|
docs:
|
|
name: Build documentation
|
|
runs-on: ubuntu-latest
|
|
container: registry.ci.openshift.org/coreos/fcos-buildroot:testing-devel
|
|
steps:
|
|
- name: Checkout repository
|
|
uses: actions/checkout@v2
|
|
|
|
- name: GH actions checkout post
|
|
run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
|
|
|
|
# This is taken from ci/travis-install.sh but should probably be
|
|
# refactored.
|
|
- name: Install dependencies
|
|
run: ./ci/installdeps.sh
|
|
|
|
- name: Build API docs and manpages
|
|
run: |
|
|
./autogen.sh --enable-gtk-doc --enable-man --enable-man-html
|
|
make -C apidoc
|
|
make manhtml
|
|
|
|
- name: Build and publish jekyll docs
|
|
uses: helaili/jekyll-action@v2
|
|
with:
|
|
token: ${{ secrets.GITHUB_TOKEN }}
|
|
jekyll_src: docs
|
|
target_branch: gh-pages
|
|
# Only publish when pushing to main.
|
|
# XXX: Maybe this should only run on the release event?
|
|
build_only: ${{ github.ref == 'refs/heads/main' && 'false' || 'true' }}
|
|
# Run the prep script to put the API docs in place.
|
|
pre_build_commands: ./docs/prep-docs.sh
|