Zum Inhalt springen

Vorlog:Phab

Aus Wikipedia


Documentation

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

Vorlagenparameter

ParameterBeschreibungTypStatus
AnchorAnchor
Fragmentnummer des Aufgaben-Kommentars (nur Ziffern)
Zahlenwertoptional
BugzillaBugzilla
Bugzilla-Nummer, ggf. mit Fragmentnummer des Kommentars
Einzeiliger Textoptional
ZuweisungEngage
Team, Projekt, Board
Einzeiliger Textoptional
MediendateiFile
File-Nummer (mit oder ohne 'F') – nicht 'file='
Einzeiliger Textoptional
MockupMock
Mock-Nummer (mit oder ohne 'M')
Einzeiliger Textoptional
Linktitel AufgabeShow
Abweichender Linktitel für Aufgabenmanageent
Einzeiliger Textoptional
Aufgabe (Bug)Task
Task-Nummer (mit oder ohne 'T'), ggf. mit Nummer des Kommentars
Einzeiliger Textoptional
BenutzerUser
Benutzername
Benutzeroptional
branchbranch
Versionsbezeichnung, etwa: 'REL1_20'
Einzeiliger Textoptional
callsignscallsigns
Liste der Phabricator-Shortcuts generieren (1=ausführlich)
Wahrheitswertoptional
commitcommit
Übersicht über einen Beitrag anzeigen (40 Zeichen Hexcode [low])
Einzeiliger Textoptional
commitdiffcommitdiff
Versionsunterschied zu einem Beitrag anzeigen (40 Zeichen Hexcode [low])
Einzeiliger Textoptional
diffdiff
Unterschied zur aktuellen Version (HEAD) anzeigen; Angabe der Bezugsversion wie bei branch=
Einzeiliger Textoptional
Pfad Verzeichnisdir
Pfad zu einem Verzeichnis
Einzeiliger Textoptional
Pfad Quellcodefile
Pfad zu einem einzelnen Quellcode – nicht 'File='
Einzeiliger Textoptional
historyhistory
Versionsgeschichte zu Datei, Verzeichnis, Projekt ('1' angeben)
Wahrheitswertoptional
Zeilennummerline
Zeilennummer im Quellcode (nur Ziffern)
Zahlenwertoptional
Pfadplain
Pfad zu einem einzelnen Text; meist ASCII-Notes wie README
Einzeiliger Textoptional
projectproject
Einzel-Quellcode-Projekt (repository); Vorgabe: mediawiki/core
Einzeiliger Textoptional
Linktitel Quellcodetitle
Abweichender Linktitel für Quellcodes
Einzeiliger Textoptional

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.

ParameterBeschreibungTypStatus
AnchorAnchor

Fragmentnummer des Aufgaben-Kommentars (nur Ziffern)

Zahlenwertoptional
BugzillaBugzilla

Bugzilla-Nummer, ggf. mit Fragmentnummer des Kommentars

Einzeiliger Textoptional
ZuweisungEngage

Team, Projekt, Board

Einzeiliger Textoptional
MediendateiFile

File-Nummer (mit oder ohne 'F') – nicht 'file='

Einzeiliger Textoptional
MockupMock

Mock-Nummer (mit oder ohne 'M')

Einzeiliger Textoptional
Linktitel AufgabeShow

Abweichender Linktitel für Aufgabenmanageent

Einzeiliger Textoptional
Aufgabe (Bug)Task

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

Einzeiliger Textoptional
BenutzerUser

Benutzername

Benutzeroptional
branchbranch

Versionsbezeichnung, etwa: 'REL1_20'

Einzeiliger Textoptional
callsignscallsigns

Liste der Phabricator-Shortcuts generieren (1=ausführlich)

Wahrheitswertoptional
commitcommit

Übersicht über einen Beitrag anzeigen (40 Zeichen Hexcode [low])

Einzeiliger Textoptional
commitdiffcommitdiff

Versionsunterschied zu einem Beitrag anzeigen (40 Zeichen Hexcode [low])

Einzeiliger Textoptional
diffdiff

Unterschied zur aktuellen Version (HEAD) anzeigen; Angabe der Bezugsversion wie bei branch=

Einzeiliger Textoptional
Pfad Verzeichnisdir

Pfad zu einem Verzeichnis

Einzeiliger Textoptional
Pfad Quellcodefile

Pfad zu einem einzelnen Quellcode – nicht 'File='

Einzeiliger Textoptional
historyhistory

Versionsgeschichte zu Datei, Verzeichnis, Projekt ('1' angeben)

Wahrheitswertoptional
Zeilennummerline

Zeilennummer im Quellcode (nur Ziffern)

Zahlenwertoptional
Pfadplain

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

Einzeiliger Textoptional
projectproject

Einzel-Quellcode-Projekt (repository); Vorgabe: mediawiki/core

Einzeiliger Textoptional
Linktitel Quellcodetitle

Abweichender Linktitel für Quellcodes

Einzeiliger Textoptional

Hintergrund[Am Gwëntext werkeln]

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[Am Gwëntext werkeln]

{{Phab|}}

Parameterstruktur[Am Gwëntext werkeln]

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

Management (auch Bugs)[Am Gwëntext werkeln]

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[Am Gwëntext werkeln]

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[Am Gwëntext werkeln]

{{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}}

Schau aa[Am Gwëntext werkeln]

Lua

Verwendetes Modul: Vorlage:Phab #f

Utilities