# Editorial pack

Things people read: articles, posts, docs, news and their previews.

Added with: `npx prongs add editorial` · Profile: [UI](https://www.prongs.dev/docs/intents/ui.md) · Intents: [9](#intents) · Domains: [`heading.*`](https://www.prongs.dev/docs/intents/heading.md) [`text.*`](https://www.prongs.dev/docs/intents/text.md) [`layout.*`](https://www.prongs.dev/docs/intents/layout.md) [`media.*`](https://www.prongs.dev/docs/intents/media.md) [`dialog.*`](https://www.prongs.dev/docs/intents/dialog.md)

## Adding it

```bash
npx prongs add editorial
```

Copies the 9 intents below into your registry, skipping any it already has, and regenerates `PRONGS.md`. A “not for” line that points at an intent your registry does not have is left out.

## Intents

### [`heading.*`](https://www.prongs.dev/docs/intents/heading.md) Heading

| Intent | Status | Use it for |
|---|---|---|
| [`heading.kicker`](https://www.prongs.dev/docs/intents/heading/kicker.md) | `<p>` | A short label above a heading that names its category or series |

### [`text.*`](https://www.prongs.dev/docs/intents/text.md) Text

| Intent | Status | Use it for |
|---|---|---|
| [`text.quote`](https://www.prongs.dev/docs/intents/text/quote.md) | `<blockquote>` | Words quoted from someone, set apart from the text around them: a pull quote in an article, a testimonial. Renders <blockquote> |
| [`text.topic`](https://www.prongs.dev/docs/intents/text/topic.md) | `<span>` | Names a topic or category an item belongs to: News, Science |
| [`text.excerpt`](https://www.prongs.dev/docs/intents/text/excerpt.md) | `<p>` | A short extract of a longer text, shown as a preview: an article summary |
| [`text.prose`](https://www.prongs.dev/docs/intents/text/prose.md) | `<div>` | Rich content written elsewhere and shown here: rendered Markdown, a post body with headings, lists and links |

### [`layout.*`](https://www.prongs.dev/docs/intents/layout.md) Layout

| Intent | Status | Use it for |
|---|---|---|
| [`layout.article`](https://www.prongs.dev/docs/intents/layout/article.md) | `<main>` | A reading column for a whole page: articles, documents, settings |
| [`layout.teaser`](https://www.prongs.dev/docs/intents/layout/teaser.md) | `<div>` | A box in a layout.collection that previews one page and opens it as a whole: its nav.item title covers the box |

### [`media.*`](https://www.prongs.dev/docs/intents/media.md) Media

| Intent | Status | Use it for |
|---|---|---|
| [`media.embed`](https://www.prongs.dev/docs/intents/media/embed.md) | `<iframe>` | Another page shown inside this one: a video player, an article preview, a map. Its alt becomes the frame title |

### [`dialog.*`](https://www.prongs.dev/docs/intents/dialog.md) Dialog

| Intent | Status | Use it for |
|---|---|---|
| [`dialog.reader`](https://www.prongs.dev/docs/intents/dialog/reader.md) | `<dialog>` | Shows one piece of content over the whole screen: reading an article |

## Next to the starter

The starter intents this pack’s intents are told apart from. Each pack intent’s page says when to use which.

| Intent | Use it for | Resolves to |
|---|---|---|
| [`heading.section`](https://www.prongs.dev/docs/intents/heading/section.md) | Title of a major part of a page | `<h2>` |
| [`text.body`](https://www.prongs.dev/docs/intents/text/body.md) | Running text: sentences and paragraphs that explain something | `<p>` |
| [`text.code`](https://www.prongs.dev/docs/intents/text/code.md) | A block of code or terminal output shown to the reader | `<pre>` |
| [`text.label`](https://www.prongs.dev/docs/intents/text/label.md) | A few words that name a value: field labels, setting names, column headers. Use as="label" htmlFor=... for form fields | `<span>` |
| [`layout.page`](https://www.prongs.dev/docs/intents/layout/page.md) | A centred column of content. An app page has one; a marketing page may have one per full-width band | `<main>` |
| [`layout.panel`](https://www.prongs.dev/docs/intents/layout/panel.md) | A self-contained box about one thing: a sign-in box, a profile summary | `<div>` |
| [`dialog.task`](https://www.prongs.dev/docs/intents/dialog/task.md) | A focused task that blocks the page until done or dismissed: edit settings, compose | `<dialog>` |
| [`media.image`](https://www.prongs.dev/docs/intents/media/image.md) | An image that illustrates content or is the content: an article cover, a screenshot, a product photo, a logo, cover art | `<img>` |

## For registry authors

**Pack intent.** `prongs add editorial` puts the editorial pack’s intents in your registry. They are then yours like the starter intents: rename, restyle and add to them, and see them with `prongs add gallery`.