2016-11-26 14:09:06 +08:00
|
|
|
# docsify
|
2016-11-22 22:54:55 +08:00
|
|
|
[](https://travis-ci.org/QingWei-Li/docsify)
|
2016-11-20 15:56:37 +08:00
|
|
|
[](https://www.npmjs.com/package/docsify)
|
|
|
|
|
|
|
|
|
|
>🃏 A magical documentation site generator.
|
|
|
|
|
|
2016-11-26 18:08:00 +08:00
|
|
|
## Links
|
2016-11-28 15:39:35 +08:00
|
|
|
- [Documentation](https://docsify.js.org)
|
2016-11-26 18:08:00 +08:00
|
|
|
- [CLI](https://github.com/QingWei-Li/docsify-cli)
|
2016-11-26 14:09:06 +08:00
|
|
|
|
2016-11-20 15:56:37 +08:00
|
|
|
## Features
|
|
|
|
|
- Easy and lightweight
|
2016-11-26 14:09:06 +08:00
|
|
|
- Custom themes
|
|
|
|
|
- No build
|
2016-11-20 15:56:37 +08:00
|
|
|
|
|
|
|
|
## Quick start
|
2016-11-30 21:53:16 +08:00
|
|
|
Create a `404.html` and `README.md` into `/docs`.
|
2016-11-20 15:56:37 +08:00
|
|
|
|
|
|
|
|
404.html
|
|
|
|
|
|
|
|
|
|
```html
|
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta charset="UTF-8">
|
2016-11-20 22:49:32 +08:00
|
|
|
<link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
|
2016-11-20 15:56:37 +08:00
|
|
|
</head>
|
2016-12-17 15:25:03 +08:00
|
|
|
<body>
|
|
|
|
|
<div id="app"></div>
|
|
|
|
|
</body>
|
2016-11-22 22:46:44 +08:00
|
|
|
<script src="//unpkg.com/docsify"></script>
|
2016-11-20 15:56:37 +08:00
|
|
|
</html>
|
|
|
|
|
```
|
|
|
|
|
|
2016-12-08 21:11:18 +08:00
|
|
|
Or Create a `index.html` and using `hash router`.
|
|
|
|
|
|
|
|
|
|
index.html
|
|
|
|
|
|
|
|
|
|
```html
|
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta charset="UTF-8">
|
|
|
|
|
<link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
|
|
|
|
|
</head>
|
2016-12-17 15:25:03 +08:00
|
|
|
<body>
|
|
|
|
|
<div id="app"></div>
|
|
|
|
|
</body>
|
2016-12-08 21:11:18 +08:00
|
|
|
<script src="//unpkg.com/docsify" data-router></script>
|
|
|
|
|
</html>
|
|
|
|
|
```
|
|
|
|
|
|
2016-11-28 14:03:54 +08:00
|
|
|
## Showcase
|
2016-12-01 10:18:00 +08:00
|
|
|
These open-source projects are using docsify to generate their sites. Pull requests welcome : )
|
2016-11-28 14:03:54 +08:00
|
|
|
|
|
|
|
|
- [docsify](https://docsify.js.org) - A magical documentation site generator.
|
2016-12-01 10:18:00 +08:00
|
|
|
- [Snipaste](https://docs.snipaste.com/) - A new way to boost your productivity.
|
2016-11-28 14:03:54 +08:00
|
|
|
|
2016-11-26 18:37:17 +08:00
|
|
|
## How to contribute
|
|
|
|
|
|
2016-12-01 10:18:00 +08:00
|
|
|
- Fork it!
|
2016-11-26 18:37:17 +08:00
|
|
|
- Run `npm i && npm run dev`
|
2016-12-01 10:18:00 +08:00
|
|
|
- open `localhost:3000`
|
2016-11-26 18:37:17 +08:00
|
|
|
|
2016-11-20 15:56:37 +08:00
|
|
|
## License
|
|
|
|
|
MIT
|
2016-12-15 19:11:15 +08:00
|
|
|
|
|
|
|
|
## Support on Beerpay
|
|
|
|
|
Hey dude! Help me out for a couple of :beers:!
|
|
|
|
|
|
|
|
|
|
[](https://beerpay.io/QingWei-Li/docsify) [](https://beerpay.io/QingWei-Li/docsify?focus=wish)
|
