Guide to contributing to the wiki: Difference between revisions

Jump to navigation Jump to search

Guide to contributing to the wiki (view source)

Revision as of 17:06, 4 May 2020

2,810 bytes removed ,  17:06, 4 May 2020
Added note about the Microsofts current browser being a fucking useless piece of shit as allways.
(Rewrite and restructuring. Tried to lighten up the guide a bit. Fixed some typos.)
(Added note about the Microsofts current browser being a fucking useless piece of shit as allways.)
(5 intermediate revisions by the same user not shown)
Line 159: Line 159:
* '''All pages:''' [[Special:AllPages|All existing pages]] and [[Special:WantedPages|Wanted pages]]
* '''All pages:''' [[Special:AllPages|All existing pages]] and [[Special:WantedPages|Wanted pages]]


== Guidelines ==
== [[Styleguide|Guidelines]] ==
As often in life, ''what'' you do is as important as ''how'' you do it. These are not ''enforced'' rules, but use your best judgment (or preferably just ask) when to divert from these suggestions.
As often in life, ''what'' you do is as important as ''how'' you do it. These are not ''enforced'' rules, but use your best judgment (or preferably just ask) when to divert from these suggestions.


=== Edits ===
Really, '''[[Styleguide|READ THEM]]'''
Every time you save your edit a commit is made. This commit will be reviewed by administrators. To make their lives easier try not to split your changes into dozens of separate commits but do them all in one go. Another thing that really helps is adding a summary (aka 'Comment') and make proper use of the ''minor edit'' option. Both will tell the administrator what to look for when checking the edit. Stating your intention as well, can prevent misunderstandings like: <code>Rephrased foreword for increased readability.</code>
 
=== New Pages ===
Avoid duplicates by thoroughly searching in the wiki and asking if need be. Try to following the existing naming schemes including capitalization. Here is an example, if you were to write a guide of how to walk properly:
* '''Bad:''' Walk
* '''A bit closer:''' How to Walk
* '''Almost there:''' Guide to walking
* '''Good:''' Guide to Walking
 
=== Jokes ===
Some pages are intended to be entertaining, but when writing guides, please remember that a new player might not realize that something is a joke or sarcasm and will instead take it at face value. For more practical guides, less jokes are better. Where it is more discretionary, please think about where jokes fit and where they don't, and if you are updating someone else's joke, think whether yours is ''actually funnier''.
 
=== Private pages / sandboxes ===
It is considered rude to change anything on another users private page without prior explicit permission. If you like someones draft you can copy and edit it in your sandbox.
 
To use your sandbox use [[Special:MyPage/Sandbox]] to be redirected to your own sandbox. You can create as many private sandboxes as you want. Just create an article in the appropriate namespace like:
https://wiki.yogstation.net/wiki/User:YourUserName/YourSandboxName
 
=== Categories ===
You can put articles into categores by inserting the appropriate command like <code><nowiki>[[Category:Guides]]</nowiki></code>. This should be done at the bottom of the page. Please refrain from creating new categories or editing article-categories without talking about it with the wiki-staff first. This is necessary for categories to be consistent.
 
=== Terminology ===
Try to be consistent with any terminology and ask for clarification if need be:
* Use '''tick''' instead of '''cycle'''
 
=== Images ===
Images should have transparent background and be in the .png or .gif format. For location- and map-related images see '''[[Styleguide|HERE]]'''. When uploading images extracted from gamefiles it can be helpful to comment the source and the content like:
<pre>Extracted from icons/obj/storage.dmi
Evidence bag</pre>
The content is especially useful if the image name is not intuitive.
 
'''Do not upload duplicate files'''. Update them instead. When uploading new versions of images it can take a while for them to get cached by the wiki. There is no need for repeated uploads. This can take quite a while.
 
=== Article Quality ===
When revising and writing articles try to consider the following things:
 
{| class="wikitable"
!Correct Language
|Check grammar / punctuation / typos. Basically make sure it feels like authentic english
|-
!Consistent Capitalisation
|For recipes and lists of ingredients capitalize the first letter if it's a multiword statement (Lime juice), but if it's a proper name (Beepsky Smash / Quadruple Sec), capitalize both. For mixed ingredients only capitalize the actual item ("coil of Wire").
|-
!Consistent language
|Some articles are packed with humour, while others are rather technical. Both is perfectly fine. Try to stay compatible when editing articles.
|-
!Ressources
|Check for broken / outdated images and links. Make sure the style of used icons is consistent.
|-
!Correctness
|Making sure that anything stated is true and isn't outdated. Best checked by experienced players and reading the game-code.
|-
!Scope / Completeness
|Anything described should either be complete, or it should be obvious that it isn't meant to be complete. The best example for the latter are things that are meant to be explored by the players. Best checked by experienced players, developers and reading the code. Remember, that guides are not meant to convert the reader into a ultrarobust powergaming machine by spoonfeeding optimized strategies.
|-
!Lore
|While there is not fixed lore-concept, it does not hurt to provide slight lore-related hints once in a while. This can best be done for non-technical descriptions and whenever reasoning is given for things being how they are (besides 'science' / 'magic')
|-
!Design
|Even the best article will feel boring without the proper use of icons and formatting. Proper Highlighting, templates and standard structures are to be used to increase readability without being excessive
|-
!Learning-Context
|Make sure that basic guides stay basic. Guides should reveal their content by being read top to bottom without prior knowledge and link-jumping. They should still have structured sections that are good to look up for experienced players, too.
|}
Having someone proofread an article for a second opinion never hurt anyone.


== Advanced Topics ==
== Advanced Topics ==
Line 300: Line 235:
** Select File (like _maps/RandomRuins/LavaRuins/lavaland_surface_ash_walker1.dmm )
** Select File (like _maps/RandomRuins/LavaRuins/lavaland_surface_ash_walker1.dmm )
** The view automatically switches from the File-tab to the Object-tab
** The view automatically switches from the File-tab to the Object-tab
** Overwrite all areas with area/space to get a better view  
** Overwrite all areas with '''area/space''' to get a better view  
** If some things like 'no_lava' are bothering you: Select all tiles > rightclick > Find replace in Selection > Replace "no_lava" with ""
** If some things like '''no_lava''' are bothering you: '''Select all tiles > rightclick > Find replace in Selection''' to replace "no_lava" with ""
** Take screenshots
** Take screenshots
* https://fastdmm2.ss13.io/ Very useful if you intend to do multiple locations. You can pan the view with the middle mouse button or the arrow-keys.
* https://fastdmm2.ss13.io/ Very useful if you intend to do multiple locations. You can pan the view with the middle mouse button or the arrow-keys.
** Open with Chrome / Firefox. Microsoft Edge does not work as of 2020.05.04
** Load up the repo
** Load up the repo
** Open the map file you want
*** Make sure the repository is specified in the top textfield: <code>yogstation13/yogstation</code>
** Set the settings you want to show on the left hand side (you can also ctl + shift click on items to jump to them on the left panel). Only have to do this step once since it saves your setting between the maps you load
*** Click on '''Open Github repository'''
*** Choose the branch <code>master</code> and click on '''Ok'''
*** Wait for '''yogstation.dme''' to load. This might take a minute
** Open the map file you want: '''File > Open > _maps > ...'''
** Set the settings you want to show on the left hand side by clicking on the eye-icons next to the nodes
*** You can also <kbd>ctrl</kbd> + <kbd>shift</kbd> click on items to jump to them on the left panel
*** Only have to do this step once since it saves your setting between the maps you load
*** Disable '''Options > Frame Areas'''
*** You will most likely want to disable a bunch of things to make adding transparency easier:
**** '''/area'''
**** '''/obj/effect/mapping_helpers/no_lava'''
**** '''/turf/open/space'''
** Take screenshots
** Take screenshots
** Open screenshot in [https://www.gimp.org/ GIMP]
** Layer-window >Rightclick on your layer > add alpha layer
** Colors > Color to Alpha
*** Color: #444488
*** Both sliders to 0
** Image > Trim to content
** (optional) Save (<kbd>Ctrl</kbd> + <kbd>S</kbd>)
** Export as png (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd>)
* '''Dream Daemon:''' Very tedious, but it will look better, since sprites for chasms etc. will properly connect.
* '''Dream Daemon:''' Very tedious, but it will look better, since sprites for chasms etc. will properly connect.
** Start your local server
** Start your local server
** Join with your BYOND-client and start ghosting
** Join with your '''BYOND client'''
** Turn yourself invisible
** '''Tab Admin > Aghost''' to start ghosting (Shortcut: <kbd>F5</kbd>)
** Disable the ingame-ui
** Adjust your view
** Go places or spawn in your maps / locations
*** Disable the ingame-ui
** Make lots screenshots
*** '''Tab Admin > Stealth Mode''' to turn your ghost invisible
** <s>Become insane</s> Have a lot of fun when combining the screenshots
*** Set '''Tab Ghost > View Range''' or '''Tab Special Verbs > Change View Range''' to increase your field of view
*** Adjust the shadows by repeatedly clicking '''Tab Ghost > Toggle Darkness'''
** Go places or spawn in your maps / locations with '''Tab Debug > Map template - Place'''
** Take screenshots (Shortcut <kbd>F2</kbd>)
 
==== Images of people ====
Getting images of people is more difficult than for objects, since people consist of all kinds of parts. This means you need ingame-screenshots:
* Start a local server with '''Dream Daemon'''
* Join with your '''BYOND client'''
* (optional) Pick a jobs with the clothes you want for your screenshots
* (optional) Build a 3x3 of tables and climb on them. The best place to do this is the lockerroom near arrivals. The even background of the tables will make it so much easier to crop out the background later.
* Rightclick your mob > Your name > View Variables
* Use the '''"select option"-dropdownmenu''' to change your mobtype
** Set species
** Make cyborg
** Other options include "Make alien" and "Make slime"
* Use the '''"select option"-dropdownmenu''' to modify your body
** Modify bodypart
** Modify organs
* Make sure the area is well-lit
** '''Tab Admin > Secrets > Fix all lights'''
** '''Tab Admin > Secrets > Make all areas powered'''
* Take screenshots (Shortcut F2)


=== Checking the game-code ===
=== Checking the game-code ===
Line 321: Line 298:


The easiest way to read the code is using the searchbar on [{{Constant/Giturl}} github].  
The easiest way to read the code is using the searchbar on [{{Constant/Giturl}} github].  
'''TODO: Add missing details and a good example.'''


[[Category:Guides]] [[Category:Game Resources]]
[[Category:Guides]] [[Category:Game Resources]]
{{Contribution guides}}
{{Contribution guides}}
Helpful Herbert
1,133

edits

Retrieved from "https://wiki.yogstation.net/wiki/Special:MobileDiff/31812...31986"

Navigation menu