Vorlage:Phab

[Werkzeuge][Bearbeiten]

Dokumentation

TemplateData

Abstrahierte Verlinkung mit Quellcodes, Bug-Tickets und anderem im jeweiligen Software-Verwaltungssystem von MediaWiki; zurzeit Phabricator.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Anchor	Anchor	Fragmentnummer des Aufgaben-Kommentars (nur Ziffern)	Nummer	optional
Bugzilla	Bugzilla	Bugzilla-Nummer, ggf. mit Fragmentnummer des Kommentars	Zeile	optional
Zuweisung	Engage	Team, Projekt, Board	Zeile	optional
Mediendatei	File	File-Nummer (mit oder ohne 'F') – nicht 'file='	Zeile	optional
Mockup	Mock	Mock-Nummer (mit oder ohne 'M')	Zeile	optional
Linktitel Aufgabe	Show	Abweichender Linktitel für Aufgabenmanageent	Zeile	optional
Aufgabe (Bug)	Task	Task-Nummer (mit oder ohne 'T'), ggf. mit Nummer des Kommentars	Zeile	optional
Benutzer	User	Benutzername	Benutzer	optional
branch	branch	Versionsbezeichnung, etwa: 'REL1_20'	Zeile	optional
callsigns	callsigns	Liste der Phabricator-Shortcuts generieren (1=ausführlich)	Boolesch	optional
commit	commit	Übersicht über einen Beitrag anzeigen (40 Zeichen Hexcode [low])	Zeile	optional
commitdiff	commitdiff	Versionsunterschied zu einem Beitrag anzeigen (40 Zeichen Hexcode [low])	Zeile	optional
diff	diff	Unterschied zur aktuellen Version (HEAD) anzeigen; Angabe der Bezugsversion wie bei branch=	Zeile	optional
Pfad Verzeichnis	dir	Pfad zu einem Verzeichnis	Zeile	optional
Pfad Quellcode	file	Pfad zu einem einzelnen Quellcode – nicht 'File='	Zeile	optional
history	history	Versionsgeschichte zu Datei, Verzeichnis, Projekt ('1' angeben)	Boolesch	optional
Zeilennummer	line	Zeilennummer im Quellcode (nur Ziffern)	Nummer	optional
Pfad	plain	Pfad zu einem einzelnen Text; meist ASCII-Notes wie README	Zeile	optional
project	project	Einzel-Quellcode-Projekt (repository); Vorgabe: mediawiki/core	Zeile	optional
Linktitel Quellcode	title	Abweichender Linktitel für Quellcodes	Zeile	optional

Format: inline

Abstrahierte Verlinkung mit Quellcodes, Bug-Tickets und anderem im jeweiligen Software-Verwaltungssystem von MediaWiki; zurzeit Phabricator.

Vorlagenparameter

Diese Vorlage bevorzugt Inline-Formatierung von Parametern.

Parameter		Beschreibung	Typ	Status
Anchor	Anchor	Fragmentnummer des Aufgaben-Kommentars (nur Ziffern)	Nummer	optional
Bugzilla	Bugzilla	Bugzilla-Nummer, ggf. mit Fragmentnummer des Kommentars	Zeile	optional
Zuweisung	Engage	Team, Projekt, Board	Zeile	optional
Mediendatei	File	File-Nummer (mit oder ohne 'F') – nicht 'file='	Zeile	optional
Mockup	Mock	Mock-Nummer (mit oder ohne 'M')	Zeile	optional
Linktitel Aufgabe	Show	Abweichender Linktitel für Aufgabenmanageent	Zeile	optional
Aufgabe (Bug)	Task	Task-Nummer (mit oder ohne 'T'), ggf. mit Nummer des Kommentars	Zeile	optional
Benutzer	User	Benutzername	Benutzer	optional
branch	branch	Versionsbezeichnung, etwa: 'REL1_20'	Zeile	optional
callsigns	callsigns	Liste der Phabricator-Shortcuts generieren (1=ausführlich)	Boolesch	optional
commit	commit	Übersicht über einen Beitrag anzeigen (40 Zeichen Hexcode [low])	Zeile	optional
commitdiff	commitdiff	Versionsunterschied zu einem Beitrag anzeigen (40 Zeichen Hexcode [low])	Zeile	optional
diff	diff	Unterschied zur aktuellen Version (HEAD) anzeigen; Angabe der Bezugsversion wie bei branch=	Zeile	optional
Pfad Verzeichnis	dir	Pfad zu einem Verzeichnis	Zeile	optional
Pfad Quellcode	file	Pfad zu einem einzelnen Quellcode – nicht 'File='	Zeile	optional
history	history	Versionsgeschichte zu Datei, Verzeichnis, Projekt ('1' angeben)	Boolesch	optional
Zeilennummer	line	Zeilennummer im Quellcode (nur Ziffern)	Nummer	optional
Pfad	plain	Pfad zu einem einzelnen Text; meist ASCII-Notes wie README	Zeile	optional
project	project	Einzel-Quellcode-Projekt (repository); Vorgabe: mediawiki/core	Zeile	optional
Linktitel Quellcode	title	Abweichender Linktitel für Quellcodes	Zeile	optional

Hintergrund

In gewisser Regelmäßigkeit ändert sich bei MediaWiki die Systematik für Verwaltungsangelegenheiten nebst der Verlinkungen. Diese Vorlage wirkt dem entgegen und soll möglichst systemunabhängig agieren, indem das Ziel abstrakt vorgegeben und unter den wechselnden Rahmenbedingungen die jeweilige Verlinkung gebildet wird.

Bei den Bug-Tickets wurde im November 2014 von Bugzilla zu Maniphest@Phabricator migriert.

Für die Quellcodes ist dies zurzeit noch GIT mit mw:Gerrit; ein Wechsel wie 2012 von SVN nach Gerrit und Anfang Juni 2013 nach GIT soll möglichst ohne Veränderung der Parameter erfolgen.

Die Pseudo-Interwikis git: und gerrit: vertragen sich nicht mit Sonderzeichen in den Parametern.

Eine verwandte Vorlage ist {{Tracked}}.

Kopiervorlage

{{Phab|}}

Parameterstruktur

Alle Parameter sind optional. Management- und Quellcode-Parameter können nicht gemischt werden.

Management (auch Bugs)

Zuletzt Bugzilla. Aktuell Phabricator: „Maniphest“

• Von Bugzilla, File, Mock, Task darf nur eins angegeben sein.

Anchor

Fragmentnummer des Aufgaben-Kommentars (nur Ziffern)

Wie auch immer ermittelt: phab:T1177 phab:T76459

Bugzilla

Bugzilla-Nummer, ggf. mit Fragmentnummer des Kommentars

• Bugzilla=123456
• Bugzilla=123456 #3
• Bugzilla=123456#c3

Engage

Zuweisung, Verknüpfung, Taggen …

… an oder mit: Team, Projekt, Board

File

Nummer einer Mediendatei (mit oder ohne 'F')

Nicht mit file= verwechseln.

Mock

Mock-Nummer (mit oder ohne 'M')

Show

Abweichender Linktitel für Aufgabenmanageent

Task

Task-Nummer (mit oder ohne 'T'), ggf. mit Nummer des Kommentars

User

Benutzername

Countdown

reserviert

Differential

reserviert

Gerrit

reserviert

Join

reserviert

Paste

reserviert

Review

reserviert

Quellcodes und Commits

Quellcodes: SVN, danach GIT. Inzwischen Phabricator: „Diffusion“
Commits: Zuletzt noch Gerrit. Zukünftig Phabricator: „Differential“

• Von branch, commit, commitdiff darf nur eins angegeben sein.
• Von commit, commitdiff, dir, file, plain darf nur eins angegeben sein.

branch

Versionsbezeichnung, etwa: REL1_20

Vorgabe: HEAD (laufende Entwicklung)

Andere Möglichkeiten wären 40 Zeichen Hexcode (low), etwa: c0825f3f13ff3656e5d589e270a42a6f7844c32d

Gerrit bis 6. Juni 2013: hb= (hash base); auch noch bei blobdiff@GIT

callsigns

Liste der Phabricator-Shortcuts generieren

1 – ausführlich

commit

Übersicht über einen Beitrag anzeigen

Parameterwert: Versionsbezeichnung; 40 Zeichen Hexcode (low)

Bei project=SVN auch die bis zu 6 Ziffern lange Gerrit-SVN-Nummer.

commitdiff

Nur Versionsunterschied zu einem Beitrag anzeigen

Parameterwert: Versionsbezeichnung; 40 Zeichen Hexcode (low)

Phabricator: Wirkungsgleich mit commit=, weil dies auch alle Unterschiede enthält

diff

Unterschied zur aktuellen Version (HEAD) anzeigen

Angabe der Bezugsversion wie bei branch=

Nur bei file= sinnvoll und zulässig.

dir

Pfad zu einem Verzeichnis.

Darf nicht zusammen mit file angegeben werden.

Vorgabe: file oder sonst das gesamte Projekt.

Gerrit bis 6. Juni 2013: a=tree

file

Pfad zu einem einzelnen Quellcode.

Darf nicht zusammen mit dir angegeben werden.

Nicht mit File= verwechseln.

Gerrit bis 6. Juni 2013: a=blob

history

Versionsgeschichte zu Datei, Verzeichnis, Projekt

Format: history=1

line

Zeilennummer im Quellcode.

Rein numerische Angabe.

Nur bei file= sinnvoll und zulässig.

plain

Pfad zu einem einzelnen Text; meist ASCII-Notes wie README.

Gerrit bis 6. Juni 2013: a=blob_plain

project

Einzel-Quellcode-Projekt (repository).

Vorgabe: MW (früher mediawiki/core)

• Callsign
• Voller Name eines Phabricator-Repository
• Bis 2014 bereits verwendeter Name eines GIT-Repository

Gerrit bis 6. Juni 2013: p=

Alle Projekte

title

Abweichender Linktitel für Quellcodes.

Beispiele

{{Phab|dir=resources/lib/jquery}}
{{Phab|file=resources/lib/jquery/jquery.cookie.js}}
{{Phab|file=resources/lib/jquery/jquery.cookie.js|history=1}}
{{Phab|commit=c6dfcfc91c8182699b576afbd8b3d3840a329f6d}}
{{Phab|project=SVN|commit=115794}}
{{Phab}}
{{Phab|dir=resources|title=/resources/}}
{{Phab|project=mediawiki/extensions/Scribunto}}
{{Phab|Bugzilla=12345}}
{{Phab|Bugzilla=12345 #1|Show=That thing with 410}}
{{Phab|Engage=MediaWiki-History-or-Diffs}}
{{Phab|Engage=}}
{{Phab|Task=123}}
{{Phab|Task=1156|Anchor=22155|Show=Mattflaschen clarifies}}
{{Phab|User=PerfektesChaos}}

• resources/lib/jquery
• resources/lib/jquery/jquery.cookie.js
• history: resources/lib/jquery/jquery.cookie.js
• rMWc6dfcfc
• rSVN115794
• mediawiki/core/*
• /resources/
• mediawiki/extensions/Scribunto/*
• phab:T14345 (Bugzilla:12345)
• That thing with 410 (Bugzilla:12345 #c1)
• #MediaWiki-History-or-Diffs
• #MediaWiki-General-or-Unknown
• phab:T123
• Mattflaschen clarifies
• @PerfektesChaos

Siehe auch

• Vorlage:Phabricator

Lua

Diese Vorlage wurde ganz oder teilweise mit Hilfe der Programmiersprache Lua erstellt.

Die Module sind mit #invoke eingebunden. In der Dokumentation der einzelnen Module finden sich auch weitere Hinweise zu Rückfragen.

Verwendetes Modul: Vorlage:Phab #f

Werkzeuge

Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.

• Verwendungen dieser Vorlage
• Cirrus-Suche zu Einbindungen dieser Vorlage (zunächst nur ANR) mit weiteren Möglichkeiten
• Anzahl der Einbindungen
• Liste der Unterseiten.
• Diese Dokumentation befindet sich auf einer eingebundenen Unterseite [Bearbeiten].
• Test-/Beispielseite erstellen.