Mingming's blog

Mingming's blog powered by Jekyll on Github, base on theme Freshman21 Design by Lijia Yu, A tribute to WordPress Theme Twenty-Twelve and Twenty-eleven.

备注

1. 根目录里的 x.md 文件会被渲染成固定链接页面；文件名前缀保留历史命名习惯，顶部导航顺序在 _includes/header.html 中显式维护
2. _posts/ 已按年份分子目录存放，例如 _posts/2024/2024-05-01-play_robot_with_baby.md，命名仍需遵循 YYYY-MM-DD-title.md

旅行页维护

• 页面入口为 /travel/，模板是 f_travel.md，公开数据维护在 _data/travel.yml。
• 每条行程必须包含唯一 id、四位年份、月-日 或日期范围、城市和地点/景点列表。可选 title 用于“春节粤西自驾”这类行程主题，只存纯文本，页面自动加 【】。单日使用 月-日，连续行程使用 月-日~月-日。中国行程写城市；境外行程写成“国家-城市”。
• 行程按年份倒序、同一年按日期正序维护。
• 旅行文章在 frontmatter 中加入与行程一致的 travel_id 后，旅行页会自动显示该文章的站内相对链接；不要在 YAML 中手写文章 URL。
• 连续日期属于同一次出行时只建一条记录，合并时间范围、城市、景点和所有相关文章；不要按每天拆分。
• 有已发布游记且能确认实际出行日期时，必须补充行程并添加 travel_id。没有文章的已完成行程，只要日期、城市和旅行性质能够确认，也可以展示。
• 外部私人记录只能作为人工审核的候选来源，不得在仓库文档中记录其本地路径，也不得在构建时读取。未来行程、住宿、家庭住址、交通班次等隐私信息不得自动发布。

Local Debug in Docker

总是 jekyll build 失败，记录下过程和相关资料，未来再说

• https://hub.docker.com/r/jekyll/jekyll/tags
• https://github.com/envygeeks/jekyll-docker/
• https://ddewaele.github.io/running-jekyll-in-docker/
• https://kuros.in/docker/docker-jekyll-container-to-serve-locally/ (dockerfile)

github

• github的官方jekyll链接 https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll

发布文章前的自查清单

• yml头里的日期是否正确？不能使用未来的时间，jekyll在编译时会忽略未来时间的文章
• 文件名是否符合规范？ 2023-03-01_xx_yy.md 就编译不出来，要用 2023-03-01-xx_yy.md 注意下划线
• 是否已使用 tekorrect -f _posts/2023-03-01-xx_yy.md 格式化文章?
• 是否需要加入 标记，用于首页文章摘要显示
• 图片尺寸太大，是否需要压缩？ https://tinypng.com/ 调用api压缩，每个月免费500张，代码已实现
• 如果文章是游记，是否已在 frontmatter 添加对应的 travel_id；若尚无行程记录，是否已人工审核并补充 _data/travel.yml
• 相邻日期是否属于同一次连续行程；如果是，是否已聚合为一条并使用 ~ 表示日期范围

Changelog

• 2025-12-07
  • 新增 scripts/generate_content_index.py Python 生成器，支持 emoji 状态、图片来源、相对路径列，输出根目录 CONTENT_INDEX.md
  • 创建本地虚拟环境 ~/code/venv/lmmsoft.github.io（Py3.12.2 + PyYAML）并用于生成目录
  • 补充设计文档 scripts/generate_content_index.md
  • 目录列可直接点击跳转 GitHub 文件，年份标题展示当年 post/draft 数量
• 2023-03-30
  • 打通卡点，第一篇博客和公众号同发的文章
• 2023-03-22
  • 新增 Jekyll 的中文字数统计插件
  • 参考文章 https://blog.fooleap.org/jekyll-count-of-chinese-characters.html
  • 多语言没做，嫌麻烦，都是中文
• 2023-03-19
  • 使用chatgpt写代码，下载.md/.html文件中flickr的图片到本地，使用github做图床
• 2023-03-07
  • 安装 pangu 工具，用于中文排版自动格式化

pip install -U pangu pangu -f ./_posts/2023-03-01-mac_finder_sort_photos_by_taken_time.md >> ./_posts/2023-03-01-mac_finder_sort_photos_by_taken_time.md tekorrect -f _posts/2023-03-01-mac_finder_sort_photos_by_taken_time.md

• 2023-03-02
  • 文章无法显示，经过检查，是文件名格式问题，错误❌2023-03-01_xx.md 正确✅2023-03-01-xx.md 太隐晦，太坑啦~
  • 图片可以使用 格式, pycharm本地预览可以，github pages也可以正常显示
• 2023-02-21
  • about页 增加 访客地理位置统计地图 widget
    • https://clustrmaps.com/
    • 使用谷歌邮箱登录
• 2023-02-02
  • 增加 我的清单 页面
• 2023-02-01
  • 增加 plausible.io 统计，号称GA平替
• 2023-01-30
  • 全平台统一名称，博客从"明明如月的博客"改名为"明明如月成长笔记"
• 2023-01-30
  • 优化了友情链接，补充了推荐语description
• 2023-01-29
  • 根目录下非 _xxx 下划线开头的目录都会被发布到生成的网站中，输入 http://{site_url}/xxx/会自动打开xxx目录下的readme.md文件，所以把 xxx 改名成 _xxx 避免发布不必要的文件。
• 2022-12-29
  • google analytics 更新，用 GA4 替换 UA，UA会在2023-06停止
  • 用 busuanzi 进行页面 PV/UV 统计
  • 用 jekyll-feed 生成 feed.atom, 同时也保留了 feed.xml(rss), 用 http://lmmsoft.github.io/ 网址订阅的话，默认用 atom
• 2022-12-28
  • 重整 about 页面， 添加英文自我介绍，添加常用社交网站的链接
• 2022-12-27
  • 修复 category url 的bug, 因把页面permalink从 categories 改名成 category ，但超链接没更新导致
• 2022-12-05
  • 全站 https
• 2021-11-25
  • 迁移博客园的文章

分类

2023-10-30 精简了分类之后，现有标签和文章数量，降序，供参考

• acm比赛 41
• 我的游记 40
• 我的生活 39
• 挨踢生涯 33
• 我的思考 31
• 我的总结 20
• 有趣+好玩(博主推荐) 14
• 学习笔记 11
• 我的练笔 9
• 我的影评 5
• 我的自由软件 3
• 我的比赛 1