blob: 3cdf3579809bc3c9a99214b8d206bc84119745ca (
plain)
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
52
53
54
55
56
57
58
59
60
|
name: Generate Doxygen Documentation
on:
push:
branches: [master]
workflow_dispatch:
permissions:
contents: write
pages: write
id-token: write
jobs:
generate-docs:
runs-on: ubuntu-latest
steps:
- name: Checkout Repository
uses: actions/checkout@v4
- name: Install Doxygen and Graphviz
run: |
sudo apt-get update
sudo apt-get install -y doxygen graphviz
- name: Prepare Doxygen Awesome CSS and JS
run: |
mkdir -p docs/css docs/js
wget https://cdn.jsdelivr.net/gh/jothepro/doxygen-awesome-css@v2.3.4/doxygen-awesome.css -O docs/css/doxygen-awesome.css
wget https://cdn.jsdelivr.net/gh/jothepro/doxygen-awesome-css@v2.3.4/doxygen-awesome-darkmode-toggle.js -O docs/js/doxygen-awesome-darkmode-toggle.js
- name: Create and Configure Doxyfile
run: |
doxygen -g
# Update Doxyfile configuration
echo "PROJECT_NAME = fbgl" >> Doxyfile
echo "PROJECT_NUMBER = 0.1.0" >> Doxyfile
echo "OUTPUT_DIRECTORY = docs" >> Doxyfile
echo "INPUT = fbgl.h README.md" >> Doxyfile
echo "HTML_OUTPUT = html" >> Doxyfile
echo "USE_MDFILE_AS_MAINPAGE = README.md" >> Doxyfile
# Doxygen Awesome theme configurations
echo "GENERATE_TREEVIEW = YES" >> Doxyfile
echo "FULL_SIDEBAR = NO" >> Doxyfile
echo "HTML_COLORSTYLE = LIGHT" >> Doxyfile
echo "DISABLE_INDEX = NO" >> Doxyfile
echo "HTML_DYNAMIC_SECTIONS = YES" >> Doxyfile
# Local CSS and JS paths
echo "HTML_EXTRA_STYLESHEET = docs/css/doxygen-awesome.css" >> Doxyfile
echo "HTML_EXTRA_FILES = docs/js/doxygen-awesome-darkmode-toggle.js" >> Doxyfile
- name: Generate Documentation
run: doxygen Doxyfile
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_branch: gh-pages
publish_dir: docs/html
force_orphan: true
|
