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

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

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

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

一、主题特点

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

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

 

视频加载时间大约1分钟下载时间

基于 Trilium 分享功能博客效果

 

详情页效果
标签体系地图,暂未发布

二、配置指南

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”替换为自己的头像即可。

头像位置 Logo

 

3.3 更换主页背景(可选)

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

如果需要显示背景则打勾即可,然后替换背景图片

 

3.4 开启公告(可选)

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

先勾选,在输入内容即可在首页显示

 

3.5 博主个人与社交信息(可选)

本主题支持以下几个社交信息展示,默认关闭,填写对应属性和主页链接即可在自动开启。

自建 RSS 步骤,我做了相关 SEO 调整,详细点击: 【5】自建 RSS 并通过 docker 部署网站地图 | shmaur

需要显示的时候,将博主信息勾上即可显示。
社交信息位置

3.6 全局开启评论(可选)

本主题默认使用 twikoo 评论系统,进行配置前需要先部署,部署方法见快速上手 | Twikoo 文档我用的是最新版本,部署完成后添加以下属性即可:

可再一级目录中进行勾选

开启评论,环境ID配置,最新评论是否在首页显示

 

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 删除即可

 

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

这里必须要保留一层才可以显示,并且自定义导航必须位于第四个才可以。

六、相关文章

在折腾这个时汇总的文章

【1】Trilium 安装部署 | shmaur

【5】自建 RSS 并通过 docker 部署网站地图 | shmaur

【6】Trilium 基础使用技巧合集 | shmaur

【4】Trilium 集成强大免费的 drawio 画图 | shmaur

Trilium博客主题:Ankia 使用指南 - 东东的小黑盒

 

 

 

“您的支持是我持续分享的动力”

微信收款码
微信
支付宝收款码
支付宝

目录关闭