Docsify | 搭建个人笔记库

本人代码几乎一窍不通,记录些遇到的问题和解决办法与操作流程。

参考教程

搭建

中文文档搭配b站教程视频
我没有使用GitHub Pages而是通过Vercel部署的,教程可以参考塔塔的Hugo | 一起动手搭建个人博客吧,区别在于注册完vercel后点击“Let's build something new”或“New project”时要选择自己的Github仓库,这部分可以参考b站教程视频中的P9-11。

插件

前人整理的插件介绍
我的笔记库中添加了三个插件:

自定义

参考塔塔的Docsify | 搭建个人静态笔记库

成品

Brsu's Notes
小球飞记
MurphyChen's Notes

注意事项

1.命令行工具在windows上指的是cmd,而不是Nodejs。(windows系统同时按win+R键会弹出“运行”,在框中输入“cmd”即可打开命令行工具)。

2.如果安装完npm后显示高危漏洞,可以按照提示升级npm版本。

3.初始化项目时如果想把docs放在其他目录之下,可以输入其他文件夹位置(?),这里以E盘目录下的“DocsifyNotes”文件夹举例

docsify init E:/DocsifyNotes/docs

目录变化之后本地预览的代码也需要跟着改变

docsify serve E:/DocsifyNotes/docs

4.创建嵌套侧边栏时需要输入从docs开始算起的相对位置,而不是当前目录的相对位置。

5.在index.html文件中

<script>
...
...
</script> //用来控制插入HTML的JS脚本

<script src="..."></script> //插入HTML的JS脚本

6.本地预览没问题,但部署后出现404情况?
注意文件命名,若出现非法符号会出现错误。(像我只好把C++改名为C艹......

加载评论