首页 on 東雲 Nano

从零搭建東雲 Nano：一次 Hugo 博客上线记录

Sat, 05 Sep 2026 17:30:00 +0800

作者说明：本文由 OpenAI Codex 根据本次建站过程整理并撰写。

我想要一个属于自己的博客：页面安静、阅读舒服，可以使用自己的域名，而且以后更新文章不能太麻烦。

于是，東雲 Nano 从一个本地文件夹开始，经过 Hugo、GitHub、Vercel 和阿里云 DNS，最终在 shinonome-nano.me 上线。这篇文章把整个过程记录下来，也保留那些真正遇到过的问题。

最终采用的方案

网站的工作链路是：

本地 Hugo 源码 → GitHub 私有仓库 → Vercel 自动构建 → 自定义域名

各部分的职责很清楚：

Hugo 把 Markdown 文章生成静态网页；
GitHub 保存源码和每次修改记录；
Vercel 自动构建、托管网站并提供 HTTPS；
阿里云 DNS 把已经购买的域名指向 Vercel。

这是一个纯静态博客，没有数据库，也不需要自己维护服务器。对个人写作而言，结构简单，后续负担也小。

为什么选择 Hugo

Hugo 是一个静态网站生成器。文章以 Markdown 文件保存，构建后得到普通的 HTML、CSS 和 JavaScript 文件。

它的优点很直接：页面加载快；源码和文章可以长期保存在本地；不依赖后台管理系统；需要搬家时只要带走仓库；写完文章推送到 GitHub 后即可自动发布。

这次使用的 Hugo 版本是 0.165.0。固定版本很重要，后面遇到的部署故障正好说明了这一点。

从空目录开始搭建

项目位于 Windows 的 D:\shinonome-nano-blog。站点没有直接套用完整的现成主题，而是围绕个人写作重新制作布局和样式，最终包含：

首页、文章列表与文章详情；
标签、归档、关于和站内搜索；
自定义 404 页面与深色模式；
阅读进度条、文章目录和前后篇导航；
canonical、Open Graph、站点地图和 robots.txt 等基础 SEO 信息。

视觉上最初使用了偏粉的色彩，后来调整为更朴素的灰绿色与暖金色。字体也没有继续依赖 Google Fonts，而是改用本地系统字体栈，减少外部资源对访问速度的影响。

你好，東雲

Sat, 05 Sep 2026 09:00:00 +0800

欢迎来到東雲 Nano。

“東雲”是天将亮时，东方天空泛起的微光。这个名字很适合一处刚刚开始、慢慢积累的个人空间。

在这里会写什么

技术实践与踩坑记录
日常观察与阅读笔记
偶尔出现的小作品

愿每一次记录，都像清晨的第一束光一样具体。

文字的形状：博客排版漫游

Fri, 04 Sep 2026 20:30:00 +0800

好的排版不会抢走内容的注意力。它更像一条安静的小径，让眼睛知道下一步该往哪里走。

标题与层次

一篇长文章需要清晰的结构。二级标题划分章节，三级标题则适合解释章节中的某个具体问题。

留白不是浪费

留白能让不同概念之间产生呼吸。与其用大量边框分隔内容，不如通过距离建立自然层次。

写作并不是把页面填满，而是把真正重要的东西留下来。

列表与强调

写作时经常需要整理一些并列信息：

先说清楚问题是什么。
给出必要的背景。
最后提供可以执行的结论。

无序列表更适合没有先后关系的内容：

足够清晰的标题
舒适的行高与行宽
克制而一致的颜色

正文里也可以使用 重点文字、轻微强调，以及像 hugo server 这样的行内代码。

代码展示

下面是一段简单的 JavaScript：

const greeting = (name) => {
  return `早上好，${name}。`;
};

console.log(greeting("東雲 Nano"));

代码区域应该与正文有所区别，但仍然属于同一套视觉语言。

表格

元素	作用	使用建议
标题	建立结构	保持层级连续
引用	补充声音	避免篇幅过长
代码	展示实现	标注语言类型

最后的检查

真正的测试来自阅读。桌面端需要控制行宽，手机端则应保证文字大小、代码横向滚动和目录操作都足够自然。

如果你读到这里没有被排版本身打断，那么它已经完成了大部分工作。

关于

Mon, 01 Jan 0001 00:00:00 +0000

你好，这里是 東雲 Nano。

这个博客用来记录技术、生活，以及那些容易被日常忽略的小小灵感。

你可以从文章开始阅读，或通过标签寻找感兴趣的主题。