Document AStop #5063
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: CI | |
on: [pull_request, push] | |
env: | |
GITHUB_TOKEN: ${{ github.token }} | |
jobs: | |
build-pdf: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
cache: 'pip' | |
- name: Install Python Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Install LaTeX | |
run: | | |
sudo apt-fast -y update | |
sudo apt-fast install -y texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra latexmk texlive-lang-greek texlive-luatex texlive-xetex texlive-fonts-extra dvipng librsvg2-bin | |
- name: Build PDF | |
run: | | |
make latexpdf | |
- name: Archive PDF | |
uses: actions/upload-artifact@v4 | |
with: | |
name: frc-docs-pdf | |
path: build/latex/firstroboticscompetition.pdf | |
if-no-files-found: error | |
build-html: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
cache: 'pip' | |
- name: Install Python Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Install librsvg2 | |
run: | | |
sudo apt-fast -y update | |
sudo apt-fast install -y librsvg2-bin | |
- name: Build HTML | |
run: | | |
make html | |
- name: Archive HTML | |
uses: actions/upload-artifact@v4 | |
with: | |
name: frc-docs-html | |
path: build/html/ | |
if-no-files-found: error | |
build-html-translation: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
repository: wpilibsuite/frc-docs-translations | |
- name: Delete old submodule | |
run: | | |
rm -rf ./frc-docs | |
- uses: actions/checkout@v4 | |
with: | |
path: frc-docs | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
cache: 'pip' | |
- name: Install Python Dependencies | |
run: | | |
pip install -r frc-docs/source/requirements.txt | |
- name: Install librsvg2 | |
run: | | |
sudo apt-fast -y update | |
sudo apt-fast install -y librsvg2-bin | |
- name: Build HTML | |
run: | | |
sphinx-build -D language=es -b html . _build/html | |
link-check-diff: | |
# This job is sourced from https://github.com/aiven/devportal/blob/main/.github/workflows/linkcheck-changed-files.yaml | |
# It is CC 4.0 I licensed: https://creativecommons.org/licenses/by/4.0/ | |
# Changes have been made. | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
fetch-depth: 0 | |
- name: Get changed files | |
id: changed-files | |
uses: tj-actions/changed-files@v41 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
- name: Install Dependencies | |
run: pip install -r source/requirements.txt | |
- name: Run linkcheck on .rst files | |
run: | | |
for file in ${{ steps.changed-files.outputs.all_changed_files }}; do | |
if [ "${file: -4}" == ".rst" ] | |
then | |
var="$var $file" | |
fi | |
done | |
if [ -z "$var" ] | |
then | |
echo "No *.rst changed files to check." | |
else | |
make BUILDER_ARGS="$var" linkcheck | |
fi | |
check-linting: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
- name: Install Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Check Lint | |
run: | | |
make lint | |
check-image-size: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
- name: Install Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Check Image Size | |
run: | | |
make sizecheck | |
check-spelling: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- name: misspell | |
uses: reviewdog/action-misspell@v1 | |
with: | |
locale: "US" | |
reporter: "github-check" | |
fail_on_error: "true" | |
check-redirects: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- name: Checkout main | |
run: | | |
git fetch origin main --depth=1 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
- name: Install Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Check redirects | |
run: | | |
make rediraffecheckdiff | |
- name: Check redirects format | |
run: | | |
[[ $(<source/redirects.txt) == $(git show origin/main:source/redirects.txt)* ]] || { echo "Error: redirects.txt can only be appended to. Lines cannot be modified or deleted."; exit 1; } | |
check-formatting: | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v4 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: 3.9 | |
- name: Install Python Dependencies | |
run: | | |
pip install -r source/requirements.txt | |
- name: Format | |
run: | | |
black --check . |