[update] new hints in the example of github-pages.md

[NatLee]

There are some issues with this document.

• Github do not support the name of token starting with GITHUB_.
  Check the issue here -> The documentation suggests an invalid value for the name of a secret github/docs#12094

• The name of token in the pages.yml is ambiguous. User may check the usage of actions.

Check List

Please read and check followings before submitting a PR.

• I want to publish my theme on Hexo official website.
  • I have read the theme publishing doc.
  • name is unique.
  • link URL is correct.
  • preview URL is correct.
  • preview URL web site is rendered correctly.
  • Add a screenshot to source/themes/screenshots.
  • Screenshot filename is same as value of name.
  • Screenshot size is 800 * 500.
  • Screenshot file format is png.
• I want to publish my plugin on Hexo official website.
  • I have read the plugin publishing doc.
  • name is unique.
  • link URL is correct.
• Others (Update, fix, translation, etc...)
  • Languages:
  • en English
  • ru Russian
  • zh-cn simplified Chinese
  • zh-tw traditional Chinese

Note

No need to translate ko, pt-br, th languages if you submit a PR for documentation.

Warning

ko, pt-br, th languages document are inactive. Please, submit issue if you want to continuous contribution to them.

[github-actions]

Theme name validation passed.
Theme thumbnails validation completed.

[renbaoshuo]

The GITHUB_TOKEN is a special token that is created automatically for each workflow run.

https://docs.github.com/en/actions/security-guides/automatic-token-authentication#about-the-github_token-secret

[renbaoshuo]

Sorry, I clicked the "Close Pull Request" button by mistake.

[stevenjoezhang]

See also github/docs#12095 (comment)

[NatLee]

@renbaoshuo Thanks for your fast response!

I have trid to use the token starts with GITHUB_ in actions.

But, I got a failed message below

In my opion, we need to change the name of token in the document or they may confuse the user.

[stevenjoezhang]

The token named secrets.GITHUB_TOKEN is created automatically. You don't need to create it.
You just need to follow the steps in github-pages.md, it should not throw any errors.

[NatLee]

@stevenjoezhang Thanks!

I followed the step here https://hexo.io/zh-tw/docs/github-pages.html and created a new repo to test the workflows.

In the stage of deployment, it showed error of 403:

[stevenjoezhang]

It is working in my repository... Maybe you can refer to peaceiris/actions-gh-pages#744

[SukkaW]

Just blocking the pull request as the change requires further discussion/investigation.

[NatLee]

@stevenjoezhang Thanks!

In that reference, we need to switch the setting in actions.

I find there is another way to give writting permission. -> peaceiris/actions-gh-pages#753

Just add permissions in the .yml.

jobs:
  pages:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    ...