Use latest Jekyll-action configuration

[jondarrer]

This is a 🔦 documentation change.

Summary

The most recent version of the jekyll-action GitHub Action, 2.1.0, has changed the environment variable JEKYLL_PAT to a parameter called token.

https://github.com/marketplace/actions/jekyll-actions#deprecation

Adding this change should make it easier for anyone setting up the GitHub Action. Using the latest version of the action brings it into line with current documentation.

Context

[MichaelCurrin]

Hi. Thanks for picking up the deprecation.

When I wrote this article, the GH token approach was no supported.

Can you make additional changes to the same page? There is a bullet point mention of JEKYLL_PAT which can come out. And the second time it is mentioned is in the Permissions section - that entire section can be removed now since one no longer needs to generate a custom token. GH generates the GH_TOKEN value automatically.

Another benefit of GH_TOKEN is its security - it scoped to one repo only while JEKYLL_PAT gives access to edit all repos of a user.
Not that you have to mention that, but just for context.

[MichaelCurrin]

Remove all references to JEKYLL_PAT and creating a custom token.

When it comes to use GH_TOKEN, make sure to add a note around that saying one must copy and paste code as is (ie don't substitute to your own value in there). And mention that GH Actions will generate and use GH_TOKEN on a workflow run, so one does not need to generate it manually.

[MichaelCurrin]

By the way, I just made the update in the demo repo which is linked in the tutorial

It uses this new token flow.

https://github.com/MichaelCurrin/jekyll-actions-quickstart/blob/v1.3.0/.github/workflows/jekyll.yml

[jdvp]

Yeah, I think the entire "Providing Permissions" section can be removed. It might also be good to update again to the latest version (2.2.0)

For me, it also didn't work unless I specifically gave the target branch too, but unsure if anyone else has had that problem. Might want to include it as well.

  - uses: helaili/jekyll-action@2.2.0
    with:
      token: ${{ secrets.GITHUB_TOKEN }}
      target_branch: 'gh-pages'

[DirtyF]

@jekyll: merge +docs