WikiIndex:Naming conventions: Difference between revisions

From WikiIndex
Jump to navigation Jump to search
m (→‎WikiIndex category names: neutralise language)
(Template:Not, improve and expand)
Line 1: Line 1:
{{TOCright}}
{{TOCright}}
:''Not to be confused with [[WikiIndex:Namespace conventions]].
{{Not|WikiIndex:Namespace conventions}}
'''de:''' [[WikiIndex:Namenskonventionen]], '''fr:''' [[WikiIndex:Conventions Nommage]]
'''de:''' [[WikiIndex:Namenskonventionen]], '''fr:''' [[WikiIndex:Conventions Nommage]]


==WikiIndex page names for wiki pages==
==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:
If you want to [[WikiIndex:Add a Wiki|add a wiki]] to {{tag|WikiIndex}}, the new page should be named according to the following naming conventions:


; First of all, don't worry if you get it wrong!  We can [[Special:MovePage|rename]] pages (not easily [[Special:Categories|categories]]).
;First of all, don't worry if you get it wrong!  We can [[Special:MovePage|rename]] pages (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 page here on WikiIndex the same as the actual [[wiki]] 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 not 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 don't include the word 'wiki' at the end, unless the name of the wiki specifically includes 'wiki'.
*We normally do not include the word 'wiki' at the end, unless the actual name of the wiki specifically includes the word 'wiki'.
 
===Example names===
* [[Wikitravel]]
* [[KayakWiki]]
* [[Homestar Runner Fanstuff Wiki]]
* [[ReefPedia]]
* [[Protocolinfo]]


===Some example names===
*[[Wikitravel]]
*[[KayakWiki]]
*[[Homestar Runner Fanstuff Wiki]]
*[[ReefPedia]]
*[[Protocolinfo]]
However, you will notice that our own wiki has its own internal naming conventions confusion. [[WikiIndex]] and [[Wiki Index]].  Cheers!
However, you will notice that our own wiki has its own internal naming conventions confusion. [[WikiIndex]] and [[Wiki Index]].  Cheers!


==Multiple language versions==
==Multiple language versions==
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.
Wiki sites with <u>separate</u> wikis written in individual specific [[:Category:Wiki Language|languages]] should get a separate page for each language version here on WikiIndex, as follows.
<!-- grammar below needs updating to neutral encyclopædic standard -->
Create one main 'mother' page for an overview of the whole thing (which may sometimes include a '[[:Category:Portal|portal]]' url), use the [[template:MultilingualMain]] to generate a simplified overview infobox, and [[template:Language versions]] to create navigational links to all available languages; and then one sub-page to that for each language version.  The main page follows the usual naming conventions and gets categorised (via the MultilingualMain template) as <code>language = [[:Category:Wiki Multilingual|Multilingual]]</code>, the sub-pages are 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.)-->


Create one main page for an overview of the whole thing (which usually includes a '[[:Category:Portal|portal]]' url), using the [[template:MultilingualMain]] to generate the infobox; and one subpage to that for each language version.  The main page follows the usual naming conventions and gets categorised (via the MultilingualMain template) 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 <s>slash</s>, 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
*[[JurisPedia]] — overview mother article, including [[template:MultilingualMain]], [[template:Language versions]], and [[template:JurisPedia]] (article template)
**[[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]]
**etc


*Example: [[JurisPedia (en)]]
To link from the main mother page to the sub-pages, there is the [[Template:Language versions|template ''language versions'']], although this template provides no reverse navigation, or 'breadcrumbs' links.<!--this template fails to provide reverse breadcrumb navigation back to the MultilingualMain page-->


To link from the main page to the subpages there is the [[Template:Language versions|template ''language versions'']], although this template provides no reverse navigation links.<!--this template fails to provide reverse breadcrumb navigation back to the MultilingualMain page-->
An alternative method of naming pages is by using their specific common name in their mother language, as listed in [[:category:Wikipedia]].
 
Irrespective of which article naming method is used, it is strongly recommended to supplement all wiki articles within the specific series with an [[:Category:Article templates|article 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 description of the entire wiki series, as shown in [[template:Wikipedia]].


==Internal page names==
==Internal page names==
*Currently we are using [[CamelCase]] or [[free link]]s, or both (as a note, [[:Category:MediaWiki|MediaWiki]] is inherently confused on internal page naming).  For all new pages, please respect the naming convention of the actual wiki we are referencing.
Currently we are using [[CamelCase]] or [[free link]]s, or both (as a note, [[:Category:MediaWiki|MediaWiki]] is inherently confused on internal page naming).  Examples include:
**Community portal – [[WikiIndex:Community portal]]
*Community portal – [[WikiIndex:Community portal]]
**Current events – [[WikiIndex:Current events]]
*Current events – [[WikiIndex:Current events]]
*Frequently asked questions (aka FAQ) – [[WikiIndex:FrequentlyAskedQuestions]]
For all <u>new</u> article pages, please respect the specific naming convention of the actual wiki we are referencing.


==WikiIndex category names==
==WikiIndex category names==
There has previously been 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]]?
There has previously been a debate over whether to make [[Special:Categories|category]] names singular or 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 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 {{template|tag}} template.  This means that in order to maintain grammatically correct prose from the 'simplest' of links, categories <u>should</u> 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==
==Other FAQs==
Questions about naming are some of the top
Questions about naming are some of the top [[WikiIndex:FrequentlyAskedQuestions|frequently asked questions]] (FAQs).
[[WikiIndex:FrequentlyAskedQuestions|FrequentlyAskedQuestions]].


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

Revision as of 14:52, 8 July 2018

Template:TOCright

Not to be confused with WikiIndex:Namespace conventions

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

WikiIndex page names for wiki pages

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

First of all, don't worry if you get it wrong! We can rename pages (not easily categories).
  • We normally name the page here on WikiIndex the same as the actual wiki being referenced.
  • 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 wikis, with identical primary names, but have differing TLDs; such as Wikkii.com and Wikkii.Org.
  • We normally do not include the word 'wiki' at the end, unless the actual name of the wiki specifically includes the word 'wiki'.

Some example names

However, you will notice that our own wiki has its own internal naming conventions confusion. WikiIndex and Wiki Index. Cheers!

Multiple language versions

Wiki sites with separate wikis written in individual specific languages should get a separate page for each language version here on WikiIndex, as follows. Create one main 'mother' page for an overview of the whole thing (which may sometimes include a 'portal' url), use the template:MultilingualMain to generate a simplified overview infobox, and template:Language versions to create navigational links to all available languages; and then one sub-page to that for each language version. The main page follows the usual naming conventions and gets categorised (via the MultilingualMain template) as language = Multilingual, the sub-pages are named by using the main page name together with the ISO 639 code of the language appended within brackets.

Example

To link from the main mother page to the sub-pages, there is the template language versions, although this template provides no reverse navigation, or 'breadcrumbs' links.

An alternative method of naming pages is by using their specific common name in their mother language, as listed in category:Wikipedia.

Irrespective of which article naming method is used, it is strongly recommended to supplement all wiki articles within the specific series with an article 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 description of the entire wiki series, as shown in template:Wikipedia.

Internal page names

Currently we are using CamelCase or free links, or both (as a note, MediaWiki is inherently confused on internal page naming). Examples include:

For all new article pages, please respect the specific naming convention of the actual wiki we are referencing.

WikiIndex category names

There has previously been 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).