Skip to content

Traps with github user site

Problem1

By following the deployment documents of VitePress, after deploy to github user site, the link is always username github.io/username

Reason

The repository name should be username.github.io, I created it wrongly as just username, the username repository is used to show info in the personal github page https://github.com/username by using its README file

Solution

change the repository name to username.github.io

Problem2

When using github actions to deploy to github pages, it shows 403 permission error

Reason

The GITHUB_TOKEN is default to set to only have read permission, so it cannot write to the github pages

Solution

add write permission in workflow

yml
permissions:
  contents: write