创建知识库

创建知识库

知识库搭建好,然后部署到github上面所需要的工具:

  • npm

  • docsify框架

1.查看npm安装了没? 没有安装,需要安装一下~

1
npm -v  

2.安装docsify并查看安装版本

1
npm install -g docsify-cli

如果cmd运行不动,就需要翻墙去运行

1
docsify -v  查看安装版本

3.创建一个文件夹(repository)

4.进入文件夹目录

5.初始化文件夹

1
docsify init   然后y确认

6.启动网站

1
docsify serve

知识库1

配置文件

1.README.md代表网站里面的内容,只需要修改这个就可以改动网站。

docsify是不用重启的,实时同步新的改变

知识库3

知识库4

内容代码分析

一级标题

2.src是一个图片链接,这些图片的存放方式全部是放在了第三方存储里面,然后Markdown里面只放了图片的链接。

这个地方,很明显就是放在了Github的cdn加速上

图片链接

3.修改主题

index.html的文件里面可以修改主题,主题一共有5种,修改配置文件,即可变化网站主题

主题修改

4.网站封面(开启封面功能)

coverpage:true 添加这个代码,就可以打开封面功能,文件:_coverpage.md

封面

封面1

5.导航栏

loadNavbar:true 添加这个代码,就可以打开导航栏功能 文件:_navbar.md

导航栏

上传github的静态网站

一个github只能运行一个静态网站

遇到的报错问题

error: remote origin already exists.
原因:

当你在git push到GitHub的时候报错 出现error: remote origin already exists. 翻译过来呢就是 错误:远程源已经存在。

解决方案:

第一: 查看远程库的信息: git remote -v
第二: 删除现有的远程仓库: git remote rm origin
第三: 建立新的远程仓库地址: git remote add origin + 远程仓库地址


创建知识库
http://example.com/2024/07/25/搭建知识库/
Author
John Doe
Posted on
July 25, 2024
Licensed under