写在前面的话
我之前根据网上的教程,用Python
的Django
搭建博客,需要写代码,申请域名和服务器,对于我这种代码小白来说,真的很艰难。后来群里大神推荐了docsify
这个神器,一切都变得那么轻松可爱~
安装docsify工具
推荐安装 docsify-cli
工具,可以方便创建及本地预览文档网站。
npm i docsify-cli -g
下载之后,直接一路next
下去,直至安装结束,过程很快。
然后重新打开命令提示符,输入npm i docsify-cli -g
,这时候就没问题了。
部署github
在官网上,安装之后,就直接让大家初始化项目,生成doc文件了。但是我觉得,先部署github更方便。部署之后,直接在里面初始化项目。
仓库命名的时候,选一个好听的名字,因为你后面生成的主页,就是这个名字。最好用英文。选择Pulic
属性,Private
属性不能发布成网页。
仓库建好之后,在本地电脑上,选择一个你喜欢的地方,克隆这个库。
你可以在Clone or download
中看到你应该克隆的网址。
克隆的时候,有两种类型,你可以选择HTTPS
克隆,也可以选择SSH
克隆。区别在于,HTTPS
不需要输密码,SSH
需要输密码(可以点击右上角进行切换)。因为是公开的库,所以其实任何人都可以下载,只是上传的时候,需要密码确认。
git clone
如果选择SSH
克隆
git clone
等待系统提示你输入密码,然后完成克隆
初始化项目
在命令提示符中,定位你刚刚克隆的文件夹位置。比如我定位到D
盘的blog
文件夹
D:\>cd blog
这时候,直接通过 init
初始化项目
docsify init ./docs
本地预览效果
在你创建docs文件后,系统会提示你,可以输入docsify serve ./docs
,来预览效果
docsify serve ./docs
这时候,你就可以在浏览器输入这个网址,看看你现在的成果。
开始写文档
初始化成功后,可以看到 ./docs
目录下创建的几个文件
-
index.html
入口文件 -
README.md
会做为主页内容渲染 -
.nojekyll
用于阻止 GitHub Pages 会忽略掉下划线开头的文件
个性化定制
配套的.md
文件,需要自己新建
附上部分插件的详细说明(有些插件,官网写的太简单了,没办法直接用)
- docsify:
- 完整网页设计可参考:
- 网页预览可参考:
上传github
在本地,你把docs
下面的文档都写好了,那么我们就上传到GitHub
上面去。
还是在blog
这个文件下,右击Git Bash Here
检查文件夹状态
git status
添加所有修改的文件
git add .
给添加的文件注释,"***"里面写你觉得合适的注释
git commit -m "update 2020.02.20"
上传GitHub
git push origin master
这时候会让你输入密码的,你就输入(屏幕上并不会显示),然后回车
生成网站
进入GitHub,确认文件都传上去了。然后点击右上角的Settings
这个就是你做的网站了,是不是很神奇~