83 lines
2.4 KiB
YAML
83 lines
2.4 KiB
YAML
name: PUBLISH DOCS
|
|
on: [workflow_dispatch]
|
|
# or set up your own custom triggers
|
|
permissions:
|
|
contents: write # allows the 'Commit' step without tokens
|
|
|
|
jobs:
|
|
get_history: # create an artifact from the existing documentation builds
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: get the gh-pages repo
|
|
uses: actions/checkout@v4
|
|
with:
|
|
ref: gh-pages
|
|
|
|
- name: tar the existing docs
|
|
run: |
|
|
mkdir -p ./docs
|
|
tar -cvf documentation.tar ./docs
|
|
|
|
- name: create a document artifact
|
|
uses: actions/upload-artifact@v4
|
|
with:
|
|
name: documentation
|
|
path: documentation.tar
|
|
|
|
build: # builds the distribution and then the documentation
|
|
needs: get_history
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: Checkout src
|
|
uses: actions/checkout@v4
|
|
|
|
- run: mkdir -p ./docs
|
|
- name: Download the existing documents artifact
|
|
uses: actions/download-artifact@v4
|
|
with:
|
|
name: documentation
|
|
- run: tar -xf documentation.tar ./docs -C ./docs
|
|
|
|
- name: Build
|
|
uses: actions/setup-node@v4
|
|
with:
|
|
node-version: 20.x
|
|
cache: 'npm'
|
|
- run: npm install -g pnpm && pnpm install
|
|
- run: pnpm run build # set up 'build' script in your package.json
|
|
|
|
- name: Build documents
|
|
run: pnpm run docs #set up 'docs' build script in your package.json
|
|
|
|
- name: tar the new docs
|
|
run: tar -cvf newdocumentation.tar ./docs
|
|
|
|
- name: create a new document artifact
|
|
uses: actions/upload-artifact@v4
|
|
with:
|
|
name: newdocumentation
|
|
path: newdocumentation.tar
|
|
|
|
commit: # commit the old and new merged documents to gh-pages/docs
|
|
needs: build
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: checkout the gh-pages repo
|
|
uses: actions/checkout@v4
|
|
with:
|
|
ref: gh-pages
|
|
|
|
- run: mkdir -p ./docs
|
|
- name: Download the new documents artifact
|
|
uses: actions/download-artifact@v4
|
|
with:
|
|
name: newdocumentation
|
|
- run: tar -xf newdocumentation.tar ./docs -C ./docs
|
|
|
|
- name: commit
|
|
run: |
|
|
git config --global user.email "cis-oss@users.noreply.github.com"
|
|
git config --global user.name "Continuous Integration"
|
|
git add .
|
|
git commit -m "CI updated the documentation"
|
|
git push |