Create an Article (Production Guide)
Each article is a separate post in WordPress, with the entire article in a single post
Author information (name, bio, headshot) are stored separately from the article, and attached to it. If an author writes more than one article, the information is re-used. See the section on Author Entries for how to create and enter them
Parts of the article
The entire title is placed in one field (the WordPress Post Title field), in all 6 languages.
- Do not attempt to edit the title in the Quick Edit view, as it contains all languages and is easily damaged.
- Set the permalink to the first half of the title (the left side of the colon).
Excerpts (English + Translations)
The Excerpt is entered in a field below the main content editing window. If you do not see this field, pull down the Screen Options menu in the upper-right corner of the screen (just below your name) to add it.
The 25 word extract is entered by clicking on the appropriate flag in the extract field.
- If there is no short version use the first sentence of the abstract.
- To keep the English version from appearing if the extract is blank, but a non-breaking space ( ) in the field.
When the article has a full translation, add text (see Translations) to the end of the extract with this information.
Abstracts (Translations only)
These are the longer (75-85 word) abstracts. Each language is entered in the appropriate article content tab, followed by a sentence that informs the reader that the rest of the article is only in English, linked to the English version of the article.
See the section on Translations for more.
Each article will have a featured image. This is a small image (145 x 105px) that is displayed with the title, author, and extract on the home page. This image is a clip from first, or most informative illustration. In addition, there are some standard featured images
- The magazine logo for editor’s notes
- The UXPA logo for articles about the organization
- A Rubes logo for Rubes Cartoons
- The book cover (centered in the image) for book reviews
Special Sidebar Content
There is a field in the editing window which can be used to put small amounts of extra text in the right side column of boxes. Right now, it is used primarily for links to special translations. Additional uses may be discovered as we go. All HTML and translations are entered manually in the editing field, just like a widget.
Formatting Article Content
Boxes. There are two special boxes styles, with icons in the editing toolbar.
Use them for callouts within the article and additional resources at the end of the article
- Start the box with an <H3> heading. This heading has to be on it’s own line in the editor, following the beginning tag for the box.
- You can format the text within the box normally (mostly).
Use them for long descriptions of images or legal information like project credits.
- <H#> must be nested in the correct hierarchy.
- <H1> is used in the template for the article (post) title. Do not manually enter an <H1> in the article text.
- <H2> and <H3> used for two levels of heading within the article.
- Be sure that headings do not have extra formatting, such a <b> or <em> codes. The difference will not be visible in the editor, but these codes will make a difference in the browser display
Figures. (See the separate entry on formatting images)
- All images must have alt text. This is a short phrase describing the image for readers who cannot see it. If there is too much text in the image, create a grey box at the end of the article for the text, and link to it in the caption.
- All images must have a caption. This is not only good practice, but makes a difference to the way WordPress formats images for multiple devices and screen sizes. Images that do not have a caption in the print version do not need a figure number, but do need a short caption.
Lists. Use the HTML list generators, especially for numbered lists.
Links. Links in the articles, where URLs are listed should be turned into proper HTML links.
Quotes. There is a special style for callout quotes (using the blockquote tag)
This is a quote. This formatting can be assigned to any text in the article by using blockquote.
Special characters. Use them! Correctly.
|Euro and Pound symbols||€ £|
|Trademark and registered mark||™ ®|
|Non-breaking space|| |
Tables. Don’t use them except for tabular content. (See the editorial guide entry). Tables must be created as correctly formatted HTML tables, not inserted as illustrations (see the full production guide entry)
- If the table is simple, transcribe it into an HTML table
- If necessary because the formatting from the print version cannot be reproduced, include the table image as an illustration, and the table text at the end of the article for accessibility.