Snippets

A snippet is a chunk of content you write once and reuse across your publication: a text, a link, a gallery, a file. Edit it in one place and it changes everywhere it's used. The Snippets tab of Studio is where you keep them all.

The Snippets tab

The tab shows one row for each kind of snippet:

• Texts
• Link lists
• Links
• Galleries
• Files
• Images and videos
• Audio
• Cards
• Calls to action (see Calls to action)
• Announcements

Each row has the kind's name, how many you have, and your latest ones side by side (scroll sideways for more). A row with none yet shows an empty tile with a "+": click it to make your first.

On the right of a row's name:

• See all opens the full list of that kind, with a search bar and a select that switches between "Your library" and "Also those made in your pages". Your library holds the snippets you made on purpose. The other choice adds those that were created along the way while you built your pages.
• + New (for example "New gallery", "New text") makes a snippet of that kind. A link opens a small window; the other kinds open in their editor.

The Create menu at the bottom of Studio's left menu also has Snippet: it opens this tab, where you choose the kind with its "New".

The Snippets tab: a row for each kind.

Editing a snippet

Click a snippet to open it. Texts, link lists, galleries, files, images, videos and cards open in the snippet editor, with a Publish bar on top like a page's. Changes reach the places where the snippet is used once you publish it. A link opens in its own small window instead (see below).

The card of a snippet also has the usual controls: a link icon that copies the address of its page, an arrow that opens it, its statistics, and remove. Its publish button sits beside its status, as on your other Studio lists.

A page of its own

Each published snippet also has its own page on your publication's site, with its name, its description, its content and a comment area under it. The link icon on the snippet's card copies its address, so you can share a gallery or a text on its own. A snippet that isn't published shows nothing to readers.

Audio

An audio snippet is a sound your readers play where it sits: in a page, a zine or an article. In the Audio row, + New (or the "+" tile) opens its editor, which is the card readers get, with its fields in place:

• Record records in your browser, with your microphone.
• Upload a file takes an audio file (MP3, M4A, WAV and the like). Once there is one, the buttons read Record again and Upload another file, and the player appears so you can listen to it.
• A cover on the left, a title, and A line about it (optional). If you don't type a title, an uploaded file's name is used.

Readers see the cover, the title, the line and a player in a line: a play button, a bar to move along, the time played and the length. In the email, an audio can't play, so it shows the cover, the title and the line, with a Listen button to the page.

An audio snippet is placed like any snippet, with the Audio block of a page or with the "/" menu of an article. Podcast links aren't supported in it yet.

Links

A link snippet is a link to another website. You write it once, and the same link can be used in:

• your menu (see Your pages and menu)
• a Link card block on a page (paste or pick a link in the block)
• the list of a Links page or block

Whenever you add a link in one of these places, you can write a new one or pick one from "Or one of your links". The window to add or edit one asks "Where does it go?" (the address), a name and an optional thumbnail.

Editing a link updates every place that uses it: the menu, the cards and the lists. Changing a link's address is different: it saves a new link for the place you're editing, and the places still using the old address keep it.

Seeing where something is used

When a snippet is used in a page or a zine, Peakub tells you, so you don't change or remove it by surprise:

• On its card in Studio, a line reads "Used in About, Issue 3". A page's name is a link to its editor. A link that sits in your menu also lists "the menu".
• At the top of the snippet editor, a notice says "It's used in ...: your changes show there too."
• Removing a snippet that's in use warns you that it will disappear from those places too.
• On any card, the paperclip icon opens a "Complements" window. Its "Used in" tab lists each page, zine, list and menu that uses the item, one per row.

Snippets made in a page

When you drop a photo or a file into a page or a zine, or add a card there, the snippet is made right inside it. These snippets are made along the way, so they don't show in "Your library": you find them in a kind's list (See all) by switching the select to "Also those made in your pages".

• They go out with the page. Publishing or republishing the page or zine that shows one publishes its changes too, so readers get the photo, the file or the card exactly when the page's change goes out. Before that, readers don't see the snippet at all: one that was never published shows them nothing.
• Where it's live. In that list, each of these snippets says "Live in About, Summer zine": the published pages and zines that show it. When none of them is published yet, the line is missing.
• Keeping one. Under that line, Keep in library makes the snippet one of your library's. Publishing one by hand (its publish button in the Snippets tab or in its editor) does the same. From then on it is published on its own and no longer goes out with the pages that show it. Publishing a page never does this.
• Shared between pages. If several pages show the same snippet, publishing any of them publishes it for all.

Snippets in articles

Snippets can be placed in articles too, and a passage of an article can be turned into a snippet. A snippet made in an article is listed with the others, and says "Live in" followed by the article once it is published. The "Used in" line of a snippet names the articles that show it, next to pages and zines. See Snippets and blocks from your publication in an article.