Hugo克隆站点和迁移计划

Hugo 的基础支撑 - 安装和运行

以winodws为主，使用 Windows PowerShell 安装

打开 Windows PowerShell ，不是（管理员）版的，输入下方命令，等待安装。

1 2	`# 下载 Hugo 扩展版本 winget install Hugo.Hugo.Extended`

关闭终端，重新打开一次。
输入 hugo --version ，或 hugo version 检查版本信息。

v0.136.5-46cccb021bc6425455f4eec093f5cc4a32f1d12c+extended windows/amd64 BuildDate=2024-10-24T12:26:27Z VendorInfo=gohugoio

使用 CD + 你需要预置的目录
输入 hugo new site Blog Blog 为你要存放 Hugo 的目录
输入 cd Blog 进入创建好的 Hugo 目录，里面有 Hugo 释放的文件
输入 git init 构建（需要安装git和配置path环境）
重新配置好后，记得cd到你创建的目录 Blog
输入 git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book 添加 Hugo-book 主题
手动找到你新建的 Blog 目录，找到 hugo.toml 文件并打开
在底部添加配置 theme = 'hugo-book' hugo-book为默认主题
运行 hugo server 启动
添加项目命令（可手动在 content 目录添加）

1	`hugo new content posts/my-first-post.md`

启动服务

#携带草稿启动
hugo server --buildDrafts
#更方便 -D
hugo server -D

调试完成后可以清理文件重新生成并运行

1
2
3

# 生成并清理站点
hugo --cleanDestinationDir
hugo server

这样你就完成了一次 Hugo 构建

Hugo 的目录结构

用 Hugo 创建的网站共有 7 个文件夹和 1 个文件，这些文件分别代表：

archetypes：存放用 hugo 命令新建的 Markdown 文件应用的 front matter 模版
content：存放内容页面，比如「博客」、「读书笔记」等
layouts：存放定义网站的样式，写在layouts文件下的样式会覆盖安装的主题中的 layouts文件同名的样式
static：存放所有静态文件，如图片
data：存放创建站点时 Hugo 使用的其他数据
public：存放 Hugo 生成的静态网页
themes：存放主题文件
config.toml：网站配置文件（hugo.toml / hugo.yaml）

配置 Hugo 主题

一般安装的 Hugo 主题的文件结构中都会有 exampleSite 文件夹，也是你在选择主题时参考的网站 demo。
把 exampleSite 的文件复制到站点目录，在此基础上进行基础配置。非常推荐这么做，这样做能解决很多「为什么明明跟教程一步一步做下来，显示的结果却不一样？」的疑惑。（这主要是因为不同的主题模版配置文件不同导致的。）
在把exampleSite文件复制到站点目录时，请根据对应文件夹进行复制文件
- 比如exampleSite下有 content , static 和 config.toml 3 个文件，就找到你自己的站点跟目录下这对应的三个文件。在把对应目录中的内容分别复制过去。
其中在复制config.toml的内容时要注意：

1	`baseURL = "https://example.com/" #把https://example.com/改成自己的域名`

如果你没有在 GitHub Pages 中设置自定义域名，这里的域名应该填 https://.github.io/ （⚠️ 注意：最后的/不要忘了加）themes

1	`themes = "你选择的主题名字"。 #这一行命令代表启用你安装的主题`

在 config.toml 中输入这行命令才能启用安装的主题，不过一般这行命令在你复制 exampleSite 的配置文件信息时，主题作者已经写好了这行。

剩余的需要自行在主题的 hugo.toml 或 config.toml 配置，如果是新建立的站点，这需要花费一段时间去调整每个参数。

参考内容：如何用 GitHub Pages + Hugo 搭建个人博客 · KrislinBlog

镜像一个 Hugo 站点 - MD简明版

原因：在2024年5月2日实测所有Gitee Pages服务均已挂，一律返回502.全站无任何通知声明，Gitee群里无人回应。止增笑耳；其中收录的MK简明版失效，无法访问，因此我花了点时间镜像了一份MK简明版文档，并将其收录到友链中。

原有的md简明版网站：

A Study Note for Markdown.

通过时光机预览md简明版原站点：

https://web.archive.org/web/20230602143806/https://keatonlao.gitee.io/a-study-note-for-markdown/syntax/#%E5%85%B6%E4%BB%96-html-%E6%94%AF%E6%8C%81

后来我发现有一个md简明版克隆站点：（内容差不多，不过整体的效果不太像）

https://md.xalaok.top/

因此，我最终镜像了一个md简明版网站

镜像站：小晓de雨滴・ MD简明版

克隆一个这样的网站需要先准备和被克隆站点接近的 Hugo 版本，然后调整 config 的参数配置，和构建网站，最好要有一个 pages 静态页面，不过离线的也行。还要有一定的耐心。

# 构建离线站点（适用此站点的文档手册）
https://bootstrap.hugoblox.com/hugo-tutorials/offline-site/

# 这是一个较早期的版本，因此不能使用新的 Hugo 运行它，不然会报错

# Hugo 0.78
https://github.com/gohugoio/hugo/releases/tag/v0.78.0

# 直接下载 hugo_extended_0.78.0_Windows-64bit.zip
# 解压文件 hugo.exe 提取到下载好的md文档目录 `a-study-note-for-markdown-master` - `src`
# 直接在地址栏输入 cmd 打开 cmd 窗口
# 输入 hugo server
# cmd会输出这样一段内容

WARN 2024/10/29 15:07:38 Module "wowchemy" is not compatible with this Hugo version; run "hugo mod graph" for more information.
Start building sites …

                   | EN
-------------------+-----
  Pages            | 65
  Paginator pages  |  0
  Non-page files   |  0
  Static files     | 13
  Processed images | 25
  Aliases          |  4
  Sitemaps         |  1
  Cleaned          |  0

Built in 342 ms
Watching for changes in C:\test\a-study-note-for-markdown-master\src\{assets,content,data,layouts,static,themes}
Watching for config changes in C:\test\a-study-note-for-markdown-master\src\config.toml, C:\test\a-study-note-for-markdown-master\src\config\_default, C:\test\a-study-note-for-markdown-master\src\themes\wowchemy\config.yaml, C:\test\a-study-note-for-markdown-master\src\themes\netlify-cms-academic\config.yaml, C:\test\a-study-note-for-markdown-master\src\go.mod
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/a-study-note-for-markdown/ (bind address 127.0.0.1)
Press Ctrl+C to stop

# 复制这个链接 http://localhost:1313/a-study-note-for-markdown/
# 现在可以进入浏览器访问它
# 修改尾缀,定位目录 a-study-note-for-markdown-master\src\config\_default 
# 找到配置文件 config.toml 定位到13行

# The URL of your site.
# End your URL with a `/` trailing slash, e.g. `https://example.com/`.
baseurl = "https://keatonlao.gitee.io/a-study-note-for-markdown/"

# 将地址修改为你的地址，例如： （fxy5750.github.io）
# 将尾缀修改为你需要的尾缀，例如 （tool/mkdocs）
# 尾缀要符合你放在服务器的路径 ./tool/mkdocs
# 修改后保存

# 生成并清理站点
hugo --cleanDestinationDir
hugo server

# 现在窗口就会提示一串新路径
# 回到 src 根目录，找到 public 文件，将其复制到你需要指定的地方，并更名
示例：mkdocs
路径： ./tool/mkdocs

克隆站点到这里就结束了，虽然很简单，但它却是我花了一天的时间去琢磨，学习 hugo 的基础，搭建一个简单的blog页面，然后在克隆站点。

利用 Hugo 为 Hexo 新增功能 - 迁移计划

迁移目的？为什么需要迁移：原则上来说 Hexo 驱动的 Fluid 仍然是我使用这个博客的主站点，会利用 Hugo 的部分功能来实现辅助，例如照片墙，即刻说说，vurepress/hugobook做文档，以及 Dream 主题展示主要作品。

计划使用到的开源主题

短文推文博客样式：

Moments | Hugo Themes

主题预览：Moments Demo

主题下载：FarseaSH/hugo-theme-moments: A Hugo theme designed for micro-blogging. 专为动态发布设计的Hugo主题

更多Moments用例: 情侣点滴 | 朋友分享 | 个人成长 | 产品更新

特点 Feature

专门支持短博文的 Hugo 主题
响应式设计，桌面端&手机端精心适配
拥有和社交平台一致的图片浏览体验
简洁的设计，纯净的体验，摆脱社交平台广告
支持在 Moments 中分享主流互联网平台的信息（朋友圈文章，知乎，哔哩哔哩，网易云音乐，等等）
设计上支持多用户，和不同的人一起搭建不同的 Moments 空间

照片墙示例主题：

Gallery Deluxe 画廊 |Hugo 主题

参考效果预览：staticbattery.com

主题下载：bep/gallerydeluxe: Fast Hugo gallery theme/module suitable for lots of images.

特点 Feature

一个 Hugo 模块，用于显示照片库。它非常快速/有效，尤其是在您显示大量图像时。
这个主题就是你在 staticbattery.com 上看到的，在撰写本文时，它在移动和桌面的 Google PageSpeed 上得分为 100。

hugobook主题：

Book | Hugo Themes

主题下载：alex-shpak/hugo-book: Hugo documentation theme as simple as plain book

特点 Feature

Hugo 文档主题像普通书一样简单
干净简单的设计
轻便且适合移动设备
多语言支持
可定制
零初始配置
方便的短代码
评论支持
简单的博客和分类法
主要功能无需 JavaScript 即可工作
深色模式

Hugo Dream主题：

Dream | Hugo Themes

主题下载：g1eny0ung/hugo-theme-dream: 🌱 A Hugo theme named Dream.

主题演示：首页 | g1eny0ung 的博客

主题文档：Quick Start | Hugo Theme Dream

# 组图概览

{% gi total n1-n2-... %}



{% endgi %}

站点新闻

#迁移通知 #镜像站点

Hugo克隆站点和迁移计划

https://fxy5750.github.io/2024/10/29/41-Hugo/

作者

fxy5750

发布于

2024年10月29日

更新于

2024年10月29日

许可协议

四足相机机器人模型资产上一篇

天赋很重要吗？人生是否有意义？下一篇