项目简介
本项目是基于docsify框架构建的文档生成系统。Docsify是基于Vue的现代化文档生成工具,可轻松创建现代化、简洁且个性化的在线文档网站。其使用静态文件,无后端依赖,开发和部署都很便捷。
项目的主要特性和功能
- 简单易用:通过简单命令行操作即可创建和更新文档内容。
- 自定义性强:可编辑
index.html
和其他Markdown文件来定制页面内容和样式。 - 插件系统:支持多种插件,涵盖全文搜索、图片缩放、代码复制、字数统计、代码高亮、emoji表情支持、分页导航等。
安装使用步骤
1. 安装依赖
确保已安装Node.js和npm(Node包管理器),在命令行执行以下命令全局安装docsify-cli
工具:
sh
npm i docsify-cli -g
2. 创建和初始化项目
创建文件夹,在该文件夹下执行以下命令初始化文档目录:
sh
docsify init ./docs
此操作会在当前文件夹生成docs
目录,包含index.html
(入口文件)和README.md
(作为主页内容渲染)。
3. 本地预览
运行以下命令启动本地服务器,实时预览文档效果:
sh
docsify serve docs
默认访问地址为 http://localhost:3000
。
4. 自定义配置和添加插件
可编辑index.html
文件自定义文档标题、样式和配置选项,也可添加插件扩展文档功能:
- 全文搜索:在index.html
中添加全文搜索配置项并引入search.min.js
。
- 图片缩放:引入zoom-image.min.js
。
- 代码复制:引入docsify-copy-code
插件。
- 字数统计:添加count
配置项并引入countable.js
。
- 代码高亮:引入Prism
的语法文件。
- emoji表情支持:引入emoji.min.js
。
- 分页导航:引入docsify-pagination
插件。
- 返回顶部:引入docsify-scroll-to-top
插件。
- 侧边栏折叠:引入docsify-sidebar-collapse
插件。
5. 个性化操作
自定义导航栏
在index.html
文件中添加nav
标签自定义导航栏内容,示例如下:
```html
```
定制化配置项
在index.html
文件的script
标签中对window.$docsify
进行配置,定制文档标题、仓库地址等,示例如下:
javascript
window.$docsify = {
name: '你的文档标题', // 文档标题,显示在侧边栏顶部
};
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】