configure - SilverBlog/silverblog GitHub Wiki

配置文件

一個 SilverBlog 實例的配置存儲在 config 文件夾中。

快速設置(推薦)

你可以在項目根目錄下執行 ./manage.py setting,即可在終端中啟用基於 whiptails 的管理界面。

在菜單項中選擇 Setting,即可便捷調整你博客的常見配置項目。

手工設置

你也可以使用文本編輯器修改你的 SilverBlog 配置文件。

配置文件均為 JSON 格式。

系統設置(config/system.json

變量名稱 用途 默認值
Project_Name 博客名稱
Project_Description 博客介紹
Project_URL 博客的訪問地址。注意不要以斜杠結尾,如 https://www.example.com
Author_Image 博主的頭像地址,可以是絕對或相對路徑
Author_Name 博主的暱稱
Author_Introduction 博主的介紹
Theme 網站主題
API_Password 網站 API 密碼
Paging 每頁展示博文數量 10
Time_Format 時間輸出格式 %Y-%m-%d
Rss_Full_Content 輸出全文 RSS true
Editor 在命令行管理界面使用的編輯器 vim

導航菜單設置(config/menu.json

每項變量名稱 用途
title 菜單顯示的名稱
name 可選,文章名稱,不可與 absolute 同時存在
absolute 可選,絕對路徑地址,不可與 name 同時存在

文章列表(config/page.json

通常情況下反對直接使用文本編輯器修改文章列表,因為你可以通過 SilverBlog 的命令行管理界面、客戶端或 API 便捷的更新博文。

每項變量名稱 用途
title 文章顯示的標題
name 文章名稱(用於區分不同文章,在文章文件名和鏈接中顯示)
time 文章發佈時間(UNIX 時間戳)
excerpt 文章摘要