如何使用 hugo 以及 DoIt 主题

dcdyouget 收录于类别 Hugo

2024-12-02 2024-12-02 约 218 字预计阅读 1 分钟

如何开始编写文章

在文档的开头,使用 markdown 语法的 yaml 块将一下配置写入

yaml

# 标明改文章是属于那个文件夹的
categories:
  - 开发
  - 测试
# 编写日期
date: "2024-12-02"
# 文章的标签
tags:
  - k8s
# 文章标题
title: "使用 kubekey 安装 k8s"
# 作者 需要提前在 /mysite/data/authors 下边配置
authors: [dcdyouget]
# 文章的简述,如果设置改值则会在首页中内容
summary: "在 ubuntu 2204 通过 kubekey 安装 k8s 1.29 :tent: "
# 如果设置为 true 则改文章不会显示在主页上
hiddenFromHomePage: false

更多配置内容可以查看这个链接的第三章节 [前置参数]

如何配置作者

在 hugo 运行目录路径

bash

/mysite/data/authors/

创建文件,dcdyouget.toml

toml

link = "http://dcdyouget.top"
email = "1376372464@qq.com"
name = "dcdyouget"

然后再每个文章的开头 authors 字段中引用即可

hugo 的 config.yaml 配置

yaml

defaultContentLanguage: "zh-cn"
languageCode: "zh-CN"
theme: 'DoIt'
# 网页在标签中的名称
title: "Log_Every_Thing"
# 开启enableEmoji支持
enableEmoji: true

menu:
  main:
    - identifier: "posts"
      name: "文章"
      url: "/posts/"
    - identifier: "tags"
      name: "标签"
      url: "/tags/"
    - identifier: "categories"
      name: "分类"
      url: "/categories/"

outputs:
  home:
    - "HTML"
    - "JSON"
    - "RSS"
  page:
    - "MARKDOWN"
    - "HTML"

params:
  description: "记录"
  search: 
    enable: true
    type: "fuse"
  header:
    title:
      name: "Log_Every_Thing"
      # 设置播客标题名称动画为打字机动画
      typeit: true
  typeit:
    # 字符出现的速度
    speed: 100
    # 光标闪烁速度
    cursorSpeed: 1000
    # 光标的样式
    cursorChar: "|"
    # 打字结束之后光标的持续时间 (单位是毫秒, "-1" 代表无限大)
    duration: -1
  footer:
    hugo: true
    custom: "Shaped by Yesterday"
  home:
    profile:
      # 设置 图标 url 位置相对于/assest 路径
      avatarURL: "icon.png"
  page:
    # 配置文章原始文件的链接
    linkToMarkdown: true
    # 是否启用字数统计
    enableWordCount: true
    # 阅读时间统计
    enableReadingTime: true
    toc:
      # 是否使用目录
      enable: true
      # 是否使用静态目录
      keepStatic: false
      auto: true
    comment:
      # 是否启用评论系统
      enable: false
    code:
      maxShownLines: 10