Mosley: Text replacement - "/tg/station" to "{{SplurtStation}}"

2025-08-11T09:22:26Z

Text replacement - "/tg/station" to "{{SplurtStation}}"

← Older revision		Revision as of 09:22, 11 August 2025
Line 38:		Line 38:

	=== Online auto-creation ===		=== Online auto-creation ===
	On the ~~/tg/station~~ GitHub, a formatted block in your PR's description as described above will cause a bot to automatically generate a <tt>.yml</tt> file.		On the {{SplurtStation}} GitHub, a formatted block in your PR's description as described above will cause a bot to automatically generate a <tt>.yml</tt> file.

	The idea is to reduce merge conflicts caused by two PRs trying to edit the same file.		The idea is to reduce merge conflicts caused by two PRs trying to edit the same file.
Line 75:		Line 75:
	** <code>pip install PyYaml</code>		** <code>pip install PyYaml</code>
	** <code>pip install beautifulsoup4</code>		** <code>pip install beautifulsoup4</code>
	* With ~~/tg/station~~'s code, simply run makeChangelog.bat.		* With {{SplurtStation}}'s code, simply run makeChangelog.bat.
	* On Linux or other codebases, run <code>python tools/ss13_genchangelog.py html/changelog.html html/changelogs</code>		* On Linux or other codebases, run <code>python tools/ss13_genchangelog.py html/changelog.html html/changelogs</code>

imported>SpaceManiac: Remove "Game Resources" category

2020-12-04T03:40:20Z

Remove "Game Resources" category

New page

: [[Guide to contributing to the game]]

You can add changelog entries by using the following template in the body of your pull request:

:cl:
prefix: text
prefix: text
prefix: text
/:cl:

Your GitHub username is credited by default, or you can add a name at the end of the <tt>:cl:</tt> line to override it.

Valid prefixes are:

* [[File:Tick-circle.png]] add
* [[File:Cross-circle.png]] del
* [[File:Bug-minus.png]] fix
* [[File:Hard-hat-exclamation.png]] wip
* [[File:Wrench-screwdriver.png]] tweak
* [[File:Burn-exclamation.png]] experiment
* [[File:Spell-check.png]] spellcheck
* [[File:Music-plus.png]] soundadd
* [[File:Music-minus.png]] sounddel
* [[File:Image-plus.png]] imageadd
* [[File:Image-minus.png]] imagedel
* [[File:Scales_icon.png]] balance
* [[File:Coding.png]] code
* [[File:Burn-exclamation.png]] refactor
* [[File:Chrome-wrench.gif]] config
* [[File:Ban.png]] admin
* [[File:Hard-hat-exclamation.png]] server

== Advanced information ==
{{note|This guide thanks to friends from [http://ss13.nexisonline.net/wiki/Guide_to_Changelogs /vg/].}}

Changelogs are small YAML files that developers create to add their pull requests' changes to the master changelog.html file. A python script run by a maintainer collects all the changes specified and generates the HTML necessary, merging changes by the same author during the same day.

=== Online auto-creation ===
On the /tg/station GitHub, a formatted block in your PR's description as described above will cause a bot to automatically generate a <tt>.yml</tt> file.

The idea is to reduce merge conflicts caused by two PRs trying to edit the same file.

=== Committing a .yml file ===
PR changelogs are temporary and just get deleted after they're merged into the master changelog.

# Create <code>html/changelogs/''USERNAME-BRANCHNAME''.yml</code>.
## Go to <code>/master/html/changelogs/</code> on your branch.
## Create file <code>''USERNAME-BRANCHNAME''.yml</code> in the folder, where 'BRANCHNAME' the name of the branch on your fork and 'USERNAME' is your github username.
##* Example: <code>Deantwo-BrainlessShooting.yml</code>
##* File name is not super important but helps the maintainers know who made the file and which PR it is related to. Also prevents conflicts since two files won't have the same name.
# Copy the contents of [https://github.com/tgstation/-tg-station/blob/master/html/changelogs/example.yml this].
# Fill it out.
#* Make sure to set delete-after to true.
#* Also ensure you update the author name so you get credited appropriately.
# '''PROOFREAD.''' Changelog entries are final after they're merged.
# Add it to git so it's included with your PR.

'''File content example:'''
author: Deantwo

delete-after: True

changes:
- rscadd: "Added laser rifles for everyone."
- rscdel: "Removed everyone's brains."

=== Updating the Changelog ===

''Only maintainers need to do this.''

* First, install python3, pip, and PyYaml:
** After installing python and ensuring it and its Scripts/ folder is in PATH, download and run [https://raw.githubusercontent.com/pypa/pip/master/contrib/get-pip.py get-pip.py] with python.
** Once pip is installed run the following commands in your terminal
** <code>pip install PyYaml</code>
** <code>pip install beautifulsoup4</code>
* With /tg/station's code, simply run makeChangelog.bat.
* On Linux or other codebases, run <code>python tools/ss13_genchangelog.py html/changelog.html html/changelogs</code>

=== Screwed up Changelog ===
If a changelog needs to be edited after merge, a maintainer will need to edit the html/changelogs/.all_changelog.yml file in order to fix the database. (This file is hidden on Linux and Mac OSX.)

{{Contribution guides}}

Guide to Changelogs - Revision history

Mosley: Text replacement - "/tg/station" to "{{SplurtStation}}"

imported>SpaceManiac: Remove "Game Resources" category