@@ -44,6 +44,9 @@ concurrency:
4444
4545jobs :
4646 doc-build-and-publish :
47+ env :
48+ ARCHIVE : " addon-serial_modem-${{inputs.documentation_tag}}.zip"
49+
4750 runs-on : ubuntu-latest
4851
4952 permissions :
@@ -69,49 +72,21 @@ jobs:
6972 sudo tar xf doxygen-${DOXYGEN_VERSION}.linux.bin.tar.gz -C /opt
7073 echo "/opt/doxygen-${DOXYGEN_VERSION}/bin" >> $GITHUB_PATH
7174
72- - name : Compute documentation tag
73- id : doc_meta
74- run : |
75- # Manual dispatch honors `documentation_tag`; otherwise derive from ref / event.
76- DOCUMENTATION_TAG='${{ inputs.documentation_tag || '' }}'
77-
78- VERSION_REGEX='^v([0-9a-zA-Z\.\-]+)$'
79- if [[ -z "$DOCUMENTATION_TAG" ]] && [[ ${GITHUB_REF#refs/tags/} =~ $VERSION_REGEX ]]; then
80- DOCUMENTATION_TAG="${BASH_REMATCH[1]}"
81- fi
82-
83- if [[ -z "$DOCUMENTATION_TAG" ]] && [[ ${GITHUB_REF#refs/heads/} == "main" ]]; then
84- DOCUMENTATION_TAG="latest"
85- fi
86-
87- if [[ -z "$DOCUMENTATION_TAG" ]] && [[ "${{ github.event_name }}" == "pull_request" ]]; then
88- DOCUMENTATION_TAG="PR-${{ github.event.pull_request.number }}"
89- fi
90-
91- if [[ -z "$DOCUMENTATION_TAG" ]]; then
92- DOCUMENTATION_TAG="latest"
93- fi
94-
95- echo "documentation_tag=${DOCUMENTATION_TAG}" >> "$GITHUB_OUTPUT"
96- echo "DOCUMENTATION_TAG=${DOCUMENTATION_TAG}" >> "$GITHUB_ENV"
97- ARCHIVE_NAME="addon-serial_modem-${DOCUMENTATION_TAG}.zip"
98- echo "ARCHIVE_NAME=${ARCHIVE_NAME}" >> "$GITHUB_ENV"
99-
10075 - name : Build documentation
10176 working-directory : doc
10277 run : |
10378 doxygen
10479 sphinx-build -M html . build
10580
10681 cp custom.properties build/html
107- sed -i 's/__VERSION__/'"${DOCUMENTATION_TAG }"'/g' build/html/custom.properties
82+ sed -i 's/__VERSION__/'"${{inputs.documentation_tag} }"'/g' build/html/custom.properties
10883
10984 cp tags.yml build/html
110- sed -i 's/__VERSION__/'"${DOCUMENTATION_TAG }"'/g' build/html/tags.yml
85+ sed -i 's/__VERSION__/'"${{inputs.documentation_tag} }"'/g' build/html/tags.yml
11186
11287 cd build/html
11388
114- zip -rq "${ARCHIVE_NAME }" .
89+ zip -rq "${{env.ARCHIVE} }" .
11590 ls -lah .
11691 pwd
11792
@@ -122,18 +97,17 @@ jobs:
12297 if-no-files-found : error
12398 retention-days : 2
12499 path : |
125- doc/build/html/${{ env.ARCHIVE_NAME }}
100+ doc/build/html/${{env.ARCHIVE }}
126101
127102 - name : Check version
128103 run : |
129- # Align with `monitor_*.txt` field 3 and doc-publish `OUTDIR` awk pattern.
130104 VERSION_REGEX="^v([0-9a-zA-Z\.\-]+)$"
131105 if [[ ${GITHUB_REF#refs/tags/} =~ $VERSION_REGEX ]]; then
132106 VERSION=${BASH_REMATCH[1]}
133107 elif [[ ${GITHUB_REF#refs/heads/} == "main" ]]; then
134108 VERSION="latest"
135109 elif [[ "${{ github.event_name }}" == "pull_request" ]]; then
136- VERSION="PR -${{ github.event.number }}"
110+ VERSION="pr -${{ github.event.number }}"
137111 fi
138112 echo "VERSION=${VERSION}"
139113 echo "VERSION=${VERSION}" >> "$GITHUB_ENV"
0 commit comments