目录

文档

中文文档:https://www.gohugo.org/doc

常用命令工具

官方命令工具:Hugo命令

本地服务预览

hugo server

生成静态文件

注意:目前我们已经通过github actions完成hugo的持续集成编译构建部署,不再需要在本地手动编译静态网站页面。

# 格式:
# hugo -d html/静态文件目录/

hugo -d I:\src\hugo\9ong-html\

自定义hugo格式化md文件

这个是自己写通过python写的windows cmd命令工具,用于格式化markdown文件。

hugo-md-format

自定义md文件图片替换为七牛云图片

这个是自己写通过python写的windows cmd命令工具,用于将markdown文件中第三方图片整体替换为七牛云图片

qiniu-img-replace

文章属性Front Matter设置

官方文档参考Front Matter内置 Fromt Matter

Front Matter范例

---
title: "项目计划:代码未动,计划先行"
isCJKLanguage: true
date: 2019-07-02 09:36:20
categories: 
- 软件工程
tags: 
keywords: 
---

自定义支持部分显示showless

自定义属性,文章支持只显示部分内容。

---
title: "11项目计划:代码未动,计划先行"
isCJKLanguage: true
date: 2019-07-02 09:36:20
categories: 
- 软件工程
tags: 
keywords: 
showless: true  #设置部分内容可访问
---

自定义支持脑图mindmap

自定义属性,文章支持脑图/思维导图

mindmap: true #为true时通过脑图渲染节点

文章中如何写脑图节点:自定义mind脑图shortcodes

自定义支持绘图mermaid

采用mermaid的绘图方案,官方文档:mermaid绘图帮助文档

---
mermaid: true #为true时支持mermaid绘图展示
---

流程图:

graph TD;
    A-->B
    A-->C
    B-->D
    C-->D

时序图:

sequenceDiagram;
    Alice->>John: Hello John, how are you?
    activate John
    John-->>Alice: Great!
    deactivate John

更多图参考:官方帮助文档:mermaid绘图帮助文档

注意:需要科学上网。

shortCodes

官方文档 shortcodes

自定义mind脑图shortcodes

根据脑图的大小样式,共有3个脑图的shortcodes:mind-sm, mind-md, ming-lg,分别对应height为400px,800px,1600px的脑图显示范围。

shortcode文件详见:layots/partials/shortcodes/mind-sm.html等

mind-sm范例:

  • 根目录
    • 目录1
      • 目录11
      • 目录12
    • 目录2
      • 目录21

还支持mind-md、mind-lg

小技巧

内联md文件自动生成文章URL

[Neat](http://www.9ong.com/092020/%E5%A6%82%E4%BD%95%E6%B4%97%E7%A2%97.html)
[About](/092020/%E5%A6%82%E4%BD%95%E6%B4%97%E7%A2%97.html#who)

如何置顶文章

文章默认按照时间排序,如果我们想置顶某篇文章,可以在FrontMatter设置weight属性(权重),权重最大文章在最前面。

---
weight: 1000
---

持续补充 @tsingchan