Skip to main content

Smallsite Design

Online editing help

Element: General article

A general article has the most flexible content model, allowing most blocks, a glossary and sections, with those able to contains their own.

General articles and their sections and subsections can have up to 50 blocks, such as paragraphs, lists, tables or asides, and one glossary. An article can have up to 20 sections with up to nine subsections in each. Thus a general article can have a lot of content but still be relatively easy to navigate around. While an article can have so much content, actually filling it with that much may overload a web server's capacity to serve it.

Sections and subsections

Sections and subsections allow for hierarchical information presentation, and include automatically generated menu bars for quick discoverability and access.

The section details are:
#FieldDescription
a1 Section: 0Section number and number of subsections
bHeadingHeading for the section. Cannot be changed to one that already exists
cNavigationShort version of the Heading to be used in navigation links
dIntroductionDescription of what the section is about

The identifier used by links is derived from the master locale Heading by converting it all to lowercase, then converting each sequence of non-alphabetic characters to a single -. For example, the identifier for this section is sections-and-subsections. The derived identifier must also be unique within the article. Subsection identifiers must be unique to their parent section, but will be prefixed with the parent section's identifier and -- in links to make them unique to the article.

Like most introductions, it is meant to be indicative of the content, so that a reader can decide whether the content is useful for them, but it should not be relied upon for critical information, as it will probably be ignored after that decision is made. Thus any important information should be after the introduction, with any pivotal information that defines how the section should be viewed in the first block.

Each section or subsection can have a basic aside, consisting of a heading and a paragraph or introduction and image and an optional quote. These can provide some simple visual embellishment to make a page more varied and attractive. However, images in basic asides cannot have labels, so cannot link to inline tables or lists.

Glossary

While a glossary structure in a general article could be used for terms, their structure is more useful than that.

A general article can have a hierarchical structure with its sections and subsections. This gives an opportunity to use a glossary at each level, allowing a three-tier descriptive listing. Each entry can be enhanced with a picture. The obvious use for this is with a company staff listing, with management in the base article area, division heads and support staff in their own subsections, and section heads and their staff in subsections under them.

The structure can be extended downwards and laterally by linking to further such articles, and combined with being allowed up to 99 entries in a glossary, quite sophisticated or voluminous structures can be easily accommodated.

There are a couple of functional limitations of glossaries in a general article compared to a standalone glossary article, being that general article glossaries don't:

  • Have a menu providing links to every fifth entry
  • Allow their entries to be used for pop-ins.

Neither of these limit the utility of the entries themselves, which still allow formatting and links in their descriptions.


Manage         Help   Powered by: Smallsite Design©Patanjali Sokaris         art-a  3  0  2022-04-23-08-44-16