日历事件格式自定义
年轮 Pro 功能
年轮时间统计支持自定义日历事件格式,你可修改日历事件的标题、地点、备注的内容格式,满足你的需求。
日历事件包含三个部分:标题 Title、地点 Location、备注 Notes,即有三个日历事件格式可以自定义。默认的日历事件格式为:标题 [detail]
,地点 [duration]
,备注 [note]
。
你可以在日历设置页修改默认的日历事件格式,将会默认应用于所有导出的日历事件;也可以在日历设置页内的特定项目设置页中,为项目设置独立的日历事件格式。
日历事件格式中可以使用的变量
变量名称 | 关键字 | 示例 |
---|---|---|
项目名称 | [project] | 学习 |
标签 | [tags] | #折腾 #Project Log |
详情 | [detail] | 搭建年轮文档 |
时长 | [duration] | 1小时 2 分钟 |
开始时间 | [start] | 2025-01-01 10:00 |
结束时间 | [stop] | 2025-01-01 11:02 |
笔记 | [note] | 使用 fumadocs 搭建文档框架,以 mdx 格式撰写与管理内容 |
例如,修改 Title 的格式为 [project] - [detail]
,则日历事件格式为:项目名称 - 详情
。
修改 Location 的格式为 [start] ~ [stop]
,则日历事件格式为:开始时间 ~ 结束时间
。
修改 Notes 的格式为 [tags]\n[note]
,则日历事件格式为:标签\n笔记
。
变量分隔
默认情况下不需要特地设置分隔符,只有在格式中连续使用了多个变量时需要设置。
例如:[project][detail]
,这一格式中两个变量之间没有分隔符,需要将两个变量分隔,否则会导致导入格式错误。
因为如果两个变量连续使用,年轮在从日历导入事件时将会无法区分哪部分是哪个变量。如果日历 Title 为 日常娱乐
,格式为 [project][detail]
,则无法判断项目名是 日常
还是 日常娱乐
。
因此请在格式中将变量进行分隔。通常推荐使用 |
符号作为分隔符,例如:[project]|[detail]
。若使用其他符号,请确保该符号在记录的详情中不会出现,避免解析错误。
不推荐使用单个空格作为分隔,因为空格在详情、标签、笔记内容中经常出现,容易导致解析错误。
分隔符不限定于单个字符,可以使用任意多个字符作为分隔,只需要保证两个变量之间不是直接相连即可。例如:[project]: -[detail]
变量优先级
在相同字段中多次使用同一个变量时,年轮会使用最先出现的变量。
当在多个字段(标题、地点、备注)中使用相同的变量关键字时,年轮会按照以下优先顺序处理:
- 标题(Title)中的变量
- 地点(Location)中的变量
- 备注(Notes)中的变量
例如,如果你在标题和地点中都使用了 [project]
变量,年轮会优先使用标题中解析出的项目名称。
日历事件对应的年轮项目
同步修改时
当年轮从日历事件同步修改时,如果格式包含 [project]
变量,且年轮中存在这一名称的项目,年轮会更新对应时间记录的项目为这一个项目。否则,年轮不会修改时间记录的项目。
导入事件时
当年轮从日历导入事件转化为时间记录时,也会优先使用格式中的 [project]
变量来匹配同名项目,如果格式中包含 [project]
变量,且匹配成功,年轮会使用匹配到的项目。
若上述步骤没有匹配到项目,年轮会使用事件所在日历所对应关联的项目。
如果日历没有找到关联的项目,最终导入的时间记录的项目会为空。
最后更新