docsify/README.md

98 lines
2.8 KiB
Markdown
Raw Normal View History

<p align="center">
<a href="https://docsify.js.org">
<img alt="docsify" src="./media/docsify.png">
</a>
</p>
<p align="center">
A magical documentation site generator.
</p>
<p align="center">
2017-03-16 05:32:33 +08:00
<a href="https://travis-ci.org/QingWei-Li/docsify"><img alt="Travis Status" src="https://img.shields.io/travis/QingWei-Li/docsify/master.svg?style=flat-square"></a>
2016-12-18 19:43:58 +08:00
<a href="https://www.npmjs.com/package/docsify"><img alt="npm" src="https://img.shields.io/npm/v/docsify.svg?style=flat-square"></a>
2017-02-12 16:30:45 +08:00
<a href="https://github.com/QingWei-Li/donate"><img alt="donate" src="https://img.shields.io/badge/%24-donate-ff69b4.svg?style=flat-square"></a>
</p>
2016-11-20 15:56:37 +08:00
2016-11-26 18:08:00 +08:00
## Links
2017-03-10 05:19:57 +08:00
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
- No statically built html files
- Simple and lightweight (~16kB gzipped)
2017-02-13 22:43:58 +08:00
- Smart full-text search plugin
2016-12-20 22:32:56 +08:00
- Multiple themes
2017-02-13 22:43:58 +08:00
- Useful plugin API
2017-02-17 23:09:09 +08:00
- Compatible with IE10+
2017-05-30 14:01:06 +08:00
- Support SSR
2016-11-20 15:56:37 +08:00
## Quick start
2017-03-10 05:19:57 +08:00
Create an `index.html`.
2016-11-20 15:56:37 +08:00
```html
<!-- index.html -->
2016-11-20 15:56:37 +08:00
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
2017-03-16 05:32:33 +08:00
<link rel="stylesheet" href="//unpkg.com/docsify/lib/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>
2017-03-16 05:32:33 +08:00
<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
2016-11-20 15:56:37 +08:00
</html>
```
2017-02-05 09:50:08 +08:00
## Browser Support
Modern browsers and Internet Explorer 10+.
2017-02-05 09:50:08 +08:00
2016-11-28 14:03:54 +08:00
## Showcase
2017-03-10 05:19:57 +08:00
These open-source projects are using docsify to generate their sites. Pull requests welcome :blush:
2016-11-28 14:03:54 +08:00
2017-03-10 05:19:57 +08:00
| Project | Description |
|---|---|
| [Snipaste](https://docs.snipaste.com/) | Snip & Paste |
| [puck](https://puck.zz173.com/) | A small & magical php framework. |
| [Samaritan](http://samaritan.stockdb.org) | An Algorithmic Trading Framework for Digital Currency. |
| [Vudash](http://vudash.github.io/vudash/) | Powerful, Flexible, Open Source dashboards for anything |
| [Trilogy](http://trilogy.js.org) | No-hassle SQLite with a Promise-based, document store style API. |
| [Mybatis-Plus](http://mp.baomidou.com/) | An enhanced toolkit of Mybatis to simplify development |
2017-04-17 20:32:38 +08:00
| [JS MythBusters](https://mythbusters.js.org) | An optimization handbook from a high level point of view. |
2017-04-21 06:02:39 +08:00
| [hire-me](https://fvcproductions.github.io/hire-me) | A path to getting an awesome tech gig. |
| [vue-amap](https://elemefe.github.io/vue-amap/) | A Map Component Library Base on Vue 2.x and Gaode Map. |
2016-11-28 14:03:54 +08:00
2016-12-23 09:25:30 +08:00
## Similar projects
2017-03-10 05:19:57 +08:00
| Project | Description |
|---|---|
| [docute](https://github.com/egoist/docute) | 📜 Effortlessly documentation done right |
| [docpress](https://github.com/docpress/docpress) | Documentation website generator |
2016-12-23 09:25:30 +08:00
2016-12-20 22:32:56 +08:00
## Contributing
2016-11-26 18:37:17 +08:00
2016-12-01 10:18:00 +08:00
- Fork it!
2016-12-20 22:34:13 +08:00
- Create your feature branch: `git checkout -b my-new-feature`
- Commit your changes: `git commit -am 'Add some feature'`
- Push to the branch: `git push origin my-new-feature`
- Submit a pull request
2016-12-20 22:32:56 +08:00
## Development
2017-01-10 23:55:58 +08:00
```bash
2016-12-20 22:32:56 +08:00
npm i && npm run dev
open http://localhost:3000
```
2016-11-26 18:37:17 +08:00
2016-11-20 15:56:37 +08:00
## License
2017-03-10 05:19:57 +08:00
2016-11-20 15:56:37 +08:00
MIT