增加第三方外掛程式 gitbook 入門教程之主題外掛程式

2021-10-15 00:04:33 字數 2470 閱讀 6993

目前 gitbook 提供三類文件: book 文件,api 文件和 faq 文件.

其中,預設的也是最常使用的就是 book 文件,如果想要了解其他兩種文件模式,需要引入相應的主題外掛程式.

官方主題外掛程式文件:

book 文件theme-default 主題theme-default 是 3.0.0 引入的預設主題,大多數外掛程式針對的都是預設主題,如果切換到其他主題或者自定義主題,可能會造成某些情況下不相容,甚至報錯.

預設情況下,左側選單不顯示層級屬性,如果將 showlevel 屬性設定為 true 可以顯示層級數字.

示例:

效果:

預設情況下左側選單樹不顯示目錄層級

開啟層級顯示設定後,左側選單樹顯示當前目錄層級

theme-comscore 主題default 預設主題是黑白的,而 comscore 主題是彩色的,即標題和正文顏色有所區分.

示例:

效果:

預設情況下各級標題顏色均是黑色,不同級別的標題僅僅是大小區別.

設定 comscore 主題後,各級標題顏色不同,不僅僅是大小不同.

api 文件theme-api 外掛程式如果文件本身是普普通文件模式,切換成 api 文件模式後並不會有太大變化,除非一開始就是介面文件,那樣使用 theme-api 外掛程式才能看出效果.

示例:

語法:

示例:效果:

新增 api 相關方法後的文件效果,正常會兩列顯示並在右上角增加語言切換工具.

faq 文件theme-faq 外掛程式theme-faq 可以幫助我們構建問答中心,預設好常見問題以及相應答案模式,同時為了方便搜尋到問題或答案,一般需要搜尋外掛程式的配合.

示例:

幫助中心沒有工具欄,因此涉及到工具類的外掛程式一律失效或主動移除,同時預設搜尋外掛程式也會失效.

語法:

在當前頁面底部顯示延伸閱讀,支援 yaml 語法關聯到其他頁面.

新建 _layouts/website/page.html 檔案,用於擴充套件當前主題外掛程式來增加自定義 logo.

新建 _layouts/website/page.html 檔案,用於擴充套件當前主題外掛程式來增加自定義導航欄鏈結.

示例:

新建 _layouts/website/page.html 檔案,增加自定義 logo 和導航欄鏈結.

效果:

小結

本節主要講解了常用的三種文件模式,其中 default 主題外掛程式,適合一般的部落格類**或靜態**,api 主題外掛程式適合介面文件的編寫,faq 主題外掛程式則適合幫助中心.

三種主題外掛程式分別對應不同的應用場景,預設情況下使用的是 default 主題外掛程式,平時介紹的大多數功能外掛程式也大多適合這種主題,另外兩種主題可能就不能很好相容第三方外掛程式,需要親身體驗.

Flask 第三方外掛程式

因為flask自帶的session是將session存在cookie中 所以才有了第三方flask session外掛程式,可以將session儲存在我們想儲存的資料庫中 redis等 pip install flask session注意redis資料庫一定是在內網中的且是一台單獨的伺服器,防止被...

Android 增加第三方APK

一 原始碼增加 這種方法要求開發的apk必須遵循一些約定,最主要的就是字串必須在strings.xml裡定義,不能直接在應用程式裡賦字串值。二 沒有原始碼,只有編譯好的apk 有2種辦法可以新增.這種方法最簡單,但是在重新make整個專案後又必須重新複製到此目錄。2 使用build prebuilt...

Lua第三方外掛程式列表

下面的這些內容不包含在本文中 官方的lua包和文件 參看 涉及到lua使用但不是被lua使用者普遍使用的東西 參看 uses.html 本wiki已經存在的內容 參看 luadirectory librariesandbindings lua的使用列表 1 see also luaeditorsup...