目录

文档

中文文档: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: 
---
  • title 内容的标题

  • description 内容的描述

  • date 内容将被排序的日期

  • aliases 一个或多个别名(例如,重命名内容的旧发布路径)的数组,将创建这些别名以重定向到该内容。

    ---
            ...
    aliases:
        - /posts/baidu.html/
        - /2010/01/01/tencent.html
            ...
    ---
    
  • draft 如果为true,将不会呈现,除非hugo –buildDrafts进行编译

  • publishdate 如果在未来,内容将不会被呈现,除非hugo –buildFuture进行编译

  • type 内容的类型(如果未设置,将自动从目录派生)

  • isCJKLanguage 如果为 true,则明确将内容视为 CJKLanguage(.Summary 和 .WordCount 在 CJKLanguage 中可以正常工作),可以解决中文乱码问题

  • weight 用于排序的权重,值越高越排在前面

  • markup 指定"rst"将用于reStructuredText (需要rst2html格式) 或者 “md”(默认) 将用于Markdown格式

  • slug 出现在 URL 尾部的标记, 或

  • url 从 Web 根目录到内容的完整路径。

    如果slug与url两者都不存在,则将使用文件名。

自定义支持部分显示showless

隐藏、密码访问

自定义属性,文章支持只显示部分内容。(需要编码调整themes代码支持自定义变量)

---
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绘图帮助文档

注意:需要科学上网。

自定义URL

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
---

LeanCloud域名更新

域名无法访问的临时解决方案 - 新闻公告 - LeanCloud 用户社区

push: "https://" + n + ".push.lncld.net",
stats: "https://" + n + ".stats.lncld.net",
engine: "https://" + n + ".engine.lncld.net",
api: "https://" + n + ".api.lncld.net"

更换为:

push: 'https://avoscloud.com',
stats: 'https://avoscloud.com',
engine: 'https://avoscloud.com',
api: 'https://avoscloud.com',  

持续补充 @tsingchan