ikun194 / ikun194.github.io

http://ruins_blog.bear556.xyz/
1 stars 0 forks source link

使用docsify+GitHubPages搭建静态文档站 #16

Open ikun194 opened 2 months ago

ikun194 commented 2 months ago

我建的站:赛博扫盲手册

安装docsify

npm i docsify-cli -g
 # 安装docsify
docsify init ./docs
 # 初始化并创建./docs文件夹

安装成功了,可以看到对应目录下出现了这些文件:

现在就可以编辑README.md来修改主页内容了,你也可以使用docsify serve ./docs来在本机3000端口上启动一个实时更新的开发服务器来查看你的更改。

多页文档

直接在docs目录下新建md文件,通过域名/文件名进行访问。

定制侧边栏

在创建多页文档之后你会发现,只能手动输入地址去访问对应的文档,这时候就需要通过编辑侧边栏来实现,在index.html里找到window.$docsify = {在下面添加loadSidebar: true

<!-- index.html -->

 <script>
    window.$docsify = { 
        loadSidebar: true 
     } 
 </script>

然后创建sidebar.md文件,在里面用markdown链接格式填入你的页面的地址。。

 * 基础篇
 * [前言](/)
 * [硬件](1)
 * [操作系统](2)
 * [浏览器](3)

你问为什么我后面填的是123?因为我的文件名就是1.md,2.md,3.md。。。。

更多配置修改

官方文档
都是在index.html里的window.$docsify = {添加的,插件也是