网站建立记录

🚀 博客搭建全流程笔记 (Pelican + GitHub + Cloudflare)

核心架构：

  • 发动机：Python + Pelican (静态网站生成器)

  • 仓库：GitHub (版本控制与存储)

  • 发布端：Cloudflare Pages (全球 CDN 加速 + 自动化构建)

📅 第一阶段：基础设施准备

1. 域名与 DNS

  • 购买：在 Spaceship 购买高性价比数字域名。

  • 托管：登录 Spaceship 后台，将 Nameservers (NS) 修改为 Cloudflare 提供的地址。

  • 意义：利用 Cloudflare 的全球 CDN 加速、免费 SSL 证书（HTTPS）以及后续的 Pages 托管服务。

2. 本地环境初始化 (Python)

在 PyCharm 或 VS Code 终端执行以下核心命令：

PowerShell

# 1. 创建虚拟环境 (隔离项目，防止污染全局库)
python -m venv .venv

# 2. 激活环境 (Windows) -> 每次写博客前必做！
.venv\Scripts\activate
# 注：Mac/Linux 使用 source .venv/bin/activate

# 3. 安装 Pelican 和 Markdown 支持
pip install "pelican[markdown]"

# 4. 初始化项目 (一路回车，URL 暂时留空)
pelican-quickstart

🛠️ 第二阶段：版本控制 (Git) —— 最关键的一步

此阶段极易踩坑，必须严格执行 .gitignore 配置，否则会导致仓库爆炸。

1. 创建防爆盾：.gitignore

在项目根目录（和 pelicanconf.py 同级）新建文件 .gitignore，填入以下内容：

Plaintext

.venv/
output/
__pycache__/
.idea/
cache/
*.pyc

⚠️ 警示：如果不加这个文件，Git 会试图上传虚拟环境里成千上万个 Python 库文件，导致上传失败或崩溃。

2. 推送到 GitHub

PowerShell

git init
git add .
git commit -m "Initial commit"
# 关联远程仓库 (URL 替换为你自己的)
git remote add origin https://github.com/你的用户名/my_blog.git
git push -u origin master

☁️ 第三阶段：云端部署 (Cloudflare Pages)

1. 核心配置清单

在 Cloudflare Pages 后台关联 GitHub 仓库后，Build Settings 必须精准填写：

配置项 填写内容 备注
Framework preset None 不要选其他框架
Build command pip install pelican[markdown] && pelican content -s publishconf.py 安装依赖并生成网页
Build output output Pelican 默认生成位置
Environment Variables PYTHON_VERSION = 3.11 关键！ 即使本地是 3.14，云端也要填 3.11

2. 域名绑定

  • 在 Pages 项目页点击 Custom Domains。

  • 输入在 Spaceship 购买的域名，Cloudflare 会自动完成 DNS 解析记录的添加。

✍️ 第四阶段：日常创作与维护 (Loop)

搭建完成后，以后的日常只需要做三件事：

  1. 写 (Write)：

    • 在 content/ 目录下新建 .md 文件。

    • 元数据必填：文件头部必须包含 Title:, Date:, Category: 等信息。

  2. 存 (Commit)：

    PowerShell

    git add . git commit -m "新文章：标题"

  3. 发 (Push)：

    PowerShell

    git push

    🚀 自动化：Git 推送后，Cloudflare 会自动检测更新并重新部署，全球用户立刻就能看到新内容。

📝 附录：踩坑与故障排除日志 (Troubleshooting)

🔴 故障 A：Git 试图上传数千个文件 (.venv 问题)

  • 现象：git status 满屏红色，包含 .venv/Lib/...。

  • 原因：.gitignore 文件缺失、位置错误，或在创建该文件前就已经执行了 git add。

  • 急救方案：

    PowerShell

    ```

    1. 确保 .gitignore 在根目录且内容正确

    2. 清空 Git 缓存

    git rm -r --cached .

    3. 重新添加

    git add . ```

🔴 故障 B：Git 报错 "Author identity unknown"

  • 原因：新环境未配置身份。

  • 解决：

    PowerShell

    git config --global user.email "你的邮箱" git config --global user.name "你的名字"

🔴 故障 C：仓库太乱，想重头再来 (重生之术)

  • 解决：

    PowerShell

    rm -Recurse -Force .git # 删除旧的 Git 记录 git init # 重新初始化 git add . # 重新添加

💡 常用命令备忘

  • 本地预览：pelican --listen (访问 localhost:8000)

  • 云端卡顿：如果更新后线上没变，去 Cloudflare 控制台看 Deployments 日志，通常是构建命令写错或网络波动。

links

social