docsify部署到GitHub Pages

Welcome to Linux DOC 👋

• 📚官方文檔
• 😃github
• 📺在線演示

git安裝

下載git

sudo yum install git
複製代碼

若是使用Ubuntu系統，運行sudo apt-get install git

配置git

git config --global user.name "Your Name" 
git config --global user.email "email@example.com"
複製代碼

查看git配置是否生效

git config --list
複製代碼

配置遠程倉庫

ssh-keygen -t rsa -C "your_email@youremail.com"
複製代碼

一路回車便可，在root目錄下.ssh文件夾內會生成id_rsa、id_rsa.pub

在GitHub中配置SSH keys，並建立倉庫

配置SSH keys

首先咱們進入GitHub官網，點擊右上角頭像，選擇Settings，而後選擇SSH and GPG keys，在右邊新建一個SSH keys。把上一步生成的id_rsa.pub填寫到key下方，Title能夠隨意填寫。

建立倉庫

咱們點擊頭像左邊的+號，點擊New repository建立一個新的倉庫。

輸入倉庫名，其餘保持默認便可。

初始化倉庫

在本地新建一個文件夾mydoc

mkdir mydoc
複製代碼

初始化git

git init
複製代碼

初始化完成，咱們來測試一下。

vim readme.txt
複製代碼

在readme.txt裏寫一句話，而後輸入:wq退出。

git add .
git commit -m "新建readme.txt"
git push origin master
複製代碼

而後刷新剛纔建立的倉庫，發現已經成功提交了。

安裝npm

下載npm

wget https://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz
複製代碼

解壓

xz -d node-v10.15.3-linux-x64.tar.xz
tar -xvf node-v10.15.3-linux-x64.tar
複製代碼

把解壓的文檔移動到別的目錄

mv node-v10.15.3-linux-x64 /usr/local/lib 
mv /usr/local/lib/node-v10.15.3-linux-x64/ /usr/local/lib/nodejs
複製代碼

添加環境變量

export PATH=/usr/local/lib/nodejs/bin:$PATH
複製代碼

建立連接

ln -s /usr/local/lib/nodejs/bin/node /usr/bin/node 
ln -s /usr/local/lib/nodejs/bin/npm /usr/bin/npm 
ln -s /usr/local/lib/nodejs/bin/npx /usr/bin/npx
複製代碼

能夠使用node -v、npm version來查看版本信息。

使用docsify

安裝

npm i docsify-cli -g
複製代碼

初始化

進入mydoc文件夾

docsify init ./docs
複製代碼

本地預覽網站

docsify serve docs
複製代碼

經過docsify serve能運行一個本地服務器，方便預覽。默認訪問路徑：http://localhost:3000 若是你們使用雲服務器，那麼默認訪問路徑爲：http://<你的服務器ip>:3000/ 記得要放行3000端口。

若是下載緩慢的話，能夠安裝國內鏡像來提高速度

國內npm鏡像

npm config set registry https://registry.npm.taobao.org
複製代碼

GitHub Pages

點開倉庫，選擇Settings，往下拉找到GitHub Pages，按下圖所示選擇。

此時，點擊上方分配的免費域名就看到頁面了。

配置自定義域名

在Custom domain選項中，填寫本身的二級域名地址，點擊save。使用自定義域名前，須要在域名商進行CNAME解析。記錄值填寫 yourname.github.io，其中yourname替換爲你的github用戶名。而後返回github官網等待域名證書，證書下發成功後，勾選GitHub Pages下的Enforce HTTPS按鈕，刷新頁面就能夠了。