Factorio:Style guide - Revision history

Bilka: /* Taking screenshots of the game */ code template for command

2025-06-06T10:30:09Z

Taking screenshots of the game: code template for command

← Older revision		Revision as of 10:30, 6 June 2025
Line 61:		Line 61:
	* Turn on {{Keybinding\|alt}} mode.		* Turn on {{Keybinding\|alt}} mode.
	* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.		* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.
	* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: /c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2} takes pixel perfect screenshots with the new high resolution graphics.		* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: <code>/c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2}</code> takes pixel perfect screenshots with the new high resolution graphics.
	* You can [[Console#Change_game_speed\|slow down the game]] or pause the game in the map editor to find the right moment for the picture.		* You can [[Console#Change_game_speed\|slow down the game]] or pause the game in the map editor to find the right moment for the picture.
	* Go into the highest zoom level you possibly can without missing any vital information.		* Go into the highest zoom level you possibly can without missing any vital information.

Cardinal: Added language suffix.

2025-03-17T10:34:13Z

Added language suffix.

← Older revision		Revision as of 10:34, 17 March 2025
Line 1:		Line 1:
			{{Languages}}
	This is the official Factorio style guide. Please follow this guide and the [[Factorio:Wiki rules\|rules]] when creating or editing pages and files on this wiki. Unlike the rules, failure to follow this guide will not be punished, however it is still highly encouraged to follow it.		This is the official Factorio style guide. Please follow this guide and the [[Factorio:Wiki rules\|rules]] when creating or editing pages and files on this wiki. Unlike the rules, failure to follow this guide will not be punished, however it is still highly encouraged to follow it.

Bilka: /* Taking screenshots of the game */

2025-01-25T21:56:28Z

Taking screenshots of the game

← Older revision		Revision as of 21:56, 25 January 2025
Line 57:		Line 57:
	* Turn off clouds, smoke and animated trees! The shadows distract from the actual content of the image.		* Turn off clouds, smoke and animated trees! The shadows distract from the actual content of the image.
	* Reset brightness, contrast and saturation to default in the graphics settings.		* Reset brightness, contrast and saturation to default in the graphics settings.
	* In [[Space Age]], try to take screenshot of entities on their respective planets/space platforms and prefer taking screenshots on [[Nauvis]] if possible.		* In [[Space Age]], try to take screenshot of entities on their respective planets/space platforms and otherwise prefer taking screenshots on [[Nauvis]] if possible.
	* Turn on {{Keybinding\|alt}} mode.		* Turn on {{Keybinding\|alt}} mode.
	* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.		* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.

Bilka: /* Taking screenshots of the game */ Write down the tile preference for infobox images

2025-01-15T16:00:34Z

Taking screenshots of the game: Write down the tile preference for infobox images

← Older revision		Revision as of 16:00, 15 January 2025
Line 68:		Line 68:
	* Don't use .jpg / .jpeg as a fileformat as you will lose detail.		* Don't use .jpg / .jpeg as a fileformat as you will lose detail.
	* Use the high resolution sprites!		* Use the high resolution sprites!
	* For images to be used in an infobox: Use zoom level 2 ~~and try~~ to make it 300×300px in size.		* For images to be used in an infobox:
			** Use zoom level 2.
			** Try to make the image 300×300px in size, or at least square.
			** Prefer a natural background like desert or grass over lab tiles.

	== Templates ==		== Templates ==

Bilka: /* Media */ Graphics are tinted based on the current planet, so try to match planet to entity and generally default for nauvis

2024-10-25T12:54:53Z

Media: Graphics are tinted based on the current planet, so try to match planet to entity and generally default for nauvis

← Older revision		Revision as of 12:54, 25 October 2024
Line 57:		Line 57:
	* Turn off clouds, smoke and animated trees! The shadows distract from the actual content of the image.		* Turn off clouds, smoke and animated trees! The shadows distract from the actual content of the image.
	* Reset brightness, contrast and saturation to default in the graphics settings.		* Reset brightness, contrast and saturation to default in the graphics settings.
			* In [[Space Age]], try to take screenshot of entities on their respective planets/space platforms and prefer taking screenshots on [[Nauvis]] if possible.
	* Turn on {{Keybinding\|alt}} mode.		* Turn on {{Keybinding\|alt}} mode.
	* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.		* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.
Line 67:		Line 68:
	* Don't use .jpg / .jpeg as a fileformat as you will lose detail.		* Don't use .jpg / .jpeg as a fileformat as you will lose detail.
	* Use the high resolution sprites!		* Use the high resolution sprites!
	* For images to be used in an infobox: ~~use~~ zoom level 2 and try to make it 300×300px in size.		* For images to be used in an infobox: Use zoom level 2 and try to make it 300×300px in size.

	== Templates ==		== Templates ==

Bilka: /* Capitalization */ Clarifications regarding the expansion

2024-10-10T13:40:37Z

Capitalization: Clarifications regarding the expansion

← Older revision		Revision as of 13:40, 10 October 2024
Line 28:		Line 28:

	=== Capitalization ===		=== Capitalization ===
	* Only the first letter ~~and proper~~ nouns such as "Nauvis" should be capitalized ~~in section headings or page names~~.		* Only the first letter should be capitalized in section headings or page names.
	* In-game items, entities, and other in-game object names are common nouns and should not be capitalized unless they start a new sentence.		* Proper nouns such as planet names ("Nauvis", "Gleba", ...) and the names of the expansion mods ("Space Age", "Quality", "Elevated Rails") should be capitalized. However, the content they contain (quality tiers, elevated rail entity, etc.) should not be capitalized.
			* In-game items, entities, and other in-game object names are common nouns and should not be capitalized unless they start a new sentence.
	* When linking to another page within a flowing text, use normal capitalization for the link. For example: <code><nowiki>"in order to craft [[iron gear wheel]]s, [[iron plate]]s must..."</nowiki></code> and ''not'' <code><nowiki>"in order to craft [[Iron gear wheel]]s, [[Iron plate]]s must...</nowiki></code>. Remember that the first letter is automatically capitalized to resolve the page when the link is clicked.		* When linking to another page within a flowing text, use normal capitalization for the link. For example: <code><nowiki>"in order to craft [[iron gear wheel]]s, [[iron plate]]s must..."</nowiki></code> and ''not'' <code><nowiki>"in order to craft [[Iron gear wheel]]s, [[Iron plate]]s must...</nowiki></code>. Remember that the first letter is automatically capitalized to resolve the page when the link is clicked.

Bilka: /* Templates */ link to template category

2024-08-30T15:04:34Z

Templates: link to template category

← Older revision		Revision as of 15:04, 30 August 2024
Line 69:		Line 69:

	== Templates ==		== Templates ==
	* Templates are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.		* [[:Category:Templates\|Templates]] are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.
	* Templates should be have their use described using [[Template:Documentation]] by including it in the template code: <nowiki><noinclude>{{doc}}</noinclude></nowiki>		* Templates should be have their use described using [[Template:Documentation]] by including it in the template code: <nowiki><noinclude>{{doc}}</noinclude></nowiki>
	* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.		* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.

Bilka: /* Media */ updated with new graphics settings

2021-12-03T11:29:04Z

Media: updated with new graphics settings

Bilka: Removed usages for Template:Tl (see User talk:SyntaxTerror#Template:Tl for why it was removed)

2020-08-11T19:36:55Z

Removed usages for Template:Tl (see User talk:SyntaxTerror#Template:Tl for why it was removed)

SyntaxTerror: links to templates using {{tl}} (template:tl)

2020-08-07T16:04:33Z

links to templates using {{tl}} (template:tl)

← Older revision		Revision as of 10:30, 6 June 2025
Line 61:		Line 61:
	* Turn on {{Keybinding\|alt}} mode.		* Turn on {{Keybinding\|alt}} mode.
	* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.		* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.
	* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: /c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2} takes pixel perfect screenshots with the new high resolution graphics.		* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: <code>/c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2}</code> takes pixel perfect screenshots with the new high resolution graphics.
	* You can [[Console#Change_game_speed\|slow down the game]] or pause the game in the map editor to find the right moment for the picture.		* You can [[Console#Change_game_speed\|slow down the game]] or pause the game in the map editor to find the right moment for the picture.
	* Go into the highest zoom level you possibly can without missing any vital information.		* Go into the highest zoom level you possibly can without missing any vital information.

← Older revision		Revision as of 11:29, 3 December 2021
Line 42:		Line 42:
	* When possible, avoid putting important text in images, as it is not search-able, and makes finding that info harder. The text also can not be translated, so each language would need its own version of the image.		* When possible, avoid putting important text in images, as it is not search-able, and makes finding that info harder. The text also can not be translated, so each language would need its own version of the image.
	** If a translated version of an image is needed, please upload it under the same name as the original image, with your language suffix at the end, e.g. (Programmable_speaker_ui.png in German -> Programmable_speaker_ui-de.png)		** If a translated version of an image is needed, please upload it under the same name as the original image, with your language suffix at the end, e.g. (Programmable_speaker_ui.png in German -> Programmable_speaker_ui-de.png)
	* When uploading an image, please use a descriptive, unique name~~, and fill out the description box~~. Images given a non-descriptive name will be renamed.		* When uploading an image, please use a descriptive, unique name. Images given a non-descriptive name will be renamed.
	* Item icons should be named after their English in-game name.		* Item icons should be named after their English in-game name.
	* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.		* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.
Line 49:		Line 49:
	* Gifs of mechanics are allowed and encouraged.		* Gifs of mechanics are allowed and encouraged.
	* Please ensure that the image you are uploading is of good quality. Use the PNG filetype when possible.		* Please ensure that the image you are uploading is of good quality. Use the PNG filetype when possible.
	* Video guides or tutorials should not be placed in the main wiki, however links to them are allowed in the "See also" section of pages.
	* All in-game sprites/icons that were retrieved directly from the game source files need to have [[Template:Game image]] on their file page. This is essential to indicate that you do not own the copyrights of the image.		* All in-game sprites/icons that were retrieved directly from the game source files need to have [[Template:Game image]] on their file page. This is essential to indicate that you do not own the copyrights of the image.

Line 55:		Line 54:
	* Place <code><nowiki>{{Screenshot}}</nowiki></code> in the file description when uploading it.		* Place <code><nowiki>{{Screenshot}}</nowiki></code> in the file description when uploading it.
	* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).		* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).
	* Turn off clouds and ~~smoke~~! The shadows distract from the actual content of the image.		* Turn off clouds, smoke and animated trees! The shadows distract from the actual content of the image.
	* Turn on ~~info (~~{{Keybinding\|alt}}).		* Reset brightness, contrast and saturation to default in the graphics settings.
	* Use [[Console#Enable_god_mode\|god mode]]! You can move anywhere on the map and your character won't be in the picture.		* Turn on {{Keybinding\|alt}} mode.
			* Use [[Console#Enable_god_mode\|god mode]] or the [[map editor]]! You can move anywhere on the map and your character won't be in the picture.
	* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: /c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2} takes pixel perfect screenshots with the new high resolution graphics.		* It is possible to take large screenshots using a [[Console#Large_Screenshots\|console command]]. For example: /c game.take_screenshot{{x=1024, y=1024}, showgui=false, show_entity_info=true, zoom=2} takes pixel perfect screenshots with the new high resolution graphics.
	* You can [[Console#Change_game_speed\|slow down the game]] to find the right moment for the picture.		* You can [[Console#Change_game_speed\|slow down the game]] or pause the game in the map editor to find the right moment for the picture.
	* Go into the highest zoom level you possibly can without missing any vital information.		* Go into the highest zoom level you possibly can without missing any vital information.
	* A good in-game picture should be built so that only the relevant entities/items are shown. Anything in the photo other than what you are trying to show/explain is unnecessary clutter.		* A good in-game picture should be built so that only the relevant entities/items are shown. Anything in the photo other than what you are trying to show/explain is unnecessary clutter.

← Older revision		Revision as of 19:36, 11 August 2020
Line 5:		Line 5:
	* See the [[Factorio:Editor noticeboard\|Editor noticeboard]] for guidelines on whether the wiki is currently targeting the stable or experimental version of the game.		* See the [[Factorio:Editor noticeboard\|Editor noticeboard]] for guidelines on whether the wiki is currently targeting the stable or experimental version of the game.
	* [[Upcoming features]] should be referenced with a link to a comment or image posted by a member of Factorio's development staff. Please consider that the [[News\|Factorio Friday Facts]] usually show plans and not confirmed changes, so information should not be treated as such.		* [[Upcoming features]] should be referenced with a link to a comment or image posted by a member of Factorio's development staff. Please consider that the [[News\|Factorio Friday Facts]] usually show plans and not confirmed changes, so information should not be treated as such.
	* Pages about removed content should be marked with the <code>{{~~tl\|~~archive}}</code> template and not be edited any further, except to remove redlinks or outdated categories.		* Pages about removed content should be marked with the <code><nowiki>{{archive}}</nowiki></code> template and not be edited any further, except to remove redlinks or outdated categories.

	== Language ==		== Language ==
Line 35:		Line 35:
	* This wiki uses a history section on all content pages to track when entities/items are changed in the game. To do this, the wiki uses the [[Template:History\|history]] template, which provides automatic formatting and version linking. The header for this section should be <code><nowiki>== History ==</nowiki></code>.		* This wiki uses a history section on all content pages to track when entities/items are changed in the game. To do this, the wiki uses the [[Template:History\|history]] template, which provides automatic formatting and version linking. The header for this section should be <code><nowiki>== History ==</nowiki></code>.
	* Bugs and bug fixes must not be placed in the update history section of a page. Any kind of bug should be reported on the forums and has no place on the wiki unless it is deemed "not a bug" by the developers. In that case, the specific behavior should be documented on the page itself and not in its history section. However, bug fixes ''are'' documented on [[version history]] pages, since they are part of the official changelog.		* Bugs and bug fixes must not be placed in the update history section of a page. Any kind of bug should be reported on the forums and has no place on the wiki unless it is deemed "not a bug" by the developers. In that case, the specific behavior should be documented on the page itself and not in its history section. However, bug fixes ''are'' documented on [[version history]] pages, since they are part of the official changelog.
	* While a history section is not required for information pages such as [[Railway]], all content pages concerning entities or mechanics of the game should have a history, taken from the changelog file provided with a standard Factorio install. The ~~<code>{{tl~~\|history~~}}</code>~~ template will automatically link to the relevant page in [[version history]].		* While a history section is not required for information pages such as [[Railway]], all content pages concerning entities or mechanics of the game should have a history, taken from the changelog file provided with a standard Factorio install. The [[Template:History\|history template]] will automatically link to the relevant page in [[version history]].
	* Trivia and general facts are allowed, as long as it does not contain personal opinion or conjecture. These facts should be placed in a specific "Trivia" section. If possible, (such as detailing information provided by a dev through official channels) provide a source link.		* Trivia and general facts are allowed, as long as it does not contain personal opinion or conjecture. These facts should be placed in a specific "Trivia" section. If possible, (such as detailing information provided by a dev through official channels) provide a source link.
	* The history section should not be included in translated pages. Likewise, the [[version history]] is not to be translated. See the [[Factorio:translation guide\|translation guide]] for further information.		* The history section should not be included in translated pages. Likewise, the [[version history]] is not to be translated. See the [[Factorio:translation guide\|translation guide]] for further information.
Line 45:		Line 45:
	* Item icons should be named after their English in-game name.		* Item icons should be named after their English in-game name.
	* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.		* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.
	* Please mark any duplicated files for deletion ~~with~~ the <code>{{~~tl\|~~delete}}</code> ~~template~~.		* Please mark any duplicated files for deletion by placing the [[Template:Delete\|deletion template]] on the page: <code><nowiki>{{delete}}</nowiki></code>.
	* If uploading images that are not of Factorio, please ensure you hold rights to upload the image.		* If uploading images that are not of Factorio, please ensure you hold rights to upload the image.
	* Gifs of mechanics are allowed and encouraged.		* Gifs of mechanics are allowed and encouraged.
Line 53:		Line 53:

	=== Taking screenshots of the game ===		=== Taking screenshots of the game ===
	* Place ~~the~~ <code>{{~~tl\|screenshot~~}}</code> ~~template~~ in the file description when uploading it.		* Place <code><nowiki>{{Screenshot}}</nowiki></code> in the file description when uploading it.
	* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).		* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).
	* Turn off clouds and smoke! The shadows distract from the actual content of the image.		* Turn off clouds and smoke! The shadows distract from the actual content of the image.
Line 70:		Line 70:
	== Templates ==		== Templates ==
	* Templates are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.		* Templates are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.
	* Templates should ~~include~~ <~~code~~>{{~~tl\|documentation~~}}</~~code~~> ~~inside of noinclude tags, and should have a~~ /~~doc sub-page to describe the use of the template.~~		* Templates should be have their use described using [[Template:Documentation]] by including it in the template code: <nowiki><noinclude>{{doc}}</noinclude></nowiki>
	* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.		* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.

	== See also ==		== See also ==
	* [[Factorio:Wiki_rules\|The rules]]		* [[Factorio:Wiki_rules\|The rules]]

← Older revision		Revision as of 16:04, 7 August 2020
Line 2:		Line 2:

	== Page creation and upcoming/outdated content ==		== Page creation and upcoming/outdated content ==

	* Avoid creating unnecessary pages or subpages. If the info you are trying to add is related to an entity in-game, please place the info on that entity's page.		* Avoid creating unnecessary pages or subpages. If the info you are trying to add is related to an entity in-game, please place the info on that entity's page.
	* See the [[Factorio:Editor noticeboard\|Editor noticeboard]] for guidelines on whether the wiki is currently targeting the stable or experimental version of the game.		* See the [[Factorio:Editor noticeboard\|Editor noticeboard]] for guidelines on whether the wiki is currently targeting the stable or experimental version of the game.
	* [[Upcoming features]] should be referenced with a link to a comment or image posted by a member of Factorio's development staff. Please consider that the [[News\|Factorio Friday Facts]] usually show plans and not confirmed changes, so information should not be treated as such.		* [[Upcoming features]] should be referenced with a link to a comment or image posted by a member of Factorio's development staff. Please consider that the [[News\|Factorio Friday Facts]] usually show plans and not confirmed changes, so information should not be treated as such.
	* Pages about removed content should be marked with the <code~~><nowiki~~>{{archive}}~~</nowiki>~~</code> template and not be edited any further, except to remove redlinks or outdated categories.		* Pages about removed content should be marked with the <code>{{tl\|archive}}</code> template and not be edited any further, except to remove redlinks or outdated categories.

	== Language ==		== Language ==

	* Edit in an “encyclopedia” style, avoiding use of the first person or any personal bias. Avoid words like I, me, you, etc. The tutorial namespace is exempt from this guideline.		* Edit in an “encyclopedia” style, avoiding use of the first person or any personal bias. Avoid words like I, me, you, etc. The tutorial namespace is exempt from this guideline.
	* Correct all typos found, even if changing the sentence layout is necessary. Comprehension is important.		* Correct all typos found, even if changing the sentence layout is necessary. Comprehension is important.
Line 17:		Line 15:
	* Items, entities, and other in-game objects should be named and translated according to the official in-game translations.		* Items, entities, and other in-game objects should be named and translated according to the official in-game translations.
	* To automatically translate page names, infoboxes and similar templates, use [[Template:Translation]].		* To automatically translate page names, infoboxes and similar templates, use [[Template:Translation]].
	** See also: ''[[Factorio:Translation guide\|~~Translation~~ guide]]''		** See also the ''[[Factorio:Translation guide\|translation guide]]''.

	== Page layout and formatting ==		== Page layout and formatting ==

	* Typically, a page will start with a short intro, then the content of the page, a history section, and a "see also" section. Please follow this when creating content pages. Categories should be used sparingly.		* Typically, a page will start with a short intro, then the content of the page, a history section, and a "see also" section. Please follow this when creating content pages. Categories should be used sparingly.
	* Please use sane formatting, and do not Capitalize Words Like This, or L I K E T H I S.		* Please use sane formatting, and do not Capitalize Words Like This, or L I K E T H I S.
Line 31:		Line 28:

	=== Capitalization ===		=== Capitalization ===

	* Only the first letter and proper nouns such as "Nauvis" should be capitalized in section headings or page names.		* Only the first letter and proper nouns such as "Nauvis" should be capitalized in section headings or page names.
	* In-game items, entities, and other in-game object names are common nouns and should not be capitalized unless they start a new sentence.		* In-game items, entities, and other in-game object names are common nouns and should not be capitalized unless they start a new sentence.
Line 37:		Line 33:

	=== The history section ===		=== The history section ===

	* This wiki uses a history section on all content pages to track when entities/items are changed in the game. To do this, the wiki uses the [[Template:History\|history]] template, which provides automatic formatting and version linking. The header for this section should be <code><nowiki>== History ==</nowiki></code>.		* This wiki uses a history section on all content pages to track when entities/items are changed in the game. To do this, the wiki uses the [[Template:History\|history]] template, which provides automatic formatting and version linking. The header for this section should be <code><nowiki>== History ==</nowiki></code>.
	* Bugs and bug fixes must not be placed in the update history section of a page. Any kind of bug should be reported on the forums and has no place on the wiki unless it is deemed "not a bug" by the developers. In that case, the specific behavior should be documented on the page itself and not in its history section. However, bug fixes ''are'' documented on [[version history]] pages, since they are part of the official changelog.		* Bugs and bug fixes must not be placed in the update history section of a page. Any kind of bug should be reported on the forums and has no place on the wiki unless it is deemed "not a bug" by the developers. In that case, the specific behavior should be documented on the page itself and not in its history section. However, bug fixes ''are'' documented on [[version history]] pages, since they are part of the official changelog.
	* While a history section is not required for information pages such as [[Railway]], all content pages concerning entities or mechanics of the game should have a history, taken from the changelog file provided with a standard Factorio install. The <code~~><nowiki~~>{{history}}~~</nowiki>~~</code> template will automatically link to the relevant page in [[version history]].		* While a history section is not required for information pages such as [[Railway]], all content pages concerning entities or mechanics of the game should have a history, taken from the changelog file provided with a standard Factorio install. The <code>{{tl\|history}}</code> template will automatically link to the relevant page in [[version history]].
	* Trivia and general facts are allowed, as long as it does not contain personal opinion or conjecture. These facts should be placed in a specific "Trivia" section. If possible, (such as detailing information provided by a dev through official channels) provide a source link.		* Trivia and general facts are allowed, as long as it does not contain personal opinion or conjecture. These facts should be placed in a specific "Trivia" section. If possible, (such as detailing information provided by a dev through official channels) provide a source link.
	* The history section should not be included in translated pages. Likewise, the [[version history]] is not to be translated. See the [[Factorio:translation guide\|translation guide]] for further information.		* The history section should not be included in translated pages. Likewise, the [[version history]] is not to be translated. See the [[Factorio:translation guide\|translation guide]] for further information.

	== Media ==		== Media ==

	* When possible, avoid putting important text in images, as it is not search-able, and makes finding that info harder. The text also can not be translated, so each language would need its own version of the image.		* When possible, avoid putting important text in images, as it is not search-able, and makes finding that info harder. The text also can not be translated, so each language would need its own version of the image.
	** If a translated version of an image is needed, please upload it under the same name as the original image, with your language suffix at the end, e.g. (Programmable_speaker_ui.png in German -> Programmable_speaker_ui-de.png)		** If a translated version of an image is needed, please upload it under the same name as the original image, with your language suffix at the end, e.g. (Programmable_speaker_ui.png in German -> Programmable_speaker_ui-de.png)
Line 51:		Line 45:
	* Item icons should be named after their English in-game name.		* Item icons should be named after their English in-game name.
	* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.		* When uploading an updated version of an image, use the "upload a new version of this image" link found on the old file's page. This ensures that all old instances are updated automatically.
	* Please mark any duplicated files for deletion with the <code~~><nowiki~~>{{delete}}~~</nowiki>~~</code> template.		* Please mark any duplicated files for deletion with the <code>{{tl\|delete}}</code> template.
	* If uploading images that are not of Factorio, please ensure you hold rights to upload the image.		* If uploading images that are not of Factorio, please ensure you hold rights to upload the image.
	* Gifs of mechanics are allowed and encouraged.		* Gifs of mechanics are allowed and encouraged.
Line 59:		Line 53:

	=== Taking screenshots of the game ===		=== Taking screenshots of the game ===
	* Place <code>{{tl\|~~Screenshot~~}}</code> in the file description when uploading it.		* Place the <code>{{tl\|screenshot}}</code> template in the file description when uploading it.
	* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).		* Take pictures at day! Use night or dawn only if you need to explain something that only works at night (for example, the lights).
	* Turn off clouds and smoke! The shadows distract from the actual content of the image.		* Turn off clouds and smoke! The shadows distract from the actual content of the image.
Line 75:		Line 69:

	== Templates ==		== Templates ==

	* Templates are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.		* Templates are to be used for formatting/common text on many pages. Do not create templates for only a few pages, except for special circumstances.
	* Templates should include <code~~><nowiki~~>{{documentation}}~~</nowiki>~~</code> inside of noinclude tags, and should have a /doc sub-page to describe the use of the template.		* Templates should include <code>{{tl\|documentation}}</code> inside of noinclude tags, and should have a /doc sub-page to describe the use of the template.
	* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.		* Avoid making many sequential edits to a commonly used template. This creates strain on Wube's servers to update across all the pages. Perform edits to those templates with a single edit only. If you need to edit a protected template, please contact an admin, as these templates are especially heavily used.

	== See also ==		== See also ==
	* [[Factorio:Wiki_rules\|The rules]]		* [[Factorio:Wiki_rules\|The rules]]