Push the website to Github Pages

[theadanielskocher]

I have finished my website and I want to push my website to Github pages by hand, but nothing works. How can I address this issue?

Thank you for your answer!

[brc-dd]

Please follow the deploy guide - https://vitepress.dev/guide/deploy#github-pages and if any issue arises, create one with proper debugging information including a minimal reproducible example and the steps you followed.

[theadanielskocher]

When I try to paste this code: https://ideone.com/FkP3KS to .github/workflows, I get this error:

Dependencies lock file is not found in /home/runner/work/dang7rickroll.github.io/dang7rickroll.github.io. Supported file patterns: package-lock.json,npm-shrinkwrap.json,yarn.lock

How can I address this issue? Thank you so much.

[brc-dd]

You need to commit your lock file too. A lock file will be generated when you run npm install locally.

[laplacetw]

I've committed pnpm-lock.yaml with VitePress official deploy guide and had the same error. So I use the --no-frozen-lockfile :

- name: Install dependencies
        run: pnpm install --no-frozen-lockfile

@brc-dd I follow the official deploy guide and deploy to GitHub pages with base "/project-name/". But why when I type "username.github.io/project-name/" into browser then it will become "username.github.io" ?

• laplacetw.github.io/vitepress-theme-trigger/
• .github/workflows/gh-pages.yml

[brc-dd]

@laplacetw Your pagination component is not SSR friendly and there you're doing history.pushState({ page: blogStore.currentPage }, 'goPage()', '/') -- that's why it's going back to / instead of /base/

[laplacetw]

@brc-dd really appreciate your help ! I made that dynamic pagination component because I don't like to build .html for every pagination page. I'm not sure which one is better.

[brc-dd]

That's fine. You just need to wrap it with <ClientOnly> or call that history thing inside onMounted. Anyway that history call should have something like withBase('/') for it work properly

[hf-xz]

Hey, I get the same situation yesterday. You are getting this page (screen shot) because it's build by jekyll but not vitepress. Jekyll is the default method used by github to build your github.io so you need to change this. see this

If you want to use a build process other than Jekyll or you do not want a dedicated branch to hold your compiled static files, we recommend that you write a GitHub Actions workflow to publish your site.

Follow this section, you can change your build method from jekyll to custom Github Actions workflow.

After change the settings to this:

You may follow vitepress guide to write your own workflow.

The code given by the guide is good enough for me. I just changed two settings and it works great.

• first, at on-push-branches, change the 'main' to the 'master' which I used in my repo
• second, at steps Build with VitePress and Upload artifact, change the path docs/.vitepress/* to .vitepress/* because the .vitepress is on my project root.