SL 的家庭生活 — Pixnet 部落格備份

Pixnet 部落格 完整備份，包含 345 篇文章、約 4,600 張圖片。

GitHub Pages 瀏覽：https://shumingyang-opencode.github.io/slfamily-backup/

---

目錄結構

.
├── crawler.py              # 爬蟲腳本（Pixnet → Markdown + 圖片下載）
├── mkdocs.yml              # MkDocs 設定檔（Material Theme）
├── overrides/              # MkDocs 版型覆蓋
│   └── main.html
├── scripts/                # 工具腳本
│   └── gen_image_readme.py # 圖片來源文件產生器
├── AGENTS.md               # 專案說明（AI agent 用）
│
└── output/                 # 所有備份資料
    ├── README.md           # output 目錄索引
    ├── all_posts.json      # 全站文章清單（JSON）
    ├── index.md            # 全站文章索引（Markdown）
    ├── broken_images.md    # 已知破圖清單
    ├── external_images_summary.md  # 外部圖片彙整
    └── posts/{slug}/
        ├── post.md         # 文章內容
        ├── meta.json       # 標題、日期、分類、URL
        ├── images.json     # 已下載圖片清單
        ├── images/         # 本機圖片
        └── README.md       # 圖片來源紀錄

---

各目錄／檔案說明

路徑	說明
crawler.py	Pixnet 爬蟲，下載所有文章與原始圖片
mkdocs.yml	MkDocs 設定（Material 主題、Google Analytics）
scripts/gen_image_readme.py	掃描所有文章，自動產生每篇的 README.md 圖片來源紀錄
output/index.md	全站文章索引（依日期排序）
output/all_posts.json	全站文章資料（JSON）
output/broken_images.md	Pixnet CDN 已失效的圖片清單
output/external_images_summary.md	不在本機 Repo 內的所有圖片完整清單
output/README.md	output 資料夾目錄，含 345 篇文章的 README.md 連結
output/posts/{slug}/README.md	單篇文章的圖片來源紀錄表

---

圖片來源說明

每篇文章目錄下的 README.md 紀錄了該文章所有圖片的來源：

類型	Repo 位置欄位
已下載到本機的圖片	posts/{slug}/images/{filename}
僅有外部連結的圖片	不在 Repo 內 + 完整 URL

外部圖片來源分布

來源	說明
bp.blogspot.com	作者早期 Blogger 文章遺留的圖片（共 7 篇全量使用，部分混合）
pic.pimg.tw	Pixnet CDN（極少數已失效 404）
s.pixfs.net	Pixnet 表情符號 GIF
youtube.com / facebook.com	嵌入的外部平臺連結
mail.google.com	Gmail 表情符號

詳細清單見 output/external_images_summary.md。

---

使用方式

瀏覽文章

直接從 output/README.md 或 output/index.md 進入各篇文章。

重新執行爬蟲

source .venv/bin/activate && python3 crawler.py

已下載的文章會自動跳過。

重新產生圖片來源紀錄

python3 scripts/gen_image_readme.py

部署 MkDocs

find output/posts -name "post.md" -exec sh -c 'mv "$1" "${1%/*}/index.md"' _ {} \;
source .venv/bin/activate && mkdocs build -d /tmp/mkdocs-site

詳見 AGENTS.md 完整部署步驟。

---

授權

本專案所有文章與圖片版權歸原作者所有。