Page naming guide
Page naming guide (project)(alpha test)
You can add your comment, additions etc.
Warning: This is project of page by OCE with help of external (CC) and (C) sources not mentioned yet, so this page CAN'T be launched before completing this or will break rules. For now for editing purposed only.
to jest jakis tekst
Page Naming Guide
Page naming for the Shareaza Wiki is relatively straightforward, but it's important you get it correct.
General conventions
Capitalization
Page names should use sentence style capitalization (only capitalize the first word and any proper nouns) rather than headline style capitalization:
- Correct: "A new method for creating Shareaza plugins"
- Incorrect: "A New Method for Creating Shareaza Plugins"
Translated page
Translated page is named as English one followed by "/LanguageSufix":
- Correct: "Main/pl"
- Incorrect: "plMain" or "pl/Main
Sufixes are used by Template:Languages to generate box like this one:
Languages: |
English • Deutsch • Español • Français • עברית • Italiano • Nederlands • Polski • Português • Русский • 中文(繁體) | e |
for identification of page language and displaying link in box created by template on page.
Every language got own and unique sufix:
- /pl - Polish
- /fr - French
- /sp - Spanish
(this list ought to be completed)
Please note that in case you are creating a page with a unique title in a non-English language, this title should be in English and be followed by the correct language suffix in order to make translations possible at a later time.
Translation of page ought to be done translating from English page. In case of doubts in content English version prevails, and normally translated page should be corrected according to English one.
One-page articles
Content with a unique title
If you are adding an article or other content that only requires a single page in the wiki, simply use the name of that article as the page name.
For example, the page for a one-page article called "A new approach to Shareaza plugins" would be, simply A new approach to Shareaza plugins. So long as your content title is unique, this is the easiest and preferred approach, but please remember only in that case.
Content with a non-unique title
Wherever possible, you should try to create content with unique titles, in order to simplify the page naming as much as possible. If this is impossible, prefix the title with the topic, followed by a colon and no spaces.
For example, if I needed to add a page called "Optimization", simply calling the page "Optimization" would create a possible conflict as Optimization can apply to a wide variety of topics within the wiki. If my Optimization article was specifically about download, I would expand my title so it is unique (ie: download optimization).
It is a best-practice within this wiki to have unique article titles wherever possible.
Multiple-page content
If the content you are adding to the wiki requires multiple pages, use the following page naming method.
- Learning plugin - Main table-of-contents page
- Learning plugin/Introduction
- Learning plugin/A user's view
- Learning plugin/More advanced scripting
- Learning plugin/Next steps
If you don't use the pathname-like hierarchy depicted here, your articles will all be located at the top of the hierarchy, instead of nested.
Comments
Added one necessary line. BTW, Oce, why don't you use Wiki formatting in here? Any special reason for that? Old death 21:41, 7 March 2010 (UTC)
- Because I am lazy, should do it. Have you seen how list look like? Underscores in page names? 13:19, 8 March 2010 (UTC)
- Underscores in page names: Shareaza Settings and Shareaza_Settings link to the same page... If you create a new page, use underscores; when linked from within the Wiki, these underscores are not needed however... BTW, to sign your comments, you can type 4 tides ('~') in a row. mfg, Old death 01:42, 8 March 2010 (UTC)
- I think underscores force not to loose any character as it could lead to wrong linking. If they are transparent then it is good, and also they shows this is link address, not a text. If that works for searching so give the same search result then it is ok IMHO.
- Underscores in page names: Shareaza Settings and Shareaza_Settings link to the same page... If you create a new page, use underscores; when linked from within the Wiki, these underscores are not needed however... BTW, to sign your comments, you can type 4 tides ('~') in a row. mfg, Old death 01:42, 8 March 2010 (UTC)