Hugo 基础用法。

HUGOMORE42

创建页面

1
$ hugo new post/mypage.md

生成的文件位置: content/post/mypage.md

hugo 会在这个 MarkDown 文件顶部会自动添加相关参数:

  • title 页面标题
  • date 发布时间
  • draft 是否草稿(发布草稿需要使用buildDrafts参数)
  • tags 标签
  • categories 页面类别数组。如: ["category_a", "category_b"]
  • description 页面 description 部分

可以在页面中使用 HUGOMORE42 这个标记来来显示 “更多” 。

运行 web 服务器

1
$hugo server --buildDrafts

使用 hugo server 可运行一个 web 服务器,默认监听端口 1313
常用参数:

  • t 指定主题。 如: -t hyde
  • w 监视 MarkDown 文件变更以自动重新渲染页面。
  • buildDrafts 渲染标记为 draft 的页面。

其它

  • 插入图片
    图片文件保存在 static/media 目录。
    插入文件:
1
2
{ { % img src="/media/example.jpg" alt="example" % } }
// 需要删除百分号和{}之间的空格
  • 生成站点所有页面 直接运行 hugo 即可。
    相关参数:
  • buildDrafts 输出标记为 draft 的页面。