配置cloudflare_page

安装

以这个页面 https://gohugo.com.cn/getting-started/quick-start/ 进行初步安装，但要注意，以下主题代码不要使用：

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

应该使用如下克隆主题的代码：

克隆主题，并删除主题中的.git文件夹，使得主题与整个网站架构同一个仓库管理

git clone https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
rm -rf themes/ananke/.git
# 如果在windows下，用以下代码：
Remove-Item -Recurse -Force .\themes\ananke\.git

数学公式问题

在根目录的文件夹layouts下创建partials，在这个文件夹下创建math.html,内容如下：

<script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js" id="MathJax-script" async></script>
<script>
  MathJax = {
    tex: {
      inlineMath: [['\\(', '\\)'], ['$', '$']],
      displayMath: [['\\[', '\\]'], ['$$', '$$']]
    }
  };
</script>

<!-- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.25/dist/katex.min.css" integrity="sha384-WcoG4HRXMzYzfCgiyfrySxx90XSl2rxY5mnVY5TwtWE6KLrArNKn0T/mOgNL0Mmi" crossorigin="anonymous">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.25/dist/katex.min.js" integrity="sha384-J+9dG2KMoiR9hqcFao0IBLwxt6zpcyN68IgwzsCSkbreXUjmNVRhPFTssqdSGjwQ" crossorigin="anonymous"></script>
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.25/dist/contrib/auto-render.min.js" integrity="sha384-hCXGrW6PitJEwbkoStFjeJxv+fSOOQKOPbJxSfM6G5sWZjAyWhXiTIIAmQqnlLlh" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script>
<script>
  document.addEventListener("DOMContentLoaded", function() {
    renderMathInElement(document.body, {
      delimiters: [
        {left: '\\[', right: '\\]', display: true},
        {left: '$$', right: '$$', display: true},
        {left: '\\(', right: '\\)', display: false},
      ],
      throwOnError : false
    });
  });
</script> -->

上面分别展示了mathjax和katex，注意：mathjax用v3版本可以直接用美元符号来进行行内公式设置

配置hugo.toml, 使其可以显示数学公式

baseURL = 'https://example.org/'
locale = 'en-us'
title = 'My New Hugo Project'
theme = 'ananke'

[markup]
  [markup.goldmark]
    [markup.goldmark.extensions]
      [markup.goldmark.extensions.passthrough]
        enable = true
        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]'], ['$$', '$$']]
          inline = [['\(', '\)'], ['$', '$']]
[params]
  math = true

如果在文章页面不想显示数学公式，可以令 math=false即可。

在主题的baseof.html中添加代码：

<head>
...
  {{ if .Param "math" }}
    {{ partialCached "math.html" . }}
  {{ end }}
...
</head>

数学公式测试页面

+++
date = '2026-05-28T11:13:12+08:00'
draft = false
title = 'My First Post'
+++

## 简介

这是 **粗体** 文本，这是 *斜体* 文本。

访问 [Hugo](https://gohugo.io) 网站！

This is an inline \(a^*=x-b^*\) equation.

测试：
This is another inline $a^*=x-b^*$ equation.


These are block equations:

\[a^*=x-b^*\]

\[ a^*=x-b^* \]

\[
a^*=x-b^*
\]

These are also block equations:

$$a^*=x-b^*$$

$$ a^*=x-b^* $$

$$
a^*=x-b^*
$$

注意，如果要往cloudflare部署，需要将draft设置为false

部署cloudflare

以下这个页面是能正常使用的：

https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site/

不过要在里面创建对应hugo版本的字符串，我使用的Variables and Secrets是:

HUGO_VERSION
0.161.0

余下的就是在github创建仓库，并用cloudflare与github连接。

关于推送时的问题

如果用了代理，则需要用下面代码确保推送github成功：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

关于设置标签问题

在hugo.toml中添加：

[taxonomies]
  tag = "tags"
  category = "categories"

[[menu.main]]
  name = "标签"
  url = "/tags/"
  weight = 10

[[menu.main]]
  name = "分类"
  url = "/categories/"
  weight = 20

在 archetypes/default.md文件中，添加：

+++
date = '{{ .Date }}'
draft = true
title = '{{ replace .File.ContentBaseName "-" " " | title }}'
tags = []
categories = []
+++

解决`obsidian`与`hugo`之间的图片问题

思路：采用bundle的方式，即以文件夹形式组织一篇文章，只不过这个文件夹的名字即是当前博客文章的名字，其中的index.md即是正文，而该文件夹下的所有图片可以被hugo自动解析。以一篇文章为例：

这就是一个完整的bundle。

在 Obsidian 中设置，让它插入图片时自动使用标准 Markdown 格式：

进入 Obsidian 设置 → 文件与链接
找到 “内部链接类型”，改为 “基于当前笔记的相对路径”
找到 “使用 Wikilinks”，关闭这个开关（取消勾选）

这样设置后，再拖入图片，插入的格式就会变成 ![](2026-06-20_180348.jpg) 而不是 ![[...]]。

为了能用hugo new命令，需要进行以下设置：

创建原型模板：在 archetypes/ 下建一个文件夹（如 post-bundle），里面放一个 index.md 作为模板。
使用命令创建：

hugo new --kind post-bundle .\content\posts\测试2

添加链接

两种方法：

(1) 在content下建立links.md:

+++
title = "极速访问"
date = 2026-06-21T16:21:01+08:00
layout = "links"
summary = "links"
+++

### Heros

* [Gauss's Blog](https://gaussup.pages.dev/) 这是一个很棒的小家伙，快来围观！

(2) 修改toml配置文件：

baseURL = 'https://iefanfn.pages.dev/'
locale = 'en-us'
title = '随心记'
theme = 'PaperMod'

[markup]
  [markup.highlight]
    # 🛠️ 确保下面这两行是 true
    codeFences = true
    guessSyntax = true
    # 挑选一个你喜欢的高亮主题（monokai, dracula, github 等）
    style = "monokai" 
    noClasses = true

  [markup.goldmark]
    [markup.goldmark.extensions]
      [markup.goldmark.extensions.passthrough]
        enable = true
        [markup.goldmark.extensions.passthrough.delimiters]
          block = [['\[', '\]'], ['$$', '$$']]
          inline = [['\(', '\)'], ['$', '$']]
[params]
  math = true
  ShowCodeCopyButtons = true
  
  [params.profileMode]
    enabled = true
    title = "IEFAN"
    subtitle = "随 心 所 记"

  # 
  [[params.socialIcons]]
    name = "🚀"
    url = "https://gaussup.pages.dev/"
    title = "来看看成长中的大神！"


[taxonomies]
  tag = "tags"
  category = "categories"

[[menu.main]]
  name = "标签"
  url = "/tags/"
  weight = 10

[[menu.main]]
  name = "分类"
  url = "/categories/"
  weight = 20

[[menu.main]]
    name = "友链"
    url = "/links/"
    weight = 30     # 数字越大越靠右

安装#

数学公式问题#

在根目录的文件夹layouts下创建partials，在这个文件夹下创建math.html,内容如下：#

配置hugo.toml, 使其可以显示数学公式#

在主题的baseof.html中添加代码：#

数学公式测试页面#

部署cloudflare#

关于推送时的问题#

关于设置标签问题#

解决obsidian与hugo之间的图片问题#

添加链接#

安装