当前位置: 首页 > news >正文

Hugo基本用法(转)

hugo本地创建、更新、删除文章后同步到gitpage的基本流程:

前提环境:

public目录位于blog目录下,属于blog的子仓库submodule 使用命令 git submodule status可看到 注意 写文章后直接sh deploy.sh,不用单独运行hugo相关任何命令

结论,改动blog仓库之前,确保public子仓库所有改动已提交 已push 问题: 如果仓库有子模块,任何情况下都先确保子模块commit和push以后,才可以同步父仓库?否则子模块就失效?

1、写文章

在blog项目根目录下执行 hugo new post/test.md 创建了一个md文件 vim content/post/test.md 移除 draft: true这一行 否则草稿不会公开为文章

2、发布文章到gitpage

blog根目录下执行deploy.sh脚本,成功以后等待约1分钟,gitpage上即可看到更新后的内容

3、修改、删除文章

只需要编辑或删除blog/content/post/下的md文件,然后再次在根目录执行deploy.sh脚本,即可同步到gitpage

4、同步本地blog仓库文件到github

任何本地blog根目录的文件,包括content/post下的md文件,或者config.toml配置文件,更新后都可以执行second-push.sh,远端仓库立即生效。second-push.sh内容为(git add –all . && git commit -m “update” && git push)

5、其他

对md文章或config.toml做任何改动以后,首先需要执行deploy.sh。然后如有需求再执行second-push.sh

其他:克隆此仓库

git clone git@github.com:richard-chen93/blog.git

其他 待删除,可以尝试的命令:

git submodule sync git submodule init git submodule update

添加tags

博客根目录下的archetypes目录下,也有一个default.md文件。这是hugo新建md文件的默认模板

启动实时预览(本地预览网站效果)

写一篇文章生成一次会很繁琐,可以通过启动网站预览,实时监控页面的更改并刷新页面。 hugo server -D 参数: -D 输出包括标记为 draft: true 的草稿文章

默认地址为 http://localhost:1313 如果 1313 端口被占用,会随机使用其他空端口。

若换了新电脑,要在新电脑上发布文章

  • 1、将blog克隆到本地
git clone git@github.com:richard-chen93/blog.git
  • 2、进入blog根目录,删除public文件夹
rm -rf public
  • 3、用以下命令设置子模块
 git submodule initgit submodule updategit submodule statusgit submodule sync

此时执行deploy可能会报错: fatal: You are not currently on a branch. To push the history leading to the current (detached HEAD) state now, use

git push origin HEAD:<name-of-remote-branch>

可尝试下面的指令修复问题:(在blog目录或public目录下都做)

  git checkout maingit push origin HEAD:maingit push -f

如果再有如下报错:

Auto-merging search/index.json
CONFLICT (content): Merge conflict in search/index.json
Auto-merging post/index.html
Auto-merging index.html
Auto-merging archives/index.html
Automatic merge failed; fix conflicts and then commit the result.

这样处理:

git add search/index.json
git commit -s
git push

Hugo 添加网站流量统计

不蒜子是一个通过仅仅两行代码实现的网页流量计数器

1.在themes/layouts/partials/head.html文件中引入不蒜子js文件

<!-- 不蒜子 -->
<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

2.在页面添加统计代码,在/themes/layouts/partials/footer.html中添加如下代码

<span id="busuanzi_container_site_pv">本站总访问量<span id="busuanzi_value_site_pv"></span>次
</span>
&nbsp;

3.在themes/layouts/_default/single.html中添加以下代码

<h5 id="wc" style="font-size: 1rem;text-align: center;">{{ .FuzzyWordCount }} Words|Read in about {{ .ReadingTime }} Min|<span id="busuanzi_container_page_pv">本文总阅读量<span id="busuanzi_value_page_pv"></span>次
</span></h5>

可根据个人喜好选择放在文章头部或尾部

问题记录

执行 hugo –cleanDestinationDir, 若blog仓库content/post下有删除的md文章,则public/post下对应的html文章也会同步删除。然后执行deploy.sh之后,git就会报错:

 # On branch main# Untracked files:#   (use "git add <file>..." to # include in what will be # committed)#      ../content/post/1.md
nothing added to commit but untracked files present (use "git add" to track)

所以目前不要动public目录下的任何东西,更新文章只在blog下进行,再deploy到gitpage即可。

http://www.jsqmd.com/news/919148/

相关文章:

  • JMeter汇总报告保姆级解读:从‘样本’到‘吞吐量’,每个参数到底在说什么?
  • Steam游戏自动破解终极指南:从源码编译到实战应用的完整教程
  • 植物健康系统毕业设计源码
  • 零知识证明集成失败率高达67%?Lovable 2.3.0 ZK-Rollup适配手册(含BLS签名加速实测数据)
  • 语音芯片厂家一览
  • 技术人如何高效处理信息流:从AI、比特币到StoreKit 2的实践思考
  • 185、运动控制中的行业应用:AGV与移动机器人
  • 昌吉白蚁消杀防治优选金盾虫控 青蚁卫士:深耕 15 年本土知名品牌,专业虫害防控本地靠谱推荐 - 卓一科技
  • 个人品牌战略转型:公司、奖学金、研讨会三位一体同步启动的实践指南
  • 2020流程挖掘趋势:从RPA导航到数字孪生,AI驱动流程发现与实时监控
  • 从SourceForge到Hitachi Vantara:Kettle下载地址变迁背后的故事与Linux环境搭建实战
  • DouyinLiveWebFetcher:抖音直播数据采集的终极解决方案
  • OpenRCT2 v0.5.1“沼泽城堡”版本发布,多项特性更新且将停对Win7/8官方支持!
  • 别再只改SE11了!ABAP搜索帮助增强的完整流程:从创建、分配到调试的避坑指南
  • 数据库原理选择题精选
  • 2026年5月成都春熙路附近好吃的火锅串串推荐榜|本地人实测口碑评分4.5分+ - TOP10品牌推荐榜单
  • 考研各科真题答题卡PDF可打印(英语、管综、数学等)
  • 保姆级教程:用ONNX Runtime在Python中直接运行DETR目标检测模型(附完整代码)
  • SuperAGI与LlamaIndex集成:构建异构数据智能分析系统
  • 告别环境报错:用Docker一键部署MMDetection3D开发环境(支持PyTorch 1.10.1 + CUDA 11.3)
  • 2026 年 ZJIT 引入新寄存器分配器:全局分配优势大,方法内联正推进!
  • Linux动态链接库缺失导致FlexNet许可证服务器启动失败的解决方案
  • Playwright连接浏览器踩坑实录:解决端口占用、配置文件污染与连接超时
  • Gemini多模态视频分析落地全链路(企业级部署避坑手册)
  • 实战 Claude 的 effort 参数:让智能体“按需用力“省 token(含 Opus 4.8 更新)
  • 好用还专业!2026年最值得体验的专业降AI率工具
  • 从数据洞察到模型调优:用Seaborn和Sklearn完整走一遍房价预测项目
  • 告别闪退!手把手教你用VS2010旗舰版写出第一个C++程序(附Hello World完整代码)
  • 告别ViT的‘暴力计算’:手把手教你用PyTorch实现MViT的池化注意力(附代码)
  • MedMNIST:18个标准化医疗图像数据集如何重塑医疗AI开发范式