WikiIndex:Naming conventions: Difference between revisions

From WikiIndex
Jump to navigation Jump to search
(Wikilinks, dictionary definitions, cleanup grammar)
 
(37 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== WikiIndex page names for wiki pages ==
{{Not|WikiIndex: Namespace conventions}}{{TOC right}}
If you want to [[Add a Wiki]] to WikiIndex, the new page should be named according to the following naming conventions:
'''de:''' [[WikiIndex: Namenskonventionen]], '''fr:''' [[WikiIndex: Conventions Nommage]]
----
==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 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 name the article page here on WikiIndex the same as the <u>actual</u> [[wiki]] site being referenced.
#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 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'.


* We normally have the page at WikiIndex the same as the wiki being referenced.
===Some example names===
* We normally don't include the '.com' or '.org'  or other TLD.
*[[Wikitravel]]
*[[KayakWiki]]
*[[Homestar Runner Fanstuff Wiki]]
*[[ReefPedia]]
*[[Protocolinfo]]
*{{Cambridge-Dictionary|etc}}.


=== Example names ===
==Multiple language versions==
* [[Wikitravel]]
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.
* [[KayakWiki]]
<!-- grammar below needs updating to neutral encyclopædic standard -->
* [[Homestar Runner Fanstuff Wiki]]
#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.
* [[ReefPedia]]
#Then create one individual article page for each separate wiki site for each language version.
* [[Protocolinfo]]


However, you will notice that our own wiki has its own internal naming conventions confusion. [[WikiIndex]] and [[Wiki Index]]. Cheers!
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.)-->


== multiple language versions ==
===Example, ISO 639 identifier===
<span style="color: red; font-size: large;">'''Proposal:'''</span>
*[[JurisPedia]] — overview 'mother' article, including [[template: Multilingual main]] (infobox), [[template: Language versions]] (hatnote quick navigation), and [[template: JurisPedia]] (article navigation template, usually a footnote);
<div style="background-color: #FFFFAA; border: thin dotted black;">Wiki sites with separate wikis for individual languages should get a separate page for each language version in the catalogue here.<br/>
**[[JurisPedia (ar)]] — Arabic language wiki article, including only [[template: JurisPedia]];
(Advantages: Clear and differentiated information on the wiki with individual size/statistics measures for example.)
**[[JurisPedia (de)]] — German language wiki article, including only [[template: JurisPedia]];
**[[JurisPedia (en)]] — English language wiki article, including only [[template: JurisPedia]];
**{{Cambridge-Dictionary|etc}}.


I propose to have one main page for the whole thing and a subpage to that - one for each language version. For the subpages I suggest a unified naming pattern: ISO language codes. Then there should be an automatically generated breadcrumb navigation that leads you back to the main page.<br/>
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-->
(Advantages: 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: [[Ekopedia/en]]
===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}}.


&rarr; ''Please comment! especially objections to making this the new standard/recommendation - either here, on the talk page here - or maybe even on my talk page...'' &larr;</div>
===Navigation template===
--[[User:Speckmade|Speckmade]] 17:32, 29 January 2009 (EST)
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]].


:Hi Speckmade. This proposal seems reasonable to me. I'd like to know if there are any disadvantages, though.
==Internal page names==
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:
*Community portal – [[WikiIndex:Community portal]]
*Current events – [[WikiIndex: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.


:Here are my thoughts. Subpages automatically have a link back to the main page right at the top. Would breadcrumb navigation back to the main page still be helpful or would it be redundant? Also, do most wiki engines calculate legitimate content pages for each language separately or do they calculate them all in the aggregate? I presume we would link from the main page to the subpages. If so, I would hope that the link to the each language's subpage includes its name, even if we use the ISO code for the actual <nowiki>{{PAGENAME}}</nowiki> of the subpage. I doubt most people would recognize a language by its ISO code alone.
==WikiIndex category names==
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.


:--[[User:MarvelZuvembie|MarvelZuvembie]] 16:31, 13 March 2009 (EDT)
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.
:: I can't think of disadvantages at the moment...
:: With the "Subpages automatically [...] link[ing] back to the main page right at the top" you refer to my example implementation? If so, actually ''this is'' the (simulation of) the breadcrumb navigation...
:: content page counters: If each language version of a wiki runs on its own wiki installation, then they usually get counted seperately. My proposal was thought for that case.
:: And of course we should link from the main page to the language version pages - and of course we should make the links readable for humans; the ISO code thing is just to have a clear naming scheme for those subpages.--[[User:Speckmade|Speckmade]] 12:57, 2 May 2009 (EDT)


:::OK, that sounds good to me. --[[User:MarvelZuvembie|MarvelZuvembie]] 21:48, 4 May 2009 (EDT)
==Other FAQs==
Questions about naming are some of the top [[WikiIndex:Frequently asked questions|frequently asked questions]] (FAQs).


== Internal page names ==
[[Category:Guidelines|Naming]]
* Currently we are [[CamelCase or Free links or both]] (As a note, MediaWiki is inherently confused on internal page naming)
__INDEX__
** Recent changes – Special:Recentchanges
** Community Portal – Community_Portal
** Current Events – Current_events
 
[[Category:Guidelines]]
 
[[fr:WikiIndex:Conventions Nommage]]
[[de:WikiIndex:Namenskonventionen]]

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).