利用docsify生成文档网站
利用docsify生成文档网站
点击**博客右上角文档阅读**即可体验
下面的简介摘抄自docsify的官网 https://docsify.js.org 中的简介
docsify是一个神奇的文档网站生成器。他可以快速帮你生成文档网站。不同于GitBook
、Hexo
的地方是它不会生成静态的.html
文件,所有转换工作都是在运行时。如果你想要开始使用他,只需要创建一个index.html
就可以开始编写文档并直接部署在GitHub Pages
(码云Pages
、阿某云OSS
或者鹅云COS
等等)。它的主要特性如下:
- 无需构建,写完文档直接发布(运行时
markdown
文档转换) - 容易使用并且轻量(压缩后 ~21kB,当然这里不包括
markdown
文档的大小) - 智能的全文搜索
- 丰富的
API
- 支持
Emoji
,可以在文中添加表情 - 兼容
IE11
- 支持服务端渲染
SSR
docsify的最大优势是可以让使用者感受到用写博客的姿势去编写文档,反过来说也行:用写文档的姿势去写博客。docsify
的学习成本很低,部署简单,官方文档十分完善,原则上只需要理解markdown
的语法和Node.js
的安装即可,对于非IT
技术从业者也十分友好。知名的技术公众号号主JavaGuide的站点就是采用docsify
构建的。
安装使用
根据官网教程来即可,比较简单。
https://docsify.js.org/#/?id=docsify
部署
推荐github page,giteepage,腾讯云静态网站托管。
如果你有备案好的域名,一定要利用好二级域名,可以构建多个网址哦!
License:
CC BY 4.0