轉(zhuǎn)載原作者主題使用手冊：Trilium博客主題：Ankia 使用指南 - 東東的小黑盒

基于原作者進行的設(shè)計改造。以下原文來自原作者，基于原作者基礎(chǔ)新增了我的配置

更新記錄：Ankia&shmaur-Theme 更新記錄 - shmaur

本博客主題主題預(yù)覽：shmaur

本博客主題使用方式：使用手冊，轉(zhuǎn)載于 Ankia-Theme 內(nèi)容修改

一、主題特點

相較于 Trilium 自帶的分享功能，本主題有以下特點

• 擁有一套完整的博客系統(tǒng)

• 博客界面簡潔

• 完美適配的移動端界面

• 優(yōu)化正文閱讀體驗

• 增加正文目錄，適配移動端（新增）

• 支持一鍵發(fā)布博客

• 支持代碼高亮

• 諸多可配置項

• 支持博客圖片點擊放大縮?。ㄐ略觯?/p>

• 新增文章作者

• SEO 站點建設(shè)

image.png

image.png

二、配置指南

2.1 下載

下載地址：https://github.com/Shmaur/Ankia-shmaur-Theme-trilium/releases/tag/release

2.2 安裝

1、按以下步驟將主題導(dǎo)入 Trilium：

2、在你想存放博客的筆記下方右鍵

3、選擇【Import into note】

4、在彈出的窗口中選擇第一步中下載的 zip 包，將【Options】下的「Safe import」取消勾選

5、點擊【Import】

6、導(dǎo)入成功的話筆記中會出現(xiàn)以下目錄結(jié)構(gòu)的筆記：

• myblog
  • 說說
  • 文章分類
  • 推薦閱讀
  • 導(dǎo)航
  • 標簽
  • 首頁
  • 未發(fā)表
  • Ankia&Shmaur-Theme

注：以上筆記為博客基礎(chǔ)的結(jié)構(gòu)，請勿刪除！

在 myblog 中點擊分享，然后點擊分享連接就可以看到效果。

image.png

三、配置

3.1 基礎(chǔ)配置

博客的所有配置均以 Trilium 屬性的形式存在，在【我的博客】筆記中修改以下屬性的值即可進行配置。

#siteName = xxx              // 博客的名稱，會在瀏覽器標簽頁和導(dǎo)航欄中顯示
#blogStartTime = xxx         // 博客的開始時間，會在 footer 中顯示博客運行時間
#shareDescription= xxx       // 博客的簡介，用于生成網(wǎng)頁 meta 信息
#siteKeywords = xxx          // 網(wǎng)站關(guān)鍵詞
#motto = xxx                 // 座右銘，會在右側(cè)博主信息中展示
#bloggerName = xxx           // 博主的昵稱，會在右側(cè)博主信息中展示
#siteDescription = xxx       // 網(wǎng)站 SEO 使用 （新增）
#record = xxx                // 備案號 （新增）
#recordLinkrecordLink = xxx  // 公安驗證網(wǎng)址（https://beian.miit.gov.cn/#/Integrated/index） （新增）
#announcement = xxx          // 網(wǎng)站公告
#mailLink= xxx               // 郵箱地址
#ishomepageBG=false          // 背景圖片是否顯示，默認不顯示，如果需要顯示將屬性改成 true（新增）

image.png

3.2 更換博客頭像

將【我的博客→Ankia&Shmaur-Theme→imgs】下的“l(fā)ogo”替換為自己的頭像即可。作用位置如下圖

image.png

3.3 更換主頁背景

將【我的博客→Ankia&Shmaur-Theme→imgs】下的“主頁背景”替換為自己喜歡的背景即可。

#ishomepageBG=false // 默認不顯示，需要顯示將 false 改成 true

3.4 社交信息

本主題支持以下幾個社交信息展示，默認關(guān)閉，填入對應(yīng)屬性和主頁鏈接即可在自動開啟。

#githubLink = xxx         // github
#mailLink = xxx           // 郵箱
#RSSLink = xxx            // RSS地址，示例：./feed 
#zhihuLink = xxx          // 知乎
#sspaiLink = xxx          // 少數(shù)派
#doubanLink = xxx         // 豆瓣
#netEaseCloudLink = xxx   // 網(wǎng)易云音樂
#bilibiliLink = xxx       // 嗶哩嗶哩
#telegramLink=xxx         // telegram

自建 RSS 步驟，我做了相關(guān)調(diào)整，詳細點擊： 自建 RSS 并通過 docker 部署網(wǎng)站地圖 | shmaur

image.png

3.5 開啟評論（可選）

本主題默認使用 twikoo 評論系統(tǒng)，進行配置前需要先部署，部署方法見：快速上手 | Twikoo 文檔我用的是最新版本，部署完成后添加以下屬性即可：

#enableTwikoo   // 開啟 twikoo 評論
#envId = xxx    // twikoo 的環(huán)境 id

開啟后在主面板會顯示【最新評論】模塊，如果不需要此功能，請在“我的博客”中添加 #disableLatestCommentPane 標簽

image.png

3.6 開啟文章閱讀量統(tǒng)計（可選）

#enableVisitors   // 開啟文章閱讀量統(tǒng)計（需要先部署 twikoo）

image.png

3.7 開啟贊賞功能（可選）

添加以下屬性以開啟贊賞功能

#enableReward     // 開啟贊賞功能后需要將【我的博客→Ankia&Shmaur-Theme→imgs】路徑下的”支付寶收款碼“和“微信收款碼”替換為你自己的收款碼。

3.8 其他功能

#showComments   // 在除博文之外的頁面顯示評論插件，比如在“關(guān)于”筆記中添加此標簽，那么“關(guān)于”界面中就會出現(xiàn)評論系統(tǒng)，下同
#showReward     // 在除博文之外的頁面顯示贊賞按鈕
#swapInfoCard   // 交換主頁左右邊欄（博主信息與說說）的位置。 已刪除，不支持

3.9 友鏈功能的說明

3.9.1 更改自己的友鏈信息

將友鏈（位置：DIY導(dǎo)航欄 - 關(guān)于 - 友鏈）筆記中的屬性修改為你自己的博客信息：

#shareAlias=friendCircle  #categoryName=朋友圈  #friendCircleUrl="你部署后的服務(wù)器地址"

3.9.2 添加別人為友鏈

同樣在友鏈筆記中按照格式續(xù)上即可：

"<編號>": {
   "title": "<博客名稱>",
   "link": "<博客鏈接>",
   "img": "<博主頭像>",
   "des": "<博客簡介>"
}

四、使用指南

4.1 使用個人動態(tài)（說說）功能

添加以下屬性以開啟個人動態(tài)（說說）功能，默認開啟：

#enablePersonalDynamic  // 發(fā)動態(tài)時，只需要將博文的分類填寫為「說說」即可。

4.2 使用推薦閱讀功能

添加以下屬性以開啟推薦閱讀功能，默認開啟：

#enableRecommendedReading  // 使用時，只需要將博文放置于「推薦閱讀」下方即可。

4.3 建立博客分類

建立博客分類很簡單，直接在「文章分類」筆記下方建立子筆記，然后在該筆記上賦予以下屬性：

#categoryName = xxx                // （必須）這個是用于「blogStateChange」腳本查找對應(yīng)分類的名稱，最好與分類標題保持一致
#shareAlias=category_xxx           // （必須）xxx 的值請與categoryName 中填寫的值保持一致
#sorted=date #sortDirection=desc   // (非必須，但推薦)使博文按發(fā)表時間降序排列

4.4 使用標簽功能

標簽無需手動創(chuàng)建，在博文中的#標簽中填寫好標簽，在博文發(fā)布時會自動創(chuàng)建標簽。

4.5 發(fā)布博客的流程

你可以在筆記庫的任何地方寫博客，在這之前唯一需要做的就是，新建博文的時候請選擇「博文模板」。

4.6 新建博文的流程

右鍵任何你想存放博文的父筆記（比如今日日記） 在彈出的窗口上將鼠標移動到【Insert child note】 選擇【博文模板】 博文具有 5 個基本屬性：

分類  // 該博文歸屬的分類，需要與上文中對應(yīng)分類的#categoryName的值一致。
標簽  // 該博文的標簽，支持添加多個標簽
頭圖  // 博文在首頁顯示的預(yù)覽圖，需要填寫圖片網(wǎng)絡(luò)鏈接/圖床鏈接
時間  // 博文的發(fā)表時間
作者  // 文章的作者

發(fā)布博客的方式很簡單，點擊【發(fā)布】按鈕即可自動發(fā)布；如果需要下架某篇博文，只需要將【發(fā)布】取消勾選。

4.7 如何置頂博文

在想要置頂?shù)牟┪闹刑砑右韵聦傩?，該博文會在「時間線」以及對應(yīng)的分類中置頂。

#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。

五、注意事項

刪除了導(dǎo)航中的分類、標簽、歸檔、現(xiàn)在；不包含今日熱榜等。

如果需要將文章頁面寬度自適應(yīng)，可調(diào)整以下這里的寬度。把 max-width 刪除即可

image.png

六、相關(guān)文章

在折騰這個時匯總的文章

Trilium 安裝部署 | shmaur

自建 RSS 并通過 docker 部署網(wǎng)站地圖 | shmaur

Trilium 使用技巧合集 | shmaur

Trilium 集成強大免費的 drawio 畫圖 | shmaur

Trilium博客主題：Ankia 使用指南 - 東東的小黑盒