Difference between revisions of "Project Gorgon Wiki:How to help"

From Project: Gorgon Wiki
Jump to: navigation, search
m (MediaWiki help links.)
m (F.A.Q.)
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{| style="margin:0 0 0.5em 1em; border:none; float:right; text-align:left; width:280px;" cellpadding="1"
+
{{TOCright}}
 +
{| style="margin:0 0 0.5em 1em; border:none; float:right; clear:right; text-align:left; width:230px;" cellpadding="1"
 
|-
 
|-
|style="background:#eeffee; border: 1px solid #cddccd; vertical-align: top;"|
+
|style="background: #eef8ff; border: 1px solid #cdd6dc; vertical-align: top;"|
<div style="background:#c9e4b8; padding:5px; margin:3px; font-weight:bold; text-align:center; font-size:120%;">Special Pages</div>
 
<div style="padding-left: 1em;">
 
[[Special:WantedFiles]] (missing images)
 
 
 
[[Special:LonelyPages|Orphaned Pages]]
 
 
 
[[Special:NewFiles]]<br/>
 
[[Special:ListFiles]]<br/>
 
[[Special:UnusedFiles]]
 
</div>
 
|-
 
| style="height:5px;"|
 
|-
 
|style="width: 25%; background: #eef8ff; border: 1px solid #cdd6dc; vertical-align: top;"|
 
 
<div style="background:#c1e2e2; padding:5px; margin:3px; font-weight:bold; text-align:center; font-size:120%;">MediaWiki Help</div>
 
<div style="background:#c1e2e2; padding:5px; margin:3px; font-weight:bold; text-align:center; font-size:120%;">MediaWiki Help</div>
 
<div style="padding-left:1em;">
 
<div style="padding-left:1em;">
Line 30: Line 17:
 
; Discussion
 
; Discussion
 
: [http://en.wikipedia.org/wiki/Help:Using_talk_pages Using talk pages]
 
: [http://en.wikipedia.org/wiki/Help:Using_talk_pages Using talk pages]
: Advanced
+
; Advanced
; [http://www.mediawiki.org/wiki/Help:Magic_words Magic words]
+
: [http://www.mediawiki.org/wiki/Help:Magic_words Magic words]
 
; Extensions
 
; Extensions
: [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) DynamicPageList]
 
 
: [http://semeb.com/dpldemo/index.php?title=DPL:Manual The &lt;DPL&gt; tag]
 
: [http://semeb.com/dpldemo/index.php?title=DPL:Manual The &lt;DPL&gt; tag]
 +
</div>
 +
|-
 +
| style="height:5px;"|
 +
|-
 +
|style="background:#eeffee; border: 1px solid #cddccd; vertical-align: top;"|
 +
<div style="background:#c9e4b8; padding:5px; margin:3px; font-weight:bold; text-align:center; font-size:120%;">Special Pages</div>
 +
<div style="padding-left: 1em;">
 +
[[Special:WantedFiles]]
 +
 +
[[Special:LonelyPages|Orphaned Pages]]
 +
 +
[[Special:NewFiles]]<br/>
 +
[[Special:ListFiles]]<br/>
 +
[[Special:UnusedFiles]]
 
</div>
 
</div>
 
|-
 
|-
Line 40: Line 40:
 
|}
 
|}
  
==How do I edit?==
+
==Welcome to the Wiki==
This wiki uses the '''MediaWiki''' platform. If you are new to MediaWiki, see the Help articles on the sidebar.
+
Welcome to the Project Gorgon Wiki. If you found this page, it probably means you want to contribute.
  
Most importantly don't let the wiki editing get into your enjoyment of the game! Set some time aside to wind down and just play. One way I do it is to take captures with [http://www.fraps.com/ FRAPS] and review them later in [http://www.xnview.com/en/ XnView]. [http://capture2text.sourceforge.net/ Capture2Text] is very handy to grab text from an image and put it into the clipboard (saves typing).
+
==First Steps==
  
==Talk Pages==
+
Setup your personal and talk pages, when you first log in, you will see your username and 'Talk' in the upper right corner click those to create your pages. Even if they are blank, this makes it easier for others to contact you. It also allows for easy collaboration when working on large projects.
Please have a brief read of [http://www.mediawiki.org/wiki/Help:Talk_pages#Editing_conventions_on_talk_pages MediaWiki Help on Talk Pages]. '''Signatures, indents, and topics''' (headings) in Talk Pages make it easier to see how the discussion is going and who has last replied, not just for the person you respond to, but any future editors who want to get up to date on the history of an article.
 
  
Ideally, replies to someone in any Talk Page should generate a notification, however it may not work on this wiki yet (we'll have to ask devs to add required extensions). Either way, structuring talk pages is very helpful.
+
Please have a brief read of [http://www.mediawiki.org/wiki/Help:Talk_pages#Editing_conventions_on_talk_pages MediaWiki Help on Talk Pages]. '''Signatures, indents, and topics''' (headings) in Talk Pages make it easier to see how the discussion is going and who has last replied, not just for the person you respond to, but any future editors who want to get up to date on the history of an article.  
  
==Where to Help==
+
Consider '''watching''' talk pages (click the star) which you are participating in, as they will be highlighted in the [[Special:RecentChanges]].
The following areas of the wiki need the most help:
 
  
<div style="background:#f8f8e8;border:1px solid #ccc;padding:5px;">
+
Next, it will be helpful to familiarize yourself with some of the information to the right. This wiki uses the '''MediaWiki''' platform. If you are new to MediaWiki, some Help articles can be found on the sidebar. You can edit the wiki if you are logged into forum account.  Please click that, and create a page about yourself, and a Talk Page so that people may leave you messages.
; Pages that need fleshing out
 
: [[Oritania]] (almost empty) - [[Under the Hand]] - [[Wolf Cave]]
 
  
; Pages with existing but incomplete tables
+
When creating pages, we would like to maintain some semblance between similar pages. You can check out the [[Project Gorgon Wiki:Formatting|formatting guidelines]] page, although partially outdated. The best method is to find a similar page, and see the formatting of that page. 
: [[Gems]] (complete the table)
 
: [[Teleportation]] recipes
 
: [[Surveying]] (list of maps and what gems they lead to)
 
  
 +
Finally, pick something to add. You can choose from one of the general categories below or anything that you come across that you would like to work on.
 +
==Where to Help==
 +
The following areas of the wiki need the most help:
 +
; Creature Page Updates
 +
: Most Creatures require updates to follow the [[Creature Template]]. Combat Abilities, Miscellaneous, and Reported Loot sections need updating!
 +
; Missing Images
 +
: It would be great to get nice clear images of most creatures and NPCs. It would be preferable that these screenshots be taken on the highest level of graphics. Focus on lower level areas first (Serbule Hills, Serbule, Eltibule, Anagoge). You can look at [[Special:WantedFiles]] if you want to. Red links are usually missing images. Click the "(1 link)" next to the red link, click the page listed below, then from that page click the image link in the article to add a picture. Try to optimize pictures a little bit in Photoshop by using "Save for Web" if your version offers it. Size it down to 400 pixels wide to reduce the file size, as most articles will display a 400px thumb.
 +
; Missing Monsters
 +
: There are at least four named bosses missing on the wiki!
 +
; NPCs
 +
: Many NPCs are missing their Conversations section.
 
; Skills
 
; Skills
: Listing of the Advanced Abilities and where they drop or who teaches them (very useful)
+
: Many skills require a few sentences about the skill, and possibly some user comments on mechanics.
 +
: The [[Druid]] skill '''''needs''''' to be expanded on. It is missing most of its core gameplay elements and players '''''need to know''''' all of the unique requirements and cases of the skill. Much needed as it is a popular subject for questions.
 +
: It would be great to have images for all skills, something that represents the skill.
 
: If you have high level play experience:
 
: If you have high level play experience:
 
:: ... overview of pros and cons (good abilities, bad abilities)
 
:: ... overview of pros and cons (good abilities, bad abilities)
:: ... relevant equipment/desirable augments on items (consider adding an example with [[Template:ItemT]])
 
 
:: ... which other skills does it work well with? and why?
 
:: ... which other skills does it work well with? and why?
 
: Simple lists or tables of level up skills/rewards. <span style="color:#F00;font-size:1.5em;">*</span>
 
: Simple lists or tables of level up skills/rewards. <span style="color:#F00;font-size:1.5em;">*</span>
 
; Recipes
 
: Simple lists or tables of recipes. <span style="color:#F00;font-size:1.5em;">*</span>. Such lists are useful for the wiki search, even without individual pages, if a player /wiki "fried banana" ... the pages listing the recipe will show up in the results.
 
 
 
; Dungeons
 
; Dungeons
: Higher level dungeons are poorly documented atm:
+
: Many dungeons are sparsely documented, and still require:
:: Listing of foes, special foes, and harvestable nodes
 
 
:: Describe Points of Interest in the dungeon
 
:: Describe Points of Interest in the dungeon
:: Add articles for missing bosses
 
 
:: Any particular general loot , quest loot that drops here?
 
:: Any particular general loot , quest loot that drops here?
 
:: Consider adding a few images to highlight the sights in a gallery tag (see [[Dungeon Template]])
 
:: Consider adding a few images to highlight the sights in a gallery tag (see [[Dungeon Template]])
 +
; Gameplay
 +
: Pretty much all gameplay articles can be expanded upon.
 +
; Missing Pages
 +
: Look at [[Special:WantedPages]] to see if you can start on any of the pages. And Be sure that it is not just a misspelled word! Red links on a 'normal' wiki  are usually an indicator that something is missing. If that page is relevant and you can expand on that page please do so.
 +
; Delete pages
 +
: If you come across an irrelevant or duplicate page and want to have it deleted, add the code <b><nowiki>[[Category:Candidates for deletion]]</nowiki></b> to the bottom of the page. One of the wiki administrators will be notified.
  
; High level Zones
+
== Spoilers ==
:: '''Sun Vale''' NPCs, foes, landmarks (during alpha some abilities may move from one vendor to another, but those edits will not be lost, just moved to other articles as the game updates)
+
If the information exists, this Wiki should record it somewhere. Now, Project Gorgon is exploration based, so some spoilers might damage potential discoveries players might make. In general, record everything, but if the topic spoils a riddle, puzzle, or is something extremely hidden, it is best to spoiler tag it.  Some parts of the wiki, such as Lore related pages, contain spoilers, but do not need to be marked as such. Zones, Dungeon pages, Hidden Skill mechanics, and NPCs that have major reveals should use spoilers.
 
 
; Missing images
 
: Look at [[Special:WantedFiles]]. Red links are usually missing images. Click the "(1 link)" next to the red link, click the page listed below, then from that page click the image link in the article to add a picture. Try to optimize pictures a little bit in Photoshop by using "Save for Web" (JPEG). Size it down to 300 pixels wide to reduce the file size, as most articles will display a 300px thumb. Larger images can be used in the Galleries at bottom of dungeon/zone articles.
 
 
 
; IMPORTANT
 
: <span style="color:#F00;font-size:1.5em;">*</span> Please be aware that Eric (lead dev) has expressed interest in feeding most abilities/recipes into the wiki at some point (probably using the "Semantic" extension and formatting tables with special templates). That  means you should probably not create any individual pages for recipes or abilities at this point during alpha. Doing so is not terribly useful as the wiki search will find them in relevant lists (NPCs, or Skills pages), and they may be overwritten when this data is fed into the wiki directly from the developer's spreadsheets/database. If you have knowledge of how to automate this kind of thing, please message [[User talk:Gorgonzola]]. The ''design'' of such tables can be discussed in the [[Skill Template]] page.
 
 
 
</div>
 
 
 
==Article Guides (structure and consistency)==
 
Note that the following are not actual MediWiki templates. They are an example page in which we can discuss what the structure of the articles should look like. These should be used as a guide for creating new articles.
 
 
 
As the Wiki community grows we can discuss the of these articles in the relevant '''Talk Pages'''. For now I recommend to "watch" the templates below (click the star icon). They will be on your watchlist, and also appear to be in '''bold''' text in Recent Changes, so you can more easily follow updates.
 
 
 
<div style="background:#f8f8f8;border:1px solid #ccc;padding:5px;">
 
<DynamicPageList>
 
category = Template guides
 
</DynamicPageList>
 
</div>
 
 
 
==Formatting Templates==
 
See [[:Category:Template demos]] for a good overview with examples. For the full list see [[:Category:Formatting templates]].
 
 
 
If you have some template ideas, or something you'd like, drop me a message at [[User talk:Gorgonzola]].
 
 
 
{| class="wikitable"
 
! style="width:100px;"|Template !! style="text-align:left;width:75px;"|Demos !! style="text-align:left;"|Description
 
|-
 
! [[Template:Quote|Quote]]
 
| [[Quote Template Demos|Demos]] || Quote in-game text (NPC talk, lore items, etc) and official sources.
 
|-
 
! [[Template:Hint|Hint]]
 
| - || Hides light spoilers inside a tooltip. This helps keep the layout nice as these fit "inline". Keep these hints short because they appear as a tooltip. You can not use double quotes inside, use single quotes 'like this'.
 
|-
 
! [[Template:Spoiler|Spoiler]]
 
| - || Hide big spoilers in a collapsible block. Unfortunately we can not format a table inside those! Consider using lists (bullet lists, definition lists).
 
|-
 
! [[Template:ItemT|ItemT]]
 
| [[Item Template Demos|Demos]] || This is a fun template that gives the appearance of an in-game item description. Its goal is to liven up the pages with some visuals. As for all templates, its value is that we can change the appearance later for many pages just by editing the template, so if the in-game appearance change, that is not a problem. <span style="color:red">Icons are not yet supported</span> until the Wiki has better Extensions installed (a default "empty" icon is used).
 
|-
 
! [[Template:MOB infobox|MOB infobox]]
 
| - || Create an attractive "infobox" (as is commonly used in Wikipedia) for enemies and bosses. This is another way to liven up the pages. The info card does not document everything as that is in the body of the article. <span style="colo:red">TODO</span> More parameters will be added but are limited atm due to lack of proper Wiki Extensions.
 
|-
 
! [[Template:MAP infobox|MAP infobox]]
 
| - || Create an attractive "info card" for dungeons and sub-areas (do not use for zones yet, may use a different template).
 
|}
 
 
 
==Categories==
 
This section gives an overview of the common categories:
 
 
 
: [[:Category:Zones]]
 
: [[:Category:Dungeons]]
 
: [[:Category:Bosses]]
 
: [[:Category:Elite]] (Elite Bosses)
 
: [[:Category:NPCs]]
 
:: [[:Category:Serbule NPCs]]
 
:: [[:Category:Eltibule NPCs]]
 
:: [[:Category:Kur Mountains NPCs]]
 
:: etc.
 
: [[:Category:Skills]]
 
:: [[:Category:Beast Forms]]
 
:: [[:Category:Combat Skills]]
 
:: [[:Category:Other Skills]]
 
:: [[:Category:Trade Skills]]
 
  
 
==Sources for the Wiki==
 
==Sources for the Wiki==
Line 156: Line 97:
 
==F.A.Q.==
 
==F.A.Q.==
 
; Q. This wiki is too light/bright/does not look like a gaming wiki!
 
; Q. This wiki is too light/bright/does not look like a gaming wiki!
: A: This is completely unimportant during the alpha. This wiki is hosted by the developers themselves, on their own domain. This means in due time, they may very well decide to revamp the general appearance to something more exciting. They obviously have more important things to do during alpha. What matters now is providing quality content and help for the players. If you prefer, consider helping out the [http://project-gorgon.wikia.com/wiki/Project_Gorgon_Wiki Project: Gorgon Wikia site] instead.
+
: A: This is completely unimportant during the alpha. This wiki is hosted by the developers themselves, on their own domain. This means in due time, they may very well decide to revamp the general appearance to something more exciting. They obviously have more important things to do during alpha. What matters now is providing quality content and help for the players.
  
 
; Q. The rich text editor is too basic/ the syntax is complicated.
 
; Q. The rich text editor is too basic/ the syntax is complicated.
 
: A: It is. Consider it a new skillset. With that said, keep in mind this is collaborative work. If you don't like formatting things, simply focus on quality content. Someone else who is more into the layout and formatting will simply go over and tidy up things.
 
: A: It is. Consider it a new skillset. With that said, keep in mind this is collaborative work. If you don't like formatting things, simply focus on quality content. Someone else who is more into the layout and formatting will simply go over and tidy up things.
 +
 +
{{Project Gorgon Wiki formatting guides nav}}

Revision as of 22:12, 7 June 2018

MediaWiki Help
Formatting
Text and HTML
Images (& gallery syntax)
Links
Tables
Table markup
Editing
Categories
Moving a page
Transclusion (ie. includes)
Discussion
Using talk pages
Advanced
Magic words
Extensions
The <DPL> tag
Special Pages

Welcome to the Wiki

Welcome to the Project Gorgon Wiki. If you found this page, it probably means you want to contribute.

First Steps

Setup your personal and talk pages, when you first log in, you will see your username and 'Talk' in the upper right corner click those to create your pages. Even if they are blank, this makes it easier for others to contact you. It also allows for easy collaboration when working on large projects.

Please have a brief read of MediaWiki Help on Talk Pages. Signatures, indents, and topics (headings) in Talk Pages make it easier to see how the discussion is going and who has last replied, not just for the person you respond to, but any future editors who want to get up to date on the history of an article.

Consider watching talk pages (click the star) which you are participating in, as they will be highlighted in the Special:RecentChanges.

Next, it will be helpful to familiarize yourself with some of the information to the right. This wiki uses the MediaWiki platform. If you are new to MediaWiki, some Help articles can be found on the sidebar. You can edit the wiki if you are logged into forum account. Please click that, and create a page about yourself, and a Talk Page so that people may leave you messages.

When creating pages, we would like to maintain some semblance between similar pages. You can check out the formatting guidelines page, although partially outdated. The best method is to find a similar page, and see the formatting of that page.

Finally, pick something to add. You can choose from one of the general categories below or anything that you come across that you would like to work on.

Where to Help

The following areas of the wiki need the most help:

Creature Page Updates
Most Creatures require updates to follow the Creature Template. Combat Abilities, Miscellaneous, and Reported Loot sections need updating!
Missing Images
It would be great to get nice clear images of most creatures and NPCs. It would be preferable that these screenshots be taken on the highest level of graphics. Focus on lower level areas first (Serbule Hills, Serbule, Eltibule, Anagoge). You can look at Special:WantedFiles if you want to. Red links are usually missing images. Click the "(1 link)" next to the red link, click the page listed below, then from that page click the image link in the article to add a picture. Try to optimize pictures a little bit in Photoshop by using "Save for Web" if your version offers it. Size it down to 400 pixels wide to reduce the file size, as most articles will display a 400px thumb.
Missing Monsters
There are at least four named bosses missing on the wiki!
NPCs
Many NPCs are missing their Conversations section.
Skills
Many skills require a few sentences about the skill, and possibly some user comments on mechanics.
The Druid skill needs to be expanded on. It is missing most of its core gameplay elements and players need to know all of the unique requirements and cases of the skill. Much needed as it is a popular subject for questions.
It would be great to have images for all skills, something that represents the skill.
If you have high level play experience:
... overview of pros and cons (good abilities, bad abilities)
... which other skills does it work well with? and why?
Simple lists or tables of level up skills/rewards. *
Dungeons
Many dungeons are sparsely documented, and still require:
Describe Points of Interest in the dungeon
Any particular general loot , quest loot that drops here?
Consider adding a few images to highlight the sights in a gallery tag (see Dungeon Template)
Gameplay
Pretty much all gameplay articles can be expanded upon.
Missing Pages
Look at Special:WantedPages to see if you can start on any of the pages. And Be sure that it is not just a misspelled word! Red links on a 'normal' wiki are usually an indicator that something is missing. If that page is relevant and you can expand on that page please do so.
Delete pages
If you come across an irrelevant or duplicate page and want to have it deleted, add the code [[Category:Candidates for deletion]] to the bottom of the page. One of the wiki administrators will be notified.

Spoilers

If the information exists, this Wiki should record it somewhere. Now, Project Gorgon is exploration based, so some spoilers might damage potential discoveries players might make. In general, record everything, but if the topic spoils a riddle, puzzle, or is something extremely hidden, it is best to spoiler tag it. Some parts of the wiki, such as Lore related pages, contain spoilers, but do not need to be marked as such. Zones, Dungeon pages, Hidden Skill mechanics, and NPCs that have major reveals should use spoilers.

Sources for the Wiki

Besides in-game content, a list of known sources that can be used to flesh out the wiki:

F.A.Q.

Q. This wiki is too light/bright/does not look like a gaming wiki!
A: This is completely unimportant during the alpha. This wiki is hosted by the developers themselves, on their own domain. This means in due time, they may very well decide to revamp the general appearance to something more exciting. They obviously have more important things to do during alpha. What matters now is providing quality content and help for the players.
Q. The rich text editor is too basic/ the syntax is complicated.
A: It is. Consider it a new skillset. With that said, keep in mind this is collaborative work. If you don't like formatting things, simply focus on quality content. Someone else who is more into the layout and formatting will simply go over and tidy up things.
Formatting guides
How to helpFormattingCategories