VOID 主題使用文檔

VOID 這個Typecho主題方方正正的，顯得很端莊的樣子。確實(shí)是這樣的，主題中圓角很少，不規(guī)則的圖形也很少

開始使用

1. 下載主題
2. 解壓
3. 將主題文件夾下的 VOID 文件夾上傳至站點(diǎn) /usr/themes 目錄下
4. 后臺啟用主題
5. 將配套插件文件夾下的 VOID 文件夾上傳至站點(diǎn) /usr/plugins 目錄下
6. 后臺啟用插件

• 可選：將主題?assets?文件夾下的?VOIDCacheRule.js?復(fù)制一份到站點(diǎn)根目錄，并在主題設(shè)置中啟用 Service Worker 緩存。
• 可選：主題文件夾下 advanceSetting.sample.json 中有一些高級設(shè)置，可以看看。

有提供開發(fā)版主題下載，但不保證開發(fā)版有更新更多的功能。而且開發(fā)版變動頻繁，若無必要請使用發(fā)布版主題。

常見問題

以下功能由插件提供：

• 文章點(diǎn)贊
• 文章瀏覽量統(tǒng)計
• 文章字?jǐn)?shù)統(tǒng)計

添加歸檔頁面

新建獨(dú)立頁面，自定義模板選擇?Archives，內(nèi)容留空。

添加友情鏈接

新建獨(dú)立頁面，然后如此書寫：

[links]
[熊貓小A](https://www.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=200&r=G&d=)
[熊貓小A的博客](https://blog.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=64&r=G&d=)
[/links]

文章中、獨(dú)立頁面中都可以通過該語法插入類似的展示塊。在某些 Typecho 版本中 HTML 會被轉(zhuǎn)義后輸出，請使用?!!!?包裹以上代碼，例如：

!!!
[links]
···
[/links]
!!!

!!!?需要單獨(dú)占一行。

圖片排版

在文章中，使用?[photos][/photos]?包起來的圖片可顯示在同一行。例如：

[photos]
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0073.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0053.jpeg)
[/photos]

[photos]
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0039.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0051.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0005.jpeg)
[/photos]

在某些 Typecho 版本中 HTML 會被轉(zhuǎn)義后輸出，請使用?!!!?包裹以上代碼，例如：

!!!
[photos]
···
[/photos]
!!!

!!!?需要單獨(dú)占一行。

增強(qiáng)的 Markdown 語法

• 注音語法：{{文本:zhu yin}}，會渲染為：文本zhu yin
• notice 提示塊：[notice]提示內(nèi)容[/notice]

頁面空白

• 首先檢查是否有插件重復(fù)引入了 JQuery，若有，在插件設(shè)置頁面關(guān)閉。
• 另外，推薦使用 PHP 7.0 及以上版本搭配 MySQL 數(shù)據(jù)庫。PHP 5.6 或者更低版本以及其它數(shù)據(jù)庫可能出現(xiàn)未知問題（并且我不會去修復(fù)）。

更新

同開始使用，區(qū)別是你可以直接覆蓋主題文件。大多數(shù)情況下無需禁用主題，這樣你的主題設(shè)置就不會丟失。

某些版本由于改用幅度較大需要重啟主題與插件，請參見對應(yīng)版本的發(fā)布日志。

開發(fā)與自定義

首先注意：我不保證提供任何自定義修改相關(guān)的指導(dǎo)與幫助。You are on your own.

如果你有不錯的想法，可以定制自己的版本。首先你需要準(zhǔn)備好 NodeJS 環(huán)境，然后 clone 這個 repo：

git clone https://github.com/AlanDecode/Typecho-Theme-VOID ./VOID && cd ./VOID

安裝依賴：

npm install -g gulp
npm install

用以下命令打包依賴的 JS 和 CSS：

gulp dev

主題的樣式是用 SCSS 寫的，你可以使用自己喜歡的方式編譯 SCSS，或者使用：

gulp sass

監(jiān)聽 SCSS 更改然后實(shí)時編譯。盡請?zhí)砑幼约合胍墓δ埽瑵M意后就提交代碼。然后：

gulp build

構(gòu)建你的主題，生成的主題位于?./build?目錄下。如果你對自己的更改很滿意，歡迎提出 Pull Request。