|
8 | 8 | push:
|
9 | 9 | branches: [ main ]
|
10 | 10 |
|
11 |
| -jobs: |
12 |
| - release-context: |
13 |
| - runs-on: ubuntu-latest |
14 |
| - outputs: |
15 |
| - version-name: ${{ github.ref_name }} |
16 |
| - is-latest: ${{ steps.compare-tags.outputs.is-latest }} |
17 |
| - steps: |
18 |
| - - uses: joutvhu/get-release@v1 |
19 |
| - id: latest-release |
20 |
| - with: |
21 |
| - latest: true |
22 |
| - throwing: false |
23 |
| - env: |
24 |
| - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} |
25 |
| - - name: Compare tags |
26 |
| - id: compare-tags |
27 |
| - env: |
28 |
| - REF_TYPE: ${{ github.ref_type }} |
29 |
| - REF_NAME: ${{ github.ref_name }} |
30 |
| - LATEST_TAG: ${{ steps.latest-release.outputs.tag_name }} |
31 |
| - run: | |
32 |
| - if [ "${REF_TYPE}" == 'tag' ] && [ "${REF_NAME}" == "${LATEST_TAG}" ]; then |
33 |
| - echo 'is-latest=true' >> "${GITHUB_OUTPUT}" |
34 |
| - else |
35 |
| - echo 'is-latest=false' >> "${GITHUB_OUTPUT}" |
36 |
| - fi |
37 |
| -
|
38 |
| - spm-context: |
39 |
| - runs-on: ubuntu-latest |
40 |
| - outputs: |
41 |
| - package-dump: ${{ steps.dump-package.outputs.package-dump }} |
42 |
| - steps: |
43 |
| - - uses: swift-actions/setup-swift@v1.24.0 |
44 |
| - with: |
45 |
| - swift-version: '5.8' |
46 |
| - - uses: actions/checkout@v4 |
47 |
| - # We don't use a cache here, because SPM doesn't resolve dependencies when dumping packages. |
48 |
| - - name: Dump package |
49 |
| - id: dump-package |
50 |
| - run: | |
51 |
| - delimiter="$(openssl rand -hex 8)" |
52 |
| - echo "package-dump<<${delimiter}" >> "${GITHUB_OUTPUT}" |
53 |
| - swift package dump-package >> "${GITHUB_OUTPUT}" |
54 |
| - echo "${delimiter}" >> "${GITHUB_OUTPUT}" |
| 11 | +permissions: |
| 12 | + contents: write |
55 | 13 |
|
56 |
| - generate-docs: |
57 |
| - needs: |
58 |
| - - release-context |
59 |
| - - spm-context |
60 |
| - runs-on: ubuntu-latest |
61 |
| - strategy: |
62 |
| - matrix: |
63 |
| - target: ${{ fromJson(needs.spm-context.outputs.package-dump).products.*.targets.* }} |
64 |
| - steps: |
65 |
| - - uses: swift-actions/setup-swift@v1.24.0 |
66 |
| - id: swift-setup |
67 |
| - with: |
68 |
| - swift-version: '5.8' |
69 |
| - - name: Read OS Version |
70 |
| - uses: sersoft-gmbh/os-version-action@v3 |
71 |
| - id: os-version |
72 |
| - - uses: actions/checkout@v4 |
73 |
| - - uses: actions/cache@v3 |
74 |
| - with: |
75 |
| - path: .build |
76 |
| - key: ${{ runner.os }}-${{ steps.os-version.outputs.version }}-spm-${{ steps.swift-setup.outputs.version }}-${{ hashFiles('**/Package.resolved') }} |
77 |
| - restore-keys: | |
78 |
| - ${{ runner.os }}-${{ steps.os-version.outputs.version }}-spm-${{ steps.swift-setup.outputs.version }}- |
79 |
| - - uses: sersoft-gmbh/swifty-docs-action@v3 |
80 |
| - env: |
81 |
| - ENABLE_DOCC_SUPPORT: '1' |
82 |
| - DOCC_JSON_PRETTYPRINT: 'YES' |
83 |
| - with: |
84 |
| - package-version: ${{ needs.release-context.outputs.version-name }} |
85 |
| - targets: ${{ matrix.target }} |
86 |
| - enable-inherited-docs: true |
87 |
| - enable-index-building: false |
88 |
| - transform-for-static-hosting: true |
89 |
| - hosting-base-path: ${{ github.event.repository.name }}/${{ needs.release-context.outputs.version-name }} |
90 |
| - output: ${{ matrix.target }}-docs |
91 |
| - - name: Package docs |
92 |
| - env: |
93 |
| - TARGET: ${{ matrix.target }} |
94 |
| - run: tar -cvf "${TARGET}-docs.tar" "${TARGET}-docs" |
95 |
| - - uses: actions/upload-artifact@v3 |
96 |
| - with: |
97 |
| - name: ${{ matrix.target }}-docs |
98 |
| - path: ${{ matrix.target }}-docs.tar |
| 14 | +concurrency: |
| 15 | + group: ${{ github.ref }} |
| 16 | + cancel-in-progress: true |
99 | 17 |
|
100 |
| - publish-docs: |
101 |
| - needs: |
102 |
| - - release-context |
103 |
| - - spm-context |
104 |
| - - generate-docs |
105 |
| - runs-on: ubuntu-latest |
106 |
| - steps: |
107 |
| - - uses: actions/checkout@v4 |
108 |
| - with: |
109 |
| - ref: gh-pages |
110 |
| - path: repository |
111 |
| - - uses: actions/download-artifact@v3 |
112 |
| - with: |
113 |
| - path: artifacts |
114 |
| - - name: Extract tars |
115 |
| - run: find artifacts -name '*.tar' -execdir tar -xvf '{}' --strip-components 1 \; -delete |
116 |
| - - name: Merge documentations |
117 |
| - env: |
118 |
| - TARGETS: ${{ join(fromJson(needs.spm-context.outputs.package-dump).products.*.targets.*, ' ') }} |
119 |
| - DOCS_BASE_DIR: repository/${{ needs.release-context.outputs.version-name }} |
120 |
| - run: | |
121 |
| - rm -rf "${DOCS_BASE_DIR}" |
122 |
| - is_first=1 |
123 |
| - for target in $TARGETS; do |
124 |
| - if [ $is_first -eq 1 ]; then |
125 |
| - echo "Copying initial documentation for ${target}" |
126 |
| - cp -R "artifacts/${target}-docs" "${DOCS_BASE_DIR}" |
127 |
| - is_first=0 |
128 |
| - else |
129 |
| - echo "Merging documentation for ${target}" |
130 |
| - cp -R "artifacts/${target}-docs/data/documentation/"* "${DOCS_BASE_DIR}/data/documentation/" |
131 |
| - cp -R "artifacts/${target}-docs/documentation/"* "${DOCS_BASE_DIR}/documentation/" |
132 |
| - fi |
133 |
| - done |
134 |
| - echo "Deleting non-mergable metadata.json" |
135 |
| - rm -f "${DOCS_BASE_DIR}/metadata.json" |
136 |
| - - name: Create version index |
137 |
| - working-directory: repository |
138 |
| - env: |
139 |
| - TARGET_DOCS_DIR: ${{ needs.release-context.outputs.version-name }}/documentation |
140 |
| - INDEX_FILE: ${{ needs.release-context.outputs.version-name }}/index.html |
141 |
| - BASE_URL: 'https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/${{ needs.release-context.outputs.version-name }}/documentation' |
142 |
| - REPO_NAME: ${{ github.event.repository.name }} |
143 |
| - run: | |
144 |
| - target_count=0 |
145 |
| - target_list="" |
146 |
| - single_target_name="" |
147 |
| - for target in $(ls "${TARGET_DOCS_DIR}"); do |
148 |
| - if [ -d "${TARGET_DOCS_DIR}/${target}" ]; then |
149 |
| - single_target_name="${target}" |
150 |
| - target_count=$((target_count+1)) |
151 |
| - target_list="${target_list}<li><a href=\"${BASE_URL}/${target}\"><code>${target}</code> Documentation</a></li>" |
152 |
| - fi |
153 |
| - done |
154 |
| - if [ ${target_count} -gt 1 ]; then |
155 |
| - echo "Found ${target_count} targets. Generating list..." |
156 |
| - cat > "${INDEX_FILE}" <<EOF |
157 |
| - <!DOCTYPE html> |
158 |
| - <html> |
159 |
| - <head> |
160 |
| - <title>${REPO_NAME} Documentation</title> |
161 |
| - </head> |
162 |
| - <body> |
163 |
| - <ul> |
164 |
| - ${target_list} |
165 |
| - </ul> |
166 |
| - </body> |
167 |
| - </html> |
168 |
| - EOF |
169 |
| - else |
170 |
| - echo "Found one target. Generating redirect file to target ${single_target_name}" |
171 |
| - cat > "${INDEX_FILE}" <<EOF |
172 |
| - <!DOCTYPE html> |
173 |
| - <html> |
174 |
| - <head> |
175 |
| - <title>${REPO_NAME} Documentation</title> |
176 |
| - <meta http-equiv="refresh" content="0; url=${BASE_URL}/${single_target_name}" /> |
177 |
| - </head> |
178 |
| - <body> |
179 |
| - <p>Redirecting...</p> |
180 |
| - </body> |
181 |
| - </html> |
182 |
| - EOF |
183 |
| - fi |
184 |
| - - name: Create root index |
185 |
| - working-directory: repository |
186 |
| - env: |
187 |
| - REDIRECT_URL: 'https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/latest' |
188 |
| - REPO_NAME: ${{ github.event.repository.name }} |
189 |
| - run: | |
190 |
| - cat > 'index.html' <<EOF |
191 |
| - <!DOCTYPE html> |
192 |
| - <html> |
193 |
| - <head> |
194 |
| - <title>${REPO_NAME} Documentation</title> |
195 |
| - <meta http-equiv="refresh" content="0; url=${REDIRECT_URL}" /> |
196 |
| - </head> |
197 |
| - <body> |
198 |
| - <p>Redirecting...</p> |
199 |
| - </body> |
200 |
| - </html> |
201 |
| - EOF |
202 |
| - - name: Create latest symlink |
203 |
| - if: ${{ needs.release-context.outputs.is-latest }} |
204 |
| - working-directory: repository |
205 |
| - env: |
206 |
| - VERSION_NAME: ${{ needs.release-context.outputs.version-name }} |
207 |
| - run: | |
208 |
| - rm -f 'latest' |
209 |
| - ln -s "${VERSION_NAME}" 'latest' |
210 |
| - - name: Determine changes |
211 |
| - id: check-changes |
212 |
| - working-directory: repository |
213 |
| - run: | |
214 |
| - if [ -n "$(git status --porcelain)" ]; then |
215 |
| - echo 'has-changes=true' >> "${GITHUB_OUTPUT}" |
216 |
| - else |
217 |
| - echo 'has-changes=false' >> "${GITHUB_OUTPUT}" |
218 |
| - fi |
219 |
| - - uses: crazy-max/ghaction-github-pages@v4 |
220 |
| - if: ${{ steps.check-changes.outputs.has-changes }} |
221 |
| - with: |
222 |
| - keep_history: true |
223 |
| - build_dir: repository |
224 |
| - commit_message: Deploy documentation for '${{ needs.release-context.outputs.version-name }}' |
225 |
| - env: |
226 |
| - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} |
227 |
| - |
228 |
| - cleanup: |
229 |
| - needs: |
230 |
| - - generate-docs |
231 |
| - - publish-docs |
232 |
| - if: ${{ always() }} |
233 |
| - runs-on: ubuntu-latest |
234 |
| - steps: |
235 |
| - - name: Cleanup Artifacts |
236 |
| - uses: joutvhu/delete-artifact@v1 |
| 18 | +jobs: |
| 19 | + generate-and-publish-docs: |
| 20 | + uses: sersoft-gmbh/oss-common-actions/.github/workflows/swift-generate-and-publish-docs.yml@main |
| 21 | + with: |
| 22 | + os: ubuntu |
| 23 | + swift-version: '5.9' |
| 24 | + organisation: ${{ github.repository_owner }} |
| 25 | + repository: ${{ github.event.repository.name }} |
| 26 | + pages-branch: gh-pages |
0 commit comments