纪念我第一次写日记37周年
我有写日记的习惯,几岁的时候就开始,就是高三的时候也在忙里偷闲的写。目前最早能找到的是89年6月2号,网址在这里。算来正好有37年了。哇,真是不短的时间。
我准备把日记整理成电子版本。
顺便,我开发了一个Python的包,来帮助有同样爱好或者习惯的人写日记,名字就暂且就叫xuanxin吧。
这个Python的写日记的包,我想应该支持多语言(比如20260609_zh.md就是那天的中文日记,如果不加'_zh'就默认英文,网页上有按钮支持语言切换),自动生成网页,支持本地网络服务器启动,可以选择不同的风格,支持图片和视频。
日记还要支持很好的导航,可以移动到前一天,后一天,分页功能等等。
目前第一版已经能用了。把每天的 Markdown 文件放进一个文件夹,运行一条命令,就能生成整套静态网页:首页按日期列出所有篇目,篇目多了自动分页;点进某一天,正文、图片、数学公式都能正常显示。图片可以做成轮播相册(GALLERYS … GALLERYE),加一句 password: mypassword 就能挡住不想公开的照片。大 PNG 会自动转成 _small.jpg,省流量也省空间。
安装:
pip install xuanxin
源码在 GitHub:xuanxinjushi/xuanxin。想改功能、报 bug、提想法,欢迎发 issue 或 PR。
本地预览:
xuanxin diary -i xx-diary -o output_folder -gtag gtag.js -home wu-99.com --page-size 20
python -m http.server 8080 --directory output_folder
浏览器打开 http://localhost:8080 就能看。
最近又加了几项:中英文同一天各写一篇(比如 20260609.md 和 20260609_zh.md),网页上一键切换;相册支持视频;每篇日记底部有「前一天 / 后一天」链接。
三十七年的纸笔日记,能走到今天这一步,我自己也觉得有点意思。把旧时光数字化,顺便写个小工具送给同样爱记日记的人——这就是我玄心想做的事。
旧日记从这里读起:1989年6月2日。新的,就从今天这篇开始。
语法演示¶
下面几段是 xuanxin 生成网页时常用的 Markdown 写法, rebuild 后在这页上就能直接看到效果。
数学公式¶
行内:三十七年大约是 $37 \times 365 \approx 1.35 \times 10^4$ 天。
独立一行(display math):
日记里默认开 MathJax;若不要,build 时加 --no-mathjax。
单张图片¶

图片文件放在与日期同名的文件夹里(如 20260608/);大 PNG 会自动转成 _small.jpg。
相册(GALLERYS … GALLERYE)¶
横滑轮播,可混图片和视频:
带密码的相册¶
在 GALLERYS 行写 password: …,页面会先问口令(适合只想给熟人看的图):
代码与其它¶
xuanxin diary -i xx-diary -o output_folder
| 功能 | Markdown |
|---|---|
| 中文篇 | 20260609_zh.md |
| 英文篇 | 20260609.md |
| 相册起止 | >GALLERYS / >GALLERYE |
外链示例:1989年6月2日那篇 · xuanxin 仓库


