时间：   |   分类：     |   阅读： 835 字 ~2分钟

新建的 Hugo 网站存在很多需要配置的地方。 下面是笔者记录的搭建笔记

配置文件

文章目录

解决文章目录不渲染第一级目录

默认情况下，网站左侧是从第二层级渲染。

以下图为例，左侧的文章目录没有渲染右侧的第一级别的目录 rbenv 安装 ruby 失败

image

针对这种情况，我们可以在配置文章增加配置：tableOfContents.startLevel = 1

更多信息可以查看configuration-markup/#table-of-contents

1
2
3
4
5

[markup]
  [markup.tableOfContents]
    startLevel = 1
    endLevel = 3
    ordered = false

配置是否自动在标题标号

某些情况下，我们希望渲染后的 html 自动添加添加 编号

image

同时，某些文章又希望能够 手动 添加 编号

image

针对上面的情况，我们可以通过以下方式支持：

  • 增加一个新的配置选项:disableTocPre

    1
2
3
4

    ---
title: Runloop 源码笔记：如何实现高可用的卡顿监控
disableTocPre: true
---

  • 通过 toc.html，将该属性暴露给生成的网页 disableTocPre={{.Params.disableTocPre}}

    image

  • toc.js 新增以下逻辑，当TableOfContents 的父节点可以获取到 disableTocPre 属性，并且该属性是 true 时，不再自动增加标题编号

    image

日期：无处不在的 2006

虽然之前接触过 Go，但是今天才发现它的语言格式化与其它语言有很大的不同：

  • 普通语言 需要通过 yyyy-MM-dd 表示格式化方式：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

          NSDate *date = [NSDate date];
      NSLog(@"date时间 = %@", date);
      //date时间 = 2018-05-31 06:43:07 +0000
      //如果没有规定formatter的时区，那么formatter默认的就是当前时区，比如现在在北京就是东八区，在东京就是东九区
      NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
      //最结尾的Z表示的是时区，零时区表示+0000，东八区表示+0800
      [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss Z"];
    // 使用formatter转换后的date字符串变成了当前时区的时间
      NSString *dateStr = [formatter stringFromDate:date];
      NSLog(@"字符串时间 = %@", dateStr);
      //字符串时间 = 2018-05-31 14:43:07 +080

  • Go 语言 需要通过 2006-01-02 表示格式化方式：

    1
2

      DateFormat = "2006-01-02"
  YearFormat = "2006年"

列表页标题优化

以笔记为例，默认情况下，列表的标题会变为“笔记 s”，不符合中国人习惯

通过添加下面的配置，我们可以让移除该功能

1

pluralizeListTitles = false

相关链接：pluralizeListTitles

0%