转载原作者主题使用手册:Trilium博客主题:Ankia 使用指南 - 东东的小黑盒
版本更新记录:基于 Trilium 笔记系统自动生成博客使用手册 Shmaur WhiteMinimalist-Theme 版 - shmaur
Trilium 笔记主题地址:【7】Trilium Theme:shmaur Dark Theme - shmaur
一、主题特点
相较于 Trilium 自带的分享功能,本主题有以下特点
- 支持嵌入文档渲染,include note;官方无法渲染分享的include note笔记。
- 拥有一套完整的博客系统
- 博客界面简洁
- 完美适配的移动端界面
- 优化正文阅读体验
- 增加正文目录,适配移动端
- 支持一键发布博客
- 支持代码高亮
- 诸多可配置项
- 支持博客图片点击放大缩小
- 新增文章作者
- SEO 站点建设
- 可视化基础配置
- 支持视频播放
- 支持版权说明
视频加载时间大约1分钟下载时间



二、配置指南
2.1 下载
下载地址:Release WhiteMinimalist-Theme v1.2 · Shmaur/WhiteMinimalist-Theme
2.2 安装
1、按以下步骤将主题导入 Trilium
:
2、在你想存放博客的笔记下方右键
3、选择【Import into note】
4、在弹出的窗口中选择第一步中下载的 zip 包,将【Options】下的「Safe import」取消勾选
5、点击【Import】
6、导入成功的话笔记中会出现以下目录结构的笔记:
- myblog
- 说说
- 文章分类
- 推荐阅读
- 导航
- 标签
- 首页
- 未发表
- WhiteMinimalist-Theme
注:以上笔记为博客基础的结构,请勿删除!
2.3 更新
将新版导入到笔记中。

将新版本的内容删除
在将现有目录拖动到新版本中就可以了。
更新示例操作视频
最终打开本地分享后,点击home,能够正常访问就是更新成功。在网站的基础信息需要将原来的复制到新的属性中就可以了。这个是一定要弄的,不然后面就会缺失网站的属性。
配置域名的时候,需要做一个反向代理,代理地址指向 首页地址即可。
配置 nginx
,默认进入到首页,我的配置代码 Trilium 博客配置代理

三、配置
3.1 基础配置
博客的所有配置均以 Trilium
属性的形式存在,在【myblog】笔记中修改以下属性的值即可进行配置。

3.2 更换博客头像
将【myblog→WhiteMinimalist-Theme→imgs】下的“logo”替换为自己的头像即可。

3.3 更换主页背景(可选)
主题背景默认关闭,将【myblog→WhiteMinimalist-Theme→imgs】下的“主页背景”替换为自己喜欢的背景即可。本主题默认是不显示背景图片,如果需要背景图片显示,则将下面的属性打开。

3.4 开启公告(可选)
公告默认关闭,需要勾选上即可,然后输入公告内容。

3.5 博主个人与社交信息(可选)
本主题支持以下几个社交信息展示,默认关闭,填写对应属性和主页链接即可在自动开启。
自建 RSS
步骤,我做了相关 SEO
调整,详细点击: 【5】自建 RSS 并通过 docker 部署网站地图 | shmaur


3.6 全局开启评论(可选)
本主题默认使用 twikoo
评论系统,进行配置前需要先部署,部署方法见:快速上手 | Twikoo 文档我用的是最新版本,部署完成后添加以下属性即可:
可再一级目录中进行勾选

3.7 首页显示【最新评论】模块(可选)
如果需要此功能,请在“myblog”中【最新模块打勾】,显示在首页左侧。

3.8 关闭文章评论(可选)
文章默认开启评论,前提是需要开启全局评论。配置好twikoo
,如果不需要可在文章属性中打勾,不显示评论。

3.9 开启文章阅读量统计(可选)
#enableVisitors // 开启文章阅读量统计(需要先部署 twikoo)

3.10 开启赞赏功能(可选)
勾选开启赞赏功能刷新即可生效。开启赞赏功能后需要将【myblog→WhiteMinimalist-Theme→imgs】路径下的”支付宝收款码“和“微信收款码”替换为你自己的收款码。


3.11 其他功能
#showReward // 在除博文之外的页面显示赞赏按钮
#swapInfoCard // 交换主页左右边栏(博主信息与说说)的位置。 已删除,不支持
3.12 友链功能的说明 (可选)
3.12.1 更改自己的友链信息
将友链(位置:导航 - 关于 - 友链)笔记中的属性修改为你自己的博客信息:如果不需要友链,可以将友链删除。如果想在添加回来,只需要创建新的笔记并添加类名为:#categoryName=links
即可.
#shareAlias=friendCircle #categoryName=朋友圈 #friendCircleUrl="你部署后的服务器地址"
3.12.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 如何置顶博文
在文章中勾选【置顶】即可,该博文会在「时间线」以及对应的分类中置顶。

4.8 如何隐藏博文
在文章中勾选【博客隐藏】即可,勾选后不会再博客中显示。

4.9 如何开启版本声明
在文章中勾选原创、禁止商业使用、相同方式共享任意一个即可开启版本声明
原创:此许可证要求再使用者将功劳归于创建者。它允许再用户以任何媒体或格式分发、重新混合、改编和构建材料,甚至用于商业目的。
禁止商业使用:此许可证要求再使用者将功劳归于创建者。它允许再用户以任何媒体或格式分发、重新混合、改编和构建材料,仅用于非商业目的。
相同方式共享:此许可证要求再使用者将功劳归于创建者。它允许再用户以任何媒体或格式分发、重新混合、改编和构建材料,仅用于非商业目的。如果其他人修改或改编材料,他们必须以相同的条款许可修改后的材料。
以上三个每次只能勾选一个,根据需要进行选择

4.10 如何设置链接别名
在文章属性中直接输入别名即可。

4.11 代码高亮
本主题自带 prismJS
代码高亮插件,目前全支持。
示例 HTML:
<!DOCTYPE html>
<html>
<head>
<title>示例页面</title>
<link rel="stylesheet" type="text/css" href="style.css">
<script src="script.js"></script>
</head>
<body>
<h1>Hello, World!</h1>
<p>This is an example page.</p>
<a href="#">Click me</a>
<button class="button">Submit</button>
<div id="time"></div>
</body>
</html>
示例 CSS:
@import url(https://fonts.googleapis.com/css?family=Questrial);
@import url(https://fonts.googleapis.com/css?family=Arvo);
@font-face {
src: url(https://lea.verou.me/logo.otf);
font-family: 'LeaVerou';
}
section h1,
#features li strong,
header h2,
footer p {
font: 100% Rockwell, Arvo, serif;
}
* {
margin: 0;
padding: 0;
}
body {
font: 100%/1.5 Questrial, sans-serif;
tab-size: 4;
hyphens: auto;
}
a {
color: inherit;
}
示例 Python:
from heapq import nlargest
from collections import defaultdict,ChainMap
#update 实际使⽤字典时,需要批量插⼊键值对到已有字典中,使⽤ update ⽅法实现批量插⼊.
a = {'a':1,'b':2}
a.update({'b':4,'c':5,'e':9}) # 方法1
a.update([('b',4),('c',5),('e',9)]) # 方法2
a.update([('b',4),('c',5),('e',9)],fi1=10) # 方法3
print(f'更新后的值是:{a}')
示例 JAVA:
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
示例 mysql:
CREATE DATABASE mydatabase;
USE mydatabase;
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(255) NOT NULL,
password VARCHAR(255) NOT NULL,
email VARCHAR(255)
);
INSERT INTO users (username, password, email) VALUES ('user1', 'pass1', 'user1@example.com');
SELECT * FROM users WHERE username = 'user1';
UPDATE users SET password = 'newpass' WHERE username = 'user1';
DELETE FROM users WHERE username = 'user1';
DROP TABLE users;
DROP DATABASE mydatabase;
五、注意事项
删除了导航中的分类、标签、归档、现在;不包含今日热榜等。
如果需要将文章页面宽度自适应,可调整以下这里的宽度。把 max-width
删除即可

左侧导航不显示的注意事项


这里必须要保留一层才可以显示,并且自定义导航必须位于第四个才可以。
六、相关文章
在折腾这个时汇总的文章
【5】自建 RSS 并通过 docker 部署网站地图 | shmaur
【4】Trilium 集成强大免费的 drawio 画图 | shmaur
Trilium博客主题:Ankia 使用指南 - 东东的小黑盒