2019-10-22 seo達(dá)人
使用docbox定制API文檔
什么是docbox
docbox的安裝
克隆項(xiàng)目
部署方式
docbox的編寫
定制logo及UI
更換代碼背景色
插入自己的logo
三列改為雙列
其他定制UI
在公司實(shí)習(xí)了一個(gè)月，由于業(yè)務(wù)需要，我花了大概一周時(shí)間對(duì)docbox的安裝，編寫，定制化等進(jìn)行了詳細(xì)的研究，下面給大家分享一下我的總結(jié)
什么是docbox
Docbox是一個(gè)開源的REST API文檔系統(tǒng)。它采用結(jié)構(gòu)化的Markdown文件，并生成帶有導(dǎo)航，固定鏈接的兩列布局。下面是官方example圖片：
docbox的安裝
克隆項(xiàng)目
直接去官網(wǎng)https://github.com/tmcw/docbox，然后克隆即可。
部署方式
在使用npm命令前需要下載Node.js，npm會(huì)根據(jù)package.json配置文件中的依賴配置下載安裝
接著，在/content下放入.md文件，并使用 npm run build 命令，生成一個(gè)包含所需要的js代碼的bundle.js文件，同時(shí)創(chuàng)建一個(gè)新的index.html文件
重要的就是index.html、bundle.js、/css這三個(gè)文件和文件夾
docbox的編寫
在/content下放入.md文件（markdown語(yǔ)法俺就不說了哈……）
對(duì)/src/custom/content.js中添加需要引入的.md文件位置和以及標(biāo)題
注意： /src/custom/content.js中放入的是一級(jí)標(biāo)題、二級(jí)和三級(jí)標(biāo)題需要在.md文件中編寫。
定制logo及UI
修改/src/custom/index.js文件
修改對(duì)應(yīng)標(biāo)簽的屬性即可，定制時(shí)修改生成的index.html是沒有用的，因?yàn)閕ndex.html里的標(biāo)簽是被動(dòng)態(tài)寫死的。
更換代碼背景色
<div class='round-left pad0y pad1x fill-green code small endpoint-method'>
1
<div class='endpoint dark fill-blue round '>
1
插入自己的logo
修改/src/components/app.js文件
三列改為雙列
docbox默認(rèn)情況下是顯示三列布局，但我們可以在app.js下進(jìn)行修改使之默認(rèn)為雙列布局。將下圖的1改為2即可切換雙列模式
其他定制UI
像下圖一樣，我們可以修改并填寫代碼得到自己想要的頁(yè)面樣式，比如說我在最上方加了一個(gè)固定位置的區(qū)域，然后可以在這個(gè)區(qū)域添加相應(yīng)的超鏈接等。
app.js里可以找到圖中對(duì)應(yīng)的標(biāo)簽和js代碼，docbox支持多種語(yǔ)言切換，我們?cè)谛枰牡胤郊尤胛覀兿胍尤氲臉?biāo)簽，并在/css文件夾中對(duì)相應(yīng)的css文件添加樣式就可以定制我們想要的UI啦！！！
下面給大家列出一些用docbox定制API文檔的網(wǎng)站
Mapbox API文檔
Mapillary的API文檔和Tiles文檔
HYCON 8th
Wall
藍(lán)藍(lán)設(shè)計(jì)( m.gerard.com.cn )是一家專注而深入的界面設(shè)計(jì)公司，為期望卓越的國(guó)內(nèi)外企業(yè)提供卓越的UI界面設(shè)計(jì)、BS界面設(shè)計(jì) 、 cs界面設(shè)計(jì) 、 ipad界面設(shè)計(jì) 、 包裝設(shè)計(jì) 、 圖標(biāo)定制 、 用戶體驗(yàn) 、交互設(shè)計(jì)、 網(wǎng)站建設(shè) 、平面設(shè)計(jì)服務(wù)。
藍(lán)藍(lán)設(shè)計(jì)的小編 http://m.gerard.com.cn