From 44c1567a01fc36cd964fb3e07c461738be5c8590 Mon Sep 17 00:00:00 2001 From: Hans Pagel Date: Thu, 11 Feb 2021 23:37:41 +0100 Subject: [PATCH] docs: update content --- docs/src/docPages/api/commands.md | 23 +++++++++++++++++++++++ docs/src/docPages/api/extensions.md | 6 ++++-- docs/src/pages/index.vue | 14 +++++++------- 3 files changed, 34 insertions(+), 9 deletions(-) diff --git a/docs/src/docPages/api/commands.md b/docs/src/docPages/api/commands.md index 5b01d12f..afbe92a3 100644 --- a/docs/src/docPages/api/commands.md +++ b/docs/src/docPages/api/commands.md @@ -186,6 +186,29 @@ Have a look at all of the core commands listed below. They should give you a goo | .selectNodeForward() | Select a node forward. | | .selectParentNode() | Select the parent node. | +## Example use cases + +### Quote a text +TODO + +Add a blockquote, with a specified text, add a paragraph below, set the cursor there. + +```js +// Untested, work in progress, likely to change +this.editor + .chain() + .focus() + .createParagraphNear() + .insertText(text) + .setBlockquote() + .insertHTML('

') + .createParagraphNear() + .unsetBlockquote() + .createParagraphNear() + .insertHTML('

') + .run() +``` + ## Add your own commands All extensions can add additional commands (and most do), check out the specific [documentation for the provided nodes](/api/nodes), [marks](/api/marks), and [extensions](/api/extensions) to learn more about those. diff --git a/docs/src/docPages/api/extensions.md b/docs/src/docPages/api/extensions.md index d008ac0a..022ec27f 100644 --- a/docs/src/docPages/api/extensions.md +++ b/docs/src/docPages/api/extensions.md @@ -3,7 +3,9 @@ ## toc ## Introduction -Extensions add new capabilities to tiptap. [Nodes](/api/nodes) and [marks](/api/marks) are rendered in HTML. Extensions can’t add to the schema, but can add functionality or change the behaviour of the editor. +Extensions add new capabilities to tiptap and you’ll read the word extension here very often. Actually, there are literal Extensions. Those can’t add to the schema, but can add functionality or change the behaviour of the editor. + +There are also some extensions with more capabilities. We call them [nodes](/api/nodes) and [marks](/api/marks) which can render content in the editor. ## List of provided extensions | Title | Default Extension | Source Code | @@ -19,7 +21,7 @@ Extensions add new capabilities to tiptap. [Nodes](/api/nodes) and [marks](/api/ | [TextAlign](/api/extensions/text-align) | – | [GitHub](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-text-align/) | | [Typography](/api/extensions/typography) | – | [GitHub](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-typography/) | -You don’t have to use it, but we prepared a `@tiptap/starter-kit` which includes the most common extensions. See an example on [how to use `defaultExtensions()`](/examples/default). +You don’t have to use it, but we prepared a `@tiptap/starter-kit` which includes the most common extensions. Read more about [`defaultExtensions()`](/guide/configuration#default-extensions). ## How extensions work Although tiptap tries to hide most of the complexity of ProseMirror, it’s built on top of its APIs and we recommend you to read through the [ProseMirror Guide](https://ProseMirror.net/docs/guide/) for advanced usage. You’ll have a better understanding of how everything works under the hood and get more familiar with many terms and jargon used by tiptap. diff --git a/docs/src/pages/index.vue b/docs/src/pages/index.vue index c8f18804..7b11e352 100644 --- a/docs/src/pages/index.vue +++ b/docs/src/pages/index.vue @@ -35,7 +35,7 @@ Headless

- We don’t tell you what a menu should look like or where it should be rendered in the DOM. That’s why tiptap is headless and comes without any CSS. You are in full control over markup, styling and behaviour. + It’s headless and comes without any CSS. You are in full control over markup, styling and behaviour.

@@ -49,7 +49,7 @@ Framework-agnostic

- No matter what framework you use, you’ll enjoy tiptap. Out of the box, it works with plain JavaScript and Vue.js, but it’s also possible to use it in React, Svelte and others. + Out of the box, tiptap works with plain JavaScript and Vue.js, but it’s also possible to use it in React, Svelte and others.

@@ -63,7 +63,7 @@ TypeScript

- tiptap 2 is written in TypeScript. That helps to find bugs early and gives a nice autocomplete for the API (if your IDE supports that) on top of the extensive human written documentation. + TypeScript helps to find bugs early and gives you a nice autocomplete for the API on top of the extensive human written documentation.

@@ -77,7 +77,7 @@ Collaborative

- Real-time collaboration, syncing between different devices and working offline used to be hard. We provide everything you need to keep everything in sync, conflict-free with the power of Y.js. + Real-time collaboration, syncing between different devices and working offline isn’t hard anymore. Keep everything in sync with the magic of Y.js.

@@ -91,7 +91,7 @@ Community

- Over the years, a lovely community has grown around tiptap. There’s so much content shared, so many people helping out in issues and a ton of community extensions, you’ll be surprised how much that can help. + There’s so much content shared, so many people helping out in issues and a ton of community extensions, you’ll be surprised how much that all can help.

@@ -108,7 +108,7 @@ Quickstart

- For quick demos or to give it just a spin, grab the latest build from a CDN. Here is a quick example to get you started with tiptap: + For quick demos or to give it just a spin, grab the latest build from a CDN. Here is an example to get you started with tiptap:

<!DOCTYPE html> @@ -134,7 +134,7 @@
- Learn More + Learn more