封面

通过设置 coverpage 参数，可以开启渲染封面的功能。具体用法见配置项#coverpage。

基本用法

封面的生成同样是从 markdown 文件渲染来的。开启渲染封面功能后在文档根目录创建 _coverpage.md 文件。渲染效果如本文档。

index.html

  1. <script>
  2.   window.$docsify = {
  3.     coverpage: true
  4.   }
  5. </script>
  6. <script src="//unpkg.com/docsify"></script>

_coverpage.md

  1. ![logo](_media/icon.svg)
  3. # docsify
  5. > A magical documentation site generator.
  7. - Simple and lightweight (~12kb gzipped)
  8. - Multiple themes
  9. - Not build static html files
  12. [GitHub](https://github.com/QingWei-Li/docsify/)
  13. [Get Started](#quick-start)

!> 一份文档只会在根目录下加载封面，其他页面或者二级目录下都不会加载。

自定义背景

目前的背景是随机生成的渐变色，我们自定义背景色或者背景图。在文档末尾用添加图片的 Markdown 语法设置背景。

_coverpage.md

  1. # docsify
  3. [GitHub](https://github.com/QingWei-Li/docsify/)
  4. [Get Started](#quick-start)
  6. <!-- 背景图片 -->
  7. ![](_media/bg.png)
  8. <!-- 背景色 -->
  9. ![color](#f0f0f0)