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

-
2024-12-13
This note was originally clipped from https://www.shmaur.com/6gBePxfRSctO

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

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

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

一、主题特点

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

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

二、配置指南

2.1 下载

下载地址:Release WhiteMinimalist-Theme v1.1 · Shmaur/WhiteMinimalist-Theme (github.com)

2.2 安装

1、按以下步骤将主题导入 Trilium

2、在你想存放博客的笔记下方右键

3、选择【Import into note】

4、在弹出的窗口中选择第一步中下载的 zip 包,将【Options】下的「Safe import」取消勾选

5、点击【Import】

6、导入成功的话笔记中会出现以下目录结构的笔记:

注:以上笔记为博客基础的结构,请勿删除!

配置域名的时候,需要做一个反向代理,代理地址指向 首页地址即可。

配置 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 开启文章阅读量统计(可选)

3.10 开启赞赏功能(可选)

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

只需要将开启赞赏开启就可以显示
显示位置

3.11 其他功能

3.12 友链功能的说明 (可选)

3.12.1 更改自己的友链信息

将友链(位置:导航 - 关于 - 友链)笔记中的属性修改为你自己的博客信息:如果不需要友链,可以将友链删除。如果想在添加回来,只需要创建新的笔记并添加类名为:#categoryName=links 即可.

3.12.2 添加别人为友链

同样在友链笔记中按照格式续上即可:

四、使用指南

4.1 使用个人动态(说说)功能

添加以下属性以开启个人动态(说说)功能,默认开启:

4.2 使用推荐阅读功能

添加以下属性以开启推荐阅读功能,默认关闭:

勾选上就会在首页显示

4.3 建立博客分类

建立博客分类很简单,直接在「文章分类」笔记下方建立子笔记,然后在该笔记上赋予以下属性:

4.4 使用标签功能

标签无需手动创建,在博文中的#标签中填写好标签,在博文发布时会自动创建标签。

4.5 发布博客的流程

你可以在笔记库的任何地方写博客,在这之前唯一需要做的就是,新建博文的时候请选择「博文模板」。

4.6 新建博文的流程

右键任何你想存放博文的父笔记(比如今日日记)
在弹出的窗口上将鼠标移动到【Insert child note】
选择【博文模板】
博文具有 5 个基本属性:


发布博客的方式很简单,点击【发布】按钮即可自动发布;如果需要下架某篇博文,只需要将【发布】取消勾选。

4.7 如何置顶博文

在文章中勾选【置顶】即可,该博文会在「时间线」以及对应的分类中置顶。

勾选即可

4.8 如何隐藏博文

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

4.9 如何开启版本声明

在文章中勾选原创、禁止商业使用、相同方式共享任意一个即可开启版本声明

图片来自作者

4.10 如何设置链接别名

在文章属性中直接输入别名即可。

直接输入即可

4.11 代码高亮

本主题自带 prismJS 代码高亮插件,目前全支持。

示例 HTML:

示例 CSS:

示例 Python:

示例 JAVA:

示例 mysql:

五、注意事项

删除了导航中的分类、标签、归档、现在;不包含今日热榜等。

如果需要将文章页面宽度自适应,可调整以下这里的宽度。把 max-width 删除即可

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

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

六、相关文章

在折腾这个时汇总的文章

【1】Trilium 安装部署 | shmaur

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

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

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

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


目录