2022-10-01 docsify常用的一些插件及配置 docsify常用的一些插件及配置 前面的几篇文章,我们陆续介绍了docsify网站的搭建及一些基本配置。本篇是我们关于docsify系列介绍的最后一篇。主要介绍一下我们常用的一些docsify插件。docsify的配置其实就是一些js及css插件,因此我们下面凡是脚本,大家都放到body中,凡是css文件,都放到head中,配置文件统一放到docsify配置节点。有不会配置的可以参考https://www.xiangcaowuyu.net/blog/the-docsify-configuration-article-navigation.html一、统计文章字数1.1、添加插件<!-- 字数插件 --> <script src="//cdn.jsdelivr.net/npm/docsify-count@latest/dist/countable.min.js"></script>1.2、配置// 字数插件 count: { countable: true, position: 'top', marg... Laughing 2022-10-01 随笔日记 2,196 阅读 0 评论 2022年10月01日 2,196 阅读 0 评论
2022-09-30 docsify配置文章内导航 docsify配置文章内导航 当我们一篇文章比较长时,有个文章内导航可能帮助读者快速的定位到文章对应的章节,比如,我们下面这个测试文章,每个导航,只能不停的滚动鼠标。docsify配置文章内导航,只需一个插件便可解决。一、添加插件1.1、添加脚本文件在body中添加脚本文件<!-- 文章内导航 --> <script src="//cdn.jsdelivr.net/npm/docsify-toc@1.0.0/dist/toc.js"></script>1.2、添加样式在body中添加样式文件<!-- 文章内导航 --> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify-toc@1.0.0/dist/toc.css">这样,我们在查看文章时,文章就会有一个导航栏了。个性化配置默认的配置可能并不满足我们的需要,那么我们可以对导航栏进行一些个性化配置。在docsify配置文件中,添加如下内容 toc: { ... Laughing 2022-09-30 随笔日记 1,183 阅读 2 评论 2022年09月30日 1,183 阅读 2 评论
2022-09-30 docsify配置查询功能 docsify配置查询功能 在前面的几篇文章中,我们介绍了docsify配置封面、导航栏、侧边栏等信息。其实一个基本的网站框架基本已经搭建起来了,但是现在还有一个问题,如果我们文章比较多的时候,寻找其他就比较麻烦,因此我们需要一个查询功能,以便能快速定位到我们需要的内容。添加搜索插件在index.html中添加搜索插件 <!-- 搜索功能支持 --> <script src="//cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>添加完搜索插件之后,我们网站左上角其实已经有了搜索框,但是现在的搜索框是不易用的,比如提示信息还是英文等等。配置搜索功能在docsify配置文件中,添加以下内容search: { maxAge: 3600000,// 过期时间,单位毫秒,默认一天 paths: 'auto',// 注意:仅适用于 paths: 'auto' 模式 placeholder: '搜索', // 支持... Laughing 2022-09-30 随笔日记 983 阅读 0 评论 2022年09月30日 983 阅读 0 评论
2022-09-29 docsify配置导航栏 docsify配置导航栏 在docsify配置侧边栏中,我们介绍了配置侧边栏的方法,其实配置导航栏的方式跟配置侧边栏是类似的。配置docsify在index.html中配置docsify,支持导航栏。 <script> window.$docsify = { name: '', repo: '', //启用封面支持 coverpage:true, //支持导航栏 loadNavbar: true, // 侧边栏支持,默认加载的是项目根目录下的_sidebar.md文件 loadSidebar: true, // 最大支持渲染的标题层级 maxLevel: 5, // 自定义侧边栏后默认不会再生成目录,设置生成目录的最大层级(建议配置为2-4) subMaxLevel: 4, } </script>添加侧边栏配置文件启用导航栏之后,我们需要添加一个导航栏配置文件_navbar.md。在根目录下创建文件_navbar... Laughing 2022-09-29 随笔日记 1,094 阅读 0 评论 2022年09月29日 1,094 阅读 0 评论
2022-09-28 docsify配置侧边栏 docsify配置侧边栏 docsify配置完成后,默认显示的是README.md的内容,侧边栏显示的就是README.md的目录。比如我的README.md配置# 香草物语 > https://www.xiangcaowuyu.net # 我是一级目录 ## 我是二级目录但是我们的在线文档一般不会只有一个文件,我们更多的是像文件夹层级一样,按照文件夹的目录展示我们的文档,所以,我们可以将MarkDown文件,然后所在文件夹级次进行展示。配置docsify在index.html中配置docsify,支持侧边栏。 window.$docsify = { name: '', repo: '', //启用封面支持 coverpage:true, // 侧边栏支持,默认加载的是项目根目录下的_sidebar.md文件 loadSidebar: true, // 最大支持渲染的标题层级 maxLevel: 5, // 自定义侧边栏后默认不会再生成目录,设置生成目录的最大层级(建议配置为2-... Laughing 2022-09-28 随笔日记 1,502 阅读 0 评论 2022年09月28日 1,502 阅读 0 评论
2022-09-24 docsify配置LaTeX公式 docsify配置LaTeX公式 MarkDown本身是支持LaTeX公式的,但是docsify默认是不支持LaTeX公式的,即便你输入了如下的公式$$ 现值 = 原值/(1+折现率)^{(到期日-折现日期间隔月份)/12} $$docsify也只会给你显示原始的内容。要实现公式的显示,我们可以通过以下方式。方式一、贴图我们可以使用typora这种软件,显示MarkDown内容,然后截图粘贴到docsify对应的文件中,当然,这种方式能把自己蠢哭。方式二、通过插件docsify-katex就是能显示LaTeX公式的一种插件,使用方式非常简单。将样式文件粘贴到head中,并将js文件粘贴到body中。<!-- 公式 --> <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/katex@latest/dist/katex.min.css" /><!-- 公式 --> <script src="//cdn.jsdelivr.net/npm/katex@latest/dist/... Laughing 2022-09-24 随笔日记 1,554 阅读 1 评论 2022年09月24日 1,554 阅读 1 评论
2022-09-22 docsify配置封面 docsify配置封面 在dosify一个神奇的文档网站生成工具中,我们介绍了如何安装docsify,这篇文章我们主要讲解一下如何配置docsify的封面。启用封面支持还记得我们初始化完项目之后,有一个index.html的文件夹,docsify的所有配置都在这个里面。需要我们需要启用封面,只需要在里面配置coverpage属性,设置为true即可。配置封面启用封面支持参数后,默认的封面文件为_coverpage.md,因此,我们需要在项目根目录下创建一个_coverpage.md文件。然后在封面文件中,输入自己的封面信息,下面的可以直接复制使用<!-- _coverpage.md --> # 香草物语 > 香草物语 [开始使用 Let Go](/README.md)这样,一个简单的封面就设置好了,我们可以看一下效果。 Laughing 2022-09-22 随笔日记 1,063 阅读 0 评论 2022年09月22日 1,063 阅读 0 评论
2022-09-21 dosify一个神奇的文档网站生成工具 dosify一个神奇的文档网站生成工具 之前一直使用的觅思文档作为内部在线知识库。公司内部最近在进行服务器漏洞扫描,觅思文档使用的Python+Django的形式(我用的Docker一键部署的那个,看Python的版本好像是3.7.3吧),由于Python注入漏洞影响3.10.4及以下版本,所以我尝试将Python升级到3.10.7,但是由于Django与Python版本对应关系存在问题,所以升级以失败告终。也是出于无奈,只能另寻其他替代产品。经过对比,选择了一款小巧的文档网站生成工具-dosify。一、docsify的优缺点1.1、优点简洁,没有乱七八糟的功能,也不需要复杂的配置部署简单,两三条命令即可完成部署,不需要数据库结构化展示,直接展示本地markdown文件1.2、缺点没有用户管理功能,不方便多人协作因为是本地化部署,所以不方便使用七牛等图床,导致markdown文件中粘贴图片不是很方便。(当然,我们可以通过typora配置图片上传路径解决此问题)二、docsify部署首先确保已安装node.js。2.1、安装docsify-cli推荐全局安装docsify-cli工具,可以方便地创建及在本地预览生成的文档... Laughing 2022-09-21 随笔日记 606 阅读 0 评论 2022年09月21日 606 阅读 0 评论