如何使用「Akari's Blog」主题配置自己的站点和发文

一、推荐了解

首先，你需要了解：这个博客主题的所有基础配置均以 Trilium 笔记“拥有的属性”的形式存在；

主题导入trilium，在左侧树导航选中「Akari's Blog」，切换到“拥有的属性”页面，如下图。

• 在 Trilium 中，属性主要有「标签」和「关系」两种类型。
• 在属性列表中，「标签」以 # 字符为前缀，而「关系」以 ~ 字符为前缀。
• 给「标签」和「关系」增加（可继承的）属性，可以把属性从根笔记向下继承到包含在内的所有子笔记中。

🎉推荐一个我做的「小工具」，当有大量的标签、关系塞到属性里时，把这些属性复制到这个小工具里格式化，通过这个工具能帮助你更方便的查阅、编辑这些标签和关系。

二、基础配置

黄金_shmaur贡献的WhiteMinimalist主题，增加了大量可在升级属性页面直接配置的基础功能。如下图。

Tips：

• 其中，如博客名称、座右铭等信息内容若不填，则不显示；你可以自由选择是否✔开启对应的功能模块。
• ✔【开启评论】，前提需要在服务器上部署 Twikoo，并配置 Twikoo评论环境ID到属性里才会生效；若未部署则不可用；部署后，还可以开启文章阅读量统计；Twikoo官方部署文档详见(快速上手 | Twikoo 文档)，结合AI总结，Twikoo部署还是容易；若不需要评论模块和【最新评论】卡片模块，请不✔评论和不配置评论环境ID，并在“「Akari's Blog」”属性中添加#disableLatestCommentPane标签。
• ✔【主页背景】，开启后除了会在主页显示头图，还会关联启用主页的各种美化特效。
• 博客开始时间，是用于计算页脚站点的运行时长。
• 另外，首次添加第三方社区链接（比如添加哔哩哔哩个人页面，名称「Akari's Blog」根笔记“拥有的属性”会增加一条「标签」属性—— #bilibiliLink="https://space.bilibili.com/你填入的页面链接"） ,添加后在博主卡片下方会生成对应社区网站的图标，点击图标可以跳转链接。
• （可选）关于删除社区链接后图标未消失的处理方法：
  • 添加过的社区，删除社区链接后，「标签」属性不会完全消失，例如而是变为：#bilibiliLink=""
  • 此时图标仍显示在博主卡片下方。
  • 需要手动进入「Akari's Blog」笔记的“拥有的属性”区域。
  • 找到对应的「标签」属性，如 #bilibiliLink=""。
  • 手动删除对应标签，图标才会完全移除，第三方社区对应「标签」、图标参考如下表。

  • 	#githubLink="xxx"	# github
    	#zhihuLink ="xxx"	# 知乎
    	#bilibiliLink="xxx"	# 哔哩哔哩
    	#RSSLink="xxx"	# RSS 订阅地址
    	#mailLink ="xxx"	# 点击发邮件（mailto:）
    	#sspaiLink ="xxx"	# 少数派
    	#netEaseCloudLink ="xxx"	# 网易云音乐
    	#doubanLink="xxx"	# 豆瓣
    	#telegramLink="xxx"	# Telegram

三、更换图片-博客头像、logo、背景图片、赞赏二维码及任意界面的背景图片

• 将【Akari's-Theme→imgs】下的“对应图片”替换为自己喜欢的即可。

• “imgs”笔记下（上图右）这种图片格式的笔记，是将图片直接拖拽到trilium中自动生成的。图片替换的时候请选择“上传新的修改”，不要修改任何标题和属性。
• （可选）在单独的笔记“拥有的属性”设置~pageBG=“你上传的图片”关系属性，就可实现不同的笔记显示不同的背景图片。比如“归档页面”我单独设置了背景图片，其笔记属性如下图。

• 如果笔记不独立设置关系~pageBG=“你上传的图片”，那么背景默认显示“阅读背景”的图片。

四、修改-顶部导航栏

• 导航分组下的笔记名称、排列顺序与导航栏中的一致，想要怎么取名分组都行，但是注意博客导航栏展开有层级限制。

• 「关于」分组下的子笔记的层级、顺序可以移动，这些笔记的名称可以修改，但是这些笔记的属性#categoryName别动，修改后对应功能会不可用，如不需要展示，将对应笔记添加  #shareHiddenFromTree 属性即可。
• 如果导航需要跳转到外链，可用填写笔记属性，示例：#shareExternalLink="https://www.baidu.com/" 

五、导航与推荐文章

• 导航文章或者推荐阅读增加文章：你只需克隆一份你要发表的文章到对应分组里，就行，如下图。

六、修改/增加-文章类别分组

• 请在“文章分类”目录下新建。每一个分类中需要添加以下属性：

#sorted=date #sortDirection=desc #categoryName=分类名 #shareAlias=category_分类名

• #categoryName = xxx - （必须）这个是用于「blogStateChange」脚本查找对应分类的名称，最好与分类标题保持一致
• #shareAlias=category_xxx - （必须）xxx 的值请与categoryName 中填写的值保持一致
• #sorted=date #sortDirection=desc - (非必须，但推荐)使博文按发表时间降序排列

七、发布博客文章

• 你可以在Trilium笔记库的任何地方写文章，在发布前唯一需要做的就是，把博客主题中“未发表”分组下的「文章模板」属性复制到你要发布的笔记属性里，然后去“升级属性”页面填写相关信息，如下图。

• 发布博客的方式很简单，✔【发布】按钮即可自动发布；如果需要下架、隐藏、设置声明或者不显示某篇博文评论，只需要将对应的取消勾选。
• 开启版本声明，请根据需要进行选择，原创、禁止商业使用、相同方式共享三个每次只能勾选一个。
• 要想分类生效，需要对应填入你提前预设的“文章类别”才行，如果不提前预设，发布后文章不会自动规划到对应分组里。
• 文章的标签可以添加多个，标签无需像“文章类别”需要提前手动创建，在博文发表前填写好标签，发布时会自动创建到标签组，文章会划分到对应标签。
• ✔【置顶】，该博文会在「首页」文章列表置顶显示。
• （可选）文章的时间填写了才会激活文章、字数统计、阅读量等统计。只有添加了#date(可继承的)="XXX" 属性才能让子笔记也激活显示字数统计等，如果没有加(可继承的)标识，那么使用模板设置发布后，仅#date="XXX"只会在文章首页显示统计。
• （可选）还可以设置文章账号密码验证等，例如admin:12345。此标签添加属性 #shareCredentials="username:password" .要保护整个子树，请确保标签添加(可继承的)标识。

八、发布说说

• 使用模板，发动态时，只需要将分类填写为「说说」即可，发布后会自动归类到说说。

九、友链功能说明

将属性修改为你自己站点的博客信息，将朋友的链接添加到json笔记正文中，参考如下图：

 #myTitle=网站名称 #myLink=网站链接 #myImg=网站图像 #myDes=网站介绍

• （可选）增加友链朋友圈，详见东东的教程；需要后端部署。并在「导航」中你喜欢的位置新建一个名为「朋友圈」的笔记，并且填写以下属性：

#shareAlias=friendCircle #categoryName=朋友圈 #friendCircleUrl="你部署后的服务器地址"