02 · 博客 · 2026-08-02
我是如何搭建这个作品集网站的
记录从零搭建纯静态三语作品集的过程：Markdown 即内容、网页后台更新、一键原子发布，以及为什么“静态”依然是正确的选择。
发布于 · 2026-08-02 阅读时长 · 约 1 分钟 标签 · 个人网站，建站
为什么选择纯静态
作品集网站的核心诉求是快和稳。没有后台、没有数据库，打开就是完整页面，服务器几乎不会出问题，也几乎不需要维护。
结构设计
采用 /zh、/en 与 /ja 三套目录存放同构内容，页面之间一键切换语言。build.py 把 Markdown 和模板渲染成静态 HTML，每个页面都有独立地址，方便分享和收录。
内容用 Markdown
新增一篇文章 = 新建一个 .md 文件：
---
title: 文章标题
date: 2026-08-07
tags: 标签
---
正文内容...后来我加了一个轻量后台（server/admin_server.py），它直接读写这些 Markdown 文件，并在网页上触发重新构建。所以日常更新不需要 SSH，改的仍然是同一份源文件——静态与好维护并不冲突。
一键发布
bash scripts/publish.sh 完成构建后，把 dist/ 原子替换到 /var/www/portfolio，失败时自动回滚。因为发布动作固定且可重复，我可以随时改内容，不怕把线上弄坏。
自动化：每日简报
博客里还有一块自动化内容：ai-design-daily 归档 + scripts/daily_to_blog.py 把它转成中英日三语的博客文章。机器先生成，人工再润色，然后走同一套构建发布流程。工具负责重复劳动，人负责判断。
部署
服务器上只需要一个 Nginx 提供静态文件。备案已经通过，域名 huxuancheng.top 已绑定服务器；HTTPS 也已经启用，全站通过 https 访问。