欢迎来到我的博客

这是站点的第一篇文章。整个站点是用 Markdown 写文章 + 本地生成器 产出的纯静态网站，部署到任何支持静态文件的服务器（Nginx / Apache / 对象存储）都能跑。

这个博客有什么特点

• 零运行时依赖：服务器上不需要 Node、Python 或数据库。
• 写作即发布：你只管写 .md 文件，运行一下生成脚本即可得到整站。
• 快：纯静态，加载速度极快，SEO 友好。

简单，往往是最可靠的方案。

接下来

下面这篇《如何写一篇文章》会告诉你文章怎么写、放在哪、怎么生成。把示例文章删掉，换成你自己的内容即可。

如何写一篇文章

发布新文章只需要三步。

1. 新建文件

在 content/posts/ 目录下新建一个 .md 文件，建议文件名带上日期前缀，例如：

content/posts/2026-10-21-my-first-post.md

2. 填写头部信息（frontmatter）

文件最顶部用 --- 包裹一段 YAML 信息：

---
title: "文章标题"
date: 2026-10-21
tags: [标签1, 标签2]
summary: "一句话摘要，会显示在首页和 RSS 里"
---

3. 写正文并生成

头部下面就是正文，支持标准 Markdown 语法。写完后在项目根目录运行：

python build.py

生成的整站会出现在 public/ 目录，把它上传到服务器即可。

支持哪些语法

• 标题、列表、引用、分割线
• 加粗、斜体、行内代码
• 代码块（带等宽字体与边框）
• 链接与图片

就这么简单，去写你的第一篇吧。

部署到云服务器的一些笔记

纯静态站点部署的核心就一句话：把 public/ 传到网站根目录，用 Nginx 指过去。

关键步骤

1. 在服务器安装 Nginx（apt install nginx 或 yum install nginx）。
2. 把 public/ 内容传到 /var/www/your-domain/。
3. 配置一个 server 块，root 指向该目录，index index.html。
4. 域名 A 记录解析到服务器公网 IP。
5. （可选）用 Let's Encrypt 申请免费 HTTPS 证书。

一个最小 Nginx 配置

server {
    listen 80;
    server_name your-domain.com www.your-domain.com;
    root /var/www/your-domain;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

常见坑

• 防火墙/安全组没放行 80/443 端口 → 浏览器打不开。
• 域名没解析或 TTL 未生效 → 等几分钟再试。
• 文件权限不对 → 保证 Nginx 用户能读取网站目录。

部署遇到问题时，先看 Nginx 错误日志：tail -f /var/log/nginx/error.log。