mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-19 00:41:43 +00:00
d27ed3722b
This sets the workflow concurrency to 1 for all workflows. For PRs this means if you push an additional commit older jobs will be cancelled. The documentation workflow already only runs on tags or merges to main. For this, we cancel previous runs if they are to the same destination (tag or main) but still prevent 2 jobs from running at once if they are spawned from different refs.
66 lines
2.3 KiB
YAML
66 lines
2.3 KiB
YAML
name: Documentation
|
|
|
|
on: [push, workflow_dispatch]
|
|
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.ref }}
|
|
cancel-in-progress: true
|
|
|
|
env:
|
|
BASE_PATH: allwpilib/docs
|
|
|
|
jobs:
|
|
publish:
|
|
name: "Documentation - Publish"
|
|
runs-on: ubuntu-latest
|
|
if: github.repository_owner == 'wpilibsuite' && (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v'))
|
|
concurrency: ci-docs-publish
|
|
steps:
|
|
- uses: actions/checkout@v2
|
|
with:
|
|
fetch-depth: 0
|
|
persist-credentials: false
|
|
- uses: actions/setup-java@v1
|
|
with:
|
|
java-version: 13
|
|
- name: Install libclang-9
|
|
run: sudo apt update && sudo apt install -y libclang-cpp9 libclang1-9
|
|
- name: Set environment variables (Development)
|
|
run: |
|
|
echo "TARGET_FOLDER=$BASE_PATH/development" >> $GITHUB_ENV
|
|
if: github.ref == 'refs/heads/main'
|
|
- name: Set environment variables (Tag)
|
|
run: |
|
|
echo "EXTRA_GRADLE_ARGS=-PreleaseMode" >> $GITHUB_ENV
|
|
echo "TARGET_FOLDER=$BASE_PATH/beta" >> $GITHUB_ENV
|
|
if: startsWith(github.ref, 'refs/tags/v')
|
|
- name: Set environment variables (Release)
|
|
run: |
|
|
echo "EXTRA_GRADLE_ARGS=-PreleaseMode" >> $GITHUB_ENV
|
|
echo "TARGET_FOLDER=$BASE_PATH/release" >> $GITHUB_ENV
|
|
if: startsWith(github.ref, 'refs/tags/v') && !contains(github.ref, 'alpha') && !contains(github.ref, 'beta')
|
|
- name: Build with Gradle
|
|
run: ./gradlew docs:generateJavaDocs docs:doxygen -PbuildServer ${{ env.EXTRA_GRADLE_ARGS }}
|
|
- name: Install SSH Client 🔑
|
|
uses: webfactory/ssh-agent@v0.4.1
|
|
with:
|
|
ssh-private-key: ${{ secrets.GH_DEPLOY_KEY }}
|
|
- name: Deploy Java 🚀
|
|
uses: JamesIves/github-pages-deploy-action@3.7.1
|
|
with:
|
|
SSH: true
|
|
REPOSITORY_NAME: wpilibsuite/wpilibsuite.github.io
|
|
BRANCH: main
|
|
CLEAN: true
|
|
FOLDER: docs/build/docs/javadoc
|
|
TARGET_FOLDER: ${{ env.TARGET_FOLDER }}/java
|
|
- name: Deploy C++ 🚀
|
|
uses: JamesIves/github-pages-deploy-action@3.7.1
|
|
with:
|
|
SSH: true
|
|
REPOSITORY_NAME: wpilibsuite/wpilibsuite.github.io
|
|
BRANCH: main
|
|
CLEAN: true
|
|
FOLDER: docs/build/docs/doxygen/html
|
|
TARGET_FOLDER: ${{ env.TARGET_FOLDER }}/cpp
|