Article head
The article head holds the above-the-fold content, such as the headline, byline, introduction, and an optional basic aside.
The article head content is not version-controlled, but any changes made to it are immediately visible. That means that if changes to these need to be made as a result of a new version of the article body, release the new version, then immediately update the head content.
If requiring a complete version of an article for saving in a records management system, most browsers provide a means of saving a page (typically using Ctrl+S) as a .html file and a similarly-named subfolder containing any constituent files, all of which can be made into a single .zip file which can be stored.
Navigation bar△
Descriptions of the navigation bar items.
# | Area | Description |
---|---|---|
a | Owner path | Article owner hierarchy as jumps to their listing in the Access section of the Work list page |
b | Phase details | Various details of the current phase. Only shown if the article is being edited |
Owner path△
The article body navigation bar provide jumps to the pages for it and its hierarchy of owners.
# | Name | Description |
---|---|---|
1 | Subsite | Owning subsite identifier as a jump to its entry in the Access section in the Work list page, with its category list expanded |
2 | Category | Owning category identifier as a jump to its entry in the Access section in the Work list page, with its article list expanded |
3 | Article | Article identifier as a jump to its entry in the Access section in the Work list page. New for a new article |
Phase details△
The article body navigation bar holds the details of the current phase.
# | Name | Description |
---|---|---|
1 | Phase | Current editing phase as a jump to the article's entry in the In-progress section of the Work list page. Followed by the locale, user ID and due duration if applicable |
2 | Locale | Locale being processed by the current phase. Only shown if an editing or review phase |
3 | User ID | User identifier of the person assigned the current phase. If not an editing or review phase, Manager is shown |
4 | Due | Duration in which the task is expected to be completed. Only shown if an editing or review phase |
Details△
This section describes the basic information for managing an article.
# | Name | Description |
---|---|---|
1 | Subtype | Subtype of article. One of Article, Navigation, Procedure or Questionnaire. Not displayed for subsite-specific articles |
2 | Headline | Headline for the article as a link to the latest release. Cannot be changed to one that already exists. Analogous to a newspaper headline as a short catchphrase to get attention |
3 | Navigation | Short version of the Headline to be used in navigation links |
4 | Byline | Analogous to a newspaper byline that qualifies or extends the Headline, so that the latter can be kept short. Appears in the article header below the Headline |
5 | Introduction | Plain text introduction of what the article is about. Also used to provide text about the article on various pages |
6 | Author | Full name of the writer of the current article. Used instead of the site and subsite Authors |
7 | Signature | Whether the article is listed at the top of an alphabetically-sorted Category page. Checking disables Signature for any other article in the category |
8 | Dates | Date the article was created and last updated as a release |
9 | Subsite | Provides the numbers of categories and articles in the article's subsite |
10 | Category | Provides the numbers of articles in the article's category, as well as a means to change that category |
11 | Show | Specifying how visible pages are in terms of discoverability. Listed means the article is listed on various public pages. Unlisted do not appear on those pages, but can be accessed if its URL is known. Hidden cannot be publicly accessed. Subsite-specific articles are never listed, but the articles can be accessed if their URL is known, though there are settings to show their links in the Site navigation bar and Site links |
12 | Status | A per locale setting specifying whether the locale-specific version of the page is available, or falls through to the next locale. Is Always for the master locale |
13 | Delete | Available to delete an article, but only if it is hidden and is not linked to |
The identifier used by links and URLs is derived from the master locale Headline by converting it all to lowercase, converting each sequence of non-alphabetic characters to a single -, then prefixing it with the letter for the article type and -.
Navigation is mainly for ensuring that navigation text is short so that many items can appear in navigation bars. That means that it may not be required for all locales, but only for those that may need to be shorter. Therefore, unlike other values that fall-through the locale hierarchy to the master, Navigation is only used if defined for the current locale, otherwise the headline is used. A ? will appear if the heading is too long, but Navigation may be safely ignored at the expense of possibly cluttered navigation bars.
The home page cannot be deleted directly. When its subsite is deleted, the home page will be converted to a navigation page and placed in the main subsite's default category, from where it can be deleted.
Basic aside△
A basic aside is a simple aside whose only content is an introduction, image and optionally a quote.
# | Name | Description |
---|---|---|
1 | Actions | Buttons are provided for enabling and removing the basic aside |
2 | Heading | Heading for the aside |
3 | Introduction | Plain text introduction for the image. If there is no image, this is displayed as a paragraph |
4 | Quote | Optional plain text quote to be centred under the image. Insert @^ for each line break required. Use for a personal saying of the person in the image. Not shown on a page if no Image |
5 | Image | Details about the current image used for displaying in a card or gallery item that links to the article, with an opportunity to select another, or remove it. Only Cards and Asides are available for selection |
While a basic aside can enhance the visual appeal of a page, it can aid navigation because its Image can be used in a cards (if Card) or gallery (if Card or Aside) array of a Navigation article by referencing the article as part of the array. If no Heading is specified, the basic aside is not shown on the page. However, if there is an Image, the article can still be referenced from a cards or gallery array.
Links to△
This section lists all the article's links.
# | Name | Description |
---|---|---|
1 | Link type | Name of the link group. This jumps to the Links page to allow modifying which links are in that group |
2 | Target | List of the group's links targets and their type, with jumps to them. For Subsite navigation, there are toggles for which existing subsite-specific pages are to be included |
# | Type | Description |
---|---|---|
1 | Cards | Articles or categories from which the heading, basic aside image and introduction are extracted for an array of card for informative navigation choices. Only for Navigation article pages |
2 | Gallery | Articles or categories from which the basic aside images are extracted for an array of images for visual navigation choices. Only for Navigation article pages |
3 | Inline | Any links in the article body. Can only change these by editing the article on the Article body page |
4 | Related articles | Articles and categories that are part of the site |
5 | Related sites | Pages from other sites |
For external links, the listings will be of the form URL: ID. For internal links, the form is Article: ID. Inline links will be prefixed with the host type, like Link: or Quote:
For the Related links, if any are included for both the article and its subsite, the subsite links will not be shown. For Related sites, only the URLs – not the text – have to match for the subsite version to be hidden.
Linked from△
This section lists the sources of all the links to this article.
# | Name | Description |
---|---|---|
1 | Source type | The type of owner of the link that points to the article. Either Subsite or Article |
2 | Source ID | The source identifier of the host of the link to the article. Click on it to jump to its manage page |
3 | Link type | The location of the link in its host. Click to jump to where that link is defined in the source |
Files△
This section lists all the files linked to by the article, either inline in the article, or by its basic aside.
# | Name | Description |
---|---|---|
1 | File ID | … | File identifier, extension and the number of times used |
2 | Thumbnail | Scaled down view of an image or video, and blank for any other type |
3 | Text | … | Text defined after the file was imported, file mime type and its purpose (usage type) |
New△
A new article only requires a heading, an introduction, and optionally a byline.
The fields for a new article are only available after clicking on the New link on various pages, clicking on the required subtype, and either clicking on Blank or clicking on an article from the list to clone from.
# | Name | Description |
---|---|---|
1 | Headline | Headline for the new article. Cannot be the name of an existing article. Note that the resulting article identifier derived from the headline might also be rejected because it already exists |
2 | Byline | Analogous to a newspaper byline that qualifies or extends the Headline, so that the latter can be kept short. Appears in the article header below the Headline |
3 | Introduction | Plain text introduction to what the article is about. Also used to provide text about the article on various pages |