diff --git a/.github/workflows/references.yaml b/.github/workflows/references.yaml new file mode 100644 index 00000000000..0c3df1c2f8c --- /dev/null +++ b/.github/workflows/references.yaml @@ -0,0 +1,50 @@ +--- +name: Generate References + +on: + push: + branches: + - main + +permissions: + contents: write + +jobs: + generate_references: + if: ${{ github.repository_owner == 'puppetlabs' }} + runs-on: ubuntu-latest + name: Generate References + env: + BUNDLE_WITH: "documentation" + BUNDLE_WITHOUT: "features packaging" + steps: + - name: Checkout current PR + uses: actions/checkout@v4 + + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: 3.2 + bundler-cache: true + + - name: Setup Pandoc + uses: pandoc/actions/setup@d940685d5968400c91029147adbd612deb7696b0 + with: + version: 3.1.8 + + - name: Generate References + id: generate-references + run: | + bundle exec rake references:all + git --no-pager diff --exit-code --ignore-matching-lines='This page was generated from the Puppet source' --ignore-matching-lines='built_from_commit:' man references || echo 'commit=true' >> "$GITHUB_OUTPUT" + + - name: Commit and Push + if: ${{ steps.generate-references.outputs.commit == 'true' }} + uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 + with: + author_name: GitHub Actions + author_email: actions@github.com + message: 'Update references [no-promote]' + add: 'man references' + push: true +