Difference between revisions of "Help:Contents"

From Discovery Wiki
Jump to navigationJump to search
Line 38: Line 38:
 
==The following need to be discussed==
 
==The following need to be discussed==
  
===Page (Article) Naming Conventions===
 
The following are the options
 
*Capitalizing the first letter only (The article name)
 
*Capitalizing all the first letters of the words (The Article Name)
 
*Have all small letters (the article name)
 
  
Another point I'd like to see clarified is that should the page names have full names? e.g.
 
* 'Dresden System' instead of Dresden
 
* 'Ronneburg Base' instead of Ronneburg
 
 
'''Discussion:''' I think we should go with all first caps (The Article Name) since most of the pages are already following that format. I'm all for using the full name and use the piping technique in linking.
 
[[User:Looqas|Looqas]] 15:12, 6 August 2008 (GMT)
 
 
:I agree. However the main reason that most pages are like that are because most of the pages are using proper names. As such I personally have been making sure each word is first-letter-capitalized, and it seems that other people have followed the idea. In addition to these points is, I think that page titles should have any proper nouns capitalized. But this causes problems when "of" or "a" are part of the title. To fix that inconsistency I suggest we use the "All First Letters Caps" approach.
 
 
:I do know of other Wiki editors who would prefer to use the "First letter caps" approach, so to me this issue is not resolved.
 
 
:The importance of having this issue resolved can be seen in the usage of: [[New York System]] versus [[New York system]]. Wiki capitalizes the first letter of '''any''' link. And any subsequent capitals will change the link. "[[New York system]]" is a different page to "[[New York System]]" In short, capitals matter.[[User:Chovynz|Chovynz]] 16:14, 6 August 2008 (GMT)
 
  
 
===Linking to existing pages===
 
===Linking to existing pages===

Revision as of 16:48, 6 August 2008

Introduction

This wiki uses MediaWiki. For a more detailed overview about editing please consult the MediaWiki Handbook or Wikitext example page.

Editing basics

Opening the edit page

To start editing a page, click on the "Edit" link at the top of the article. You will come to a page with a textbox with the wikitext of the article.

Summarize your edits

Below the textbox, there's a field where you can summarize your edits.

Preview before saving

Before saving your changes, it's a good idea to look how your changes will look. Repeat the process of edit/preview until your satisfied of the result, then click the "Save"-button and the changes will be made to the article.

Wikitext - How to make the page look the way you want

Basic text formatting

What it looks like What you write
You can italicize text by putting two apostrophes on each side.

Three apostrophes will bold the text.

Five apostrophes will bold and italicize the text.

You can ''italicize text'' by putting two apostrophes on each side.

Three apostrophes will '''bold the text'''.

Five apostrophes will '''bold''' and ''italicize'' '''''the text'''''.

The following need to be discussed

Linking to existing pages

Linking technique

There are variations.

Repeating the linking in an article

I find it a bit tedious to read if all the words are linked, so it could be

  • First encounters in the whole article of the word should be linked?
  • First encounter in a paragraph should be linked?
  • Sprinkle them using common sense?


Discussion: One the first point: Personally I like links to be like of last format of linking since it's explicit and works in all cases allowing also to make the link text to be anything you like.

On the second point: Somehow I think sprinkling could be the best solution. Once in a paragraph is enough I think. If the article is long then it makes sense to have the linking done several times. Looqas 15:12, 6 August 2008 (GMT)

Perhaps "Sprinkle" with only one link of any particular word per article would do the trick? So for example, if there is a link in a Ships statistics for Corsairs then there need be no other Corsairs links on the page.Chovynz 16:14, 6 August 2008 (GMT)

Writing style conventions

  • Are we gonna capitalize the text that are links e.g.

...this will lead to Jump Hole... or should we stick to English ...this will lead to jump hole...

  • In-universe or out-of-universe style?

Discussion: I'm inclined to using the small letters, but whatever... Looqas 15:12, 6 August 2008 (GMT)

Same here. Just use the pipelines (linking technique of the link|name). And I don't really understand the difference between In-Universe versus Out-of-Universe. That's a Praetyre thing. Praetyre! please explain it to us!Chovynz 16:14, 6 August 2008 (GMT)

Page composition and templates

Page types

These are types that come to my mind and all should have some sort of common template of layout. We should have links into each page type in this very guide after we have decided upon a format.

  • Ships, e.g. Odin Very heavy fighter (and their info boxes)
  • Systems, e.g. New York System (I like this page and it looks good)
  • Indivual pages for NPC Factions. All we have now is all of them grouped together NPC Factions
  • Terms and definitions, e.g.[[Trade Lane|Trade Lane] (This is one of the page types I'd like to see more clarification on since we have multiple formats there)
  • Misc pages

Templates

A long list of links to different templates below. Basically we should have some sort of template to cover all the page types.

  • Template for systems
  • Template for ships

etc.

Discussion: The list contains only of a few that came into my mind quickly. Looqas 15:12, 6 August 2008 (GMT)

Here are some that I have used. Bear in mind that as templates are being developed the things that we base them off will change. Case in point, Blodo has made a new actual template that renders my ship one obsolete. So this list would need to be updated to let people know which template to use. The good thing about using Blodos one is that any ship page that uses that template can easily and quickly be layout or style changed whilst still keeping the info, by only changing the template. Using my own, thats not possible, and it also means that any ship pages has to be converted to the Blodos one. The good thing about the ships issue specifically is that the info is already ON the wiki so it shouldnt take too much time to convert them. Chovynz 16:14, 6 August 2008 (GMT)

Using Categories

Discussion: Should we included categories in all the pages? My personal opinion is yes. It would help. Looqas 15:12, 6 August 2008 (GMT)

Definitely yes.Chovynz 16:14, 6 August 2008 (GMT)