谜之 Hugo

2020-01-03
programming hugo

This article is a bit old and the content may be outdated, so please refer to it with caution and remember to check the latest official materials (such as documentation, etc.)

UPDATE: Hugo 是什么垃圾？现已弃坑。

对新手不友好的 Hugo #

在之前 PKUCard 操作之后加了几个 Github 好友，发现很多（显然是主观感受）都在用 Hugo，也感觉之前用的 Mkdocs 不是像样的博客，早有换掉的意思。于是近期就开始上手试了一下。

说 Hugo 之前先说一下 Python 的 Pelican。Pelican 也是一个博客写作应用，但是因为用户量不够，主题样式太少，并且主题的功能也不健全，（说白了就是不合胃口，）于是就很难受。

不用 Hugo 不知道，用了才发现原来 Markdown 渲染可以有这么快。但是当我按照教程，选了一个主题，按照提示一步一步来的时候。。？！为什么是白页面？怎么还是白的？把配置文件全部照抄还不行？错误提示都是虚假的！令人抓狂

无奈只好变成全部复制下来，再进行改动。。

从 v0.55 到 v0.59 一直有 Bug 的 Hugo #

Source block following a plain list ends up in the last plain list item #556

kaushalmodi commented [on 2 Aug] Hello,

Here's a minimal example to reproduce the issue:

  • item 1
  • item 2
This block should be out of <ul>...</ul>
And also out of blockquote
text

Ref: https://discourse.gohugo.io/t/possible-regression-in-v0-55-5-regarding-lists-containing-code-blocks/18502/4?u=kaushalmodi

/cc @aignas as you seem to be the last person to work on this Blackfriday plain-list/code block issue :)

来，你瞅瞅，现在还是这个样子的😭

v0.60.0 UPDATE: 见“新的引擎”一节

这么不稳定的 Markdown 引擎，没法和 Python 比 😏

仿佛急冰的 toc 功能 #

Hugo 自带的目录功能简直了，因为只能从 h1 开始，否则：

自带的功能，老兄！这种事情都做得出来！NOT PYTHONIC AT ALL!

最后我找到了https://gist.github.com/skyzyx/a796d66f6a124f057f3374eff0b3f99a @looeee 的代码，基本可以满足需求。

修改找到的 TOC 代码 #

如果你要更改标题级别的范围，可以把[2-4]替换成你想要的。

而且这位老兄的代码就是会把标题里的一些诸如don't的标点干掉，也不会保留加粗的格式。

解决办法就是去掉planify | htmlEscape, 并在

{{ $cleanedID := replace (replace $id "id=\"" "") "\"" "" }}
django

后加入

{{- $header := replaceRE "<h[2-4].*?>((.|\n])+?)</h[2-4]>" "$1" $header -}}
django

谜之 Template 语法 #

看了 Hugo 的之后这才发现 Jinja 原来是真的漂亮简洁

就问你and (ConditionA) (ConditionB) 是人话吗？没有not是什么？没有括号也叫 Function？怕是 Shell 用多了？

not的正确打开方式：

{{ if eq (reflect.IsMap site.Params.address) false }}
django

的确。。反人类

奇奇怪怪的 Toml #

放着好好的 YAML 和 JSON 不用，突然冒出来一个 TOML。好像 Markdown 前面加 YAML 已经很常用了，然后跟我说用 TOML，不觉得等于号 有点 丑？不觉得 引号 有点 丑？虽然在做配置文件方面可能有独到之处，对不起，Vim 原生不支持，一键秒杀颜值。

新的引擎 #

突然，Hugo 给我换了一个引擎 https://github.com/gohugoio/hugo/releases/tag/v0.60.0

使用了新的引擎之后之前的问题消失了，但是变成了默认忽略 HTML，需要在config.toml里做修改

[markup.goldmark.renderer]
    unsafe = true
toml

或者config.yml

markup:
  goldmark:
    renderer:
      unsafe: true
yaml

新引擎，新bug #

headerID #

Goldmark 在设置 headerID 的时候，默认是仅保留字母和数字，但是这对 CJK 及其不友好。“更有甚者”，该项目的作者是日本人，竟然不考虑对本国文字的支持？！还说，仅保留字母和数字是合适的默认行为。Excuse me? 不应该原封不动保留 Unicode 才是好的默认行为吗？

据说会在 Hugo v0.63.0 解决，那就拭目以待吧。。

render_link #

本来说好可以支持 link 的 Markdown hook 的，但是呢，只支持[text](url)型，不支持<url>型。。[摊手.jpg]

而且，说好引用其他 Markdown 文档的 render_link 实现居然还有点复杂。。还好找到了官方实现，不然又是大坑。。

Hugo theme，注定又是一个面向 GitHub 编程。

TOC 新回复 #

我又针对 toc 写了一篇博客 hugo-toc，然后有去原来的 gist 上评论了，受到了@looeee 的回复。他说。。。他已经弃坑 Hugo 了，使用 js 解决问题。

我。。。

Leave your comments and reactions on GitHub