Guide:Game Making Tools Wiki: Difference between revisions

From Game Making Tools Wiki
m (→‎Infoboxes: Reorganised infobox examples)
m (→‎Subpages: punctuation tweak)
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
Rough guide to keeping things looking uniform.
Information about editing this wiki.


Feel free to discuss anything on this page, and make suggestions if you think there are better ways of doing things.
'''If I could emphasise one point, it would be that a wiki is a team effort, so any contribution is really appreciated. You don't have to make everything look pretty, just get the information down.'''


==Code==
If you have any more questions make a post on the [[Guide_talk:Game_Making_Tools_Wiki|Talk page]].
 
==General Tips==
* Editing a wiki can always seem a bit daunting at first, but don't worry, you can't break anything :)
* Some good things to do to get used to things is to fix any errors like broken links or typos you see. It's also really helpful!
* Getting info. down is the main thing. You, or someone else, can make it look fancy later.
* You can create pages under your username by added a forward slash '/' and whatever you want to call the page. For example [[User:Rjt/draft]]. This is useful for drafts and experiments or whatever; maybe you want to put an essay there or something!
* There are special pages like [[Special:WantedPages]] and [[Special:WantedCategories]] that may give you ideas on things that are needed.
 
==Basic Syntax==
 
===Headings===
 
===Links===
 
===Lists===
 
===Styling Text===
 
 
 
==Advanced Syntax==
 
===Code===
For blocks of code you can use the <nowiki><pre></nowiki> tag. For inline code snippets, or keyboard/inputs you can use <nowiki><code></nowiki>. A bit wrong-sounding, I know!
For blocks of code you can use the <nowiki><pre></nowiki> tag. For inline code snippets, or keyboard/inputs you can use <nowiki><code></nowiki>. A bit wrong-sounding, I know!


==Colours==
===Categories===
The colours used in the logo are: <span style=background:#ed1c24;color:white;padding:2px;>#ed1c24</span>, <span style=background:#ffaec9;padding:2px;>#ffaec9</span> and <span style=background:#fff200;padding:2px;>#fff200</span>
Categories should be on the bottom of a page.
 
I tend to order them (Software kind, 2-D/3-D, genre, x, operating system. 'X' being space for whatever else), but it doesn't matter. And sometimes I use linebreaks after groupings of categories to make it a bit easier to read, this doesn't effect how it appears on the page.
 
Example:
 
<nowiki>[[Category:Game Builder]]
[[Category:2-D]][[Category:3-D]]
[[Category:Adventure]]
[[Category:Browser]]
[[Category:Browser Export]]</nowiki>
 
You can see all the currently existing categories at: [[Special:Categories]]
 
===Media===
====Embedding====
You can embed videos using the installed [https://www.mediawiki.org/wiki/Extension:EmbedVideo EmbedVideo extension].


==Categories==
The simplest way to use it is: <code><nowiki>{{#ev:youtube|videourl}}</nowiki></code>. You can also leave out most of the URL and just add the ID string fro mthe end.
Categories should be on the bottom of a page.


The order is: Software kind, 2-D/3-D, genre, x, operating system. 'X' being space for whatever else.
====Images====
There's a button to insert images in the toolbar, but you can manually type the coed out as


  <nowiki>[[Category:Game Builder]][[Category:2-D]][[Category:Adventure]][[Category:Browser]][[Category:Browser_Export]]</nowiki>
  <nowiki>[[File:image.png|alt=alt text]]</nowiki>


Some times I use returns after groupings of cetegories to make it a bit easier to read, this doesn't effect how it appears on the page.
Please always add a short description as {{jargon|Alt Text|alt text}} to describe the image for people using assistive technology, or on low-speed connections. For a log this can be as simple as 'Unity logo'.


==Images==
When uploading, to keep things organised please start an image's filename with something like the name of the section it's used in, then an underscore, then a description of the file.
To keep things organised please start an images filename with something like the name of the section it's used in, then an underscore, then a description of the file.


EG:
EG:
Line 25: Line 63:
  <nowiki>blender_decimate.png</nowiki>
  <nowiki>blender_decimate.png</nowiki>


===Galleries===
<nowiki>solarus_logo.png</nowiki>
 
You can get a list of all the uploaded files at [[Special:ListFiles]]
 
=====Galleries=====
I've just inserted my first gallery! I think they look a bit better without the lines, but otherwise use them as you see fit.
I've just inserted my first gallery! I think they look a bit better without the lines, but otherwise use them as you see fit.


Line 40: Line 82:
Captions can have links and w/e
Captions can have links and w/e


==Infoboxes==
=====See Also=====
Images come in three kinds:
* [https://www.mediawiki.org/wiki/Help:Images Images] section on the Mediawiki help.
 
==Pages==
===Subpages===
''Subpages'' are like extra pages related to a specific page. Practically they're not much different to a regular page, they're more of an organisational tool.


* 'logo' for software logos,
They can be useful for:
* 'screenshot' for images of the software,
* and 'image' which is both a fallback to the older infobox design and for misc. images.


To add an image you can use code like this. Though use your discretion as all of it may not be needed, often just the filename and size are enough:
* Breaking down long pages into smaller ones, for example in the Guides section.
* Making extra pages attached to your own User page: for testing things out, or making personal lists, or whatever.
* They're used on the [[Name Generators]] page for recording interesting results.


<nowiki>[[File:filename.extension|220px|thumb|left]]</nowiki>
To indicate that something is a ''subpage'' you use a forward slash (/) in its link. For example a subpage of this one could be linked to with


Category links for fields like 'runs_on' and 'exports_to' looks like this:
<code><nowiki>[[/subpage]]</nowiki></code>


<nowiki>[[:Category:Linux_export|]]</nowiki>
And it would be accessible at


To add a bullet point / list simple make a new line and enter and asterix and a space, then your text
<code><nowiki>[[https://www.gamemaking.tools/wiki/index.php?title=Guide:Game_Making_Tools_Wiki/subpage]]</nowiki></code>


<nowiki>| item5_description = text text text
====See Also====
* text text text</nowiki>
* [https://www.mediawiki.org/wiki/Help:Subpages Help:Subpages] on the Mediawiki wiki.


To make a new line without a bullet use <nowiki><br></nowiki>
==Conventions==


<br>
===Infoboxes===
<hr>
Each page should have an ''[[/Infoboxes|infobox]]''. These are the sections you see on the right of each page that contain some key information like author, logo, and platforms the software runs on. There are different kinds of infobox for different kinds of pages.
<br>


Current infoboxes are:
If you don't have the info. to fill out the whole thing it's fine to leave fields empty, but if you can at least insert the code it'll make it easier for someone else to add later.


* [[Template:infobox_software|infobox_software]] - For [[:Category:Game Builder|game builder]] software.
PS: I'm working on making them easier to insert — [[User:Rjt|rjt]] ([[User talk:Rjt|talk]])
<nowiki>{{ infobox_software
| title        =
| logo        =
| image        =
| screenshot  =
| release_date =
| made_by      =
| runs_on      =
| exports_to  =
}}</nowiki>


* [[Template:infobox_assetsoftware|infobox_assetsoftware]] - For [[:Category:Asset_Creation|asset creation]] software.
===Jargon===
<nowiki>{{ infobox_assetsoftware
I'd like information on this wiki to be useful to anyone, no matter what their familiarity is with game making. If you use any jargon, please create an entry for it in [[Guide:Glossary|the glossary]], and link the word to it using the [[Template:jargon|jargon template]].
| title        =
| logo        =
| image        =
| screenshot  =
| release_date =
| made_by      =
| runs_on      =
| imports      =
| exports      =
}}</nowiki>


* [[Template:infobox_leveleditor|infobox_leveleditor]] - For [[:Category:Level_Editor|level editors]].
==Trivia==
<nowiki>{{ infobox_leveleditor
* The colours used in the logo are: <span style=background:#ed1c24;color:white;padding:2px;>#ed1c24</span>, <span style=background:#ffaec9;padding:2px;>#ffaec9</span> and <span style=background:#fff200;padding:2px;>#fff200</span>
| title        =  
| logo        =  
| image        =
| screenshot  =
| release_date =
| made_by      =
| availability =
}}</nowiki>


* [[Template:infobox_updates|infobox_updates]] - For the [[Main_Page|front page]].
==See Also==
<nowiki>{{ infobox_updates
* [https://www.mediawiki.org/wiki/Help:Formatting Help:Formatting] on the MediaWiki wiki.
| item1            =
* [[Wikipedia:Help:Wikitext|Help:Wikitext]] on Wikipedia.
| item1_date        =
* [https://workingwithmediawiki.com/book/chapter4.html MediaWiki syntax] on the 'Working with MediaWiki' website.
| item1_description =
* [[Guide:Game_Making_Tools_Wiki/Templates]]
| item2            =
* [[Guide:Game_Making_Tools_Wiki/Infoboxes]]
| item2_date        =
| item2_description =
| item3            =
| item3_date        =
| item3_description =
| item4            =
| item4_date        =
| item4_description =
| item5            =
| item5_date        =
| item5_description =
}}</nowiki>

Latest revision as of 21:55, 22 January 2023

Information about editing this wiki.

If I could emphasise one point, it would be that a wiki is a team effort, so any contribution is really appreciated. You don't have to make everything look pretty, just get the information down.

If you have any more questions make a post on the Talk page.

General Tips

  • Editing a wiki can always seem a bit daunting at first, but don't worry, you can't break anything :)
  • Some good things to do to get used to things is to fix any errors like broken links or typos you see. It's also really helpful!
  • Getting info. down is the main thing. You, or someone else, can make it look fancy later.
  • You can create pages under your username by added a forward slash '/' and whatever you want to call the page. For example User:Rjt/draft. This is useful for drafts and experiments or whatever; maybe you want to put an essay there or something!
  • There are special pages like Special:WantedPages and Special:WantedCategories that may give you ideas on things that are needed.

Basic Syntax

Headings

Links

Lists

Styling Text

Advanced Syntax

Code

For blocks of code you can use the <pre> tag. For inline code snippets, or keyboard/inputs you can use <code>. A bit wrong-sounding, I know!

Categories

Categories should be on the bottom of a page.

I tend to order them (Software kind, 2-D/3-D, genre, x, operating system. 'X' being space for whatever else), but it doesn't matter. And sometimes I use linebreaks after groupings of categories to make it a bit easier to read, this doesn't effect how it appears on the page.

Example: 

[[Category:Game Builder]]
[[Category:2-D]][[Category:3-D]]
[[Category:Adventure]]
[[Category:Browser]]
[[Category:Browser Export]]

You can see all the currently existing categories at: Special:Categories

Media

Embedding

You can embed videos using the installed EmbedVideo extension.

The simplest way to use it is: {{#ev:youtube|videourl}}. You can also leave out most of the URL and just add the ID string fro mthe end.

Images

There's a button to insert images in the toolbar, but you can manually type the coed out as 

[[File:image.png|alt=alt text]]

Please always add a short description as alt text to describe the image for people using assistive technology, or on low-speed connections. For a log this can be as simple as 'Unity logo'.

When uploading, to keep things organised please start an image's filename with something like the name of the section it's used in, then an underscore, then a description of the file.

EG: 

blender_decimate.png

solarus_logo.png

You can get a list of all the uploaded files at Special:ListFiles

Galleries

I've just inserted my first gallery! I think they look a bit better without the lines, but otherwise use them as you see fit.

I used this simple code: 

<gallery mode="packed">
File:filename.png|caption
File:filename.png|caption
File:filename.png|caption
</gallery>

Does seem to centre it though. Would look nicer left-aligned.

Captions can have links and w/e

See Also
  • Images section on the Mediawiki help.

Pages

Subpages

Subpages are like extra pages related to a specific page. Practically they're not much different to a regular page, they're more of an organisational tool.

They can be useful for:

  • Breaking down long pages into smaller ones, for example in the Guides section.
  • Making extra pages attached to your own User page: for testing things out, or making personal lists, or whatever.
  • They're used on the Name Generators page for recording interesting results.

To indicate that something is a subpage you use a forward slash (/) in its link. For example a subpage of this one could be linked to with

[[/subpage]]

And it would be accessible at

[[https://www.gamemaking.tools/wiki/index.php?title=Guide:Game_Making_Tools_Wiki/subpage]]

See Also

Conventions

Infoboxes

Each page should have an infobox. These are the sections you see on the right of each page that contain some key information like author, logo, and platforms the software runs on. There are different kinds of infobox for different kinds of pages.

If you don't have the info. to fill out the whole thing it's fine to leave fields empty, but if you can at least insert the code it'll make it easier for someone else to add later.

PS: I'm working on making them easier to insert — rjt (talk)

Jargon

I'd like information on this wiki to be useful to anyone, no matter what their familiarity is with game making. If you use any jargon, please create an entry for it in the glossary, and link the word to it using the jargon template.

Trivia

  • The colours used in the logo are: #ed1c24, #ffaec9 and #fff200

See Also

Retrieved from "https://www.gamemaking.tools/wiki/index.php?title=Guide:Game_Making_Tools_Wiki&oldid=2077"