使用docsify+Git搭建自己的WiKi网站
本文主要内容:
- 0. 前言
- 1. 要求
- 2. 快速安装docsify
- 3. 自定义配置项
- 3.1 修改主页内容
- 3.2 定制侧边栏
- 3.3 定制导航栏
- 3.4 增加标题与Git右上角标
- 3.5 增加搜索框
- 3.6 增加封面
- 3.7 更多插件
- 4. 部署到Git
0. 前言
身为技术人,一方面需要时刻更新自己的技术储备,学习最新的技术,另一方面在工作和项目开发时,面对遇到的各种各样的BUG,需要记住各式各样的对策。
生而为人,遗忘是最大的敌人。将学习到的知识点,解决BUG的对策,整理成文档
,或许是对抗遗忘的最佳方案。
这诸多的技术文档,以怎样的方式进行展示?
每人都有自己的选择方案:
- 有人使用
博客系统
进行记录,如CSDN
、博客园
、简书
、自建博客
; - 有人使用
笔记软件
,如印象笔记
、有道云笔记
; - 有人使用第三方
WiKi系统
,如语雀
、看云
; - 还有人,使用
Git
搭建属于自己的WiKi网站
(文档网站),分享自己的笔记。
目前,可用的WiKi网站开源项目中,比较火的有Hexo
、GitBook
、VuePress
、docsify
等。
每个开源项目都有自己的优点。而docsify
,是轻量级最高
、自定义化程度最高
的项目。
本文将讲述如何使用docsify+Git搭建自己的WiKi网站
。
本文首发地址:https://mp.weixin.qq.com/s/CBsg8fcCawYq2LuJcwRH3Q,作者:拾年之璐
1. 要求
在搭建之前,你的计算机需要安装以下环境:
名称 | 简介 | 官网 |
---|---|---|
Git | 分布式版本控制系统 | https://git-scm.com |
npm | Node.js 的包管理工具 | https://www.npmjs.com |
此外,你还需要:
- 掌握Markdown文档语法,docsify只能部署Markdown文档;
- 拥有Gitee/GitHub账号,用来部署WiKi系统;
- 掌握简单的HTML、JS语法,index文件需要自己配置。
接下来我们将从以下几个方面详细讲解如何使用docsify+Git搭建自己的WiKi网站
:
- 快速安装docsify
- 自定义配置项
- 部署到Git
2. 快速安装docsify
1、创建好安装docsify
的文件夹,比如:
2、在上图的地址栏里输入cmd
,按回车,打开命令行:
3、使用如下命令安装 docsify-cli
工具:
npm i docsify-cli -g
4、使用如下命令初始化
一个名为docs
的项目:
docsify init ./docs
5、使用如下命令本地运行并预览网站
:
docsify serve docs
如下图是各个命令的执行过程。自动生成docs项目文件,并显示运行的网站地址为http://localhost:3000。
进入docs项目,有三个默认的初始化文件:
每个文件的作用如下:
index.html
网站入口文件README.md
做为主页内容渲染.nojekyll
用于阻止 GitHub Pages 忽略掉下划线开头的文件
浏览器访问 http://localhost:3000,即可看到网站效果:
3. 自定义配置项
默认生成的网站效果,并非我们所需要的。
根据实际需求增加一些插件,更能满足我们的需求。
使用Web开发工具(WebStorm、PhpStorm等)打开docs文件,在编辑器中可以更好地编辑。
3.1 修改主页内容
修改README.md
:
本地网站无需重启,刷新
即可显示最新的内容:
3.2 定制侧边栏
1、打开index.html
文件,找到<script>
脚本处,增加配置 loadSidebar
选项,开启侧边栏
。
loadSidebar: true, // 增加:自动加载侧边栏
如下图:
2、在根目录
创建一个名为_sidebar.md
的文件:
如果有如下图所示的系列文档需要在侧边栏进行展示:
3、在_sidebar.md
文件中,按照如下格式写入侧边栏内容:
<!-- 侧边栏 docs/_sidebar.md -->- Laravel基础笔记- [1. 创建项目](/laravel/base/1.%20创建项目.md)- [2. 路由的基础知识](/laravel/base/2.%20路由的基础知识.md)- [3. 控制模块基础知识](/laravel/base/3.%20控制模块基础知识.md)- [4. 数据库操作](/laravel/base/4.%20数据库操作.md)
<!-- 以下略 -->
如图:
4、本地预览网站自动加载了侧边栏:
5、在index
的配置文件中,增加subMaxLevel
配置项,增加生成目录的层级:
subMaxLevel: 4, // 生成目录的最大层级
如下图:
修改后的效果如下图,文章内的标题也可作为侧栏显示出来:
3.3 定制导航栏
1、index
页配置 loadNavbar
选项,开启导航栏
:
loadNavbar: true, // 加载导航栏
如图:
2、在根目录创建一个名为_navbar.md
的文件,并按如下格式写入导航栏
信息:
<!-- _navbar.md 上面的导航栏 -->* 我的平台* [知行达摩院](https://www.zxdmy.com)* [微信公众号](https://img.zxdmy.com/md/20210129164325.jpg)* [CSDN](https://cxhit.blog.csdn.net/)* [Gitee](https://gitee.com/ZXAcademy)* [GitHub](https://github.com/ZXAcademy)* 联系我们* [邮箱](contacts/email.md)* [电话](zh-contacts/phone.md)
如图:
3、查看导航栏:
3.4 增加标题与Git右上角标
1、修改index
配置信息:
2、查看预览页面:
3.5 增加搜索框
1、修改index
配置信息:
引入JS文件
:
<!--搜索插件--><script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
修改配置
:
// 搜索框的完整配置参数search: {maxAge: 86400000, // 过期时间,单位毫秒,默认一天paths: [], // or 'auto'placeholder: '输入内容检索',noData: '未检索到结果',depth: 1,// 搜索标题的最大层级, 1 - 6hideOtherSidebarContent: false, // 是否隐藏其他侧边栏内容}
如图:
2、查看预览页面:
3.6 增加封面
1、修改index
中的配置项coverpage
,开启封面
:
coverpage: true, // 开启封面
如图:
2、在根目录创建一个名为_coverpage.md
的文件,并按如下格式写入封面信息
:
<!-- _coverpage.md 封面 -->![logo](_media/icon2.png)# zxdmy.com <small></small>> 知行达摩院 - 学无止境,知行致远!- 记录课程学习笔记
- 记录科学研究进展
- 记录项目研发历程[知行达摩院](https://zxdmy.com)
[开始使用](#欢迎使用)
如图:
3、效果:
3.7 更多插件
当然还有更多插件,比如代码复制
、图片缩放
、翻页
、字数统计
等。
插件的配置和使用方式大同小异。有的插件需要添加JS
和增加配置项
,有的插件只需要添加JS
。
需要更多插件可查阅官网开发文档
:https://docsify.js.org
本文首发地址:https://mp.weixin.qq.com/s/CBsg8fcCawYq2LuJcwRH3Q,作者:拾年之璐
4. 部署到Git
目前有两种部署方案,一种是
部署至Gitee
,另一种是部署到GitHub
。下文以部署到GitHub为例。
1、新建一个与GitHub用户名同名的公开仓库(Public)
,如下图所示:
为什么要同名?
这样的话,你的WiKi网站的域名就是:https://zxacademy.github.io/
如果使用其他的仓库名,如
blog
,那么你的WiKi网站域名就是:https://zxacademy.github.io/blog为什么要公开仓库?
GitHub私有仓库开启Pages功能需要付费。
2、复制仓库地址
,如图所示:
3、访问本地WiKi项目的根目录
,右击,选择 Git Bash Here
:
4、输入初始化命令
:
git init
如图:
这时,项目根目录多了一个名为 .git
的文件夹
这里建议在项目根目录中增加.gitignore
文件,屏蔽.git和.idea文件夹及其子目录文件:
5、在GitHub
的项目页面,复制仓库地址
,然后在上面的 bash
窗口中,输入如下命令并执行:
git remote add origin 仓库地址
如:
git remote add origin https://github.com/ZXAcademy/ZXAcademy.git
6、使用如下命令,将码云上的仓库 pull
到本地(注意本地项目中不要有和仓库中重名的文件,比如README.md、LICENSE
等初始化仓库时产生的文件)
git pull origin master
如果远程仓库为空,会报如下错误,忽略,继续执行。如图:
7、使用如下命令,将项目所有文件添加到git本地缓冲区
:
git add .
这里末尾的点(.),表示当前目录下的所有文件
8、使用如下命令为本次提交添加备注:
git commit -m '新添加的文件内容描述'
如图:
使用如下命令,将项目推送到GitHub
:
git push origin master
图:
9、前往GitHub网站查看上传成功的文件:
10、按照下图开启Git Page
服务:
然后访问给出的site即可访问自定义的WiKi网站:
https://zxacademy.github.io/zxacademy
为什么我这里直接访问https://zxacademy.github.io 不行呢?
因为我的GitHub用户名为
ZXAcademy
,含有大写字母,所以不行。
如果以后需要增删改文章,直接修改后,push至Git仓库,即可实时更新WiKi网站。
以上就是使用docsify+Git搭建自己的WiKi网站
的全部内容。
本文首发地址:https://mp.weixin.qq.com/s/CBsg8fcCawYq2LuJcwRH3Q,作者:拾年之璐
使用docsify+Git搭建自己的WiKi网站相关推荐
- dokuwiki使用教程,搭建自己的wiki网站
文章目录 0 前言 1 dokuwiki下载 2 搭建 3 修复dokuwiki的中文文章问题 4 创建wiki新页面 5 使用Add New Page插件来创建页面 6 图片复制粘贴插件(ImgPa ...
- php wiki搭建,wiki网站搭建
尝试了使用两种wiki网站:MediaWiKi.dukuwiki和HDWiKi,这三个都是php搭建的,其中dukuwiki无需后台数据库,MediaWiKi.HDWiKI需要后台mysql支持. d ...
- 使用Git搭建个人博客
为什么要搭建个人博客 好记性不如烂笔头,方便日后整理回顾 免费方便,不需要服务器不需要后台,不需要依赖除了git的外部服务 可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于github的 ...
- 个人博客网站建设_利用Github+Jeklly搭建个人博客网站
题图:by ben.pinto from Instagram 阅读文本大概需要 9 分钟. 在上篇文章<个人博客如何选型?>中讲到,可以利用 Github Pages 来搭建个人博客网站, ...
- 使用 hugo oss 搭建个人博客网站
系列文章目录 文章目录 系列文章目录 前言 一.下载hugo 二.oss 三.域名 四.创建博客上传 五.发布,上传文章 前言 本文主要详解如何用最低的成本搭建个人博客网站 原本我是直接用的githu ...
- GitHub Pages + Hexo搭建个人博客网站,史上最全教程
文章目录 一.准备工作 1. GitHub账号 2. 安装Git 3. 安装NodeJS 二.创建仓库 三.安装Hexo 四.更换主题 1. NexT 主题 2. Fluid主题 五.创建文章 六.个 ...
- 怎样搭建企业内部wiki
Wiki 是一个协同著作平台或称开放编辑系统.我们可以用Wiki来建设帮助系统,知识库系统.国内公共wiki最著名就是百度百科;我这里要讨论的是企业的内部wiki. 企业Wiki,是员工可以存储.共享 ...
- Hexo+GitHubPages搭建个人博客网站
Hexo 是一个静态网站生成器,GitHub Pages 可以免费帮我们托管静态网站,本文主要介绍如何结合两者搭建一个博客网站. 官网:https://hexo.io/zh-cn/ Hexo 介绍 H ...
- 如何搭建一个自己的网站-域名篇(上)
咪哥杂谈 本篇阅读时间约为 7 分钟. 1 前言 今天来给大家介绍,域名篇. 随着互联网时代来临,浏览器成为了日常必备的电脑工具. 而域名,但凡用过浏览器的朋友都知道它长什么样. 比如百度: 那我们用 ...
最新文章
- 机器学习开源项目Top10
- 十亿红包还不够,揭秘快手春节四大技术玩法:AI/AR/MR都被装进App,为了这个春晚真拼了...
- Spring-05 -AOP [面向切面编程] -Schema-based 实现aop的步骤
- linux之父子进程的输出
- VMware Workstation Pro 无法在Windows 上运行的 解决办法
- 搜索智能提示suggestion,附近地点搜索
- Transport(传输) 详解
- BackgroundWorker简单实用(简便的异步操作)
- 淘宝SOA框架dubbo学习(2)--搭建Zookeeper注册中心服务
- win 7-8-10 下 删除我的电脑下多余的设备和驱动器,腾讯视频,酷我音乐,手机
- PDF不能编辑怎么办?捷速PDF编辑器快速编辑!
- 修正的判定条件覆盖例题_语句覆盖、判断覆盖、条件覆盖、条件判定组合覆盖、多条件覆盖、修正条件覆盖...
- 回文是指正读反读均相同的字符序列,如“abba”和“abdba”均是回文,但“good”不是回文。编写一个程序,使用栈判定给定的字符序列是否为回文。
- 中国传统民间游戏汇总
- 《使命召唤》单机版详尽攻略
- 【自学小梅哥fpga】04 闪烁led
- s:checkbox
- Day7 牛客 回文素数
- java 电子相册_[Java教程]电子相册特效
- 华为无线路由器信道怎么测试软件,家里人太多网速抢不赢?华为AX3Pro路由上手评测...
热门文章
- monkey的基本定义及基本使用(菜鸟学习中)
- python 无限循环小数_有关无限循环小数的一处漏洞
- Postman的应用——入门应用
- 2020年11月编程排行出炉,Java市场占有率仍第一
- 鸿蒙os2.0基于安卓,外媒实测总结,目前华为鸿蒙OS 2.0依旧是基于安卓框架
- pycharm使用私钥远程连接服务器
- 嵌入式linux/鸿蒙开发板(IMX6ULL)开发(三十五)驱动程序基石
- HyperloopTT将在中国打造首个Hyperloop超级高铁系统
- TCP差分数据播发软件、RTK差分数据网络播发软件
- [Objective-C]第二天