guide/deployment/

[giscus[bot]]

guide/deployment/

提示 此文档 fork 自 vuepress official doc， 仅为了方便阅读。 下述的指南基于以下条件： Markdown 源文件放置在你项目的 docs 目录； 使用的是默认的构建输出目录 (.vuepress/dist) ； 使用 pnpm 作为包管理器，当然也支持使用 npm 或 yarn 。 VuePress 作为项目依赖安装，并在...

https://plume.pengzhanbo.cn/guide/deployment/

[yvtian-zhankui]

18:54:50.0
✖ Compiling with vite - failed in 6.86s
18:54:50.0
[vite:esbuild] Transform failed with 1 error:
18:54:50.0
/home/temp/node_modules/vuepress-theme-plume/lib/client/components/VPMenuGroup.vue?vue&type=script&setup=true&lang.ts:1:8: ERROR: Expected ">" but found "lang"
18:54:50.0
file: /home/temp/node_modules/vuepress-theme-plume/lib/client/components/VPMenuGroup.vue?vue&type=script&setup=true&lang.ts:1:8
18:54:50.0
18:54:50.0
Expected ">" but found "lang"
18:54:50.0
1 | <script lang="ts" setup>
18:54:50.0
| ^
18:54:50.0
2 | import VPIcon from '@theme/VPIcon.vue'
18:54:50.0
3 | import VPMenuLink from '@theme/VPMenuLink.vue'
18:54:50.0
18:54:50.0
at failureErrorWithLog (/home/temp/node_modules/esbuild/lib/main.js:1472:15)
18:54:50.0
at /home/temp/node_modules/esbuild/lib/main.js:755:50
18:54:50.0
at responseCallbacks.<computed> (/home/temp/node_modules/esbuild/lib/main.js:622:9)
18:54:50.0
at handleIncomingPacket (/home/temp/node_modules/esbuild/lib/main.js:677:12)
18:54:50.0
at Socket.readFromStdout (/home/temp/node_modules/esbuild/lib/main.js:600:7)
18:54:50.0
at Socket.emit (node:events:517:28)
18:54:50.0
at addChunk (node:internal/streams/readable:368:12)
18:54:50.0
at readableAddChunk (node:internal/streams/readable:341:9)
18:54:50.0
at Readable.push (node:internal/streams/readable:278:10)
18:54:50.0
at Pipe.onStreamRead (node:internal/stream_base_commons:190:23)
18:55:05.0
.

部署的时候间歇性的遇到这个错误

[yvtian-zhankui]

Run npx vuepress info
- Collecting Environment Info

  System:
    OS: Linux 6.5 Ubuntu 22.04.4 LTS 22.04.4 LTS (Jammy Jellyfish)
    CPU: (4) x64 AMD EPYC 7763 64-Core Processor
    Memory: 14.43 GB / 15.61 GB
    Shell: 5.1.16 - /bin/bash
  Binaries:
    Node: 18.20.4 - /opt/hostedtoolcache/node/18.20.4/x64/bin/node
    Yarn: 1.22.22 - /usr/local/bin/yarn
    npm: 10.7.0 - /opt/hostedtoolcache/node/18.20.4/x64/bin/npm
    pnpm: Not Found
    bun: Not Found
  Utilities:
    Git: 2.45.2 - /usr/bin/git
  Browsers:
    Chrome: 126.0.6478.182
  npmPackages:
    @vuepress/bundler-vite: ^2.0.0-rc.14 => 2.0.0-rc.14 
    @vuepress/bundler-webpack: Not Found
    @vuepress/cli:  2.0.0-rc.14 
    @vuepress/client:  2.0.0-rc.14 
    @vuepress/core:  2.0.0-rc.14 
    @vuepress/markdown:  2.0.0-rc.14 
    @vuepress/shared:  2.0.0-rc.14 
    @vuepress/utils:  2.0.0-rc.14 
    vue:  3.4.33 
    vue-router:  4.4.0 
    vuepress: ^2.0.0-rc.14 => 2.0.0-rc.14 

Vite

`-- @vuepress/bundler-vite@2.0.0-rc.14
  +-- @vitejs/plugin-vue@5.1.0
  | `-- vite@5.3.4 deduped
  `-- vite@5.3.4

[pengzhanbo]

该问题应该是相关依赖的上游导致的，正在从上游排查原因。

[yvtian-zhankui]

"@vitejs/plugin-vue":"~5.0.4"

将这个组件版本锁定到5.0.x后暂时没有出现上述问题

[pengzhanbo]

比较麻烦的是，我已经比对过 @vitejs/pljugin-vue 最近的更新，从它源码变更上看没发现可能导致该问题的修改，还需要排查更上游的 vue/compiler-*。我联系过上游的一些开发者，暂时还没给出结论，该问题短时间内不好解决，你先暂时锁下版本吧，出现问题的话重新构建。

[pengzhanbo]

另外我打算把这个 discussions comments 转到 new issue ， 后续进展在 issue #130 中进行。

[hxywd666]

在部署到Github Page的时候，我这里有一个自动部署脚本可供参考👇

#!/usr/bin/env sh
 
# 忽略错误
set -e  #有错误抛出错误
 
# 构建
pnpm run docs:build  #然后执行打包命令
 
# 进入待发布的目录
cd docs/.vuepress/dist  #进到dist目录
 
git init  #执行这些git命令
git add -A
git commit -m 'deploy'
 
# 上传仓库，这里改成你自己的仓库
git push -f https://github.com/example/example.github.io.git master:gh-pages
 
cd -
 
rm -rf docs/.vuepress/dist  #删除dist文件夹

用法：

• 在项目根目录(和package.json同级)创建一个名叫"deploy.sh"的文件，复制上面的代码到新创建的文件中
• 把仓库的地址换成你自己的
• 修改"package.json"中的"script"，如下：

"scripts": {
    "deploy":"bash deploy.sh",
    "docs:dev": "vuepress dev docs",
    "docs:dev-clean": "vuepress dev docs --clean-cache --clean-temp",
    "docs:build": "vuepress build docs --clean-cache --clean-temp",
    "docs:preview": "http-server docs/.vuepress/dist",
    "vp-update": "vp-update"
},

然后，打开Git Bash，cd到你的项目目录下，然后执行命令：

pnpm run deploy

等待一会，项目就会自动上传到example.github.io这个仓库里，然后就可以直接访问你的文档库了
如果你用的是其它包管理器，比如yarn，那么把"deploy.sh"中的"pnpm"换成"yarn"，然后在Git Bash中执行命令的时候，改成执行如下命令即可：

yarn run deploy

[pengzhanbo]

感谢提供 新的部署方式 👍👍👍

[ztygod]

关于GitHub Pages的部署有什么教程吗，网上内容版本不一样，难以判断是否有用，本人主要是卡在GitHub Actions了

[cjhalw]

上面的脚本 可以本地打包 直接打包推送github pages仓库。不在需要配置GitHub Actions了