docsify搭建个人博客

预览

fearless’s blog

fearless’s puzzle game

fearless’s github

使用工具

一个神奇的文档网站生成器 docsify

安装doocsify

  • npm i docsify-cli -g
    

初始化项目

  • # docs:项目目录
    docsify init ./docs
    

项目结构

  • index.html 入口文件
  • README.md 会做为主页内容渲染
  • .nojekyll 用于阻止 GitHub Pages 忽略掉下划线开头的文件
  • 更多自定义内容,查阅官网:docsify

本地预览

  • # docs:项目目录
    docsify serve docs
    

插件安装

按照官网步骤安装:引入对应js,配置docsify对象

插件介绍,效果预览

全文搜索 - Search
  • 文档左上角搜索框

  • // todo 搜索某些关键词,search.min.js报错
    search.min.js:1 Uncaught TypeError: Cannot read properties of undefined (reading 'substring')
    
  • 在这里插入图片描述

谷歌统计 - Google Analytics
emoji
  • 解析 emoji
外链脚本 - External Script
  • 执行外链脚本
图片缩放 - Zoom image
  • 可放大图片
在 Github 上编辑
  • 文档右上角 Edit on github 图标,可配置链接到github地址
  • 在这里插入图片描述
复制到剪贴板
  • 鼠标移入代码区,显示 Copy to clipboard 按钮
  • 在这里插入图片描述
Gitalk
  • 基于Preact和Github Issue的评论系统

  • 解决报错:Gitalk Error: Validation Failed. 442,原因是:文章URL过长,解决方法参考博客:处理 Gitalk Validation Failed(422)

  • 在这里插入图片描述

Pagination
  • docsify的分页导航插件

  • 在这里插入图片描述

字数统计
  • 文章字数统计,文档右上角显示
  • 在这里插入图片描述
Tabs
  • 在 Markdown 中显示选项卡
  • 在这里插入图片描述
docsify-sidebar-collapse

部署到Github

Create a new repository

将本地的docs项目push到新建的仓库

GitHub Pages 绑定二级域名

参考博客

公众号:
在这里插入图片描述

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

fearIess233

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值