Template:Ref FrameXML/doc
Creates a link to online repositories of current and past versions of FrameXML, such as Townlong-Yak.
This template assumes the repository can accept both patch names (such as 8.0.1) and hidden version/hotfix numbers (such as 392901) in a standardized url format to illustrate the differences from one version to the next. This template also assumes the repository can default to live or PTR code when the patch and version are omitted.
Parameters
Paremeters may be named as below, or left unnamed as 1=, 2= and 3=.
- file / 1=
- (Required) Filename or path from the root of a typical FrameXML archive
- patch= / 2=
- (Optional) Human-readable patch of the game, used to point to prior versions of the game and highlight when code was introduced or removed
- version= / 3=
- (Optional) Numeric version of the game, used by some online repositories to track subversions and hotfixes more precisely
- line= / 4=
- (Optional) Specific line number within a given patch or version (ignored if neither patch nor version are defined
- date= / 5=
- (Optional) Date when the framexml was originally published by Blizzard Entertainment
- diff=
- (Optional, available as a named parameter only) Constructs the link to show changes from the previous version
Examples
Unnamed parameters
{{Ref FrameXML|ActionButton.lua}}
- ActionButton.lua, archived at Townlong-Yak
{{Ref FrameXML|ActionButton.lua|8.0.1| |100|2018-10-16}}
- 2018-10-16, ActionButton.lua, patch 8.0.1, near line 100, archived at Townlong-Yak
{{Ref FrameXML|MyFolder/MyFile.me|1.0.0|12345|1|2000-01-01}}
- 2000-01-01, MyFile.me, version 1.0.0.12345, near line 1, archived at Townlong-Yak
Named parameters
{{Ref FrameXML|file=ActionButton.lua}}
- ActionButton.lua, archived at Townlong-Yak
{{Ref FrameXML|file=ActionButton.lua|patch=8.0.1|diff=|line=643}}
- ActionButton.lua, patch 8.0.1, near line 643, archived at Townlong-Yak
{{Ref FrameXML|file=Blizzard_ArenaUI/Blizzard_ArenaUI.lua|patch=7.2.5|version=24330|line=100}}
- Blizzard_ArenaUI.lua, version 7.2.5.24330, near line 100, archived at Townlong-Yak
Invalid usage
{{Ref FrameXML}}
- No frameXML filename or path specified. Please edit this article and add it here.
{{Ref FrameXML|InterfaceOptionsFrame.lua| | |1}}
- No patch or version specified. Please edit this article and add it here.InterfaceOptionsFrame.lua, archived at Townlong-Yak