【2】V1.2 基于 Trilium 笔记系统自动生成博客使用手册 WhiteMinimalist-Theme 版 | shmaur

shmaur

2024-08-17

- 字

trilium主题

trilium插件

trilium使用技巧

转载原作者主题使用手册：Trilium博客主题：Ankia 使用指南 - 东东的小黑盒

版本更新记录：基于 Trilium 笔记系统自动生成博客使用手册 Shmaur WhiteMinimalist-Theme 版 - shmaur

Trilium 笔记主题地址：【7】Trilium Theme：shmaur Dark Theme - shmaur

一、主题特点

相较于 Trilium 自带的分享功能，本主题有以下特点

支持嵌入文档渲染，include note；官方无法渲染分享的include note笔记。
拥有一套完整的博客系统
博客界面简洁
完美适配的移动端界面
优化正文阅读体验
增加正文目录，适配移动端
支持一键发布博客
支持代码高亮
诸多可配置项
支持博客图片点击放大缩小
新增文章作者
SEO 站点建设
可视化基础配置
支持视频播放
支持版权说明

二、配置指南

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;