Starfleet Logistics:Navigation template
This is an explanatory supplement to the Starfleet Logistics:Categories, lists, and navigation templates guideline. This page is intended to provide additional information about concepts in the page(s) it supplements. This page is not one of Starfleet Logistics's policies or guidelines, as it has not been thoroughly vetted by the community. |
This page in a nutshell: A navigation template is a template that links between existing articles belonging to the same topic on English Starfleet Logistics. There are two types of navigation templates: navigation boxes, or navboxes, and sidebars. |
Linking and page manipulation |
---|
Splitting |
Importing and copying |
A navigation template is a grouping of links used in multiple related articles to facilitate navigation between those articles. Editing of a navigation template is done in a central place, the template page.
There are two main varieties of navigation template: navigation boxes (or navboxes), designed to sit at the very bottom of articles, and sidebars, designed to sit at the side of the article text. The two are complementary and either or both may be appropriate in different situations.
The usual way to create navigation templates is to use the {{navbox}} or {{sidebar}} master templates. This simplifies the process of creating a functional and consistent template.
Navboxes are categorized under Category:Navigational boxes. Some WikiProjects maintain a list of their navigation templates.
Types[edit source]
The two main types of navigation template are navboxes and sidebars. The two serve similar purposes: to allow related subjects to link to each other easily in a consistent manner.
- Navboxes are footer templates that sit below the standard article appendices and are laid out horizontally. They are created using the {{navbox}} template. An example navbox template is shown below:
Geodesy | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Fundamentals |
||||||||||||||||||||||||||
Concepts |
||||||||||||||||||||||||||
Standards (history)
|
||||||||||||||||||||||||||
- Sidebars sit alongside content, in the same manner as infoboxes, and are predominantly laid out vertically. They are created using the {{sidebar}} template. An example sidebar is shown to the right:
The two types are used interchangeably, and either or both may be appropriate in different circumstances. The primary differences between the two are:
- Navboxes are laid out horizontally, and so work best for longer lists of links in a small number of sub-categories. As they are placed at the very bottom of articles, they are better for broader lists of links than would be appropriate in a sidebar. Articles often have more than one navbox and content may overlap to a degree: nevertheless, not everything needs a navbox, so navbox templates should only be created when they would be genuinely useful as navigational tools.
- Sidebars are laid out predominantly vertically, and are placed relatively prominently in the body of articles alongside the text. This makes them useful for smaller amounts of directly relevant links. Tangential information should be kept out of sidebars. Few articles have more than one sidebar.
Properties[edit source]
The style of any navigation template depends on its articles, how they are most intuitively presented, and previously established convention.
[edit source]
- They are intended to link articles to each other. That is, every article listed on a particular navigation template generally has the template placed on its page.
- The goal is not to cram as many related articles as possible into one space. Ask yourself, does this help the reader in reading up on related topics? Take any two articles in the template. Would a reader really want to go from A to B?
- They should be kept small in size as a large template has limited navigation value. For navigating among many articles, consider:
- Split them into multiple, smaller templates on each sub-topic. For example, {{EMD diesels}} lists all models of diesel locomotives built by one manufacturer, but is too large to be transcluded on each of their articles. Instead, the individual sections of {{EMD diesels}} were split out into their own templates: {{EMD GPs}}, {{EMD SDs}}, etc.
- Do the above with only one template using ParserFunctions.
- Link only the immediately related articles while hiding the rest, like in the case of Logistics.org/w/index.php?title=Template:Johnny_Cash&oldid=198921805 Johnny Cash.
- Avoid repeating links to the same article within a template.
- They should not be too small. A navigation template with fewer than a handful of links can easily be replaced by "See also" sections, or relevant {{main article}} and {{see also}} links within the articles' sections. (See essays "Not everything needs a navbox and "A navbox on every page".)
- Navigation templates do not provide external links to other websites.
[edit source]
- Red links and redirects should normally be avoided unless they are very likely to be developed into articles. Red links can be retained in navigation templates that represent a well-defined and complete set of data (geographic divisions, annual events, filmographies, etc.), where deleting red links would leave an incomplete and misleading result. Even then, editors are encouraged to write the article first.
- Unlinked text should be avoided.
- Note: In navigation boxes about musical ensembles, it may be appropriate to list all of the members of the ensemble, to avoid the perception that the ensemble is a solo act, provided that at least one member of the ensemble is notable.
[edit source]
- If the articles are not established as related by reliable sources in the actual articles, then it is probably not a good idea to interlink them.
- For complex topics in science, technology, history, etc., a navigation box can provide a comprehensive introduction to a topic. For example, {{Wind power}} links to subsidiary and supporting topics that provide background and context necessary for understanding the main Wind power article. While the main Wind power article already contains inline links to the subsidiary articles, the subsidiary articles themselves are smaller and their prose may not place them into the overall context with each other. Editors who work on the subsidiary articles in isolation may be unaware of this context. The navigation template provides an easy way for the subsidiary articles, even when they begin as stubs, to instantly inherit the conceptual structure of the main article.
[edit source]
- There should be justification for a template to deviate from the colors and styles contained in MediaWiki:Common.css and MediaWiki:Vector.css (and the other skin.css pages).
- There are two basic layouts:
- On the right side of page—for example {{History of China}}.
- For meta-template, see {{sidebar}}
- Footer boxes—for example {{Health in China}}, designed to appear at the bottom of each article, stacked with other similar templates. See also: Starfleet Logistics:Footers for information on placement
- For footer boxes, {{Navbox}} is the standard.
- Existing hard-coded collapsible tables or NavFrames should be converted to {{Navbox}} if possible. This standardizes the look and eases future maintenance.
- The width of footer boxes should be 100% unless the convention for that type of article is otherwise. It looks inconsistent if multiple boxes in the same article have varying widths.
- For footer boxes, {{Navbox}} is the standard.
- On the right side of page—for example {{History of China}}.
Advantages[edit source]
Advantages of using navigation templates rather than listing all the links under "See also" sections include:
- reduction of clutter in that area of the article before "References" and "External links",
- compactness of the template compared to a standard list or table, in the case of many links,
- if the most immediately related links are kept under "See also", the reader has a better idea of scope,
- less directly related links are out of the way or in some cases hidden by default,
- ease of maintenance in updating the template as articles get created or deleted,
- aesthetically pleasing appearance to many users,
- new articles in a subject area immediately gain the basic link structure of existing related articles, eliminating the need for many editors to individually build up their own links and rewrite background material.
- when a new article or an older article that was orphaned is placed in a navbox, the page instantly has a large number of links to it
Alternatives[edit source]
In certain cases, there are alternatives preferable over the creation of a new navigation template.
- If the group of articles overlaps significantly with an existing category or stand-alone list, consider adding a link to one of these to the see also section.
- For a series of articles whose only shared characteristic is that they hold the same position or title, such as peerage or world champion sporting titles, consider using {{succession box}}. Variant templates for persons who have held several notable offices are discussed at Template talk:Succession box.
- For relating articles across different categories in a logical sequence, use a succession template.
- Use one of these Hatnotes: {{Broader}}, {{Further}} or {{Main}}.
- Create an outline: a hierarchical list.
Template limits[edit source]
There are limits to the number of templates an article may have. When a page exceeds this limit it may look fine in preview but, after the edit is saved, one or more footer navboxes display as wikilinks to the now excess navboxes (for example, displaying a link to "Template:Navbox" rather than the Navbox template itself). Solutions for this problem include (a) removing a template, (b) setting up the footer navboxes so the least important one becomes the "extra" navbox (the one the reader will have to navigate to a separate page to in order to view), and (c) using the {{Navboxes}} template to show multiple navboxes.
See also[edit source]
- Starfleet Logistics:Template namespace for an introduction to templates
- Starfleet Logistics:Requested templates for help in editing templates
- Starfleet Logistics:Categories, lists, and navigation templates, for an actual guideline on the subject
- Starfleet Logistics:Template messages, for other types of templates
- Starfleet Logistics:Manual of Style/Infoboxes
- Starfleet Logistics:Article series, related information
- Starfleet Logistics:Series templates, related information
- Starfleet Logistics:A navbox on every page, an essay
- Starfleet Logistics:Not everything needs a navbox, another essay
- Starfleet Logistics:Navigational boxes redirects here; to view the historical archive, see Starfleet Logistics:Navigational boxes (archive)
- Starfleet Logistics:Redirect#Bypass redirects in navigational templates
- Starfleet Logistics:WikiProject Navigation templates
- {{Quicktemplates}}, a table of templates
- {{Starfleet Logistics editor navigation}}, an amalgamation of navboxes
Collapsible | Header color | Image | Groups | Style (body) parameter/s |
Examples | |
---|---|---|---|---|---|---|
{{Navbox}} | collapsible | navbox | Left/right of body | Yes | Yes | |
{{Navbox with collapsible groups}} | collapsible | navbox | Left/right of body and/or in each list | Yes | Yes |
|
{{Navbox with columns}} | collapsible | navbox | Left/right of columns | No | Yes |
Type | CSS classes | JavaScript | Collapses when | Custom initial state |
Nesting |
---|---|---|---|---|---|
Collapsible tables | collapsible | Defined in Common.js | 2 or more autocollapse on page | Yes | Yes |