Factorio:Wiki rules

This page is used for contributors on this wiki.

Get an account

Just follow the instructions for registering. It takes normally one or two days to be added, because every user is added by hand to avoid spam.

How to contribute?

This wiki is the work of a team. The wiki is created in an agile process: If someone asks something in the forum, it's a good idea to add it into the forum. No special knowledge is needed for that, just write and if it is ok, it isn't deleted :)

But eventually it will be changed or removed by others.

Don't be afraid: There is nothing, which you can really break, because the wiki has a version history.

Basic

• Read the wiki pages.
  • If you don't like something, change it.
  • If you find typos, change it.
  • If you find something is wrong described, make a prove, that it is wrong and change it.

Advanced

• Add missing information at the right place.

This is in most cases easy, but sometimes could be really difficult. Ask for help if you don't know.

• Split the information on big pages into subpages.

See for example the Railway network.

• If you find that a topic belongs to two pages, then don't copy the information into the two pages, but create a new page and link.

Best example for this is the Power Production page.

• Take the right words.

Factorio has a set of words, which have a fixed meaning. For example: an entity can be mined, an item can be picked up. Removing them means something different! Ask the factorio wiki, if you are unsure.

• A picture says more than 1000 words.

Make pictures, if possible. In some case use GIFs! See down.

• You can also go to the Wiki To-do List and look, if there is a job you like.

Discussions

I (ssilk) prefer the forum for discussions and I hope this is not a problem, because I think, discussions on wiki-pages is to high-end for most potential wiki-writers.

Existing discussions

In the descending order of date:

http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2047

http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3205

http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2429

http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2255

Translations

This is currently a mess!

This is how it should work

This method is used by the Mediawiki-Team and we want to adapt it. Example:

http://www.mediawiki.org/wiki/Help:Navigation The english default

http://www.mediawiki.org/wiki/Help:Navigation/es Spanish translation

http://www.mediawiki.org/wiki/Help:Navigation/de German tranlation

http://www.mediawiki.org/wiki/Help:Navigation/ru Russian translation

First some rules

• The default language is English.
• Any other language has no right to obtain a pagename, which collides with English.
• No other language has the right to use a pagename, which means the same or something different in another language.

This is the logical consequence of the above rules

• Let's say we have a page named Transport network.
• Now someone translate that page to German: Because he doesn't know better, he names the page "Transport netzwerk".
• This is a mess! Because for example in Swedish (it's just an example) this is also the translated pagename.
• What's now right? Is Transport netzwerk now a German or a Swedish page?

Solution to this

The right pagename is Transport network/de for the German and Transport network/sv for the Swedish page.

Whuuaaaa... "Transport network" - that's not German!

Yes, but it is the only way to keep the namespace clean.

And there is nothing about making a redirect page Transport netzwerk which redirects to Transport network/de. Or make a page where the user can choose if he wants the German or Swedish page.

So what do I need to do now?

• If you want to translate a page, then do not rename the page, just add a "/" and the standard macro-language-code to the pagename.

"Inserters" becomes "Inserters/fr" for France, "Inserters/ru" for Russian etc.

• If you are working on a page, which has a translated pagename then rename (Move) it! Search the orginal pagename, add the language-code (see above) and move it to the new pagename. A redirect is automatically left for the old pagename!

(More to explain, language macro, see main-page at top right)

Pictures

Picture formats

For making it simple we should use only formats based on 100. This is to avoid different sized pics which look staggered. This is especially important for the width, for the height it is not that problem. For example: 200x200, 300x100, 400x232. For existing pics (old pics use often a width of 256 px) reduce the with in text to 200 px (and analogous).

• (100 - 200) x (100-300) px

for flowing in the text, pictures which explain the text, the browser can embed this into it's own rendering. You can put them left or right, the text should flow around.

• (400 - 600) x (100 - 600) px

Something like a banner. A big pic which stays alone in its line. You may put simply a ":" in front of it to intend the pic and keep it away from flowing text.

• 300 x 300 px

This is especially for gif animations. Gif animations cannot be reduced in size, cause mediawiki re-renders the picture and the result is the first frame of the gif! See for example these pics: http://www.factorioforums.com/wiki/index.php?limit=200&ilsearch=Mpstark&user=&title=Special%3AListFiles

• the biggest format for flowing text should be: 600x600px

Making pictures out of the game

Do's:

• Take pictures at day! Turn on daylight! Use night or dawn only, if needed to explain something.
• Turn off clouds! The shadows are especially in GIF-animations not useful.
• Steam/smoke is also not so useful.
• Use god mode! Lua/Player#controllertype. You can go to every place and don't stand in the way of the picture.
• You can slowdown the game to find the right moment for the picture. Slowdown is also useful, if you use Gifcam, which makes screenshoot in 30 frames/sec only.
• You can use also the Lua/Game#peacefulmode, to be not disturbed by the natives.
• You can stop the game in the right moment using SHIFT-SPACE key. That also blends the grid in.
• Learn how to use the Debug mode to add relevant information into this picture.
• Go into the highest zoom level you possibly can, without missing any vital information.
• A good in-game picture should be rebuilt, so that only the relevant entities/items are shown. Every repetition, every unneeded element will complicate it.

Dont's

• Don't make pictures of ultra-complicated stuff! Add only as much elements, which are needed to understand, how that might work. Exception: if you show how that could look in the end.
• Don't just take a screenshot. Try to remove all unneeded informations from the picture.
• Try to make a picture without the character, except if to show something; then face the character to it.

See http://www.factorioforums.com/forum/viewtopic.php?f=6&t=2472 for more.

Optimizing the picture before upload

• Cut as much as possible/nice.
• Resolution should not normally be higher than 600x600 px. If that seems too small, then you should rethink what you want to do.
• Do not add textual information into the pictures! Instead add numbers or letters in it and add the text on the wiki-page; otherwise, it isn't searchable information,if it is written into the pic.
• Sharpen the pictures. For the wiki it looks quite better to sharpen the pictures one or two times.

Making animations

This has to be tested a bit:

Gifcam (PC only)

Licecap (also for Mac)

Good example pictures: http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3920

In-game API for screenshots

http://www.factorioforums.com/forum/viewtopic.php?f=25&t=4109#p30605

Looks like a plan: create a world. Walk through the world. Start a replay of this walk and then add making screenshots.

More or less like the method used in the demo-video, but take only some gif-animations or single pictures.