TypechoJoeTheme

香草物语

统计
登录
用户名
密码
/
注册
用户名
邮箱
输入密码
确认密码
搜索到 8 篇与 的结果
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 评论