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按钮，刷新页面就能够了。