tiptap/README.md

79 lines
4.5 KiB
Markdown
Raw Normal View History

2021-02-09 00:46:24 +08:00
# tiptap 2 (Sponsors preview!)
[![Version](https://img.shields.io/npm/v/@tiptap/core.svg?label=version)](https://www.npmjs.com/package/@tiptap/core)
[![Downloads](https://img.shields.io/npm/dm/@tiptap/core.svg)](https://npmcharts.com/compare/@tiptap/core?minimal=true)
[![License](https://img.shields.io/npm/l/@tiptap/core.svg)](https://www.npmjs.com/package/@tiptap/core)
2020-08-14 22:53:56 +08:00
[![Build Status](https://github.com/ueberdosis/tiptap-next/workflows/build/badge.svg)](https://github.com/ueberdosis/tiptap-next/actions)
2020-08-14 22:54:30 +08:00
[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub)](https://github.com/sponsors/ueberdosis)
2021-04-09 04:12:33 +08:00
[![Chat](https://img.shields.io/badge/chat-on%20discord-7289da.svg?sanitize=true)](https://discord.gg/WtJ49jGshW)
2020-08-14 22:54:30 +08:00
2021-02-09 00:46:24 +08:00
A headless and extendable rich text editor, based on [ProseMirror](https://github.com/ProseMirror/prosemirror), which is already in use at many well-known companies such as *New York Times*, *The Guardian* or *Atlassian*.
2020-11-11 21:52:27 +08:00
## Feedback
2021-02-09 00:46:24 +08:00
We are looking for your feedback to improve tiptap 2 before the first public release! Share everything that helps to make it better for everyone!
2020-11-11 21:52:27 +08:00
2021-03-18 05:35:41 +08:00
* Join the Discord server! [Link](https://discord.gg/WtJ49jGshW)
2020-11-11 21:52:27 +08:00
* Create issues on GitHub! [Link](https://github.com/ueberdosis/tiptap-next/issues)
2020-11-11 22:35:05 +08:00
* Send an email! [humans@tiptap.dev](mailto:humans@tiptap.dev)
2021-01-30 01:36:05 +08:00
* Follow us on Twitter! [@tiptap_editor](https://twitter.com/tiptap_editor) [@hanspagel](https://twitter.com/hanspagel) [@_philippkuehn](https://twitter.com/_philippkuehn)
2020-09-22 21:45:32 +08:00
## Why we built tiptap
2020-11-18 22:29:50 +08:00
We were looking for a text editor for [Vue.js](https://github.com/vuejs/vue) and found some solutions that didnt really satisfy us. An editor should be easy to extend and not based on old dependencies such as jQuery. For React there is already a great editor called [Slate.js](https://github.com/ianstormtaylor/slate), which impresses with its modularity. We came across [ProseMirror](https://github.com/prosemirror) and decided to build on it. ProseMirror is a toolkit for building rich text editors that are already in use at many well-known companies such as *Atlassian* or *New York Times*.
2020-11-13 18:04:31 +08:00
### What does `headless` mean?
2020-11-27 22:30:04 +08:00
With headless components you'll have (almost) full control over markup and styling. We dont want to tell you what a menu should look like or where it should be rendered in the DOM. Thats all up to you. There is also a [great article about headless components](https://adamwathan.me/renderless-components-in-vuejs/) by Adam Wathan.
### How is the data stored under the hood?
2020-11-11 21:52:27 +08:00
You can save your data as a raw `HTML` string or can get a `JSON`-serializable representation of your document. And of course, you can also pass `HTML` or `JSON` content back to the editor.
## 💖 Sponsor the development
Are you using tiptap in production? We need your sponsorship to maintain, update and develop tiptap. [Become a Sponsor now!](https://github.com/sponsors/ueberdosis)
## Documentation
To check out some live examples, visit [next.tiptap.dev](https://next.tiptap.dev/).
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
2020-11-11 21:52:27 +08:00
## Maintainers
2021-02-10 05:48:14 +08:00
- [Philipp Kühn](https://github.com/philippkuehn) (developer)
- [Hans Pagel](https://github.com/hanspagel) (maintainer)
2020-11-11 21:52:27 +08:00
2020-11-11 22:12:59 +08:00
## Premium Sponsors
- [überdosis](https://ueberdosis.io/)
2021-02-09 00:46:24 +08:00
- [mymind](https://mymind.com/)
- [DocIQ](https://www.dociq.io/)
- [Apostrophe CMS](https://apostrophecms.com/)
- [Ycode](https://www.ycode.com/)
- [@impactvelocity](https://github.com/impactvelocity)
- [Flow Mobile](https://www.flowmobile.app/)
2020-11-11 22:12:59 +08:00
## Credits
2021-02-09 00:46:24 +08:00
- [Sam Willis](https://github.com/samwillis)
2020-11-11 21:52:27 +08:00
- [Christoph Flathmann](https://github.com/Chrissi2812)
- [Erick Wilder](https://github.com/erickwilder)
- [Marius Tolzmann](https://github.com/mariux)
- [jjangga0214](https://github.com/jjangga0214)
- [Maya Nedeljkovich](https://github.com/mayacoda)
- [Ryan Bliss](https://github.com/ryanbliss)
- [Gregor](https://github.com/gambolputty)
- [All Contributors](../../contributors)
2020-11-27 22:30:04 +08:00
## Links
- https://github.com/ueberdosis/awesome-tiptap
## Become a sponsor
Your benefits as a sponsor:
* Give back to the open source community
2021-02-09 00:46:24 +08:00
* Get early access to private repositories
* Ensure the further maintenace and development of tiptap
2020-11-27 22:30:04 +08:00
* Your issues and pull requests get a `sponsor 💖` label
* Get a sponsor badge in all your comments on GitHub
* Show support in your GitHub profile
* Receive monthly reports about our open source work
2021-02-09 00:46:24 +08:00
Does that sound good? [Become a sponsor!](https://github.com/sponsors/ueberdosis)
2020-11-11 21:52:27 +08:00
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.