WikiIndex:Naming conventions: Difference between revisions

From WikiIndex
Jump to navigation Jump to search
m (Reverted edits by ABIDEEN0 (talk) to last revision by Hoof Hearted)
(Wikilinks, dictionary definitions, cleanup grammar)
 
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
:''Not to be confused with [[WikiIndex:Namespace Conventions]].
{{Not|WikiIndex: Namespace conventions}}{{TOC right}}
{{TOCright}}
'''de:''' [[WikiIndex: Namenskonventionen]], '''fr:''' [[WikiIndex: Conventions Nommage]]
==WikiIndex page names for wiki pages==
----
If you want to [[WikiIndex:Add a Wiki|Add a Wiki]] to [[WikiIndex]], the new page should be named according to the following naming conventions:
==WikiIndex page names for wiki sites==
If you want to [[WikiIndex:Add a Wiki|add a wiki site]] to {{tag|WikiIndex}}, the new page here on [[:Category:All|WikiIndex]] ''should'' be {{Cambridge-Dictionary|name}}d according to the following '''WikiIndex naming conventions''':


;First of all, don't worry if you get it wrong!  We can [[Special:MovePage|rename]] pages.
;First of all, do not worry if you get it wrong!  We can [[Template:Rename|rename]] article pages (though not easily [[Special:Categories|categories]]).
*We normally have the page here at WikiIndex the same as the actual [[wiki]] being referenced.
#We normally name the article page here on WikiIndex the same as the <u>actual</u> [[wiki]] site being referenced.
*We normally don't include the domain, such as '.com' or '.org', or other [[wp:top-level domain|top-level domain]] (TLD).  Exceptions to this are when two similar [[WhatIsWiki|wikis]], with identical primary names, but have differing TLDs; such as [[Wikkii.com]] and [[Wikkii.Org]].
#We normally do <u>not</u> include the {{Cambridge-Dictionary|domain}}, such as '{{Wp|.com}}' or '{{Wp|.org}}', or other {{Wp|top-level domain}} (TLD).  {{Cambridge-Dictionary|exception|Exceptions}} to this are when two similar [[WhatIsWiki|wiki sites]] (or wiki services), with identical primary names, but have differing TLDs.  {{Cambridge-Dictionary|notable|Notable}} examples here on WikiIndex include: [[Wikkii.com]] and [[Wikkii.Org]]; [[GamePedia.org]] and [[:Category:Gamepedia.com|Gamepedia.com]]; and [[:Category:Wikidot.com|Wikidot.com]] (wiki farm), [[:Category:Wikidot.org|Wikidot.org]] (wiki engine), and [[:Category:Wikidot Inc.|Wikidot Inc.]] (wiki company).
*We normally don't include the word 'wiki' at the end, unless the name of the wiki specifically includes 'wiki'.
#We normally do <u>not</u> include the word 'wiki' anywhere in the article name (nor at the end), <u>unless</u> the actual name of the wiki specifically includes the word 'wiki'.


===Example names===
===Some example names===
*[[Wikitravel]]
*[[Wikitravel]]
*[[KayakWiki]]
*[[KayakWiki]]
Line 15: Line 16:
*[[ReefPedia]]
*[[ReefPedia]]
*[[Protocolinfo]]
*[[Protocolinfo]]
*{{Cambridge-Dictionary|etc}}.


However, you will notice that our own wiki has its own internal naming conventions confusion. [[WikiIndex]] and [[Wiki Index]].  Cheers!
==Multiple language versions==
For a series of wikis with <u>separate</u> wiki sites available in individual specific written [[:Category:Wiki language|languages]] (such as [[:Category:Wikipedia|Wikipedia]]), they should get a separate article page for each language version wiki site here on WikiIndex, as follows.
<!-- grammar below needs updating to neutral encyclopædic standard -->
#Create one main 'mother' page (similar, though <u>not</u> the same as {{Cambridge-Dictionary|disambiguation}} pages found on the [[English Wikipedia]]) for an {{Cambridge-Dictionary|overview}} of the whole series of wiki sites (which may sometimes include a '[[:Category:Portal|portal]]' url, e.g. <tt><nowiki>www.Wikipedia.org</nowiki></tt>)Use the {{Template|Multilingual main}} (with the pink border) to generate a simplified overview infobox, and {{Template|Language versions}} (if able to appropriately support the required {{Cambridge-Dictionary|schema}}) to create navigational links to all available languages.
#Then create one individual article page for each separate wiki site for each language version.


==multiple language versions==
The main 'mother' or overview page follows the usual naming {{Cambridge-Dictionary|convention}}s, and gets categorised (via the language field in the [[template: Multilingual main]] infobox template) as <code>language = [[:Category:Wiki Multilingual|Multilingual]]</code>.  The individual wiki site article pages <u>may</u> be named by using the main page name together with the {{Wp|ISO 639|ISO 639 code of the language}} appended within brackets.<!--There should be an automatically generated breadcrumb navigation that leads you back to the main page.  (This way we can have clear and differentiated information on the wiki with individual size/statistics measures for example and the page names have a logical, machine friendly structure. (- Appending three characters to the path/URL of a wikis main page gives you the appropriate subpage for a special language version.) At least the naming may be understood without knowledge of the particular language.)-->
Wiki sites with separate wikis written in individual [[:Category:Wiki Language|languages]] should get a separate page for each language version in the catalogue here.


Create one main page for an overview of the whole thing, and one subpage to that for each language version.  The main page follows the usual naming conventions and gets tagged as <code>language = [[:Category:Wiki Multilingual|Multilingual]]</code>, the subpages get the name of the main page with the [[wp:ISO 639|ISO code of the language]] appended after either a slash, dash or within brackets. <!--There should be an automatically generated breadcrumb navigation that leads you back to the main page.  (This way we can have clear and differentiated information on the wiki with individual size/statistics measures for example and the page names have a logical, machine friendly structure. (- Appending three characters to the path/URL of a wikis main page gives you the appropriate subpage for a special language version.) At least the naming may be understood without knowledge of the particular language.)-->
===Example, ISO 639 identifier===
*[[JurisPedia]] — overview 'mother' article, including [[template: Multilingual main]] (infobox), [[template: Language versions]] (hatnote quick navigation), and [[template: JurisPedia]] (article navigation template, usually a footnote);
**[[JurisPedia (ar)]] — Arabic language wiki article, including only [[template: JurisPedia]];
**[[JurisPedia (de)]] — German language wiki article, including only [[template: JurisPedia]];
**[[JurisPedia (en)]] — English language wiki article, including only [[template: JurisPedia]];
**{{Cambridge-Dictionary|etc}}.


*Example: [[Ekopedia/en]]
To link from the main mother page to the article pages, there is the {{Template|Language versions}}, although this template provides no reverse navigation, or {{Cambridge-Dictionary|breadcrumb-navigation|'breadcrumbs' links}}.<!--this template fails to provide reverse breadcrumb navigation back to the Multilingual main page-->


To link from the main page to the subpages there is the [[Template:Language versions|template ''language versions'']].
===Longhand English-spelling identifier===
An alternative and now {{Cambridge-Dictionary|preferred}} method of naming article pages is by using the specific language name in the {{Cambridge-Dictionary|longhand}} {{Cambridge-Dictionary|english|English}} example of the wiki site language; [[:category: Wikipedia]] (and its individual wiki sites) is a significant example of this {{Cambridge-Dictionary|schema}}.
 
===Navigation template===
Irrespective of which article naming method is used, it is strongly recommended to {{Cambridge-Dictionary|supplement}} all wiki articles within the specific series or 'project' with an [[:Category:Article templates|article 'navigation' template]].  In its simplest form, an article template will contain a collection of [[wikilink]]s to all other wiki articles from the same series, as shown in [[template: Ardapedia]].  A more complex article template can also include a detailed {{Cambridge-Dictionary|prose}} description of the entire wiki series, as shown in [[template: Wikipedia]].


==Internal page names==
==Internal page names==
*Currently we are [[CamelCase]] or [[Free links]] or both (as a note, [[:Category:MediaWiki|MediaWiki]] is inherently confused on internal page naming).
WikiIndex is using [[CamelCase]] ''or'' [[free link]]s (as an article naming {{Cambridge-Dictionary|schema}}), or both (as a note, [[:Category:MediaWiki|MediaWiki]] itself is inherently confused on internal page naming). Examples include:
**Recent changes – Special:RecentChanges
*Community portal [[WikiIndex:Community portal]]
**Community Portal – Community Portal
*Current events [[WikiIndex:Current events]]
**Current Events – Current events
*Frequently asked questions (aka FAQ) – [[WikiIndex:Frequently asked questions]]
For all <u>new</u> article pages here on WikiIndex, please respect the specific naming convention of the <u>actual wiki site name</u> we are referencing.


----
==WikiIndex category names==
'''de:''' [[WikiIndex:Namenskonventionen]], '''fr:''' [[WikiIndex:Conventions Nommage]]
There was previously a debate over whether to make [[Special:Categories|category]] names {{Cambridge-Dictionary|singular}} or {{Cambridge-Dictionary|plural}}, at [[WikiIndex talk:Community portal#singular versus plural]].  For example, should we use <tt>Category:Languages</tt> or <tt>[[:Category:Language]]</tt>?  It should be noted however, it is generally accepted that a [[category]] <u>should</u> contain ''more'' than one article on its subject matter, so following on from that {{Cambridge-Dictionary|logic}}, pluralised naming of categories is a {{Cambridge-Dictionary|moot}} point.
 
Crucially, here at WikiIndex, we regularly [[wikilink]] to a category within the {{Cambridge-Dictionary|prose}} of other articles to provide subject information, generally by way of using our {{Template|tag}} template.  This means that in order to maintain {{Cambridge-Dictionary|grammatically}} correct prose from the 'simplest' of links, [[categories]] <u>should</u> be named singular!  However, {{Cambridge-Dictionary|common-sense|common sense}} should also {{Cambridge-Dictionary|prevail}} – if a singular name for a category just does not 'sound' correct, use the plural.
 
==Other FAQs==
Questions about naming are some of the top [[WikiIndex:Frequently asked questions|frequently asked questions]] (FAQs).


[[Category:WikiIndex]]
[[Category:Guidelines|Naming]]
[[Category:Guidelines|Naming]]
__INDEX__

Latest revision as of 03:24, 20 July 2023

Not to be confused with WikiIndex: Namespace conventions

de: WikiIndex: Namenskonventionen, fr: WikiIndex: Conventions Nommage


WikiIndex page names for wiki sites

If you want to add a wiki site to WikiIndex, the new page here on WikiIndex should be named according to the following WikiIndex naming conventions:

First of all, do not worry if you get it wrong! We can rename article pages (though not easily categories).
  1. We normally name the article page here on WikiIndex the same as the actual wiki site being referenced.
  2. We normally do not include the domain, such as '.com' or '.org', or other top-level domain (TLD). Exceptions to this are when two similar wiki sites (or wiki services), with identical primary names, but have differing TLDs. Notable examples here on WikiIndex include: Wikkii.com and Wikkii.Org; GamePedia.org and Gamepedia.com; and Wikidot.com (wiki farm), Wikidot.org (wiki engine), and Wikidot Inc. (wiki company).
  3. We normally do not include the word 'wiki' anywhere in the article name (nor at the end), unless the actual name of the wiki specifically includes the word 'wiki'.

Some example names

Multiple language versions

For a series of wikis with separate wiki sites available in individual specific written languages (such as Wikipedia), they should get a separate article page for each language version wiki site here on WikiIndex, as follows.

  1. Create one main 'mother' page (similar, though not the same as disambiguation pages found on the English Wikipedia) for an overview of the whole series of wiki sites (which may sometimes include a 'portal' url, e.g. www.Wikipedia.org). Use the {{Multilingual main}} (with the pink border) to generate a simplified overview infobox, and {{Language versions}} (if able to appropriately support the required schema) to create navigational links to all available languages.
  2. Then create one individual article page for each separate wiki site for each language version.

The main 'mother' or overview page follows the usual naming conventions, and gets categorised (via the language field in the template: Multilingual main infobox template) as language = Multilingual. The individual wiki site article pages may be named by using the main page name together with the ISO 639 code of the language appended within brackets.

Example, ISO 639 identifier

To link from the main mother page to the article pages, there is the {{Language versions}}, although this template provides no reverse navigation, or 'breadcrumbs' links.

Longhand English-spelling identifier

An alternative and now preferred method of naming article pages is by using the specific language name in the longhand English example of the wiki site language; category: Wikipedia (and its individual wiki sites) is a significant example of this schema.

Navigation template

Irrespective of which article naming method is used, it is strongly recommended to supplement all wiki articles within the specific series or 'project' with an article 'navigation' template. In its simplest form, an article template will contain a collection of wikilinks to all other wiki articles from the same series, as shown in template: Ardapedia. A more complex article template can also include a detailed prose description of the entire wiki series, as shown in template: Wikipedia.

Internal page names

WikiIndex is using CamelCase or free links (as an article naming schema), or both (as a note, MediaWiki itself is inherently confused on internal page naming). Examples include:

For all new article pages here on WikiIndex, please respect the specific naming convention of the actual wiki site name we are referencing.

WikiIndex category names

There was previously a debate over whether to make category names singular or plural, at WikiIndex talk:Community portal#singular versus plural. For example, should we use Category:Languages or Category:Language? It should be noted however, it is generally accepted that a category should contain more than one article on its subject matter, so following on from that logic, pluralised naming of categories is a moot point.

Crucially, here at WikiIndex, we regularly wikilink to a category within the prose of other articles to provide subject information, generally by way of using our {{tag}} template. This means that in order to maintain grammatically correct prose from the 'simplest' of links, categories should be named singular! However, common sense should also prevail – if a singular name for a category just does not 'sound' correct, use the plural.

Other FAQs

Questions about naming are some of the top frequently asked questions (FAQs).