diff --git a/.forgejo/workflows/build.yml b/.forgejo/workflows/build.yml new file mode 100644 index 0000000..1f71154 --- /dev/null +++ b/.forgejo/workflows/build.yml @@ -0,0 +1,49 @@ +name: Update API Documentation + +on: + push: + paths: + - 'openapi.yaml' # Trigger when openapi.yaml changes + branches: + - main # or your default branch + +jobs: + convert-and-push: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v3 + + - name: Checkout wiki + uses: actions/checkout@v3 + with: + repository: ${{github.repository}}.wiki + path: wiki + + - name: Setup Node.js + uses: actions/setup-node@v3 + with: + node-version: '16' + + - name: Install Widdershins + run: npm install -g widdershins + + - name: Convert OpenAPI to Markdown + run: | + widdershins openapi.yaml -o wiki/api.md --omitHeader true + + - name: Configure Git + run: | + cd wiki + git config --local user.email "action@github.com" + git config --local user.name "GitHub Action" + + - name: Commit and push changes to wiki + run: | + cd wiki + git add api.md + git diff-index --quiet HEAD || git commit -m "Update API documentation" + git push + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/README.md b/README.md index dac0a6a..70b42e4 100644 --- a/README.md +++ b/README.md @@ -5,4 +5,4 @@ there are a bunch of webservers i host for my personal use, mostly for different i use different hrt terms as a naming scheme for my machines. my main pc is called estrogen, my weak main vps is called bica, and the vps i use to host most of my webservers is called mono (as in monotherapy). so every webserver will most likely be under \.mono.exhq.dev ## endpoints -see: [wiki](./wiki) +see wiki