From a51180cfb78a1e5678f80a92a1de6b4872e93903 Mon Sep 17 00:00:00 2001 From: Ian Storm Taylor Date: Wed, 10 Jan 2018 22:10:55 -0800 Subject: [PATCH] add plugins doc --- docs/Readme.md | 1 + docs/general/plugins.md | 67 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+) create mode 100644 docs/general/plugins.md diff --git a/docs/Readme.md b/docs/Readme.md index 453f77763..ababa43bf 100644 --- a/docs/Readme.md +++ b/docs/Readme.md @@ -24,6 +24,7 @@ ## General +- [Plugins](./general/plugins.md) - [Resources](./general/resources.md) - [Contributing](../Contributing.md) - [Changelog](../Changelog.md) diff --git a/docs/general/plugins.md b/docs/general/plugins.md new file mode 100644 index 000000000..5b95e8b63 --- /dev/null +++ b/docs/general/plugins.md @@ -0,0 +1,67 @@ + +# Plugins + +Here's a list of Slate plugins, organized by category, so that they're easier to find than searching NPM or Yarn. + + +### Behavior + +Plugins that add specific behaviors to your editor. + +|**Plugin**|**Downloads**|**Description**| +|---|---|---| +|[`slate-auto-replace`](https://yarnpkg.com/en/package/slate-auto-replace)|![](https://img.shields.io/npm/dt/slate-auto-replace.svg?maxAge=2592000)|Automatically transform certain input as a user types.| +|[`slate-collapse-on-escape`](https://yarnpkg.com/en/package/slate-collapse-on-escape)|![](https://img.shields.io/npm/dt/slate-collapse-on-escape.svg?maxAge=2592000)|Collapse the selection when users hit esc.| +|[`slate-drop-or-paste-images`](https://yarnpkg.com/en/package/slate-drop-or-paste-images)|![](https://img.shields.io/npm/dt/slate-drop-or-paste-images.svg?maxAge=2592000)|Allows users to insert images by drag-dropping or copy-pasting.| +|[`slate-edit-blockquote`](https://yarnpkg.com/en/package/slate-edit-blockquote)|![](https://img.shields.io/npm/dt/slate-edit-blockquote.svg?maxAge=2592000)|Adds blockquote editing behaviors to an editor.| +|[`slate-edit-code`](https://yarnpkg.com/en/package/slate-edit-code)|![](https://img.shields.io/npm/dt/slate-edit-code.svg?maxAge=2592000)|Adds code block editing behaviors to an editor.| +|[`slate-edit-footnote`](https://yarnpkg.com/en/package/slate-edit-footnote)|![](https://img.shields.io/npm/dt/slate-edit-footnote.svg?maxAge=2592000)|Adds footnote editing behaviors to an editor.| +|[`slate-edit-list`](https://yarnpkg.com/en/package/slate-edit-list)|![](https://img.shields.io/npm/dt/slate-edit-list.svg?maxAge=2592000)|Adds list editing behaviors to an editor.| +|[`slate-edit-table`](https://yarnpkg.com/en/package/slate-edit-table)|![](https://img.shields.io/npm/dt/slate-edit-table.svg?maxAge=2592000)|Adds common table editing behaviors to an editor.| +|[`slate-mentions`](https://yarnpkg.com/en/package/slate-mentions)|![](https://img.shields.io/npm/dt/slate-mentions.svg?maxAge=2592000)|Adds mentions like Facebook's to an editor.| +|[`slate-no-empty`](https://yarnpkg.com/en/package/slate-no-empty)|![](https://img.shields.io/npm/dt/slate-no-empty.svg?maxAge=2592000)|Prevents documents from being empty.| +|[`slate-paste-linkify`](https://yarnpkg.com/en/package/slate-paste-linkify)|![](https://img.shields.io/npm/dt/slate-paste-linkify.svg?maxAge=2592000)|Automatically linkify URLs when they are pasted.| +|[`slate-soft-break`](https://yarnpkg.com/en/package/slate-soft-break)|![](https://img.shields.io/npm/dt/slate-soft-break.svg?maxAge=2592000)|Adds soft breaks when users hit enter.| +|[`slate-sticky-inlines`](https://yarnpkg.com/en/package/slate-sticky-inlines)|![](https://img.shields.io/npm/dt/slate-sticky-inlines.svg?maxAge=2592000)|Changes the inline node behavior to allow editing at the edges.| +|[`slate-suggestions`](https://yarnpkg.com/en/package/slate-suggestions)|![](https://img.shields.io/npm/dt/slate-suggestions.svg?maxAge=2592000)|Displays inline auto-completed suggestions.| +|[`slate-trailing-block`](https://yarnpkg.com/en/package/slate-trailing-block)|![](https://img.shields.io/npm/dt/slate-trailing-block.svg?maxAge=2592000)|Ensure that documents end in a specific kind of block.| + + +### Components + +Components for building Slate editors. + +|**Plugin**|**Downloads**|**Description**| +|---|---|---| +|[`slate-editor-icons`](https://yarnpkg.com/en/package/slate-editor-icons)|![](https://img.shields.io/npm/dt/slate-editor-icons.svg?maxAge=2592000)|A set of icons for using in toolbars, etc.| + + +### Serializers + +Serializers for handling Slate data. + +|**Plugin**|**Downloads**|**Description**| +|---|---|---| +|[`slate-base64-serializer`](https://yarnpkg.com/en/package/slate-base64-serializer)|![](https://img.shields.io/npm/dt/slate-base64-serializer.svg?maxAge=2592000)|A base64 string serializer for Slate documents.| +|[`slate-html-serializer`](https://yarnpkg.com/en/package/slate-html-serializer)|![](https://img.shields.io/npm/dt/slate-html-serializer.svg?maxAge=2592000)|An HTML serializer for Slate documents.| +|[`slate-plain-serializer`](https://yarnpkg.com/en/package/slate-plain-serializer)|![](https://img.shields.io/npm/dt/slate-plain-serializer.svg?maxAge=2592000)|A plain text serializer for Slate documents.| + + +### Utils + +Useful utilities when working with Slate documents and components. + +|**Plugin**|**Downloads**|**Description**| +|---|---|---| +|[`slate-hyperprint`](https://yarnpkg.com/en/package/slate-hyperprint)|![](https://img.shields.io/npm/dt/slate-hyperprint.svg?maxAge=2592000)|Prints Slate documents in their `slate-hyperscript` format.| +|[`slate-hyperscript`](https://yarnpkg.com/en/package/slate-hyperscript)|![](https://img.shields.io/npm/dt/slate-hyperscript.svg?maxAge=2592000)|Allows you to express Slate documents in JSX.| +|[`slate-prop-types`](https://yarnpkg.com/en/package/slate-prop-types)|![](https://img.shields.io/npm/dt/slate-prop-types.svg?maxAge=2592000)|A set of prop types to use in your Slate components.| + + +### Editors + +Full-feature editors for Slate, in case you need a drop-in one. + +|**Plugin**|**Downloads**|**Description**| +|---|---|---| +|[`slate-hyperprint`](https://yarnpkg.com/en/package/slate-hyperprint)|![](https://img.shields.io/npm/dt/slate-hyperprint.svg?maxAge=2592000)|Prints Slate documents in their `slate-hyperscript` format.|