利用docsify创建文档网站(手摸手教程)

一、前言

docsify 是一个动态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件,所有转换工作都是在运行时进行。
这将非常实用,如果只是需要快速的搭建一个小型的文档网站,或者不想因为生成的一堆 .html 文件“污染” commit 记录,只需要创建一个 index.html 就可以开始写文档而且直接部署在 GitHub Pages。

二、环境

使用docsify-cli 开发 docsify文档网站比较方便,但是需要先安装node
node安装教程可以参考 nodejs安装图文教程

三、安装

1、初始化

  1. 创建一个文件夹 ,例如叫 docs

  2. 在docs目录下安装 docsify-cli

npm i docsify-cli -g

安装完成后使用以下命令查看是否安装完成

docsify -v
  1. 初始化项目
docsify init 

初始化成功后,docsify目录会生成如下几个文件:

index.html入口文件
README.md会做为主页内容渲染
.nojekyll用于阻止 GitHub Pages 会忽略掉下划线开头的文件

 .nojekyll文件很重要,如果网站部署到GitHub Pages时,一定要注意这个文件。

2、启动服务

  1. 启动服务
docsify serve

然后浏览器打开http://localhost:3000就能看见效果。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

prefectjava

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值