一个神奇的文档站点生成器。 简单轻巧(~21kB) 没有生成静态的html文件 主题丰富
#安装
如果你想在本地搭建: npm安装:
npm i docsify-cli -g初始化:
docsify init ./docs本地预览:
docsify serve 进入http://localhost:3000就能看到效果咯!
为了更好地SEO,您可以在每个文件后面自定义标题
* [Home](/)
* [Guide](guide.md "The greatest guide in the world")默认情况下会自动根据文章标题生成目录,如果不想要,可以再index.html中新增:
<script>
window.$docsify = {
loadSidebar: true,
subMaxLevel: 2
}
</script>subMaxLevel: 2表示只显示h1~h2的标题,对应#和##。
如果你想忽略某个标题,则可以在文章中新增{docsify-ignore}:
# Getting Started
## Header {docsify-ignore}如果想忽略全部的标题,则可以新增{docsify-ignore-all}:
# Getting Started {docsify-ignore-all}
## Header表示忽略{docsify-ignore-all}下的全部标题
window.$docsify = {
coverpage: true,
}后再根目录创建_coverpage.md 输入内容就可以显示在封面了
window.$docsify = {
themeColor: '#c30aff',
}window.$docsify = {
externalLinkTarget: '_blank',
}站内搜索插件
search: 'auto',
search: {
maxAge: 86400000,
paths: '/',
placeholder: '搜索...',
noData: '未找到结果,换个搜索词试试?',
namespace: 'XhemjBlog',
},