转载原作者主题使用手册：Trilium博客主题：Ankia 使用指南 - 东东的小黑盒
基于原作者进行的设计改造。以下原文来自原作者，基于原作者基础新增了我的配置
更新记录：Ankia&shmaur-Theme 更新记录 - shmaur
本博客主题主题预览：shmaur
本博客主题使用方式：使用手册，转载于 Ankia-Theme 内容修改
一、主题特点
相较于 Trilium 自带的分享功能，本主题有以下特点
-
拥有一套完整的博客系统
-
博客界面简洁
-
完美适配的移动端界面
-
优化正文阅读体验
-
增加正文目录，适配移动端（新增）
-
支持一键发布博客
-
支持代码高亮
-
诸多可配置项
-
支持博客图片点击放大缩小（新增）
-
新增文章作者
-
SEO 站点建设
image.png
image.png
二、配置指南
2.1 下载
下载地址：https://github.com/Shmaur/Ankia-shmaur-Theme-trilium/releases/tag/release
2.2 安装
1、按以下步骤将主题导入 Trilium：
2、在你想存放博客的笔记下方右键
3、选择【Import into note】
4、在弹出的窗口中选择第一步中下载的 zip 包，将【Options】下的「Safe import」取消勾选
5、点击【Import】
6、导入成功的话笔记中会出现以下目录结构的笔记：
- myblog
- 说说
- 文章分类
- 推荐阅读
- 导航
- 标签
- 首页
- 未发表
- Ankia&Shmaur-Theme
注：以上笔记为博客基础的结构，请勿删除！
在 myblog 中点击分享，然后点击分享连接就可以看到效果。
image.png
三、配置
3.1 基础配置
博客的所有配置均以 Trilium 属性的形式存在，在【我的博客】笔记中修改以下属性的值即可进行配置。
#siteName = xxx // 博客的名称，会在浏览器标签页和导航栏中显示
#blogStartTime = xxx // 博客的开始时间，会在 footer 中显示博客运行时间
#shareDescription= xxx // 博客的简介，用于生成网页 meta 信息
#siteKeywords = xxx // 网站关键词
#motto = xxx // 座右铭，会在右侧博主信息中展示
#bloggerName = xxx // 博主的昵称，会在右侧博主信息中展示
#siteDescription = xxx // 网站 SEO 使用 （新增）
#record = xxx // 备案号 （新增）
#recordLinkrecordLink = xxx // 公安验证网址（https://beian.miit.gov.cn/#/Integrated/index） （新增）
#announcement = xxx // 网站公告
#mailLink= xxx // 邮箱地址
#ishomepageBG=false // 背景图片是否显示，默认不显示，如果需要显示将属性改成 true（新增）
image.png
3.2 更换博客头像
将【我的博客→Ankia&Shmaur-Theme→imgs】下的“logo”替换为自己的头像即可。作用位置如下图
image.png
3.3 更换主页背景
将【我的博客→Ankia&Shmaur-Theme→imgs】下的“主页背景”替换为自己喜欢的背景即可。
#ishomepageBG=false // 默认不显示，需要显示将 false 改成 true
3.4 社交信息
本主题支持以下几个社交信息展示，默认关闭，填入对应属性和主页链接即可在自动开启。
#githubLink = xxx // github
#mailLink = xxx // 邮箱
#RSSLink = xxx // RSS地址，示例：./feed
#zhihuLink = xxx // 知乎
#sspaiLink = xxx // 少数派
#doubanLink = xxx // 豆瓣
#netEaseCloudLink = xxx // 网易云音乐
#bilibiliLink = xxx // 哔哩哔哩
#telegramLink=xxx // telegram
自建 RSS 步骤，我做了相关调整，详细点击： 自建 RSS 并通过 docker 部署网站地图 | shmaur
image.png
3.5 开启评论（可选）
本主题默认使用 twikoo 评论系统，进行配置前需要先部署，部署方法见：快速上手 | Twikoo 文档我用的是最新版本，部署完成后添加以下属性即可：
#enableTwikoo // 开启 twikoo 评论
#envId = xxx // twikoo 的环境 id
开启后在主面板会显示【最新评论】模块，如果不需要此功能，请在“我的博客”中添加 #disableLatestCommentPane 标签
image.png
3.6 开启文章阅读量统计（可选）
#enableVisitors // 开启文章阅读量统计（需要先部署 twikoo）
image.png
3.7 开启赞赏功能（可选）
添加以下属性以开启赞赏功能
#enableReward // 开启赞赏功能后需要将【我的博客→Ankia&Shmaur-Theme→imgs】路径下的”支付宝收款码“和“微信收款码”替换为你自己的收款码。
3.8 其他功能
#showComments // 在除博文之外的页面显示评论插件，比如在“关于”笔记中添加此标签，那么“关于”界面中就会出现评论系统，下同
#showReward // 在除博文之外的页面显示赞赏按钮
#swapInfoCard // 交换主页左右边栏（博主信息与说说）的位置。 已删除，不支持
3.9 友链功能的说明
3.9.1 更改自己的友链信息
将友链（位置：DIY导航栏 - 关于 - 友链）笔记中的属性修改为你自己的博客信息：
#shareAlias=friendCircle #categoryName=朋友圈 #friendCircleUrl="你部署后的服务器地址"
3.9.2 添加别人为友链
同样在友链笔记中按照格式续上即可：
"<编号>": {
"title": "<博客名称>",
"link": "<博客链接>",
"img": "<博主头像>",
"des": "<博客简介>"
}
四、使用指南
4.1 使用个人动态（说说）功能
添加以下属性以开启个人动态（说说）功能，默认开启：
#enablePersonalDynamic // 发动态时，只需要将博文的分类填写为「说说」即可。
4.2 使用推荐阅读功能
添加以下属性以开启推荐阅读功能，默认开启：
#enableRecommendedReading // 使用时，只需要将博文放置于「推荐阅读」下方即可。
4.3 建立博客分类
建立博客分类很简单，直接在「文章分类」笔记下方建立子笔记，然后在该笔记上赋予以下属性：
#categoryName = xxx // （必须）这个是用于「blogStateChange」脚本查找对应分类的名称，最好与分类标题保持一致
#shareAlias=category_xxx // （必须）xxx 的值请与categoryName 中填写的值保持一致
#sorted=date #sortDirection=desc // (非必须，但推荐)使博文按发表时间降序排列
4.4 使用标签功能
标签无需手动创建，在博文中的#标签中填写好标签，在博文发布时会自动创建标签。
4.5 发布博客的流程
你可以在笔记库的任何地方写博客，在这之前唯一需要做的就是，新建博文的时候请选择「博文模板」。
4.6 新建博文的流程
右键任何你想存放博文的父笔记（比如今日日记） 在弹出的窗口上将鼠标移动到【Insert child note】 选择【博文模板】 博文具有 5 个基本属性：
分类 // 该博文归属的分类，需要与上文中对应分类的#categoryName的值一致。
标签 // 该博文的标签，支持添加多个标签
头图 // 博文在首页显示的预览图，需要填写图片网络链接/图床链接
时间 // 博文的发表时间
作者 // 文章的作者
发布博客的方式很简单，点击【发布】按钮即可自动发布；如果需要下架某篇博文，只需要将【发布】取消勾选。
4.7 如何置顶博文
在想要置顶的博文中添加以下属性，该博文会在「时间线」以及对应的分类中置顶。
#blogPostTop
4.8 代码高亮
本主题自带 prismJS 代码高亮插件，目前支持 HTML、XML、SVG、MathML、SSML、Atom、RSS、CSS、JavaScript、EJS、Go、C、C++、Python、ini、Bash、Json、Shell、SQL、TypeScript、YAML。
五、注意事项
删除了导航中的分类、标签、归档、现在；不包含今日热榜等。
如果需要将文章页面宽度自适应，可调整以下这里的宽度。把 max-width 删除即可
image.png
六、相关文章
在折腾这个时汇总的文章
自建 RSS 并通过 docker 部署网站地图 | shmaur
网友评论