Difference between revisions of "Wolfire Wiki Editing Standards"

From Wolfire Games Wiki
Jump to: navigation, search
m (Useful Examples)
m (Replaced content with "{{Wolfire Wiki Editing Standards}}")
 
(51 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Tutorials]]
+
{{Wolfire Wiki Editing Standards}}
<center>{{WQA in Progress}}</center>
 
 
 
<!--
 
 
 
PRIVATE
 
--><noinclude><!--
 
Categories --><!--
 
--></noinclude><!--
 
 
 
INCLUDED
 
-none-
 
 
 
PUBLIC
 
Content -->
 
Future location of the Wolfire Wiki Editing Standards
 
 
 
==Introduction==
 
 
 
For starters if you are reading this page it means you want to help with the wiki. Yay for you!
 
 
 
We are still very much unorganized, so contributing at this stage is important. I'm actually making all of this up as I go along. You can help decide how things are organized by joining the Wolfire Forums and discussing the crap out of how bad the wiki is and how it should be.
 
 
 
Now, the first step is to log in at the top right corner using your wolfire (does it need to be SPF?) login (if you have an underscore in your handle/alias/name you might have some trouble). Only after logging in can you then begin to contribute to the wiki.
 
 
 
Editing a wiki may seem like a daunting task if you don't know that much about modding, code or wikis, but it really only requires common sense to edit a wiki. No knowledge of code is needed. There are a few basic formatting markers but those are easy to pick up. It's more important to know how to communicate through your words than to code.
 
 
 
Remember the more you help, the easier it becomes for the next person to contribute and learn.
 
 
 
Just remember that there are many categories already available, and typos will add your page into another category. So double check and if you don't see any category that fits ask before creating your own. [[Special:Categories |List of Categories]]
 
 
 
Here's the wikipedia page on categorization.
 
[http://en.wikipedia.org/wiki/Wikipedia:Categorization]
 
[http://en.wikipedia.org/wiki/Wikipedia:Overcategorization]
 
 
 
Contents are 'organized' by adding:
 
<pre>
 
=={1}Intro==
 
=={2.1}Thing==
 
==={2.1.1}partOfThingOne===
 
==={2.1.2}partOfThingTwo===
 
=={3.2}OtherThing==
 
=={2}(actually no idea what this should be)==
 
...
 
...
 
...
 
</pre>
 
 
 
* There is still no wolfire wiki convention yet to how you should organize your page. When it happens, though, please stick to the convention.
 
 
 
 
 
==Editing a Wiki Page==
 
* ANYONE WHO UNDERSTANDS THIS SECTION PLEASE EXPLAIN IT MORE
 
 
 
===Wiki Code Format===
 
 
 
Here is the format that all edit code should start out with:
 
 
 
<pre>
 
<!--
 
 
 
PRIVATE // Only displayed on this page, not transcluded on pages that use this template
 
--><noinclude><!--
 
Categories --> <!--
 
Constants --> <!--
 
Content --> <!--
 
--></noinclude>
 
 
 
<!--
 
 
 
INCLUDED // Not displayed on this page, only transcluded on pages that use this template
 
--><includeonly><!--
 
Categories --> <!--
 
Constants --> <!--
 
Content --> <!--
 
--></includeonly>
 
 
 
PUBLIC // Displayed on this page, and transcluded on pages that use this template
 
Categories --> <!--
 
Constants--> <!--
 
Content -->
 
 
 
</pre>
 
As an example, the to-do list template's code looks like this:
 
 
 
<pre>
 
<!--
 
 
 
PRIVATE // Only displayed on this page, not transcluded on pages that use this template
 
--><noinclude><!--
 
Categories --> {{CT| Main Page}} {{CT| Wiki Contributors}}<!--
 
Constants --> {{stub}} <!--
 
Content -->
 
=Introduction=
 
The way this works is that if you have or currently contributing to the wiki put your work or progress in the "Fresh" section. If no work has been done on the task for two weeks it will go "stale". Please try to keep things fresh and move things to "Stale" if you a) can't work on it or b) see no progress for a while. It is up to you to keep things fresh! Please help us out.
 
 
 
Then when you are sure that you are completely finished put it in the "Finished" category.
 
 
 
(I would like to create a template to add here anything that has the improvement needed template in it. If you know how to do that please go ahead)
 
 
 
==Format==
 
Here is how you write the things in the list.
 
 
 
pre
 
*What needs done [[link to where you should go]] [[link to how to do it]]
 
dd/mm/yy something meaningful was last done
 
**List of things that need to be done before finishing the parent task
 
/pre
 
 
 
I just listed a top/down approach to creating the to-do list. If you prefer the bottom/up approach then post the children tasks by themselves with links to their parents.
 
<!--
 
--></noinclude>
 
=To-do List=
 
 
 
==Fresh==
 
* Help create wiki editing standards. [[Wolfire_Wiki_Editing_Standards | Help here!]] 16/6/11 theres a lot to do in [[Wolfire_Wiki_Editing_Standards]]
 
**Explaining editing format
 
**Finding good examples of wiki editing not just generic ones
 
* Add [[Wolfire_Games_Wiki:Community_Portal | fan suggestion place]] 16/6/11
 
**Add suggestions from SPF
 
**Add tutorials from SPF
 
**Get people to post/upload their art and/or mods to the wiki
 
***Make a tutorial page on how to upload stuff to the wiki
 
* Check categories [[Special:Categories | Help here!]]
 
 
 
==Stale==
 
* Find places for the [[Special:DeadendPages |deadened pages]]
 
* How to create and use templates correctly [[Wolfire_Wiki_Editing_Standards | VERY IMPORTANT]]
 
* Set up a system that makes it easy to add items to the "Fresh", "Stale", or "Finished" lists
 
* Build an official Wolfire Tutorials page using previous Wolfire blog posts
 
* [[Overgrowth_Alpha_FAQ | OG FAQ]]
 
* [[Lugaru | Lugaru page]], specifically the walkthrough guide.
 
* The OG graphics features page needs work [[Graphics | Help here!]]
 
* Categorize all images (link to [[Special:UncategorizedImages |Uncategorized Images]])
 
* Identify and update out of date, stub and duplicate pages [[:Category:Improvement Needed Templates| Use the Templates from here!]]
 
* Fully set up the various portals [[:Category:Portals|Help Here!]]
 
* Finish front page.
 
* [[:Category:Improvement_Needed| Much, much more...]]
 
 
 
==Finished==
 
* Categorize all pages as of 16/6/11 (link to [[Special:UncategorizedPages |Uncategorized Pages]])
 
</pre>
 
 
 
===Links===
 
To add links in your page you use:
 
<pre>
 
to link to a page:
 
 
 
[[page_name |Page Name]] == Page Name
 
 
 
[[page name]] == page name
 
 
 
to link to a category its important not to forget the colon ':' in front:
 
 
 
[[: category: Wiki Contributors]] == category: Wiki Contributors
 
 
 
you can also link to a special page by:
 
 
 
[[special: Special Page]] == special: Special Page
 
</pre>
 
 
 
==Templates==
 
<center>{{stub}}</center>
 
<center>* SOMEONE WHO UNDERSTANDS THIS STUFF SHOULD HELP ASAP</center>
 
 
 
 
 
The sooner its done, the sooner more people can learn how to contribute to the wiki.
 
 
 
This section should contain a more comprehensive tutorial on templates and how to build them. We also need a link to all of the templates that this wiki currently has in use.
 
 
 
This Wiki makes extensive use of templates. Templates allow you to re-use Wiki code and allow for editing of many pages simultaneously.
 
 
 
For instance:
 
<pre>
 
<center>{{WQA in Progress}}</center>
 
</pre>
 
adds
 
<center>{{WQA in Progress}}</center>
 
 
 
In [[:Category:Improvement Needed Templates]] there are a list of improvement templates. Open them up and see how they work. It will help you with understanding how to write you own.
 
 
 
==Learning by Example==
 
 
 
Any wiki using the standard wiki engine will allow you to see its source, and so it's easy to learn how to create an awesome wiki: all you have to do is look at their code
 
 
 
You can do that by either clicking "'''Edit'''"/"'''Edit this page'''" or "'''Source'''"/"'''View source'''".
 
 
 
===Useful Examples===
 
 
 
 
 
<center>{{stub}}</center>
 
 
 
''Note: These examples were not picked for any reason apart from being educational resources.''
 
 
 
*[http://en.wikipedia.org/wiki/Main_Page Wikipedia] The Behemoth that started it all. Examine their ''extensive'' code at your own risk.
 
*[http://www.wikia.com/wiki/Wikia Wikia] Not one wiki, but a vast collections of wikis hosted in one location.
 
*A variety of cool Wikia Wikis:
 
**[http://bioshock.wikia.com/wiki/BioShock_Wiki Bioshock Wiki]
 
**[http://harrypotter.wikia.com/wiki/Main_Page Harry Potter Wiki]
 
**[http://www.wowwiki.com/Portal:Main Wow Wiki]
 
**[http://marvel.wikia.com/Main_Page Marvel Database Project]
 
**[http://starwars.wikia.com/wiki/Main_Page Wookie Wiki]
 
**[http://lyrics.wikia.com/Main_Page Lyrics Wiki]
 
 
 
[[:Category:Tutorials]]
 
 
 
==Next Phase==
 
 
 
Now goto to the [[: Category: Wiki Contributors]] page and see whats happening with the wiki.
 

Latest revision as of 18:13, 11 March 2012


For starters if you are reading this page it means you either need help or you want to help with the wiki. Yay for you!

We are still very much unorganized, so contributing at this stage is important. I'm actually making all of this up as I go along. You can help decide how things are organized by joining the Wolfire Forums and discussing the crap out of how bad the wiki is and how it should be.

Now, the first step is to log in at the top right corner using your wolfire (does it need to be SPF?) login (if you have an underscore in your handle/alias/name you might have some trouble). Only after logging in can you then begin to contribute to the wiki.

Editing a wiki may seem like a daunting task if you don't know that much about modding, code or wikis, but it really only requires common sense to edit a wiki. No knowledge of code is needed. There are a few basic formatting markers but those are easy to pick up. It's more important to know how to communicate through your words than to code.

Remember the more you help, the easier it becomes for the next person to contribute and learn.


Learning by Example

Any wiki using the standard wiki engine will allow you to see its source, and so it's easy to learn how to create an awesome wiki: all you have to do is look at their code

You can do that by either clicking "Edit"/"Edit this page" or "Source"/"View source".

Useful Examples

This article is a stub. You should help Wolfire by expanding it.


Note: These examples were not picked for any reason apart from being educational resources.

Categories

There are many categories already available. Typos will create category. So double check and if you don't see any category that fits ask before creating your own. List of Categories

Here's are some help pages on categorization:

Art

All art that is reposted/posted MUST have permission from it's creator. fan art thread

Please try and fill out the summary with some basic information about your art pieces. Here are the list of Categories that should go first (choose only one):

  • Fan Art (if you took an artistic screenshot label it as fan art)
  • Fan Music
  • Fan Videos
  • Icons
    • Headers
  • Screen Shots must have either a Tutorials (only if the picture has directions in it) or Modding category together with another category for the content of the picture ie Overgrowth, Lugaru, Photoshop, Blender
    Click on me to see an example
    . There is no need to include artsy screen shots either from Wolfire or one you took (and possibly enhanced) yourself. Place those instead into Wolfire Art or Fan Art with the game tagged.
  • Textures (make sure to fill in the summary if you don't plan on writing an article explaining your texture)
  • Wolfire Art (if it's part of a specific Wolfire universe add that after (ie Lugaru, GL Fighters, Overgrowth)
  • Wolfire Music
  • Wolfire Videos

After those three steps comes the last step, going over to either the concept art template or polished art template and adding a link to your photo there.

To include a file in a page, use a link in one of the following forms:

  • [[Image:File.jpg]] to use the full version of the file
  • [[Image:File.png|200px|thumb|left|alt text]] to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
  • [[Media:File.ogg]] for directly linking to the file without displaying the file

Games

  • Black Shades
  • GL Fighters
  • Lightning's Shadow
  • Lugaru
  • Overgrowth

Help

Lore

  • Characters
    • Cats
    • Dogs
    • Rabbits
    • Rats
    • Wolves
  • Weapons (look at http://en.wikipedia.org/wiki/List_of_melee_weapons to see where your weapon fits)
    • Blunt weapons
    • Chain weapons
    • Spears
    • Pole weapons
    • Knives
    • Swords and fencing
    • Axes
    • Glove Weapons
    • Improvised Weapons
    • Miscellaneous weapons

Modding

Portals

Wiki Contributors

Wolfire

Editing a Wiki Page

  • ANYONE WHO UNDERSTANDS THIS SECTION PLEASE EXPLAIN IT MORE

Wiki Code

This article is a stub. You should help Wolfire by expanding it.

Here is the format that all edit code should start out with:

(note that every <!-- needs a -->, also, the order in which these things appear are suggestions not requirements)

<!--PRIVATE // Only displayed on this page, not transcluded on pages that use this template-->
<noinclude>
<!--Categories--> [[Category: Example]]
<!--Constants--> (aka wiki magic words)
<!--Content-->
Your PRIVATE content should start here
</noinclude>

<!--INCLUDED // Not displayed on this page, only transcluded on pages that use this template-->
<includeonly>
<!--Categories--> 
<!--Constants-->
<!--Content--> 
Your INCLUDED content should start here
</includeonly>

PUBLIC // Displayed on this page, and transcluded on pages that use this template
Categories --> 
<!--Constants--> 
<!--Content-->
Your PUBLIC content should start here

Magic Words

This article is a stub. You should help Wolfire by expanding it.

Links

To add links in your page you use:

a link to a website:

[http://www.example.com/ A test page] == A test page

to link to a page:

[[page_name |Page Name]] == Page Name

[[page name]] == page name

[[Equipment and Weapons#Dog Weapons|Dog Weapons]] == Dog Weapons (inside the Equipment and Weapons page)

to link to a category it's important not to forget the colon ':' in front:

[[: category: Wiki Contributors]] == category: Wiki Contributors

you can also link to a special page by:

[[special: Special Page]] == special: Special Page

Content Box

This article is a stub. You should help Wolfire by expanding it.
Contents are 'organized' by adding:

=={1}Intro==
=={2.1}Thing==
==={2.1.1}partOfThingOne===
==={2.1.2}partOfThingTwo===
=={3}OtherThing==
=={4}(actually no idea what this should be)==
...
...
...
  • There is still no wolfire wiki convention yet to how you should organize your page. When it happens, though, please stick to the convention.


Templates

This Wiki makes extensive use of templates. Templates allow you to re-use Wiki code and allow for easy editing.

Example One

For instance:

<center>{{Wip}}</center>

adds


Work in Progress Work in Progress: Comments & Edits Welcome


In Category:Improvement Needed Templates there are a list of improvement templates. Open them up and see how they work. It will help you with understanding how to write you own.

Example Two

The to-do list template
{{Wolfire Wiki To Do}}
adds this: *REMOVED* (messes with the content browser)

Special Pages

This article is a stub. You should help Wolfire by expanding it.

  • How can I limit the amount of content I want to show (ie only 15 recent changes or the most recent change per person)? - Conner36
{{Special:RecentChanges}} Adds the contents from the special page. 
Be careful not to leave any spaces between the words.

Next Phase

Now goto to the Category: Wiki Contributors page and see whats happening with the wiki.