Tutorial:Mod changelog format: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(outline)
(Added example and info easily found in source code, added more todos)
Line 1: Line 1:
example changelog


TODO
mod portal doesnt parse changelog like this
mod portal doesnt parse changelog like this
== General formattting info ==
completely empty lines are ignored?


Rule 1: No tabs. Tabs are the devil.<br>
* Parsing errors can be found in the [[log file]] in the [[user data directory]].
Rule 2: No whitespace at the end of lines. Use something like https://marketplace.visualstudio.com/items?itemName=MadsKristensen.TrailingWhitespaceVisualizer.<br>
 
Rule 3: https://forums.factorio.com/67140
<!-- maybe https://forums.factorio.com/67140 -->
indentation is two spaces
<!-- maybe link to vs code extension that has changelog hinting from jarg -->
link to vs code extension that has changelog hinting from jarg
 
== Important general format ==
 
* Do not use tabs
** Indentation is done with two spaces
* Do not leave whitespace at the end of lines
 
Usually, text editors can enforce this automatically, it is recommended to set this up.
 
== Example ==
It may be simpler to copy this example into your changelog and modify it than to start from scratch.
<pre>---------------------------------------------------------------------------------------------------
Version: 1.1.60
Date: 06. 06. 2022
  Features:
    - This is an entry in the "Features" category.
    - This is another entry in the "Features" category.
  Balancing:
    - This is a multiline entry in the "Balancing" category.
      There is some extra information here because it is needed for the example.
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
  Bugfixes:
    - Fixed that item requests didn't subtract items picked up from ground when reviving ghosts. (https://forums.factorio.com/102329)
    - Fixed burner inserter would not fuel itself when drop target was full. (https://forums.factorio.com/102449)
---------------------------------------------------------------------------------------------------
Version: 1.1.66
Date: 19. 08. 2022
  Major Features:
    - Initial release.
</pre>


== Formatting rules ==
== Formatting rules ==
[[#Important general format]] applies everywhere and will lead to confusing error messages if not followed.
=== Version start (?) Sections start? ===
Must start with exactly <code>---------------------------------------------------------------------------------------------------</code> followed by a newline.


Date
The next line must be a [[#Version]] line.
=== Version ===
Must start with exactly <code>Version: </code>, note the space after the colon. The remaining part of the line will be parsed as the version TODOthe section is about. TODO version format
TODO duplication?
TODO must be given
=== Date ===
Must start with exactly <code>Date: </code>, note the space after the colon. The remaining part of the line will be parsed as the dateTODO the version was released. TODO data format
TODO duplication?
=== Category ===


Version
Must start with exactly two spaces. The remaining part of the line will be parsed as the category. Must end with a colon (reminder, no whitespace at end of line!). This colon is removed for the purpose of display. TODO names and sorting


Category names and sorting
=== Entry ===


entries and multiline entries
Must start with exactly four spaces followed by exactly <code>- </code> (note the space after the dash) for a single line entry. For a multiline entry, lines after the first line must start with exactly six spaces.
TODO

Revision as of 15:08, 10 November 2022

TODO mod portal doesnt parse changelog like this completely empty lines are ignored?


Important general format

  • Do not use tabs
    • Indentation is done with two spaces
  • Do not leave whitespace at the end of lines

Usually, text editors can enforce this automatically, it is recommended to set this up.

Example

It may be simpler to copy this example into your changelog and modify it than to start from scratch.

---------------------------------------------------------------------------------------------------
Version: 1.1.60
Date: 06. 06. 2022
  Features:
    - This is an entry in the "Features" category.
    - This is another entry in the "Features" category.
  Balancing:
    - This is a multiline entry in the "Balancing" category.
      There is some extra information here because it is needed for the example.
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
  Bugfixes:
    - Fixed that item requests didn't subtract items picked up from ground when reviving ghosts. (https://forums.factorio.com/102329)
    - Fixed burner inserter would not fuel itself when drop target was full. (https://forums.factorio.com/102449)
---------------------------------------------------------------------------------------------------
Version: 1.1.66
Date: 19. 08. 2022
  Major Features:
    - Initial release.

Formatting rules

#Important general format applies everywhere and will lead to confusing error messages if not followed.

Version start (?) Sections start?

Must start with exactly --------------------------------------------------------------------------------------------------- followed by a newline.

The next line must be a #Version line.

Version

Must start with exactly Version: , note the space after the colon. The remaining part of the line will be parsed as the version TODOthe section is about. TODO version format TODO duplication? TODO must be given

Date

Must start with exactly Date: , note the space after the colon. The remaining part of the line will be parsed as the dateTODO the version was released. TODO data format TODO duplication?

Category

Must start with exactly two spaces. The remaining part of the line will be parsed as the category. Must end with a colon (reminder, no whitespace at end of line!). This colon is removed for the purpose of display. TODO names and sorting

Entry

Must start with exactly four spaces followed by exactly - (note the space after the dash) for a single line entry. For a multiline entry, lines after the first line must start with exactly six spaces. TODO