Skip to content
D
Documentation

Read an article

task
5 min readUpdated

Read an article

An article is a published post whose body is written in markdown and presented with its title, metadata—the author and publication date—tags, comments, and reader actions.

Use this page to open an article, read its content and metadata, and choose the next action.

If you need to…Go to
Find an existing articleFind and open the article
Find articles in a feedFind articles in feeds
Browse articles by tagBrowse articles by tag
Recognize the article screenUnderstand the article screen
Read the body and check its author or dateRead the article and its metadata
Add a commentComment on an article
Favorite or unfavorite the articleFavorite articles
Use author-only article actionsArticle actions reference

Before you start

The article page displays a saved article when its article data is available. Your account state changes which controls appear: authenticated readers get the comment form, while unauthenticated readers get links to sign in or create an account.

Prerequisites

  • Know which article to select from the article list, feed, or tag view.
  • If you want to comment, select Sign in before opening the article.

Find and open the article

Use this procedure to open an existing article from an article list or a tag view.

Prerequisites

  • Have an article list, feed, or tag view open.

Steps

  1. Choose the view that contains the article, then select the article you want to read.

    If you are…Select the article from…
    Reading a feed or article listThe article list or feed.
    Browsing by subjectThe tag view.

The article page opens for the selected article.

Result: The selected article page is on screen.

Understand the article screen

The article screen is the reading surface for one article: the title and metadata identify the post, the markdown body contains its content, tags describe its subject, and the lower area contains comments and reader actions.

AreaWhat you find there
Article headingThe article title.
Article metadataThe author and publication date.
Article bodyThe article text formatted from markdown.
TagsThe article's tags below the body.
Article actionsAuthor actions, or follow and favorite controls for other readers.
Comment areaExisting comments and, for authenticated readers, the comment form.

The page does not provide article-editing fields, a grid, or a configurable surface. Editing is handled in the article workspace, while this page is for reading the article and its associated activity.

Read the article and its metadata

Read the article body first, then use the metadata to identify who published it and when.

Prerequisites

  • Have the article page open.

Steps

  1. Read the article title at the top of the page.
  2. Read the article body below the title.
  3. In the article metadata, read the author's name and publication date.

The author's name is a link to that author's profile.

Result: The article content, author, and publication date are on screen.

Use the reading controls

The controls on the article page depend on whether you own the article or a comment, whether you are signed in, and whether the article is already in your favorites.

Prerequisites

  • Have the article page open.

Steps

  1. Choose the action that matches your situation.

    Your situation or goalSelect
    You own the article and want to edit itEdit Article
    You own the article and want to delete itDelete Article
    You want to follow the authorFollow
    You want to stop following the authorUnfollow
    You want to save the article as a favoriteFavorite Article
    You want to remove the article from your favoritesUnfavorite Article
    You want to add a commentEnter text in Write a comment..., then select Post Comment.
    You need to sign inSign in
    You need to create an accountsign up
  2. Use the handling shown for the action you selected.

    ActionHandling
    Edit ArticleArticle workspace
    Sign inSign in
    sign upCreate an account
    Delete ArticleSelect the control for the direct delete action.
    Follow or UnfollowSelect the control for the direct follow action.
    Favorite Article or Unfavorite ArticleSelect the control for the direct favorite action.
    Post CommentEnter text in Write a comment..., then select the direct Post Comment action.

Result: Edit Article, Sign in, and sign up take you to their linked pages. The other controls start direct actions on the article page; Delete Article leads away after the delete action, while follow, favorite, and comment actions remain on this page.

Handle errors and continue

The article page displays loading and server-response errors in its error area.

Prerequisites

  • Have the article page open.

Steps

  1. Read the message in the error area.

    What you seeWhat to do
    Failed to load articleReturn to the article list and open the article again.
    Returned errors show a key followed by its value.Read the entry and use the matching next step in this table.
    Sign in and sign up instead of the comment formSelect Sign in or sign up before trying to comment.
    Edit Article and Delete ArticleUse Article actions reference for author-only actions.
    Write a comment... and Post CommentUse Comment on an article to add a comment.
    Favorite Article or Unfavorite ArticleUse Favorite articles to manage favorites.
  2. Select the next task from the message's matching row.

Result: You are back at the article list to retry loading, or you have continued to the procedure or page that addresses the message.

Was this page helpful?

Download as PDF
Read an article — Conduit (Angular)