WikiIndex:Naming conventions: Difference between revisions

Jump to navigation Jump to search
Template:Not, improve and expand
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]]

Navigation menu