mirror of
https://github.com/ueberdosis/tiptap.git
synced 2024-12-22 08:07:50 +08:00
f387ad3dd4
* chore:(core): migrate to tsup * chore: migrate blockquote and bold to tsup * chore: migrated bubble-menu and bullet-list to tsup * chore: migrated more packages to tsup * chore: migrate code and character extensions to tsup * chore: update package.json to simplify build for all packages * chore: move all packages to tsup as a build process * chore: change ci build task * feat(pm): add prosemirror meta package * rfix: resolve issues with build paths & export mappings * docs: update documentation to include notes for @tiptap/pm * chore(pm): update tsconfig * chore(packages): update packages * fix(pm): add package export infos & fix dependencies * chore(general): start moving to pm package as deps * chore: move to tiptap pm package internally * fix(demos): fix demos working with new pm package * fix(tables): fix tables package * fix(tables): fix tables package * chore(demos): pinned typescript version * chore: remove unnecessary tsconfig * chore: fix netlify build * fix(demos): fix package resolving for pm packages * fix(tests): fix package resolving for pm packages * fix(tests): fix package resolving for pm packages * chore(tests): fix tests not running correctly after pm package * chore(pm): add files to files array * chore: update build workflow * chore(tests): increase timeout time back to 12s * chore(docs): update docs * chore(docs): update installation guides & pm information to docs * chore(docs): add link to prosemirror docs * fix(vue-3): add missing build step * chore(docs): comment out cdn link * chore(docs): remove semicolons from docs * chore(docs): remove unnecessary installation note * chore(docs): remove unnecessary installation note
82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
---
|
||
description: All the popular extensions in a single extension. Doesn’t get much better than this.
|
||
icon: stack-line
|
||
---
|
||
|
||
# StarterKit
|
||
[](https://www.npmjs.com/package/@tiptap/starter-kit)
|
||
[](https://npmcharts.com/compare/@tiptap/starter-kit?minimal=true)
|
||
|
||
The `StarterKit` is a collection of the most popular Tiptap extensions. If you’re just getting started, this extension is for you.
|
||
|
||
## Installation
|
||
```bash
|
||
npm install @tiptap/starter-kit
|
||
```
|
||
|
||
## Included extensions
|
||
|
||
### Nodes
|
||
* [`Blockquote`](/api/nodes/blockquote)
|
||
* [`BulletList`](/api/nodes/bullet-list)
|
||
* [`CodeBlock`](/api/nodes/code-block)
|
||
* [`Document`](/api/nodes/document)
|
||
* [`HardBreak`](/api/nodes/hard-break)
|
||
* [`Heading`](/api/nodes/heading)
|
||
* [`HorizontalRule`](/api/nodes/horizontal-rule)
|
||
* [`ListItem`](/api/nodes/list-item)
|
||
* [`OrderedList`](/api/nodes/ordered-list)
|
||
* [`Paragraph`](/api/nodes/paragraph)
|
||
* [`Text`](/api/nodes/text)
|
||
|
||
### Marks
|
||
* [`Bold`](/api/marks/bold)
|
||
* [`Code`](/api/marks/code)
|
||
* [`Italic`](/api/marks/italic)
|
||
* [`Strike`](/api/marks/strike)
|
||
|
||
### Extensions
|
||
* [`Dropcursor`](/api/extensions/dropcursor)
|
||
* [`Gapcursor`](/api/extensions/gapcursor)
|
||
* [`History`](/api/extensions/history)
|
||
|
||
## Source code
|
||
[packages/starter-kit/](https://github.com/ueberdosis/tiptap/blob/main/packages/starter-kit/)
|
||
|
||
## Usage
|
||
Pass `StarterKit` to the editor to load all included extension at once.
|
||
|
||
```js
|
||
import { Editor } from '@tiptap/core'
|
||
import StarterKit from '@tiptap/starter-kit'
|
||
|
||
const editor = new Editor({
|
||
content: '<p>Example Text</p>',
|
||
extensions: [
|
||
StarterKit,
|
||
],
|
||
})
|
||
```
|
||
|
||
You can configure the included extensions, or even disable a few of them, like shown below.
|
||
|
||
```js
|
||
import { Editor } from '@tiptap/core'
|
||
import StarterKit from '@tiptap/starter-kit'
|
||
|
||
const editor = new Editor({
|
||
content: '<p>Example Text</p>',
|
||
extensions: [
|
||
StarterKit.configure({
|
||
// Disable an included extension
|
||
history: false,
|
||
|
||
// Configure an included extension
|
||
heading: {
|
||
levels: [1, 2],
|
||
},
|
||
}),
|
||
],
|
||
})
|
||
```
|