日记功能到现在有660+了,作为摄影,经常需要查看天气,但又希望很轻松就能看到天气信息,最早设计的日记模板,就带有天气Header,这个和风天气的模板一用就是2年,但因为涉及到JS文件的调用,看着那一堆代码我都不想再去改动任何部分。在Obsidian日记的使用中,一直希望如果日记功能像很多日历一样加入节假日、农历等功能,那该多cool。毕竟家人农历生日记忆起来真的痛苦。
这次利用聚合数据API和Obsidian的Templater、日记功能,为日记注入节假日功能,刚好看到有节气、农历、黄历的,就一起加进来了,毕竟来都来了,加多一些也无妨。
准备
- 聚合数据API,注册后有3个免费的API,需谨慎选择,这是我选了3个万年历之后才发现的!
- Obsidian功能:核心功能-日记、第三方插件-Templater,不多说,Ob用户必备的功能了。
Obsidian配置
把日记功能和Templater功能的模板文件夹都设置到同一个文件夹上,日记功能需要具体设置到模板md文件上。
为Templater插件配置模板文件夹即可
Templator相关功能实现
在模板文件夹的日记模板中(案例只展示API功能),编写代码(10来行即可)获取API数据,根据聚合数据的API接口文档发送请求,成功后会收到数据,根据相关接口文档解析,并且格式化填入到日记中。具体代码块如下:
<%*
const apiKey = "填入你的API Key"
let apiDate = tp.date.now("YYYY-MM-DD") //日期格式需根据API的接口文档
let ApiAdress = "http://apis.juhe.cn/fapig/calendar/day"//API的接口文档提供
let apiUrl = ApiAdress + `?date=` + apiDate + `&detail=1&key=` + apiKey;//固定格式,API的接口文档提供
let wUrl = new URL(apiUrl);
const res = await request({
url: wUrl.href,
method: "GET",
});
let JsonData = JSON.parse(res);
console.log(JsonData)
let jiejiaPath =JsonData.result //需看API的接口文档,是result还是data之类的,个别存在JsonData.result.data更多的ˆ层级关系
//接下来就是格式化数据,建议修改为符合自己常用习惯,命名上本人懒用了拼音, 请勿学习,自行修改
let gzYear = jiejiaPath["gzYear"]+"-"+jiejiaPath["gzMonth"]+"-"+jiejiaPath["gzDate"]
let oldYear = jiejiaPath["lMonth"]+"月"+jiejiaPath["lDate"]
let jiejiaStr =jiejiaPath["animal"]+", "+gzYear+", "+oldYear
let jieqi = jiejiaPath["term"]
if(jieqi!=""){
jieqi = ", " + jieqi
}
let workStr =""
if(jiejiaPath["statusDesc"].indexOf("工作")!=-1)// 工作日的处理,执行添加
workStr = ""
let holidayStr =""
if("value" in jiejiaPath){
holidayStr = jiejiaPath["value"]
}else{
holidayStr = jiejiaPath["statusDesc"]
}
-%>
你的样式:
- <% holidayStr %>
- <% jiejiaStr %><% jieqi %>
- 宜: <% jiejiaPath["suit"] %>
- 忌: <% jiejiaPath["avoid"] %>
直接复制代码块放入Templator模板中文件夹的md文件中,执行输出结果为:
你的样式:
- 工作日
- 兔, 癸卯-壬戌-丁巳, 九月十二
- 宜: 结婚.会亲友.合婚订婚.纳财.纳畜.牧养.结网.收养子女.求子
- 忌: 出行.理发.安葬.安门.作灶.伐木.上梁
聚合数据API功能
API非常多,标准方法大同小异,为了方便大家根据自身需求选择API并修改代码,以使用的节假日信息查询为例,进行说明。
API KEY
聚合数据的后台,在我的API面板中,可以看到请求Key,复制粘贴到代码块的API Key中。
参数说明
进入到相关功能面板里面,去到接口文档标签中,可以看到接口地址,复制粘贴代码块的ApiAdress中,而APIUrl的组合则根据具体参数说明进行补充修改,在原来基础上增删即可。date日期格式要注意,并非每个API都是采用这个格式。而detail不是每个API都有,注意删掉。
JSON返回示例
返回示例有明显的层级关系,代码块中JsonData.result[“date”]读取对应数据,如果它们之间还存在一个data带大括号,即JsonData.result.data[“date”]。
最后
我看了一遍聚合的免费API,我觉得比较有用的可能就是天气、名人名言、心灵鸡汤、新闻摘录、星座运程,其他每日新闻很少用上,避免在日记中增加过量信息而变得臃肿。我只是希望在我看回过去某一天的时候,我希望那天的日记,能提供更多的一些客观信息。如果你有什么想法,也可以告诉我,毕竟来都来了。