当前位置: 首页 > 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.gsyq.cn/news/1430470.html

相关文章:

  • Steam游戏自动破解终极指南:从源码编译到实战应用的完整教程
  • 植物健康系统毕业设计源码
  • 零知识证明集成失败率高达67%?Lovable 2.3.0 ZK-Rollup适配手册(含BLS签名加速实测数据)
  • 语音芯片厂家一览
  • 2020流程挖掘趋势:从RPA导航到数字孪生,AI驱动流程发现与实时监控
  • 个人品牌战略转型:公司、奖学金、研讨会三位一体同步启动的实践指南
  • 昌吉白蚁消杀防治优选金盾虫控 青蚁卫士:深耕 15 年本土知名品牌,专业虫害防控本地靠谱推荐 - 卓一科技
  • OpenRCT2 v0.5.1“沼泽城堡”版本发布,多项特性更新且将停对Win7/8官方支持!
  • SuperAGI与LlamaIndex集成:构建异构数据智能分析系统
  • Playwright连接浏览器踩坑实录:解决端口占用、配置文件污染与连接超时
  • 从数据洞察到模型调优:用Seaborn和Sklearn完整走一遍房价预测项目
  • 实战 Claude 的 effort 参数:让智能体“按需用力“省 token(含 Opus 4.8 更新)
  • 告别闪退!手把手教你用VS2010旗舰版写出第一个C++程序(附Hello World完整代码)
  • MedMNIST:18个标准化医疗图像数据集如何重塑医疗AI开发范式
  • 20253921 2025-2026-2 《网络攻防实践》第十周作业
  • 13502开源:黄大年茶思屋榜文135期 第2题:多模态Agentic Reasoning
  • Keil MDK USB调试中Event Recorder语法错误解决方案
  • 你的Power BI散点图还不会‘说话’?手把手教你添加动态标题和智能切片器
  • 20260530 3
  • 【微电网调度】考虑需求响应的基于改进多目标灰狼算法的微电网优化调度研究附Matlab代码
  • 2026实测:专业降AI率网站选它准没错
  • 网盘文件直链获取终极指南:如何实现跨平台高速下载体验
  • 模块二,规划模式的定义
  • 基于复杂网络理论的快递网络优化方案【附仿真】
  • 别再删库重Fork了!Gitee同步上游代码的3种正确姿势(附Git命令详解)
  • 终极Android设备安全检测:免费开源工具Play Integrity API Checker完整指南
  • 2026年京东云OpenClaw/Hermes Agent配置Token Plan部署保姆教程
  • 3分钟上手HiveWE:8倍速打造你的魔兽争霸地图
  • Hugging Face Pipeline加载失败?4类CUDA版本兼容性暗坑,附自动化检测CLI工具(限免72小时)
  • Android Studio装AI插件总失败?手把手教你搞定Bito和Codeium的安装、登录与配置(2024最新)