WikiIndex:Naming conventions: Difference between revisions
Hoof Hearted (talk | contribs) m (→WikiIndex category names: neutralise language) |
Hoof Hearted (talk | contribs) (Template:Not, improve and expand) |
||
| Line 1: | Line 1: | ||
{{TOCright}} | {{TOCright}} | ||
{{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 | 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 | *We normally name the page here on WikiIndex the same as the actual [[wiki]] being referenced. | ||
* We normally | *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 | *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=== | |||
*[[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 | 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.)--> | |||
;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 | |||
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--> | |||
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). Examples include: | |||
*Community portal – [[WikiIndex:Community portal]] | |||
*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 | 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| | |||
[[Category:WikiIndex]] | [[Category:WikiIndex]] | ||
[[Category:Guidelines|Naming]] | [[Category:Guidelines|Naming]] | ||
Revision as of 14:52, 8 July 2018
- 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
- 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
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:
- Community portal – WikiIndex:Community portal
- Current events – WikiIndex:Current events
- Frequently asked questions (aka FAQ) – WikiIndex:FrequentlyAskedQuestions
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).