部署hugo网站到github

部署hugo网站到github

代码行

第一次开始部署

☞使用Git Bash终端

☞新建一个网站
hugo new site ffblog 其中 “ffblog” 是网站文件夹名

☞把主题文件复制到themes文件夹内

☞进入网站文件夹根目录
cd ffblog

☞将主题添加到站点配置,“bootstrap”是主题(文件)名称
echo theme = \"bootstrap\" >> config.toml

☞新建一篇文章
hugo new post/my-first-post.md

☞启动 Hugo server,运行本地网站
hugo server -D

☞进入网站根目录
cd ~/ffblog

☞构建Hugo 网站,默认将生成的静态站点文件保存到 “public” 目录,“public” 文件夹会被转换为 Git 库
hugo

☞进入public目录
cd ffblog/public

☞初始化 Git 库
git init

☞显示所有文件和目录列表,包含隐藏文件, 查看 public 目录下的文件,会发现多了 .git 文件
ls -a

☞新建一个主分支main
git branch -M main

☞将 Git 本地库关联至远程库,如果 [remote “origin”] 信息正常显示,说明你的 Git 本地库已成功关联至远程库
git remote add origin https://github.com/(github的ID号)/(github的ID号).github.io.git
(如果之前建过库的,要把库删除,重新建一个库,建库时不要勾选“Add a README file",否则在推送时可能会报错,需使用 git pull –rebase origin main ,然后再 git push -u origin main)

☞查看关联配置信息
cat .git/config 如果 [remote “origin”] 信息正常显示,说明你的 Git 本地库已成功关联至远程库

☞查看文件当前修改状态,准备提交修改的文件至本地库
git status

☞添加所有修改过的文件。你也可以只添加某个文件
git add .

☞提交文件,其中"Add a new post" 是 commit message
git commit -m "Add a new post"

☞将修改的文件推送至远程库
git push -u origin main

部署完成。

更新内容
☞进入网站根目录
cd ffblog

☞构建Hugo 网站,默认将生成的静态站点文件保存到 “public” 目录
hugo

☞进入public目录,“public” 文件夹会被转换为 Git 库
cd ffblog/public

☞初始化库
git init

☞将 Git 本地库关联至远程库
git remote add origin https://github.com/(github的ID号)/(github的ID号).github.io.git

☞查看文件当前修改状态,准备提交修改的文件至本地库 git status

☞添加所有修改过的文件。你也可以只添加某个文件
git add .

☞提交修改的文件
git commit -m "Add a new post"
其中"Add a new post" 是 commit message

☞将修改的文件推送至远程库
git push -u origin main

更新内容完成。

报错信息处理:

如果遇到类似“OpenSSL SSL_read: Connection was reset, errno 10054”的报错信息:
fatal: unable to access ‘https://github.com/(github的ID号)/(github的ID号).github.iot/': OpenSSL SSL_read: Connection was reset, errno 10054
错误原因可能是网络不稳定,连接超时造成的,如果你试了多次还是报这个错误,建议你执行下面的命令:
git config –global http.sslVerify “false”
这个命令用来修改设置,解除 SSL 验证。解除SSL时VPN软件建议使用全局代理。然后VPN断开,使用非全局再连接,然后再push。总之就是全局和非全局重复切换,多试几次。
git push -u origin main

如果遇到类似Failed to connect to github.com port 443 after 21049 ms: Timed out的报错信息
fatal: unable to access ‘https://github.com/(github的ID号)/(github的ID号).github.io.git/': Failed to connect to github.com port 443 after 21049 ms: Timed out
错误原因可能是网络不稳定,连接超时造成的,可以VPN软件不开全局代理,重复执行push多几次
git push -u origin main

如果遇到类似下面这种报错信息
[rejected] master -> master (fetch first) error: failed to push some refs
可以通过如下命令进行代码合并:
git pull –rebase origin main
然后重新push
git push -u origin main

评论