doc
This template provides an alternative to Template:Tl for linking to source code.
This uses the GitHub mirror instead of Diffusion the Gitblit server at git.wikimedia.org (WMF is deprecating gitblit and git.wikimedia.org in 2015). Editors may find GitHub's interface more user-friendly, faster responding, visually appealing, or otherwise preferable. Compare:
- Script error: No such module "callsigns"./browse/REL1_25/index.php$39 diffusion link ←
{{git file|file=index.php|text=diffusion link|line=39|branch=REL1_25}}
- github link ←
{{github|index.php|github link|line=39|branch=REL1_25}}
Usage
Basic
{{github |file=composer.json }} {{github |repo=mediawiki-extensions-Flow |file=composer.json }}
produces:
Action
{{github |repo=mediawiki-extensions-EventLogging |file=server/bin/eventlogging-devserver |text=development server | action=raw }}
produces:
Line number
{{github |file=tests/phpunit/includes/MessageTest.php |line=152 }}
produces:
<templatedata> { "params": { "repo": { "description": "Full repository name (e.g. \"mediawiki\" or \"mediawiki/extensions/EventLogging\"). Must not include any \".git\" suffix.", "type": "string", "default": "mediawiki" }, "action": { "description": "A GitHub repo action. One of \"blob\", \"raw\", \"blame\", \"commits\", or \"tree\"", "type": "string", "default": "blob" }, "branch": { "type": "string", "default": "master" }, "file": { "type": "string", "default": "", "required": true }, "line": { "type": "number" }, "text": { "description": "Custom label for the link created by this template.", "type": "string", "default": "The file path" } }, "description": "A convenient way of linking to source code.", "paramOrder": [ "repo", "action", "branch", "file", "line", "text" ] } </templatedata>