Files
histogram/.github/workflows/doc.yml
2025-06-12 21:19:03 +02:00

66 lines
1.9 KiB
YAML

name: Documentation
on:
pull_request:
branches:
- master
- develop
paths-ignore:
- '.github/workflows/cov.yml'
- '.github/workflows/fast.yml'
- '.github/workflows/slow.yml'
- 'tools/**'
- '*.md'
concurrency:
group: ${{ github.workflow }}-${{ github.head_ref }}
cancel-in-progress: true
jobs:
gcc:
runs-on: ubuntu-latest
steps:
- uses: actions/setup-python@v5
with:
python-version: '3.12'
- name: Install docbook dependencies
run: |
sudo apt-get update
sudo apt-get install -y docbook-xsl docbook-xml xsltproc doxygen
- name: Create user-config.jam
run: |
echo "using xsltproc ;" > $HOME/user-config.jam
echo "using boostbook : /usr/share/xml/docbook/stylesheet/nwalsh : /usr/share/xml/docbook/schema/dtd/4.2 ;" >> $HOME/user-config.jam
echo "using doxygen : /usr/bin/doxygen ;" >> $HOME/user-config.jam
echo "using python : 3.12 : /usr/bin/python3 ; " >> $HOME/user-config.jam
- uses: actions/checkout@v4
- name: Fetch Boost superproject
run: |
cd ..
git clone -b $GITHUB_BASE_REF --depth 5 https://github.com/boostorg/boost.git
cd boost
mv -f $GITHUB_WORKSPACE/* libs/histogram
git submodule update --init --depth 5 tools/build tools/boostdep tools/quickbook tools/boostbook
python tools/boostdep/depinst/depinst.py --git_args "--depth 5 --jobs 3" histogram
python tools/boostdep/depinst/depinst.py --git_args "--depth 5 --jobs 3" ../tools/quickbook
mv -f * $GITHUB_WORKSPACE
- name: Prepare b2
run: ./bootstrap.sh
- name: Build documentation
run: |
cd libs/histogram
../../b2 doc
- name: Upload documentation
uses: actions/upload-artifact@v4
with:
name: histogram-docs
path: libs/histogram/doc/html
if-no-files-found: error