Articles
Articles are your blog posts, news items and stories: anything with a date, an author and a body of text. Unlike pages, an article is one long piece of writing rather than a stack of blocks, and it can have comments.
Open Articles to see them all, most recently changed first, with each one’s category, status, publish date and number of comments. Select New article to start one.
Writing an article
Section titled “Writing an article”The editor has the writing on the left and the article’s settings on the right. On the left:
- Title: the article’s headline.
- Subheading: an optional line under the title. It’s also used as the article’s description when you haven’t written a meta description.
- Body: the article itself, in the rich-text editor described below.
Select Save at the top whenever you like. A new article is saved as a draft.
The rich-text editor
Section titled “The rich-text editor”The toolbar above the body works on whatever you’ve selected, or where the cursor is:
- The first menu sets the text style: Paragraph, Heading 2, Heading 3 or Heading 4. The second makes a paragraph or list Large or Small (or back to Normal size).
- B and I for bold and italic; x² and x₂ for superscript and subscript.
- The link button adds a link to the selected text, or asks for the text and the Link URL. Select an existing link to edit it or Remove link.
- The anchor button (Insert anchor) drops a named target into the text, such as
pricing-section, that you can link to from elsewhere with#pricing-section. - The dragon button inserts one of your site’s emoticons.
- The ! button inserts a callout (see below).
- • List and 1. List for bulleted and numbered lists, with Outdent and Indent to nest them.
- Align left, Align centre and Align right.
- ❝ turns a paragraph into a quotation, or back again.
- The code button marks text as code, in a monospaced font.
- The picture button inserts an image, and ▦ inserts a gallery (see below).
- — adds a horizontal line, and ↶ undoes.
- HTML switches to the raw HTML, for when you need to fix something by hand. Select it again to go back.
Pasting
Section titled “Pasting”When you paste text that has formatting, or that looks like Markdown, the editor asks what to do with it:
- Keep formatting keeps headings, bold, lists and links, tidied up to match the site.
- Convert Markdown turns Markdown (
**bold**,# headings, lists, links) into formatted text. - Plain text pastes just the words.
Pasted headings become Heading 2 to Heading 4, because the article’s title is the page’s only top-level heading.
Images
Section titled “Images”Select the picture button, then Browse… to choose an image from your media library or upload a new one. Or paste an address into Image URL. Add Alt text describing the image for people who can’t see it, and an optional Caption, then select Insert. To change an image later, select it.
Images you upload from here are shrunk in your browser before they’re stored, so large phone photos don’t slow your site down. See How uploads are resized.
Galleries
Section titled “Galleries”A gallery is a set of images in the middle of an article. Select ▦ (Insert an image gallery), then:
- Choose a Layout: Grid or Carousel (a row that scrolls sideways). New galleries start with the site’s default layout, which you can change in Settings.
- Select Add images and pick one or more images or videos from the media library. You can upload new ones from there too.
- Give each one alt text and, if you like, a caption. Use ↑, ↓ and ✕ to reorder or remove them.
- Select Insert gallery.
On the site, selecting an image opens it full-size with its caption, and the arrow keys move through the gallery. To change a gallery, select it in the editor: you can edit it and Save gallery, or Delete gallery.
Callouts
Section titled “Callouts”A callout is a highlighted box for a tip or a warning. Select the ! button, choose a Style (Success, Info, Warning or Error, each with its own icon and colour, or Other (emoticon icon) to use one of your emoticons as the icon), and write its text in the small editor. Select a callout to change or delete it.
Article settings
Section titled “Article settings”On the right of the editor:
- Slug: the article’s address,
/posts/followed by the slug. Leave it empty and it’s made from the title. - Category: every article is in exactly one category. See Categories.
- Publish date: the date shown on the article. If you leave it empty, it’s set to the day you first publish.
- Cover image URL: the image at the top of the article and on its card in listings. Select Browse… to pick one.
- Hero colour: the colour laid over the cover image at the top of the article, from your palette. It starts on Default (Slate dark).
- Authors and Reviewers: tick people from your People directory. Authors are shown with their photos as “By …”; reviewers as “Reviewed by …”. Both link to the person’s profile.
- Tags: tick any that apply. See Tags.
- Series: tick a series to add the article to it, and set the article’s position in the number box beside it. An article can be in several series. See Series.
- Meta title, Meta description and Share image URL: what search engines and link previews show. They default to the title, the subheading and the cover.
- Comments: who can comment on this article. See Comment settings.
- Disable corrections on this article: removes the Suggest a correction form from this article.
Publishing
Section titled “Publishing”An article’s Status is draft (not on the site), published (live), or modified (live, with saved changes that visitors can’t see yet). It works just like a page: visitors keep seeing the last published version until you publish again.
Publishing, unpublishing and deleting need the publisher or admin role. Editors can save and revert, but don’t see the other buttons.
- Publish saves what’s in the editor and puts it live straight away.
- Revert to published throws away your unpublished changes and goes back to the live version.
- Unpublish takes a live article off the site and back to draft, keeping everything. Confirm with Take offline.
- Delete removes the article and all its comments for good.
The first time an article is published, everyone who has subscribed to the blog gets an email about it (if the site sends email). Publishing it again later doesn’t send another. See Subscriptions.
Once an article is live, View live ↗ opens it on the site.
Previewing
Section titled “Previewing”Select Preview to see the article as it will look on the site, including unsaved changes. Select it again to refresh; close the panel with × or Escape.
Scheduling an article
Section titled “Scheduling an article”You can have a draft publish itself later:
- Save the article first. The Schedule section only appears on a saved draft, and only for publishers and admins.
- Under Schedule, pick a date and time (in your own time zone).
- Select Schedule. This saves the article as it is and sets the time.
The article stays a draft, shown as scheduled in the list, until the time comes. The site checks for due articles every 15 minutes, so it can go live up to a quarter of an hour after the time you chose. It then publishes exactly as if you’d selected Publish, including emailing subscribers.
You can keep editing and saving a scheduled article; whatever is saved when the time comes is what goes live. To stop it, select Cancel schedule.
Revisions
Section titled “Revisions”Every save, publish and schedule keeps a copy of the article. They’re listed under Revisions, below the editor, with who made each one and when. The site keeps the last 50.
Select Restore beside a revision to make it your working copy again. It’s saved as a new revision, and if the article is live, the site keeps showing the published version until you publish.
What visitors see
Section titled “What visitors see”A published article lives at /posts/ and its slug. It opens with a banner showing its category (linked to the category’s listing), title, subheading, authors, date, reviewers and tags, over the cover image. Below the body are:
- If the article is in a series, a box saying which part it is (Part 2 of 5 in …) with links to the ‹ Previous and Next › parts.
- The comments, and a form to add one.
- The Suggest a correction form.
To download an article as Markdown, HTML or PDF, see Exporting.
