Usage
Build static websites using GitHub issues, GitHub Actions, and Vitepress without writing any code or making Git commits and pushes.
Usage 1
A repository can only be forked once.
- Fork this repository.
- Enable Actions in the repository's Actions page.
- Enable Issues in the repository's Settings - General - Features.
- In the repository's Settings - Pages - Build and deployment, set Source to Github Actions.
- Create a label named "deploy" in Issues - Labels.
- Create an issue and add the "deploy" label to trigger the build process. After about 3 minutes, you can access the site on the repository homepage.
Usage 2
This method can be used multiple times without operating repository files.
- Create a new repository, and enter
Import a repository.
on the new repository page. - Fill in
Your old repository's clone URL*
with this repository link to complete the new repository creation step. - In Settings - Actions - General - Actions permissions of the repository, select
Allow all actions and reusable workflows
and clickSave
. - Enable Actions in the repository's Actions page.
- In the repository's Settings - Pages - Build and deployment, set Source to Github Actions.
- Create a label named "deploy" in Issues - Labels.
- Create an issue and add the "deploy" label to trigger the build process. After about 3 minutes, you can access the site on the repository homepage.
Usage 3
This method can be used multiple times, but requires shell operations to initialize the repository.
- Create a new repository, such as
luoway/new-repo
, and clone it to your local machine. - Run the following shell command:shell
# dir: new-repo/ git clone https://github.com/luoway/vitepress-issues-page.git mv ./vitepress-issues-page/.* ./vitepress-issues-page/* . rm -rf ./vitepress-issues-page git add -A git commit -m "init" git push
- In the repository's Settings - Pages - Build and deployment, set Source to Github Actions.
- Create a label named "deploy" in Issues - Labels.
- Create an issue and add the "deploy" label to trigger the build process. After about 3 minutes, you can access the site on the repository homepage.
Quick Access to GitHub Pages
Click the About gear icon on the repository homepage, check "Use your GitHub Pages website", and click "Save changes" to display a quick access link under About.
Page Configuration
Refer to the following file paths and manually modify them to correspond to your own repository files.
- Top title
- Homepage content
- Sidebar grouping Configuration rule: one label per line. Multiple labels are displayed as multiple groups in the sidebar.