手機(jī)安裝Linux Deploy 構(gòu)建私有云——個(gè)人博客docsify
docsify
[TOC]
網(wǎng)上有很多開(kāi)源博客系統(tǒng)，篩選了一下，選擇了支持markdown語(yǔ)法的docsify,以及可以形成章節(jié)閱覽模式的gitbook。
nodejs環(huán)境
- 通過(guò)寶塔面板-軟件管理-安裝 PM2管理器
- pm2管理器安裝失敗，但nodejs環(huán)境能夠使用
docsify —— A magical documentation site generator
docsify環(huán)境安裝
npm i docsify-cli -g
目錄初始化
我是用的是寶塔安裝的nginx服務(wù)器，docsify支持直接部署，沒(méi)有按照docsify幫助文檔中的VPS部署，修改nginx服務(wù)器配置，直接在web服務(wù)器根目錄創(chuàng)建了一個(gè)docsify目錄，在該目錄下初始化：
docsify init .
注：執(zhí)行后，會(huì)將上級(jí)目錄中的index.html文件修改;建議按docsify幫助文檔中方式，指定文檔路徑初始化目錄
啟動(dòng)本地服務(wù)預(yù)覽
docsify server . --open
個(gè)人定制
入門使用，先參考docsify幫助文檔在github的編寫方式
更多外觀 docsify-themeable
更多插件 docsify 插件列表
修改index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="description" content="Description">
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
<link rel="stylesheet" >
<style>
/* 修改logo圖片大小 */
.app-name-link img {
height: 100px;
width: 150px;
}
</style>
</head>
<body>
<div id="app">Please wait...</div>
<script>
window.$docsify = {
// 直接渲染其他域名的文檔
//basePath: 'http://guolu1976.ticp.net/docsify/',
//basePath:'/',
logo: '/img/china.svg',
auto2top: true, //當(dāng)路線改變時(shí)，滾動(dòng)到屏幕的頂部。
coverpage: false, //激活封面功能。如果為true，則會(huì)從中加載_coverpage.md。
executeScript: false, //執(zhí)行頁(yè)面上的腳本。只解析第一個(gè)腳本標(biāo)記（演示）。如果存在Vue，則默認(rèn)開(kāi)啟。
//同時(shí)設(shè)置 loadSidebar 和 autoHeader 后，可以根據(jù) _sidebar.md 的內(nèi)容自動(dòng)為每個(gè)頁(yè)面增加標(biāo)題。#78
loadSidebar: true, //_sidebar.md如果為真，則從_sidebar.md文件加載邊欄，否則從指定的路徑加載。
loadNavbar: true,
subMaxLevel: 2,//在自定義邊欄中添加目錄（TOC）。
autoHeader: false,
mergeNavbar: true,//Navbar將在小屏幕上與側(cè)邊欄合并。
maxLevel: 6,//最大的內(nèi)容表級(jí)別。
name: '簡(jiǎn)，道指根；易，經(jīng)之本',//TODO:添加logo后不能正常顯示
search: {
maxAge: 86400000, // 過(guò)期時(shí)間，單位毫秒，默認(rèn)一天
noData: {
'/': '沒(méi)有結(jié)果!'
},
paths: 'auto',
placeholder: {
'/': '搜索'
},
// 搜索標(biāo)題的最大程級(jí), 1 - 6
depth: 6,
},
// themeColor: '#3F51B5',
}
</script>
<script src="http://unpkg.com/docsify/lib/docsify.min.js"></script>
<script src="http://unpkg.com/docsify/lib/plugins/search.min.js"></script>
<script src="http://unpkg.com/docsify/lib/plugins/emoji.min.js"></script>
<script src="http://unpkg.com/docsify-copy-code"></script>
<!-- markdown 代碼高亮顯示 https://unpkg.com/prismjs/components/ -->
<script src="http://unpkg.com/prismjs/components/prism-bash.min.js"></script>
<script src="http://unpkg.com/prismjs/components/prism-php.min.js"></script>
<script src="http://unpkg.com/prismjs/components/prism-markdown.min.js"></script>
</body>
</html>
修改根目錄README.md
網(wǎng)頁(yè)書簽
<!-- README.md -->
[dogedoge](https://dogedoge.com ':include :type=iframe width=100% height=500px sandbox="allow-same-origin allow-top-navigation allow-forms allow-scripts"')
[dogedoge](https://dogedoge.com) [語(yǔ)雀—云端知識(shí)庫(kù)](https://www.yuque.com/explore/headlines)
算機(jī)/Win10/img/tool.lu.png) [在線工具—程序員的工具箱](https://tool.lu/)
---
[阮一峰的網(wǎng)絡(luò)日志](http://www.ruanyifeng.com/blog/) [Zdoc—xiaoz.me博主](https://www.xiaoz.me/doc/) [小四的后院](https://233.al/)
---
*程序員工具箱網(wǎng)站https://tool.lu/的圖片鏈接url(//qn11.tool.lu/201710/15/103320SbM84Ql4tETjg49a_28x28.png)，在docsify中不能正常顯示，vscode中markdown預(yù)覽正常，沒(méi)有查找原因。*
根目錄_navbar.md
<!-- _navbar.md -->
* ≡
* [簡(jiǎn)書](/jianshu.md)
根目錄_sidebar.md
<!-- _sidebar.md -->
* [首頁(yè)](/ ':title= 首頁(yè)')
* [我的簡(jiǎn)書](/jianshu.md ':title=我的簡(jiǎn)書')
* [簡(jiǎn)，道之根；易，經(jīng)之本](http://www.itdecent.cn/u/49f691fad0a9)
* [Win10相關(guān)](/計(jì)算機(jī)/Win10/_sidebar.md ':title= Win10相關(guān)內(nèi)容')
* [Linux相關(guān)](/計(jì)算機(jī)/Linux/_sidebar.md ':title= Linux相關(guān)內(nèi)容')
* [喜馬拉雅](/喜馬拉雅/_sidebar.md)
子目錄_sidebar.md
<!-- /計(jì)算機(jī)/Linux/_sidebar.md -->
* [Linux相關(guān)](/計(jì)算機(jī)/Linux/_sidebar.md)
* [手機(jī)安裝Linux Deploy 構(gòu)建私有云](/計(jì)算機(jī)/Linux/_sidebar.md)
- [環(huán)境搭建](/計(jì)算機(jī)/Linux/手機(jī)安裝LinuxDeploy構(gòu)建私有云/手機(jī)安裝LinuxDeploy構(gòu)建私有云.md)
- [svn服務(wù)器—subversion](/計(jì)算機(jī)/Linux/手機(jī)安裝LinuxDeploy構(gòu)建私有云/svn服務(wù)器—subversion.md)
- [個(gè)人博客—docsify）](/計(jì)算機(jī)/Linux/手機(jī)安裝LinuxDeploy構(gòu)建私有云/個(gè)人博客—docsify.md)
效果截圖
注：_sidebar.md中的鏈接，如果不添加title標(biāo)記，瀏覽器中的標(biāo)題顯示錯(cuò)誤。
首頁(yè) | /README.md
導(dǎo)航欄 | /_navbar.md
Linux相關(guān) | /計(jì)算機(jī)/Linux/_sidebar.md
個(gè)人博客 docsify | 計(jì)算機(jī)/Linux/手機(jī)安裝LinuxDeploy構(gòu)建私有云/個(gè)人博客—docsify
遇到的問(wèn)題
源碼安裝nodejs
需要使用新版gcc編譯器，簡(jiǎn)單嘗試不成功后放棄
阿里的源對(duì)x86架構(gòu)以外的cpu架構(gòu)支持的不好,沒(méi)有更換源去嘗試。
后來(lái)發(fā)現(xiàn)通過(guò)寶塔面板安裝PS2管理器可以部署nodejs環(huán)境
需升級(jí)gcc
Centos7升級(jí)gcc版本方法之一使用scl軟件集
yum install centos-release-scl scl-utils-build scl-utils
wget https://npm.taobao.org/mirrors/node/v10.16.0/node-v10.16.0.tar.gz
tar xvzf node-v10.16.0.tar.gz
cd node-v10.16.0
./configure
make -j4
sudo make install
側(cè)邊欄，瀏覽器標(biāo)題，站內(nèi)導(dǎo)航問(wèn)題
參考總結(jié)中內(nèi)容。
參考
dragon | docsify - 生成文檔網(wǎng)站簡(jiǎn)單使用教程
馮白楊 | 基于滴滴云搭建輕量文檔網(wǎng)站生成工具 Docsify
總結(jié)
- 導(dǎo)航用到的_sidebar.md等站內(nèi)md文件中，使用站內(nèi)的鏈接文件，需要使用絕對(duì)路徑（根目錄 / 是index.html所在目錄）
<!--_sidebar.md-->
* [首頁(yè)](/)
* [簡(jiǎn)，道之根；易，經(jīng)之本](http://www.itdecent.cn/u/49f691fad0a9)
* [Win10](/簡(jiǎn)書/Win10/Win10.md)
- 首頁(yè)使用的絕對(duì)路徑，docsify會(huì)導(dǎo)航到根目錄的README.md；
- 前面例子中，二級(jí)導(dǎo)航Win10的鏈接Win10.md使用的是絕對(duì)路徑；
- 啟用自定義導(dǎo)航后，所有的文件夾子目錄需要都使用_sidebar.md進(jìn)行導(dǎo)航（否則，目錄[TOC]展開(kāi)位置不可控，很可能在README.md的一級(jí)大綱中展開(kāi)）；
- 二級(jí)目錄中，_sidebar.md文件中第一行加入圖片鏈接，會(huì)自動(dòng)添加到導(dǎo)航欄；
- 導(dǎo)航到對(duì)應(yīng)文章時(shí)，大綱目錄會(huì)出現(xiàn)在導(dǎo)航欄中，通過(guò)index.html中初始化腳本參數(shù)subMaxLevel，控制顯示級(jí)別；
- 多頁(yè)時(shí)側(cè)邊欄配置了subMaxLevel無(wú)效 #726 : 文件名、文件夾路徑中不要包含空格(可以考慮用下劃線_代替空格)
- docsify擴(kuò)展語(yǔ)法中，使用title設(shè)置超級(jí)鏈接的文檔標(biāo)題時(shí)，等號(hào)后邊需要加空格，否則一些標(biāo)題顯示不完整，下面的例子中,不添加空格，瀏覽器標(biāo)簽頁(yè)的標(biāo)題，"Win10"不會(huì)顯示：
* [Win10相關(guān)](/計(jì)算機(jī)/Win10/_sidebar.md ':title= Win10相關(guān)')
Markdown文檔中的鏈接路徑中要使用/，在windows下很容易將路徑使用\，如果路徑中使用了,在docsify中，會(huì)造成導(dǎo)航欄錯(cuò)誤；
MarkDown 鏈接中有空格怎么辦_百度知道
2017年7月20日 - 回答：將空格替換成 %20 即可。
同時(shí)關(guān)注了GitBook,以后制作電子書的時(shí)候再嘗試。
