|
| 1 | +<!--- |
| 2 | +Logo |
| 3 | +--> |
1 | 4 | <p align="center">
|
2 | 5 | <a href="https://docsify.js.org">
|
3 | 6 | <img alt="docsify" src="https://github.com/docsifyjs/docsify/blob/develop/docs/_media/icon.svg">
|
4 | 7 | </a>
|
5 | 8 | </p>
|
6 | 9 |
|
7 | 10 | <p align="center">
|
8 |
| - A magical documentation site generator. |
| 11 | + <b>Docsify</b>, a magical documentation site generator that has no statically built html files. It is simple and lightweight with a smart full-text search plugin and multiple themes, useful plugin API, compatible with IE11. It also supports both <a href="https://github.com/docsifyjs/docsify-ssr-demo">SSR</a> and embedded files. |
9 | 12 | </p>
|
10 | 13 |
|
| 14 | +<!--- |
| 15 | +Badges |
| 16 | +--> |
11 | 17 | <p align="center">
|
12 | 18 | <a href="https://discord.gg/3NwKFyR"><img
|
13 | 19 | alt="Join Discord community and chat about Docsify"
|
|
36 | 42 | /></a>
|
37 | 43 | </p>
|
38 | 44 |
|
39 |
| -<p align="center">Gold Sponsor via <a href="https://opencollective.com/docsify">Open Collective</a></p> |
40 |
| - |
| 45 | +<!--- |
| 46 | +About, Intro, Contributing |
| 47 | +--> |
41 | 48 | <p align="center">
|
42 |
| - <a href="https://opencollective.com/docsify/order/3254"> |
43 |
| - <img src="https://opencollective.com/docsify/tiers/gold-sponsor.svg?avatarHeight=36"> |
44 |
| - </a> |
| 49 | + <h3 align="center"> |
| 50 | + <a href="https://docsify.js.org/#/quickstart">Quick start</a> · |
| 51 | + <a href="https://github.com/docsifyjs/docsify/blob/develop/CONTRIBUTING.md">Introduction</a> · |
| 52 | + <a href="https://github.com/docsifyjs/docsify/blob/develop/SETUP.md">Contributing</a> · |
| 53 | + <a href="https://github.com/docsifyjs/docsify-cli">CLI</a> · |
| 54 | + <a href="https://docsify.js.org/#/deploy">Development Instructions</a> |
| 55 | + </h3> |
45 | 56 | </p>
|
46 | 57 |
|
47 |
| -## Links |
48 |
| - |
49 |
| -- [`develop` branch preview](https://docsifyjs.netlify.com/) |
50 |
| -- [Documentation](https://docsify.js.org) |
51 |
| -- [CLI](https://github.com/docsifyjs/docsify-cli) |
52 |
| -- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify) |
53 |
| -- [Awesome docsify](https://github.com/docsifyjs/awesome-docsify) |
54 |
| -- [Community chat](https://discord.gg/3NwKFyR) |
55 |
| - |
56 |
| -## Features |
57 |
| - |
58 |
| -- No statically built html files |
59 |
| -- Simple and lightweight (~21kB gzipped) |
60 |
| -- Smart full-text search plugin |
61 |
| -- Multiple themes |
62 |
| -- Useful plugin API |
63 |
| -- Compatible with IE11 |
64 |
| -- Support SSR ([example](https://github.com/docsifyjs/docsify-ssr-demo)) |
65 |
| -- Support embedded files |
| 58 | +<!--- |
| 59 | +Contributors |
| 60 | +--> |
66 | 61 |
|
67 |
| -## Quick start |
| 62 | +<h2 align="center">Contributors</h2> |
68 | 63 |
|
69 |
| -Look at [this tutorial](https://docsify.js.org/#/quickstart) |
| 64 | +<p align="center"> |
| 65 | + <a href="https://github.com/docsifyjs/docsify/graphs/contributors"> |
| 66 | + <img src="https://opencollective.com/docsify/contributors.svg?width=890" /> |
| 67 | + </a> |
| 68 | +</p> |
70 | 69 |
|
71 |
| -[](https://codesandbox.io/s/307qqv236) |
| 70 | +<!--- |
| 71 | +Backers |
| 72 | +--> |
| 73 | +<h2 align="center">Much love to all our backers</h2> |
| 74 | +<p align="center"> |
| 75 | +Be a backer for our awesome project by clicking this <a href="https://opencollective.com/docsify#backers" target="_blank" rel="noopener">link</a>. Thank you to all our backers! 🙏 |
| 76 | + <a href="https://opencollective.com/docsify#backers" target="_blank"> |
| 77 | + <img src="https://opencollective.com/docsify/backers.svg?width=890"> |
| 78 | + </a> |
| 79 | +</p> |
72 | 80 |
|
73 |
| -## Showcase |
| 81 | +<!--- |
| 82 | +Sponsors |
| 83 | +--> |
| 84 | +<h2 align="center"> Much love to all our sponsors! </h2> |
74 | 85 |
|
75 |
| -These projects are using docsify to generate their sites. Pull requests welcome :blush: |
| 86 | +<p align="justify"> |
| 87 | + Support this project by donating to our <a href="https://opencollective.com/docsify#silver-sponsors" target="_blank" rel="noopener">OpenCollective</a>. By sponsoring this project your logo will be shown below. The core maintainers and contributors to this open-source project are working mostly in their free time.. Thank you so much for your never ending support! |
| 88 | +</p> |
76 | 89 |
|
77 |
| -Move to [awesome-docsify](https://github.com/docsifyjs/awesome-docsify#showcase) |
| 90 | +<p align="center"> |
| 91 | + <a href="https://opencollective.com/docsify/silver-sponsors/0/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/0/avatar.svg"></a> |
| 92 | + <a href="https://opencollective.com/docsify/silver-sponsors/1/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/1/avatar.svg"></a> |
| 93 | + <a href="https://opencollective.com/docsify/silver-sponsors/2/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/2/avatar.svg"></a> |
| 94 | + <a href="https://opencollective.com/docsify/silver-sponsors/3/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/3/avatar.svg"></a> |
| 95 | + <a href="https://opencollective.com/docsify/silver-sponsors/4/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/4/avatar.svg"></a> |
| 96 | + <a href="https://opencollective.com/docsify/silver-sponsors/5/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/5/avatar.svg"></a> |
| 97 | + <a href="https://opencollective.com/docsify/silver-sponsors/6/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/6/avatar.svg"></a> |
| 98 | + <a href="https://opencollective.com/docsify/silver-sponsors/7/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/7/avatar.svg"></a> |
| 99 | + <a href="https://opencollective.com/docsify/silver-sponsors/8/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/8/avatar.svg"></a> |
| 100 | +</p> |
78 | 101 |
|
79 |
| -## Similar projects |
| 102 | +### Showcase |
80 | 103 |
|
81 |
| -| Project | Description | |
| 104 | +| Links | Description | |
82 | 105 | | ------------------------------------------------ | ---------------------------------------- |
|
| 106 | +| [Awesome Docsify](https://github.com/docsifyjs/awesome-docsify) | Awesome things related to [docsify](https://docsify.js.org/). | |
83 | 107 | | [docute](https://github.com/egoist/docute) | 📜 Effortlessly documentation done right |
|
84 | 108 | | [docpress](https://github.com/docpress/docpress) | Documentation website generator |
|
85 |
| - |
86 |
| -## Contributing |
87 |
| - |
88 |
| -### Online one-click setup for Contributing |
89 |
| - |
90 |
| -You can use Gitpod(A free online VS Code-like IDE) for contributing. With single click it'll launch a workspace and automatically: |
91 |
| - |
92 |
| -- clone the docsify repo. |
93 |
| -- install the dependencies. |
94 |
| -- start `npm run dev`. |
95 |
| - |
96 |
| -So that you can start straight away. |
97 |
| - |
98 |
| -[](https://gitpod.io/#https://github.com/docsifyjs/docsify) |
99 |
| - |
100 |
| -- Fork it! |
101 |
| -- Create your feature branch: `git checkout -b my-new-feature` |
102 |
| -- Commit your changes: `git commit -am 'Add some feature'` |
103 |
| -- Push to the branch: `git push origin my-new-feature` |
104 |
| -- Submit a pull request |
105 |
| - |
106 |
| -## Development |
107 |
| - |
108 |
| -```bash |
109 |
| -npm run bootstrap && npm run dev |
110 |
| -``` |
111 |
| - |
112 |
| -## Backers |
113 |
| - |
114 |
| -Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/docsify#backers)] |
115 |
| - |
116 |
| -<a href="https://opencollective.com/docsify#backers" target="_blank"><img src="https://opencollective.com/docsify/backers.svg?width=890"></a> |
117 |
| - |
118 |
| -## Sponsors |
119 |
| - |
120 |
| -Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/docsify#silver-sponsors)] |
121 |
| - |
122 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/0/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/0/avatar.svg"></a> |
123 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/1/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/1/avatar.svg"></a> |
124 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/2/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/2/avatar.svg"></a> |
125 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/3/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/3/avatar.svg"></a> |
126 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/4/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/4/avatar.svg"></a> |
127 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/5/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/5/avatar.svg"></a> |
128 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/6/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/6/avatar.svg"></a> |
129 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/7/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/7/avatar.svg"></a> |
130 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/8/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/8/avatar.svg"></a> |
131 |
| -<a href="https://opencollective.com/docsify/silver-sponsors/9/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/9/avatar.svg"></a> |
132 |
| - |
133 |
| -## Contributors |
134 |
| - |
135 |
| -This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)]. |
136 |
| -<a href="https://github.com/docsifyjs/docsify/graphs/contributors"><img src="https://opencollective.com/docsify/contributors.svg?width=890" /></a> |
137 |
| - |
138 |
| -## Status |
139 |
| - |
140 |
| -<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22unit+tests%22"><img |
141 |
| - alt="Docsify unit test suite" |
142 |
| - title="Docsify unit test suite" |
143 |
| - src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/unit tests/develop?label=unit%20tests&cacheSeconds=300" |
144 |
| -/></a> |
145 |
| -<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22e2e+tests%22"><img |
146 |
| - alt="Docsify e2e test suites" |
147 |
| - title="Docsify e2e test suites" |
148 |
| - src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/e2e tests/develop?label=e2e%20tests&cacheSeconds=300" |
149 |
| -/></a> |
150 |
| -<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22lint+checks%22"><img |
151 |
| - alt="Docsify linting checks" |
152 |
| - title="Docsify linting checks" |
153 |
| - src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/lint checks/develop?label=lint%20checks&cacheSeconds=300" |
154 |
| -/></a> |
| 109 | +| [unpkg ](https://unpkg.com/browse/[email protected]/) | CDN | |
| 110 | +| [jsdelivr](https://cdn.jsdelivr.net/npm/docsify/) | CDN | |
| 111 | +| [cdnjs](https://cdnjs.com/libraries/docsify) | CDN | |
155 | 112 |
|
156 | 113 | ## License
|
157 | 114 |
|
158 |
| -[MIT](LICENSE) |
| 115 | +[MIT](LICENSE) |
0 commit comments