3  Article head

Descriptions of the navigation bar items.

ab

This section describes the basic information for managing an article.

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 -.

Because Android phones usually show text about 8% larger than almost anywhere else, if not having access to an Android phone to check that Headline and Byline do not make the text in them wrap around, allow at least 5-10% clearance either end of the text when designing on other devices.

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 headline is perhaps too long, but Navigation may be safely ignored at the expense of possibly cluttered navigation bars.

For a card, the article's Navigation and Introduction are used as its heading and explanatory text. If there is no navigation text, the Headline is used. Consider how the text for these article attributes would look in a card when composing their text, especially since they will be truncated for non-Highlight first cards when shown two-across on larger devices. Check what they look like for each locale.

By default, new articles are only enabled for the master locale. Once all the text for a locale for the article has been completed, the locale can be enabled under Locales. Up until then, the locale is bypassed in locale fall-through. If the locale was specified for rendering of the page, a highlighted message is displayed under the page header indicating that it is not available and which locale the page is being displayed with. All links on the page still use the original locale to maximise locale continuity while traversing the site.

Enabling a locale for an article does not check if any text has actually been translated in it as some fall-through may be wanted, such as when having two different English locales where spellings differ, but some paragraphs may have no such differences, so the non-master versions do not need to have their own text. While editing, rich-text element blocks will have an ⧉ to indicate that it has no inline elements, while fields for sections, and asides and glossary headings will be empty.

The home page cannot be deleted directly. When its subsite is deleted, the home page will be converted to a normal navigation page (h- in its ID is replaced with n-) and placed under Templates, from where it can be raided for content or deleted.

A basic aside is a simple aside whose only content is an introduction, image and optionally a quote.

While a normal aside only has a heading but can contain several other elements, a basic aside is essentially a combination of an normal aside with a figure. Their advantage is that they are more straightforward to set up.

Specifying an image for a category can aid navigation when used in a card (if Card) or gallery (if Card or Aside) array of a Navigation article. For a card, the Navigation and Introduction are used as its heading and explanatory text. If there is no navigation text, the Headline is used. Consider use in a card when framing the text for these article attributes.

Warning
An aside is a floating element that displaces the content next to it, forcing that content to wrap around the aside. Many elements, like a paragraph, can have an image that floats to its end side. Having two floating elements in the same area can sometimes produce odd results. In general, avoid having an element with a floating image next to an aside to prevent its image possibly appearing within the following element.

This section lists all the article's links.

Only one of a cards array, catalog or gallery can be used in the one navigation page. Cards are for primary navigation, while a gallery is more a way to show some pictures for people to select from on a whim. A catalog looks like a Category page, but it can link to up to any 20 articles or categories in a custom order.

For external links in the list of links for Related sites, the listings will be the URL, with any text underneath. For internal links in the other link types, the form is Article: ID. Inline links will be prefixed with the host element type, like Link: or Citation:. If in a navigation article, any targets already in a catalog or cards array will not show in Related articles.

The number of times a link is used is for that exact link target. For internal links, which will normally use the same target article, category or fragment for each locale for it, that will generally be the number of locales by the number of times it is used in the master locale. If it does not match that, then there may be some locales that have not been fully translated. External links should have similar numbers, but if the URL for them is different for one or more locales, they will be treated as different links with their own row and counts.

If wanting a catalog-like structure with external links, such as when using multiple sites as a set, use a list with specially formatted items, perhaps with a link to the page as the first element, followed by a break. For a more graphical structure, use a diagram element with boxes set up as links, perhaps with an overlay with an image behind each of them.

This section lists the sources of all the links to this article.

This section lists all the files linked to by the article, either inline in the article, or by its basic aside.

There are some keyboard shortcuts that help speed up common tasks.

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 an article from the list to clone from. That list of articles is only those of the same type that have been released and not currently being edited. New articles are always Hidden.

Subsite pages have fixed headings and introductions, so are created as soon as Blank or an article to clone from is selected. Contact pages are built at rendering time from details provided in the Contact section of their Subsite page.

For cloning, while the new article must have a different headline for the master locale to ensure it has its own URL, the rest of the article is as intact as possible. Especially if using multiple locales, this keeps the maximum amount of existing content to aid in deciding what to edit for the purpose of the new article. The cloned article will have a creation date at least one second after the article it was cloned from, reflecting the starting copyright date of the content cloned. The updated date will be that of the cloned article or the new creation date, whichever is later.