Initial - 主題使用文檔

主題命名為Initial，意為“初”，專注于文字，算是極極極簡風格吧，簡約而不簡單，希望你能喜歡這種很小眾的風格，這篇文檔就是來介紹這款Typecho主題的用法。

如何使用

下載主題包并解壓，把解壓出來的文件夾改名為“initial”，將文件夾上傳至網站文件主題目錄下，網站后臺啟用這款typecho主題即可。

一、文章內設置項

此處為編輯文章時，最下方“自定義字段”位置的選項設置，此處的設置只對當前文章或者頁面生效。

文章縮略圖

文章縮略圖就是在首頁或者歸檔頁才會顯示的一張展示圖片(圖片大小無任何限制，請自行控制)。
本主題是一個主打文字的主題，所以默認是不顯示文章縮略圖的，如果需要顯示縮略圖，在編輯文章或者頁面時，最下方的“自定義字段”位置有一個“自定義縮略圖”的選項，可以輸入你喜歡的圖片的地址來作為該文章的縮略圖。如果想要使用文章內的第一張圖片作為縮略圖，只需輸入數字“1”即可（若該文章內無圖，則不顯示）。

2.3版本更新：文章縮略圖支持調用文章內的任意圖片。如果想要使用文章內的第三張圖片作為縮略圖，只需輸入數字“3”即可（若該文章內無第三張圖片，則不顯示）。

文章目錄

默認關閉，啟用則會在該文章內顯示“文章目錄”，如果文章內無任何標題，就算此選項已啟用，也是不會顯示目錄的。

二、輕語

輕語是2.3版新出的一項功能，類似于說說，用于發表一些小動態 or 小牢騷 or ...
使用此功能需要先在后臺創建獨立頁面，然后選擇“輕語”模板即可（若不想在導航欄顯示，可以設置為隱藏）。在這款typecho主題的前臺進入此頁面，如果是在登錄狀態下，您就可以在此頁面發表“輕語”了。若您想在首頁展示你的“輕語”，您可進入后臺-控制臺-外觀設置內找到“顯示最新的輕語”選項，勾選對應的位置即可。

注意：

• “輕語”支持Markdown語法，默認支持<br><strong><a><img><pre><code>這幾個標簽，如果需要支持更多標簽，請在后臺-設置-評論內找到“允許使用的HTML標簽和屬性”，添加對應的標簽即可。
• “輕語”對圖片大小無限制（max-width:100%），請自行控制。
• 管理“輕語”（修改、刪除、等操作）請在后臺-管理-評論內操作。（“輕語”基于Typecho的評論功能）
• 目前發布“輕語”的權限設置為（2.4版更新為：具有“編譯”以上權限的用戶）所有登陸用戶，即你的網站內所有已注冊用戶登陸后都可發表，后續看反饋是否需要調整。
• 開啟“輕語”將強制“將較新的的評論顯示在前面”。
• 有其余問題可隨時提問。

三、鏈接

此項為2.1版本新增的功能，但從2.4版開始，鏈接列表已從外觀設置遷移至管理-獨立頁面-鏈接模板頁面-自定義字段-links內。

新用戶若需要使用“鏈接”功能，請前往?后臺-管理-獨立頁面-新增頁面-自定義模板-選擇“鏈接”?創建“鏈接”模板頁面，然后新增“自定義字段”，字段名稱設置為links，字段值按照下方的格式輸入即可插入鏈接。

添加鏈接

管理鏈接列表請編輯“鏈接”模板（后臺-管理-獨立頁面-鏈接模板頁面），在最下方的自定義字段-links內按照以下格式添加即可。

鏈接輸入格式：
鏈接名稱*,鏈接地址*,鏈接描述,鏈接圖標,鏈接分類

不同信息之間用英文逗號“,”分隔，例如：
OFFODD,http://www.offodd.com/,JIElive的博客 | 有點不同,https://www.offodd.com/logo.png,Myself

若中間有暫時不想填的信息，請留空，例如暫時不想填寫鏈接描述和鏈接圖標：
OFFODD,http://www.offodd.com/,,,Myself

若結尾有暫時不想填的信息，無需逗號，可直接留空，例如暫時不想填寫鏈接圖標和鏈接分類：
OFFODD,http://www.offodd.com/,JIElive的博客 | 有點不同

多個鏈接換行即可，一行一個

小技巧：如果某個鏈接已經失效，但是又不需要立即刪除它，常用場景就是鏈接站點無法訪問或者友鏈站點把你的友鏈刪除了，你就可以給鏈接名稱加上<del>標簽，把鏈接地址留空，把鏈接描述改為原因，然后鏈接地址和鏈接描述可以放到鏈接分類后面來備份，例如：
<del>OFFODD</del>,,暫時無法訪問,,Myself,備份：http://www.offodd.com/JIElive的博客 | 有點不同https://www.offodd.com/logo.png

11月7日更新：若 鏈接地址 留空，則自動添加<del>標簽

鏈接功能使用效果可以預覽本站的鏈接頁面。

四、后臺設置

絕大部分的內容都在這里。
我發現竟然很多人不知道有主題設置或者不知道在哪里，這里說一下，進入后臺-控制臺-外觀-外觀設置。

站點 LOGO 地址

默認是顯示后臺設置的站點名稱（文字版），此處可以填入你的LOGO圖片的地址，填入后就會在站點名稱顯示的位置顯示你填入的LOGO（站點名稱不再顯示），圖片高度是限制最高30像素，超出則會縮小到30像素高，寬度不限。

自定義站點副標題

站點標題就是你使用瀏覽器瀏覽網站時，在瀏覽器上顯示的網站名稱，默認只顯示站點名稱，此處可以填入一個你喜歡的副標題，填入后將在原標題后方使用“ - ”分隔符顯示你設置的副標題，例如：標題 - 副標題。（副標題僅在首頁時顯示）

Favicon 地址

Favicon 就是你使用瀏覽器瀏覽網站時，在瀏覽器標題前顯示的網站小LOGO，填寫一個你的LOGO地址即可。（Favicon建議使用ico格式）

CSS文件的鏈接地址替換

此項設置是方便給使用了CDN服務的朋友使用，可以把本主題的CSS文件替換為你的CDN文件，直接輸入CSS文件在你的CDN的父級目錄鏈接即可，例：

CSS文件原地址是  http://www.example.com/usr/themes/initial/style.min.css
CSS文件在你的CDN內的地址是  http://www.cdn.com/initial/style.min.css
那么此項設置你應該輸入  http://www.cdn.com/initial/

文章內的鏈接地址替換

此項設置也是方便給使用了CDN服務的朋友使用，可以把文章或頁面內的指定鏈接替換為另一個你需要的鏈接，原鏈接和替換鏈接之間使用等號“=”分割，可以設置多個替換規則，一行一個。替換鏈接是替換文章或頁面內的所有符合條件的鏈接，所以建議使用在附件鏈接上面，而且盡量把原鏈接寫全，以免“誤傷”。

導航欄顯示

此項設置是設置這款typecho主題頭部導航欄的顯示內容。

• 顯示分類：啟用將顯示所有文章分類
• ?合并分類：將分類合并為下拉菜單顯示，需要啟用“顯示分類”后，此項才可生效
• 顯示頁面：啟用將顯示獨立頁面
• ?合并頁面：將獨立頁面合并為下拉菜單顯示，需要啟用“顯示頁面”后，此項才可生效

導航欄-分類 下拉菜單顯示名稱

當“導航欄顯示”設置為“顯示分類”、“合并分類”后，導航欄內的分類會生成一個下拉菜單，此項設置可以自定義這個下拉菜單的顯示名稱，留空則默認顯示為“分類”。

導航欄-頁面 下拉菜單顯示名稱

同上一項

面包屑導航顯示

• 文章內顯示：啟用將會在文章內顯示面包屑導航
• ?文章標題替換為“正文”：啟用后會將文章內的面包屑導航的文章標題部分替換為“正文”
• 頁面內顯示：啟用將會在獨立頁面內顯示面包屑導航

微信打賞二維碼

填入你的微信打賞二維碼圖片地址, 就可以在文章底部添加微信打賞，留空則不設置微信打賞，（建議圖片尺寸不低于240*240）

支付寶打賞二維碼

同上一項

浮動顯示頭部

2.0版全新的頭部樣式，有跟隨和固定兩種顯示方式，默認是常規的跟隨顯示，啟用此項后，頭部將始終顯示。

動態顯示側邊欄

啟用后將動態滾動顯示側邊欄，默認關閉。

公共靜態資源來源

公共靜態資源包括CSS框架、JS庫等公共庫文件，此設置可將切換主題的公共資源文件，比如前段時間BootCDN遷移導致暫停服務，就可以暫時切換至其他來源，或根據網站的受眾人群，選擇合適的來源

HTML壓縮

啟用后將壓縮HTML代碼，酌情開啟。

全站Pjax

Pjax是一種網站局部刷新技術，做到頁面加載時只刷新指定的部分，不刷新整個頁面，不用多次的JS、CSS解析，只更新必要的內容，避免了頁面重新渲染的過程。開啟后將同時開啟ajax評論，并強制關閉“反垃圾保護”，強制“將較新的的評論顯示在前面”。

Ajax翻頁

Ajax翻頁默認關閉，開啟后，文章翻頁將使用Ajax方式獲取。

返回頂部

啟用后將在右下角顯示“返回頂部”按鈕

背景音樂

默認關閉，請選擇“順序播放”或者“隨機播放”以啟用，啟用將在右下角顯示“音樂控制”按鈕（需在下一步輸入音樂地址），背景音樂功能建議配合“全站Pjax”使用。

背景音樂地址

上一步啟用背景音樂后，需在此處輸入完整的音樂地址（建議mp3格式，兼容性最好），可以輸入多個音樂，一行一個。

背景音樂播放音量

輸入一個你覺得合適的背景音樂播放音量，0~100%音量對應0~1之間的小數，比如輸入0.25表示25%的音量。

顯示鏈接圖標（內頁）

2.2.1版新增功能，啟用后內頁（鏈接模板）鏈接將顯示鏈接圖標，若某個站點未設置鏈接圖標，將嘗試自動獲取圖標，若獲取失敗則圖標顯示為“★”。無 鏈接地址 的鏈接不會顯示圖標

首頁顯示的鏈接分類

鏈接在首頁顯示的分類，若首頁只需顯示某分類下的鏈接，在此輸入鏈接的分類名即可，如果要顯示多個分類的鏈接，可在多個分類名之間用英文逗號“,”分隔，留空則默認顯示全部鏈接。分類名建議使用字母形式

內頁（鏈接模板）顯示的鏈接分類

鏈接在鏈接模板頁面顯示的分類，若鏈接模板頁面只需顯示某分類下的鏈接，在此輸入鏈接的分類名即可，如果要顯示多個分類的鏈接，可在多個分類名之間用英文逗號“,”分隔，留空則默認顯示全部鏈接。分類名建議使用字母形式

首頁顯示鏈接

鏈接在首頁顯示的位置，可設置在側邊欄顯示或者在頁面底部顯示

顯示最新的“輕語”

將在選擇的位置顯示最新的一條“輕語”

側邊欄顯示

側邊欄需要顯示的項目

ICP備案號

輸入網站的ICP備案號，將在底部顯示，留空則關閉此項

底部自定義內容

此處可以輸入你的網站統計代碼，也可以輸入一些其他JS內容，若開啟了全站Pjax，建議使用百度統計或者Google統計。

這位作者還分享了這款Typecho教程，也可以了解一下。

更新歷史

2018/09/04：發布第一版
2018/09/08：更新1.1版本
2018/09/12：更新1.2版本
2018/09/17：更新1.2.1版本（增加返回頂部過渡動畫，微調部分樣式，添加標簽云，修復小BUG）
2018/09/28：更新1.3版本
2018/10/12：更新2.0版本
2018/11/02：更新2.1版本
2018/11/23：更新2.2版本
2018/11/28：更新2.2.1版本
2018/12/14：更新2.3版本
2018/12/24：更新2.3.1版本
2018/12/25：更新2.3.2版本
2019/01/04：更新2.4版本
2019/01/09：更新2.4.1版本
2019/01/14：更新2.4.2版本
2019/02/20：更新2.4.3版本
2019/12/11：更新2.4.4版本
2020/09/04：更新2.4.5版本
2020/09/11：更新2.5版本
2020/09/16：更新2.5.1版本
2020/10/21：更新2.5.2版本
2022/03/09：更新2.5.3版本
2022/10/12：更新2.5.4版本
2023/02/20：更新2.5.5版本

2.5.5版更新內容

• 修復部分用戶背景音樂播放音量無法設置的問題
• 適配返回頂部新算法,修復返回頂部后無法繼續下拉的問題

2.5.4版更新內容

• 新增單欄模式（關閉側邊欄，簡單優化了一下樣式）
• 修復當文章被設置為隱藏或私密時，依舊能通過側邊欄小工具訪問的問題
• 優化加密文章展示效果

之前一位網友提出的一個建議 “可不可以考慮下取消所有側邊欄后，內容居中，太需要了。” ，真是一個很不錯的想法啊，這樣Initial不就秒變成為一個簡單的單欄主題了嗎？??

2.5.3版更新內容

• 修復Ajax翻頁雙擊(多擊)問題
• 修改過度樣式，解決刷新頁面后頁面移動問題
• 更新幾個Gravatar頭像源

2.5.2版更新內容

• 后臺新增“自定義樣式”（優先級大于默認樣式）
• 字體大小和行距稍微增大（閱讀更輕松）
• “文章許可信息”可關閉顯示
• 備案號鏈接跟隨調整（這玩意為什么又變了？??）
• 優化輕語評論邏輯
• 其他細節調整與優化

本次更新主要是調整了字體大小，希望能夠使閱讀更加輕松。

2.5.1版更新內容

• 新增“代碼高亮”（Highlight.js）
• 修復關閉Pjax時產生報錯的問題
• 大量優化與調整
• 重寫了“輕語”和“最近回復”的部分代碼
• 優化部分頁面結構，更有利于SEO
• 其他細節調整

本次更新新增了便于閱讀的“代碼高亮”功能（阻滯頁面，影響加載速度，雖然很微弱，但是不爽??）。

js文件使用base62轉碼壓縮，如果需要查看源碼，可在瀏覽器控制臺內點擊Initial By JIElive http://www.offodd.com 這個log右上角的鏈接，里面就是js源碼，可以方便大家mod.

上個版本提取js后有可能會出現一些BUG，雖然我已經盡量把能想到的問題全部測試通過了，但不排除還有沒發現的問題，如果發現問題歡迎留言反饋。

2.5版更新內容

• js寫入獨立文件
• 修復關閉Ajax翻頁時,加密文章無法打開的問題
• 刪除公共靜態資源來源“BootCDN”（太不穩定）
• 其他微調優化

本次更新主要是把js語句全部寫入獨立的js文件，配合pjax和cdn，訪問速度理論上應該有所提升，其余更新內容不多。

2.4.5版更新內容

• 站點標題支持自定義顯示方式（僅文字、僅LOGO、LOGO+文字）
• 文章目錄添加全局開關
• 添加Staticfile靜態資源CDN
• 其他微調

更新內容不多，不想覆蓋升級的可以參照GitHub自行修改。

2.4.4版更新內容

• 優化分類名過長時的顯示問題
• 備案號鏈接地址更新
• archive頁面添加文章閱讀量顯示
• 關閉偶爾可能會出現的無關緊要的php提示
• 其他優化與小調整

小小更新一下，以上問題基本不影響使用，想省事的可以自行修復一下即可。

2.4.3版更新內容

• 刪除外觀設置內從2.4版本開始棄用的鏈接列表（已遷移至 管理-獨立頁面-鏈接模板頁面-自定義字段-links 內）
• 新增“輕語”的評論回復功能，并優化評論樣式
• 新增文章底部“文章許可信息”，可在后臺自定義內容
• 修復“輕語”評論無法換行的問題
• 修復某些情況下“文章目錄”按鈕狀態異常
• 修復“注腳”鏈接新窗口打開的問題
• 優化導航下拉列表，不再限制寬度
• 優化評論框架結構，回復評論目標更清晰
• 其他優化與小調整

注意：從本版開始，后臺-外觀設置內的 鏈接列表 已徹底刪除，新的鏈接列表已遷移至 管理-獨立頁面-鏈接模板頁面-自定義字段-links 內，以后的鏈接操作都需要在這里進行。

2.4.2版更新內容

• 新增背景音樂“隨機播放”選項，請在 后臺-控制臺-外觀-設置外觀-背景音樂 處修改
• 將文章、頁面、輕語的外鏈接、評論者的鏈接修改為使用使用新窗口打開（僅外鏈接使用新窗口，本站鏈接還在當前頁打開）
• 調整“文章目錄”按鈕位置到右下角并美化界面，僅當文章有目錄時，才會顯示
• 后臺設置選項判斷優化（老用戶請進入 后臺-設置外觀 將未選擇的設置項重選一下即可，不影響使用，請正常升級）
• 其他優化與小調整

本次更新以查找問題為主，需要注意的就是主題設置項進行了優化，新用戶忽略即可，老用戶升級后，請到 后臺-設置外觀 ，可以看到有幾個單選的設置項被清空了，只需要重新選擇一下并保存就行，當然，如果你不重新選擇，也不會影響使用??。

2.4.1版更新內容

• 調整“文章目錄”選項位置到 編輯文章 內，可單獨設置每篇文章是否顯示文章目錄（默認關閉）
• 調整側邊欄“最近回復”超鏈接，點擊自動跳轉至評論位置
• 部分代碼優化

本次更新依然是小更新，優化為主，主要是調整了“文章目錄”的開啟關閉方式，從之前的 主題設置 移動到 編輯文章 內，可單獨設置每篇文章是否顯示文章目錄（默認關閉）。

2.4版更新內容

• 新增文章閱讀量統計與顯示
• 新增文章目錄（默認關閉）
• 新增“輕語”的評論功能
• 將“鏈接列表”遷移至“鏈接”頁面內，防止丟失
• 稍微增加移動端字體大小
• 修復關閉Pjax時某些情況下無法評論
• 修復幾處PHP Notice
• 優化Archive作者頁標題
• 優化熱門文章排序規則
• 代碼優化和其他優化調整

注意：從2.4版開始，鏈接列表 已遷移至 管理-獨立頁面-鏈接模板頁面-自定義字段-links 內，以后的鏈接操作都需要在這里進行，主題設置處的列表暫留備份，再更新幾次后將會徹底刪除。

此次更新最需要注意的就是“鏈接列表”，從主題設置遷移到了“鏈接”模板頁面的自定義字段內。

老用戶更新2.4版主題后

若已創建 鏈接模板頁面，前臺刷新該頁面，將會自動將之前的 鏈接列表 遷移至 鏈接模板頁面 內。

若未創建 鏈接模板頁面，請前往 管理-獨立頁面-新增頁面-自定義模板-選擇“鏈接” 創建“鏈接”模板頁面，然后前臺訪問該頁面，將會自動將之前的 鏈接列表 遷移至 鏈接模板頁面 內。

新用戶若需要使用“鏈接”功能，請前往 管理-獨立頁面-新增頁面-自定義模板-選擇“鏈接” 創建“鏈接”模板頁面，然后新增“自定義字段”，字段名稱設置為links，字段值按照之前的 鏈接格式 輸入即可。具體使用方法可以點擊這里查看。

2.3.2版更新內容

• 優化子分類顯示（同一父分類下的所有級別的子分類都將顯示在該父分類下，級別太多也不好吧??）。
• 其他小調整。

子分類這個東西之前從來沒有使用過，所以也一直沒有發現這個問題，謝謝網友**@luvnaxx**發現并提出。

2.3.1版更新內容

• 新增切換Gravatar頭像源，官方源、國內源、V2EX源
• 豐富Ajax翻頁選項，自動、點擊、關閉
• 刪除DNS預獲取、刪除自定義Apple圖標
• 其他優化與小調整

最近年底了，事情很多，更新不會很大，以優化和修復為主。

2.3版更新內容

• 新增Ajax翻頁，支持自動翻頁與點擊翻頁
• 新增“輕語”功能（類似說說），并新增一套極簡“輕語”模板，支持在首頁和側邊欄顯示
• 文章縮略圖支持調用文章內的任意圖片（例如：輸入數字“2”代表使用文章內第二張圖片）
• 再次優化加密文章與Pjax沖突問題，已經趨近完美
• 解決進入“歸檔”頁面時側邊欄的文章數量異常
• 其他功能優化與小調整（比較多，記不清了）

本版更新主要在“輕語”這個功能，折騰了很久，本以為挺簡單，但實際操作才發現有很多小問題，還好都解決了，目前正常使用沒問題，后續更新會豐富此功能。 其次就是添加了Ajax翻頁，這個也是很多朋友期待的，歡迎更新品嘗，若有問題隨時站內反饋??

2.2.1版更新內容

• 鏈接功能添加鏈接圖標參數
• 鏈接模板內的鏈接增加圖標顯示（默認關閉）
• 其他小調整

本版更新為小更新，主要由于在后臺的“鏈接列表”增加了一個“鏈接圖標”的參數，考慮到要盡量減少對使用者的影響，故提前更新。

2.2版更新內容

• 添加側邊欄動態滾動（默認關閉）
• 調整右下角小工具位置，解決超寬屏尷尬
• 添加背景音樂播放進度條
• 修復關于鏈接的小問題
• 清除翻譯語句
• 其他細節調整與小BUG修復

2.1版更新內容

• 新增一套鏈接模板
• 新增鏈接功能，可在首頁（側欄或頁底）和鏈接模板內顯示，可自定義要顯示的分類
• 新增自定義公共靜態資源來源，支持BootCDN、CDNJS、jsDelivr
• 修復加密文章與Pjax有沖突的問題（感謝okgo發現并提出此BUG，估計帶Pjax的TE主題都有此問題??）
• 修復側邊欄熱門文章顯示數量使其與后臺設置一致
• 移除Normalize，將其優化集成進主題css
• 背景音樂優化、界面微調優化
• 其他細節調整與小BUG修復（優化了很多細節，記不起來了??）

2.0版更新內容

• 公共靜態資源由BootCDN替換為CDNJS（BootCDN已暫停）
• 重新設計的網站頭部樣式
• 新增可將頭部設置為固定顯示
• 新增導航欄可自定義顯示分類、頁面、是否合并顯示等（充足的自定義）
• 新增自定義副標題，取消自定義描述（因為頭部重做后已不顯示此項）
• 新的a標簽顏色，整體樣式微調
• 新增面包屑導航（可自定義）
• 新增側邊欄熱門文章
• 其他細節調整與小BUG修復

本版更新主要在外觀，變化較大，當然，細節和新增功能也是精益求精，望君喜。

1.3版更新內容

• 使用excerpt摘要函數，可自動截取摘要
• 閱讀量統計（這個目前還不確定是否要加上）暫時不加
• 自定義文章縮略圖或者自動調用文章第一張圖片作為縮略圖
• URL替換（主要是方便于使用七牛等cdn的靜態文件鏡像加速）
• HTML代碼壓縮
• 背景音樂添加支持多首歌曲循環，添加錯誤歌曲檢測，自動跳過
• 添加評論區文章作者小標簽
• 其他細節調整與優化

1.2版更新內容

• 優化部分細節
• 修復一處關于Ajax評論的邏輯性小錯誤
• 添加右下角小工具
• 返回頂部(1.2.1版添加過渡動畫)
• 背景音樂
• 側邊欄添加標簽云（1.2.1）

背景音樂這個真是折騰了好久，因為主要是想使用網易的音樂，再加上要盡量做到最輕量，看了幾個API框架，直接就放棄了（雖然做完只有不到100KB，但還是覺得太大了），最后找到一個不錯的開放API，可惜不支持https??貌似沒辦法了。。。
晚上回家思考了一下，制作本主題的初衷就是簡約而不簡單，既然是要“簡約”何不做到極致？好像找到了新的大門??

最后確定使用原生HTML5播放器（隱藏式），后臺自定義一首你最最喜歡的音樂循環播放（后臺可給音樂設置一個合適的音量），僅使用一個按鈕來集成播放狀態提示、播放控制、播放進度，*播放和暫停狀態提示由純CSS實現；播放和暫停控制由原生JS實現。*雖然沒有使用框架那么強大的功能和兼容性，但覺得非常符合本主題初衷。

1.1版更新內容

• 全站Pjax + ajax評論
• 二維碼打賞