超实用!!! 三分钟将你的项目部署在github page上
创始人
2025-06-01 05:17:46

文章目录

  • 前言
  • 一、在项目中新增配置
  • 二、配置github page setting?
  • 三、如何访问github page?
  • 总结


前言

最近给一个dicom-demo项目加了一个展示tag的功能,主要是方便自己平常定位问题查tag使用。没想到项目搞完了,发现云服务器到期了,尴尬…
后来想了下,使用github page不也行么!!!下面主要以dicom 这个项目为例子,展示下如何将自己的项目部署在github page上


一、在项目中新增配置

因为我这个项目使用的vite, 所以下边主要以vite为例

  1. 在 vite.config.js 中设置正确的 base。
    如果你要部署在 https://.github.io/ 上,你可以省略 base 使其默认为 ‘/’。
    如果你要部署在 https://.github.io// 上,例如你的仓库地址为 https://github.com//,那么请设置 base 为 ‘//’。
    此步骤主要是设置打包后静态资源前缀, CRA项目可参考下方链接homepage
  2. 在项目根路目录下,新建deploy.sh文件(文件大致意思就是在build完后的dist目录中,新建仓库,然后将内容推到远程仓库的gh-pages),内容如下:
#!/usr/bin/env sh
# 删除dist, 否则第二次会提示fatal: A branch named 'main' already exists.
rm -rf dist# 发生错误时终止
set -e# 构建
npm run build# 进入构建文件夹
cd dist# 如果你要部署到自定义域名
# echo 'www.example.com' > CNAMEgit init
git checkout -b main
git add -A
git commit -m 'deploy'# 如果你要部署在 https://.github.io/
git push -f git@github.com:wangliang101/dicom-demo.git main:gh-pagescd -
  1. 上一步完成后,我发现我的项目打开就直接跳转 http://localhost:3000/dicom-demo/ 了,而且线上访问也是会带着/dicom-demo, 即我们的base, 所以我们需要配置下项目的basename,如下图:
    在这里插入图片描述

二、配置github page setting?

  1. 打开需要配置github page的仓库,并找到setting选项在这里插入图片描述
  2. 找到pages选项,按下图进行配置,配置完记得点击save进行保存在这里插入图片描述
  3. 在本地项目根路径下运行以下命令,等命令结束后,就完成了github page的部署
bash deploy.sh

三、如何访问github page?

部署完成后,如何获得你的github page的地址呢?可以参考下图
在这里插入图片描述

总结

总体来说,github page的部署还是很简单的。主要是将build后的dist放到一个新的分支上,然后github page就和nginx一样,就会自动托管你的静态文件。当然除了文章提到的方式,还有其他方式也可以实现,比如:我们直接将github page的deploy分支设置为main,文件夹设置为docs, 然后我们将打包出的产物直接放到docs即可,大家也可以试一下。

上一篇:数据结构---队列

下一篇:C++数据类型

相关内容

热门资讯

【实验报告】实验一 图像的... 实验目的熟悉Matlab图像运算的基础——矩阵运算;熟悉图像矩阵的显示方法࿰...
MATLAB | 全网最详细网... 一篇超超超长,超超超全面网络图绘制教程,本篇基本能讲清楚所有绘制要点&#...
大模型落地比趋势更重要,NLP... 全球很多人都开始相信,以ChatGPT为代表的大模型,将带来一场NLP领...
Linux学习之端口、网络协议... 端口:设备与外界通讯交流的出口 网络协议:   网络协议是指计算机通信网...
kuernetes 资源对象分... 文章目录1. pod 状态1.1 容器启动错误类型1.2 ImagePullBackOff 错误1....
STM32实战项目-数码管 程序实现功能: 1、上电后,数码管间隔50ms计数; 2、...
TM1638和TM1639差异... TM1638和TM1639差异说明 ✨本文不涉及具体的单片机代码驱动内容,值针对芯...
Qt+MySql开发笔记:Qt... 若该文为原创文章,转载请注明原文出处 本文章博客地址:https://h...
Java内存模型中的happe... 第29讲 | Java内存模型中的happen-before是什么? Java 语言...
《扬帆优配》算力概念股大爆发,... 3月22日,9股封单金额超亿元,工业富联、鸿博股份、鹏鼎控股分别为3.0...
CF1763D Valid B... CF1763D Valid Bitonic Permutations 题目大意 拱形排列࿰...
SQL语法 DDL、DML、D... 文章目录1 SQL通用语法2 SQL分类3 DDL 数据定义语言3.1 数据库操作3.2 表操作3....
文心一言 VS ChatGPT... 3月16号,百度正式发布了『文心一言』,这是国内公司第一次发布类Chat...
CentOS8提高篇5:磁盘分...        首先需要在虚拟机中模拟添加一块新的硬盘设备,然后进行分区、格式化、挂载等...
Linux防火墙——SNAT、... 目录 NAT 一、SNAT策略及作用 1、概述 SNAT应用环境 SNAT原理 SNAT转换前提条...
部署+使用集群的算力跑CPU密... 我先在开头做一个总结,表达我最终要做的事情和最终环境是如何的,然后我会一...
Uploadifive 批量文... Uploadifive 批量文件上传_uploadifive 多个上传按钮_asing1elife的...
C++入门语法基础 文章目录:1. 什么是C++2. 命名空间2.1 域的概念2.2 命名...
2023年全国DAMA-CDG... DAMA认证为数据管理专业人士提供职业目标晋升规划,彰显了职业发展里程碑及发展阶梯定义...
php实现助记词转TRX,ET... TRX助记词转地址网上都是Java,js或其他语言开发的示例,一个简单的...
【分割数据集操作集锦】毕设记录 1. 按要求将CSV文件转成json文件 有时候一些网络模型的源码会有data.json这样的文件里...
Postman接口测试之断言 如果你看文字部分还是不太理解的话,可以看看这个视频,详细介绍postma...
前端学习第三阶段-第4章 jQ... 4-1 jQuery介绍及常用API导读 01-jQuery入门导读 02-JavaScri...
4、linux初级——Linu... 目录 一、用CRT连接开发板 1、安装CRT调试工具 2、连接开发板 3、开机后ctrl+c...
Urban Radiance ... Urban Radiance Fields:城市辐射场 摘要:这项工作的目标是根据扫描...
天干地支(Java) 题目描述 古代中国使用天干地支来记录当前的年份。 天干一共有十个,分别为:...
SpringBoot雪花ID长... Long类型精度丢失 最近项目中使用雪花ID作为主键,雪花ID是19位Long类型数...
对JSP文件的理解 JSP是java程序。(JSP本质还是一个Servlet) JSP是&#...
【03173】2021年4月高... 一、单向填空题1、大量应用软件开发工具,开始于A、20世纪70年代B、20世纪 80年...
LeetCode5.最长回文子... 目录题目链接题目分析解题思路暴力中心向两边拓展搜索 题目链接 链接 题目分析 简单来说࿰...