基于 Hugo + Org Mode + Github Page 的静态站点搭建

sudo pacman -S hugo

# 随便一个 REMAD.md
echo "# Just a README" >> README.md
git init
git add README.md
git commit -m "first commit"
# 新基础分支
git branch -M main
git remote add origin [email protected]:Name/Name.github.io.git
# 提交到基础分支
git push -u origin main

hugo new site blog

hugo server

# blog 下
git clone [email protected]:<Name>/<Name>.github.io.git project

# 在 blog 目录下操作
git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt

publishDir: project/docs
# 站点URL
baseURL: https://fingerknight.github.io/
# 默认语言
defaultContentLanguage: zh-cn
languageCode: zh-CN
hasCJKLanguage: true
# 主题
theme: LoveIt
# 网站标题
title: 手指骑士的病房
# 作者
author:
  name: Finger Knight
  email: [email protected]
  link: https://fingerknight.github.io/about
# 默认每页列表显示的文章数目
paginate: 12
# 谷歌分析代号 [UA-XXXXXXXX-X]
googleAnalytics: ""
# 版权描述，仅仅用于 SEO
copyright: ""
# 是否使用 robots.txt
enableRobotsTXT: true
# 是否使用 git 信息
enableGitInfo: false
# 是否使用 emoji 代码
enableEmoji: true
# 忽略一些构建错误
ignoreErrors: ["error-remote-getjson", "error-missing-instagram-accesstoken"]

# 标记语言设置
markup:
  highlight:
    noClasses: false
    codeFences: true
    guessSyntax: true
    lineNos: true
    lineNumbersInTable: true
  goldmark:
    extensions:
      definitionList: true
      footnote: true
      linkify: true
      strikethrough: true
      table: true
      taskList: true
      typographer: true
    renderer:
      # 是否在文档中直接使用 HTML 标签
      unsafe: true
  # 目录
  tableOfContents:
    startLevel: 2
    endLevel: 6

# 网站地图配置
sitemap:
  changefreq: weekly
  filename: sitemap.xml
  priority: 0.5

# Permalinks 配置
Permalinks:
  posts: ':filename'

# 输出设置

outputs:
  home:
    - HTML
    - JSON
  page:
    - HTML
    - MarkDown
  section:
    - HTML
  taxonomy:
    - HTML
  taxonomyTerm:
    - HTML

# 语言设置
language:
  zh-cn:
    contentDir: content
    languageName: 中文

# 菜单设置
menus:
  main:
    - identifier: main
      pre: <i class="fa-solid fa-house"></i>
      post: ''
      name: 
      url: /
      title: 主页
      weight: 1
    - identifier: tags
      pre: <i class="fa-solid fa-tags"></i>
      post: ''
      name: ''
      url: /tags/
      title: 标签
      weight: 2
    - identifier: posts
      pre: <i class="fa-solid fa-layer-group"></i>
      post: ''
      name: ''
      url: /posts/
      title: 归档
      weight: 3
    - identifier: about
      pre: <i class="fa-solid fa-bed-pulse"></i>
      post: ''
      name: ''
      url: /about
      title: 病历
      weight: 4


# 参数设置
params:
  # 网站默认主题样式 ["auto", "light", "dark"]
  defaultTheme: "auto"
  # 哪种哈希函数用来 SRI, 为空时表示不使用 SRI
  # ["sha256", "sha384", "sha512", "md5"]
  fingerprint: "sha256"
  # 日期格式
  dateFormat: "2006-01-02"

  # 网站标题, 用于 Open Graph 和 Twitter Cards
  title: "手指骑士的病房"
  # 网站描述, 用于 RSS, SEO, Open Graph 和 Twitter Cards
  description: "痴人说梦"
  # 网站图片, 用于 Open Graph 和 Twitter Cards
  # images:
  #   - /logo.png

  # 首部元素
  header:
    # 桌面端导航栏模式 ["fixed", "normal", "auto"]
    desktopMode: fixed
    # 移动端导航栏模式 ["fixed", "normal", "auto"]
    mobileMode: auto
    title:
      # logo: /avatar.png
      name: 手指骑士的病房
      pre: ''
      post: ''
      typeit: false

  # 尾部元素
  footer:
    enable: true
    custom: ''
    hugo: true
    copyright: true
    # 是否显示作者
    author: true
    # 网站创立年份
    since: 2022
    icp: ''
    # 许可协议信息 (支持 HTML 格式)
    license: <a rel="license external nofollow noopener noreffer" href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank">CC BY-NC 4.0</a>

  # Section (所有文章) 页面配置
  section:
    # section 页面每页显示文章数量
    paginate: 20
    # 日期格式 (月和日)
    dateFormat: 01-02
    # RSS 文章数目
    rss: 10

  # List (目录或标签) 页面配置
  list:
    paginate: 20
    dateFormat: 01-02
    rss: 10

  # 主页配置
  home:
    # RSS 文章数目
    rss: 10
    # 主页个人信息
    profile:
      enable: true
      # gravatarEmail: ''
      avatarURL: /img/YunRuAvatar.jpg
      title: ''
      subtitle: 痴人说梦
      typeit: false
      # 是否显示社交账号
      social: false
      # 免责声明
      disclaimer: ''
      # 主页文章列表
    posts:
      enable: true
      paginate: 5
      defaultHiddenFromHomePage: false

  # 文章页面全局配置
  page:
    # 是否在主页隐藏一篇文章
    hiddenFromHomePage: false
    # 是否在搜索结果中隐藏一篇文章
    hiddenFromSearch: false
    # 是否使用 fontawesome 扩展语法
    fontawesome: true
    # 是否在 RSS 中显示全文内容
    rssFullText: false

    prev: false
    next: false
    linktomarkdown: false

    # 开启上下篇
    nav: false

    # 目录
    toc:
      enable: true
      #  是否保持使用文章前面的静态目录
      keepStatic: false
      # 是否侧边目录自动折叠展开
      auto: false

    # 代码
    code:
      # 是否显示代码块的复制按钮
      copy: true
      # 默认展开显示的代码行数
      maxShownLines: 50

    # KaTeX 数学公式
    math:
      enable: true
      inlineLeftDelimiter: ''
      inlineRightDelimiter: ''
      blockLeftDelimiter: ''
      blockRightDelimiter: ''
      copyTex: true
      mhchem: true

    # 地图
    mapbox:
      accessToken: ''
      lightStyle: 'mapbox://styles/mapbox/light-v10?optimize=true'
      darkStyle: 'mapbox://styles/mapbox/dark-v10?optimize=true'
      navigation: true
      geolocate: true
      scale: true
      fullscreen: true

    # 关闭分享
    share:
      enable: false

    # 评论看后面
    # comment:
    #   enable: true
    #   gitalk:

    # 第三方静态资源
    library:
      css: {}
      js: {}

    # 页面 SEO 配置
    seo:
      images: []
      publisher:
        name: ''
        logoUrl: ''

  # TypeIt 配置
  typeit:
    speed: 100
    cursorSpeed: 1000
    cursorChar: '|'
    duration: -1

  # 网站 SEO 配置
  seo:
    image: ''
    thumbnailUrl: ''

  #  第三方库文件的 CDN 设置
  # CDN 数据文件名称, 默认不启用
  # ["jsdelivr.yml"]
  # 位于 "themes/LoveIt/assets/data/cdn/" 目录
  # 可以在你的项目下相同路径存放你自己的数据文件:
  # "assets/data/cdn/"
  # cdn:
  #   data: ''

  # 搜索设置
  search:
    enable: true
    # 搜索引擎的类型 ["lunr", "algolia"]
    type: lunr
    # 文章内容最长索引长度
    contentLength: 4000
    # 搜索框的占位提示语
    placeholder: ''
    # 最大结果数目
    maxResultLength: 10
    # 结果内容片段长度
    snippetLength: 50
    # 搜索结果中高亮部分的 HTML 标签
    highlightTag: em
    # 是否在搜索索引中使用基于 baseURL 的绝对路径
    absoluteURL: false

(with-eval-after-load 'ox
  (require 'ox-hugo)
  (setq org-hugo-base-dir ../blog/"
        ;; org-hugo-section "posts"
        org-hugo-default-static-subdirectory-for-externals "img"
        org-hugo-auto-set-lastmod t
        org-hugo-export-with-toc nil))