Majestix: 1 revision imported: Initial Setup

2026-04-12T06:16:26Z

1 revision imported: Initial Setup

← Older revision		Revision as of 08:16, 12 April 2026
(No difference)

en>Tactica: Change paramOrder in the TemplateData block to have |File= first.

2025-11-22T03:08:21Z

Change paramOrder in the TemplateData block to have |File= first.

New page

<noinclude>{{Documentation subpage}}</noinclude>
== Usage ==
<templatedata>
{
"params": {
"project": {
"label": {
"en": "Repository",
"cs": "Úložiště",
"pt": "Repositório",
"tr": "Depo"
},
"description": {
"en": "Which Git repository the file is in.",
"cs": "Ve kterém úložišti Git se soubor nachází.",
"pt": "Em que repositório do Git está o ficheiro.",
"tr": "Dosyanın içinde bulunduğu Git deposu."
},
"type": "string",
"default": {
"en": "mediawiki/core",
"cs": "mediawiki/core",
"pt": "mediawiki/core",
"tr": "mediawiki/core"
}
},
"action": {
"label": {
"en": "Mode",
"cs": "Mód",
"pt": "Modo",
"tr": "Mod"
},
"description": {
"en": "One of “browse”, “tree” or “blame” or “history”.",
"cs": "Jedno z “browse”, “tree” nebo “blame” nebo “history”.",
"pt": "Um de “explorar”, “árvore” ou “blame” ou “histórico”.",
"tr": "“browse\", “tree” veya “blame” veya “history” modlardan biri."
},
"type": "string",
"default": {
"en": "browse",
"cs": "browse",
"pt": "explorar",
"tr": "browse"
}
},
"branch": {
"label": {
"en": "Branch",
"cs": "Větev",
"pt": "Ramo",
"tr": "Dal"
},
"description": {
"en": "Which branch of the repository the file is in.",
"cs": "Ve které větvi úložiště se soubor nachází.",
"pt": "Em que ramo do repositório o ficheiro está.",
"tr": "Dosyanın deponun hangi dalında olduğu."
},
"type": "string",
"default": {
"en": "HEAD",
"cs": "HEAD",
"pt": "HEAD",
"tr": "HEAD"
}
},
"file": {
"label": {
"en": "File",
"cs": "Soubor",
"pt": "Ficheiro",
"tr": "Dosya"
},
"description": {
"en": "Path to the file within the specified repository and branch.",
"cs": "Cesta k souboru v rámci zadaného úložiště a větve.",
"pt": "Caminho para o ficheiro dentro do repositório e ramo especificado.",
"tr": "Belirtilen depo ve daldaki dosyanın yolu."
},
"example": {
"en": "includes/MediaWiki.php",
"cs": "includes/MediaWiki.php",
"pt": "includes/MediaWiki.php",
"tr": "includes/MediaWiki.php"
},
"type": "string",
"required": true,
"suggested": true,
"aliases": [
"1"
]
},
"sha": {
"label": {
"en": "Commit",
"cs": "Vazba",
"pt": "Implementar",
"tr": "Taahhüt"
},
"description": {
"en": "The SHA-1 hash of the specific commit within a branch. Use this to make a permalink.",
"cs": "Hash SHA-1 konkrétního potvrzení v rámci větve. Použijte toto k vytvoření trvalého odkazu.",
"pt": "O ''hash'' SHA-1 da implementação específica dentro de um ramo. Utilize isto para criar uma ligação permanente.",
"tr": "Bir daldaki belirli kaydetmenin SHA-1 karma değeri. Kalıcı bağlantı oluşturmak için bunu kullanın."
},
"type": "string"
},
"line": {
"label": {
"en": "Line number",
"cs": "Číslo řádku",
"pt": "Número da linha",
"tr": "Satır numarası"
},
"description": {
"en": "The link will anchor to this line within the file, and highlight it.",
"cs": "Odkaz se ukotví na tento řádek v souboru a zvýrazní jej.",
"pt": "A hiperligação irá ancorar a esta linha dentro do ficheiro, e realçá-la.",
"tr": "Bağlantı, dosya içindeki bu satıra bağlanacak ve onu vurgulayacaktır."
},
"example": {
"en": "42",
"cs": "42",
"pt": "42",
"tr": "42"
},
"type": "number"
},
"text": {
"label": {
"en": "Label",
"cs": "Označení",
"pt": "Etiqueta",
"tr": "Metin"
},
"description": {
"en": "The text that become the link.",
"cs": "Text, který se stane odkazem.",
"pt": "O texto que se torna a ligação.",
"tr": "Bağlantı haline gelen metin."
},
"type": "string",
"default": {
"en": "The “file” parameter value.",
"cs": "Hodnota parametru “file”.",
"pt": "O valor do parâmetro do “ficheiro”.",
"tr": "“file” parametresi değeri."
},
"aliases": [
"2"
]
}
},
"description": {
"en": "Generates a link to view the file in Gerrit.",
"cs": "Vygeneruje odkaz pro zobrazení souboru v Gerritu.",
"pt": "Gera uma hiperligação para ver o ficheiro no Gerrit.",
"tr": "Dosyayı Gerrit'te görüntülemek için bir bağlantı oluşturur."
},
"paramOrder": [
"file",
"text",
"action",
"project",
"branch",
"sha",
"line"
],
"format": "inline"
}
</templatedata>

== Examples ==
; Basic
{{tlx|Git file|file{{=}}''composer.json''}}
produces
:{{Git file|file=composer.json}}
{{tlx|Git file|project{{=}}mediawiki/extensions/''Flow'' |file{{=}}''FlowActions.php''}}
produces
:{{Git file|project=mediawiki/extensions/Flow|file=FlowActions.php}}

; Text
{{tlx|Git file|project{{=}}mediawiki/extensions/EventLogging|file{{=}}devserver/bin/eventlogging-devserver|text{{=}}development server}}
produces
:{{Git file|project=mediawiki/extensions/EventLogging|file=devserver/bin/eventlogging-devserver|text=development server}}

; Action
{{tlx|Git file|file{{=}}composer.json |action{{=}}raw}}
{{tlx|Git file|file{{=}}composer.json |action{{=}}blame}}
{{tlx|Git file|file{{=}}composer.json |action{{=}}history}}
produces
:{{Git file|file=composer.json|action=raw}}
:{{Git file|file=composer.json|action=blame}}
:{{Git file|file=composer.json|action=history}}

{{tlx|Git file|project{{=}}mediawiki/extensions/EventLogging|text{{=}}EventLogging extension|action=tree}}
produces
:{{Git file|project=mediawiki/extensions/EventLogging|text=EventLogging extension|action=tree }}

; Line number
{{tlx|Git file|file{{=}}tests/phpunit/includes/SampleTest.php|line{{=}}41}}
produces
:{{Git file|file=tests/phpunit/includes/SampleTest.php|line=41}}

; Project summary page (deprecated)
{{tlx|Git file|project{{=}}oojs/core|action{{=}}summary|text{{=}}OOjs (core)}}
produces
:{{Git file|project=oojs/core|action=summary|text=OOjs (core)}}

== Known issues ==
* Merge with {{tl|Git}}, or maybe {{tl|Gerrit}}, {{tl|MW file}}, etc. but simpler?

== Notes ==
The template has to use numeric entities <code>&#59;</code> and <code>&32;</code> for semicolon and hashmark because, as [[w:Wikipedia:Advanced template coding#MediaWiki wiki-formats the clauses inside #if|WP:Advanced template coding]] says, "''MediaWiki wiki-formats the clauses inside #if''". MediaWiki would sometimes parse these characters as introducing a definition term and numbered list (even though they're not at the start of new lines).

== See also ==
* {{tl|git repo}} links to a repository summary
* {{tl|MW file}} generates a box with various links to a file in MediaWiki core, used by [[Manual:Contents|Manual]].
* {{tl|git}} generates links to various git-related objects on gerrit, like commits or changesets
* {{tl|github}} links to a file on the GitHub mirror of a repository (by default wikimedia/mediawiki)
* lots of other fancy templates for extensions on gerrit, see [[:Category:Git]].

<includeonly>

[[Category:External link templates{{#translation:}}]]
[[Category:Git{{#translation:}}| ]]
</includeonly>

Template:Git file/doc - Revision history

Majestix: 1 revision imported: Initial Setup

en>Tactica: Change paramOrder in the TemplateData block to have |File= first.