hugo小技巧
目录
文档
中文文档: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
- 目录1
还支持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