研究笔记 + 多页作品集站点。基于 Jekyll + GitHub Pages。
站点：https://pyf-labrary.github.io/marginalia/
_posts/ 单篇文章（.md 或 .html，文件名 YYYY-MM-DD-slug.ext）
showcases/<slug>/ 多页作品集，整目录原样发布，不被 Jekyll 模板包裹
_includes/custom-head.html 站点级 <head> 注入（含 noindex 元标记）
_config.yml 站点配置
index.md / about.md / showcases.md 导航页
scripts/publish.py path/to/some-note.md \
--tags "tag1,tag2" \
--description "1–2 句信息密度高的摘要，进搜索结果" \
--keywords "逗号分隔关键词"脚本会：
- 用第一行
# title当作 post 标题（自动剥掉，避免重复 H1） - 用紧跟其后的 blockquote 当作 description（除非
--description显式给出） - 用文件 mtime 当作 post 日期（除非
--date给出，固定为 12:00 +0800 让 UTC 日期对齐） - 用源文件名当作 slug（除非
--slug） - 写到
_posts/YYYY-MM-DD-slug.md git add+git commit+git push（用~/.config/gh/org_pyf-labrary.token自动认证）
常用开关：--no-push（只 commit）、--no-commit（只写文件）、--force（覆盖已存在 post）。
也可以直接在 _posts/ 建文件 YYYY-MM-DD-some-title.md，顶部写 front matter：
---
layout: post
title: "标题"
date: 2026-05-01 12:00:00 +0800
description: "SEO 摘要"
tags: [tag1, tag2]
---正文支持 .md 或 .html（扩展名分别）。push 到 main，约 30–90 秒上线。
整个目录扔到 showcases/<slug>/ 下，包含 index.html + 子页 + assets/。然后到 showcases.md 加一条入口链接。
启用了 jekyll-seo-tag + jekyll-sitemap：
<head>自动生成 OpenGraph / Twitter Card / canonical /<meta description>/ JSON-LD（BlogPosting/WebSiteschema）/sitemap.xml由 jekyll-sitemap 自动生成，包含所有 posts 和 pages/feed.xml由 jekyll-feed 提供/robots.txt显式Allow: /并指向 sitemap
写新文章时，front matter 里加 description:（首选）或 excerpt: 给 SEO tag 用。tags: 和 keywords: 可选。
showcases/<slug>/ 下的原始 HTML 文件 Jekyll 不处理，需在 <head> 里手动加 canonical / OG / description。模板见 /tmp/inject-seo.py（一次性脚本，按需重跑）。
bundle install
bundle exec jekyll serve不安装也行——push 后让 GitHub Pages 在线构建即可。