日记功能到现在有660+了,作为摄影,经常需要查看天气,但又希望很轻松就能看到天气信息,最早设计的日记模板,就带有天气Header,这个和风天气的模板一用就是2年,但因为涉及到JS文件的调用,看着那一堆代码我都不想再去改动任何部分。在Obsidian日记的使用中,一直希望如果日记功能像很多日历一样加入节假日、农历等功能,那该多cool。毕竟家人农历生日记忆起来真的痛苦。

这次利用聚合数据API和Obsidian的Templater、日记功能,为日记注入节假日功能,刚好看到有节气、农历、黄历的,就一起加进来了,毕竟来都来了,加多一些也无妨。

我的Obsidian日记

准备

  • 聚合数据API,注册后有3个免费的API,需谨慎选择,这是我选了3个万年历之后才发现的!
  • Obsidian功能:核心功能-日记、第三方插件-Templater,不多说,Ob用户必备的功能了。
聚合数据可用的免费接口

Obsidian配置

把日记功能和Templater功能的模板文件夹都设置到同一个文件夹上,日记功能需要具体设置到模板md文件上。
 

日记功能设置

为Templater插件配置模板文件夹即可

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 KEY

我的API面板查看API KEY

聚合数据的后台,在我的API面板中,可以看到请求Key,复制粘贴到代码块的API Key中。

参数说明

接口文档

进入到相关功能面板里面,去到接口文档标签中,可以看到接口地址,复制粘贴代码块的ApiAdress中,而APIUrl的组合则根据具体参数说明进行补充修改,在原来基础上增删即可。date日期格式要注意,并非每个API都是采用这个格式。而detail不是每个API都有,注意删掉。

JSON返回示例

JSON返回示例

返回示例有明显的层级关系,代码块中JsonData.result["date"]读取对应数据,如果它们之间还存在一个data带大括号,即JsonData.result.data["date"]。

最后

看了一遍聚合的免费API,感觉比较有用的可能就是天气、名人名言、心灵鸡汤、新闻摘录、星座运程,其他每日新闻很少用上,避免在日记中增加过量信息而变得臃肿。我只是希望在看回过去某一天的时候,那天的日记能提供更多的一些信息。如果你有什么想法,也可以告诉我,毕竟来都来了。