要想部署一个属于自己的个人网站或者项目网站,流程参考 一个网站部署的详细流程!步骤齐全!少走坑路 - 腾讯云,其中包括域名注册、域名备案、域名解析、购买服务器等等,这些流程真的很长很麻烦,而且服务器费用还高
有时候只是想把网站部署出去给少数人使用,想省事也不想承担相应成本,可以借助 github 平台来完成,本文介绍如何创建:
- 个人网站(
https://<username>.github.io/) - 项目网站(
https://<username>.github.io/<project-name>/)
创建个人网站
- 创建仓库
仓库名设置为:
<username>.github.io(username:github 官网的用户名)
例如我的个人主页的仓库地址:github.com/ALKAOUA720/…
- 修改构建产物的输出路径(这里以 vite 举例)
修改 vite 的构建选项:build.outDir 为 docs(注意:这里必须是叫 docs,要跟 github 官方对应)
代码如下:
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
// https://vite.dev/config/
export default defineConfig({
plugins: [react()],
build: {
outDir: "docs", // 输出构建产物到docs目录
},
});
- 打开github,打开配置页:settings - pages
配置 Build and deployment 的 source 为 Deploy from a branch 和 branch 为 [主分支] 的 /docs 目录
- 本地开发环境执行
build命令生成构建产物
(注意:这里要检查一下 .gitignore 文件要不包含 docs 目录)
- 本地提交并推送到远程仓库后,打开github,打开actions页
可以看到页面自动开启部署流程,部署完成后:
- 部署完成后,可以看到 Github Pages 已经自动生成我的个人网站了,可以直接访问 alkaoua720.github.io/
创建项目网站
以我的个人 Github 项目为例:
github.com/ALKAOUA720/… (一个采用 React + umi 框架的前端 Web 项目)
大体步骤和创建个人网站的流程一样
- 修改构建产物输出目录为
docs
- 本地执行
npm run build后生成的构建产物:
- 提交推送到远程仓库后还是到 settings - pages 路径下,关注 build and deployment 区域
- 后续每次推送后 github 都会自动执行构建流程
- 回到 settings - pages 下可以看到这个项目的网站链接已经生成,部署记录也可以看到,点击访问项目网站 alkaoua720.github.io/common-ui-r…
生成网站的二维码
借助 草料二维码生成器 可以给你的个人网站、项目网站生成二维码,方便移动端扫码访问:
- 点击“网址” - “网址静态码”
- 输入网址链接后点击“生成二维码”:
成功为我的项目网站 alkaoua720.github.io/common-ui-r… 生成一个二维码
- 可以调整二维码尺寸(单位:px)
- 还可以对二维码进行美化
最终效果:
二维码永久有效