2017-02-13 22:43:58 +08:00
# Cover
2017-02-21 14:04:16 +08:00
Activate the cover feature by setting `coverpage` to **true** . Details are available in the [coverpage configuration paragraph ](configuration#coverpage ).
2017-02-13 22:43:58 +08:00
## Basic usage
2017-02-21 14:04:16 +08:00
Set `coverpage` to **true** , and create a `_coverpage.md` :
2017-02-13 22:43:58 +08:00
```html
2017-02-21 14:04:16 +08:00
<!-- index.html -->
2017-02-13 22:43:58 +08:00
< script >
window.$docsify = {
coverpage: true
}
< / script >
< script src = "//unpkg.com/docsify" > < / script >
```
```markdown
2017-02-21 14:04:16 +08:00
<!-- _coverpage.md -->
2017-02-13 22:43:58 +08:00
![logo ](_media/icon.svg )
2017-02-21 14:04:16 +08:00
# docsify <small>3.0</small>
2017-02-13 22:43:58 +08:00
> A magical documentation site generator.
2017-02-21 14:04:16 +08:00
- Simple and lightweight (~14kB gzipped)
- No statically built html files
2017-02-13 22:43:58 +08:00
- Multiple themes
[GitHub ](https://github.com/QingWei-Li/docsify/ )
2017-02-21 14:04:16 +08:00
[Get Started ](#docsify )
2017-02-13 22:43:58 +08:00
```
!> A document site can have only one cover page.
## Custom background
2017-02-21 14:04:16 +08:00
The background color is generated randomly by default. You can customize the background color or image:
2017-02-13 22:43:58 +08:00
```markdown
2017-02-21 14:04:16 +08:00
<!-- _coverpage.md -->
2017-02-13 22:43:58 +08:00
# docsify
[GitHub ](https://github.com/QingWei-Li/docsify/ )
[Get Started ](#quick-start )
<!-- background image -->
![](_media/bg.png)
<!-- background color -->
![color ](#f0f0f0 )
```