纪念我第一次写日记37周年

我有写日记的习惯,几岁的时候就开始,就是高三的时候也在忙里偷闲的写。目前最早能找到的是89年6月2号,网址在这里。算来正好有37年了。哇,真是不短的时间。

我准备把日记整理成电子版本。

顺便,我开发了一个Python的包,来帮助有同样爱好或者习惯的人写日记,名字就暂且就叫xuanxin吧。

这个Python的写日记的包,我想应该支持多语言(比如20260609_zh.md就是那天的中文日记,如果不加'_zh'就默认英文,网页上有按钮支持语言切换),自动生成网页,支持本地网络服务器启动,可以选择不同的风格,支持图片和视频。

日记还要支持很好的导航,可以移动到前一天,后一天,分页功能等等。

目前第一版已经能用了。把每天的 Markdown 文件放进一个文件夹,运行一条命令,就能生成整套静态网页:首页按日期列出所有篇目,篇目多了自动分页;点进某一天,正文、图片、数学公式都能正常显示。图片可以做成轮播相册(GALLERYSGALLERYE),加一句 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.md20260609_zh.md),网页上一键切换;相册支持视频;每篇日记底部有「前一天 / 后一天」链接。

三十七年的纸笔日记,能走到今天这一步,我自己也觉得有点意思。把旧时光数字化,顺便写个小工具送给同样爱记日记的人——这就是我玄心想做的事。

旧日记从这里读起:1989年6月2日。新的,就从今天这篇开始。

语法演示

下面几段是 xuanxin 生成网页时常用的 Markdown 写法, rebuild 后在这页上就能直接看到效果。

数学公式

行内:三十七年大约是 $37 \times 365 \approx 1.35 \times 10^4$ 天。

独立一行(display math):

$$\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$$

日记里默认开 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 仓库