blob: 8018d63c9512686f0f167cae328d12eac0b4a9e0 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
name: Build Docs
on:
push:
branches:
- main
pull_request:
workflow_dispatch:
concurrency:
group: docs-deployment-${{ github.ref }}
cancel-in-progress: true
jobs:
build-deploy:
name: Build & Deploy Docs
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Install Python Dependencies
uses: HassanAbouelela/actions/setup-python@setup-python_v1.0.0
with:
dev: true
python_version: 3.9
# Undeclared dependency for `releases`... whoops
# https://github.com/bitprophet/releases/pull/82
- run: pip install six
- name: Generate AutoDoc References
run: sphinx-apidoc -o docs/output botcore -fe
- name: Generate HTML Site
run: sphinx-build -nW -j auto -b html docs docs/build
- name: Uplaod Build Artifact
uses: actions/upload-artifact@v2
with:
name: docs
path: docs/build/*
- name: Deploy To GitHub Pages
uses: JamesIves/[email protected]
with:
branch: docs
folder: docs/build
# We only want to actually push the build if we're on main, otherwise just make sure everything works
dry-run: ${{ github.ref != 'refs/heads/main' }}
|