Absoluter Dateisystempfad, der dem Projektpfad vorangestellt wird; der Pfad zum Repository ist $projectroot/$project. Wird bei der Installation auf $GITWEB_PROJECTROOT gesetzt. Diese Variable muss korrekt gesetzt sein, damit Gitweb Repositories finden kann.

our $projectroot = "/srv/git";

http://git.example.com/gitweb.cgi?p=foo/bar.git

http://git.example.com/gitweb.cgi/foo/bar.git

Name einer einfachen Textdatei, die Projekte auflistet, oder der Name eines Verzeichnisses, das nach Projekten gescannt werden soll.

<URI-encoded filesystem path to repository> SP <URI-encoded repository owner>

Wenn die Variable $projects_list nicht gesetzt ist, scannt Gitweb das Dateisystem rekursiv nach Git-Repositories. Die Variable $project_maxdepth wird verwendet, um die Traversierungstiefe relativ zu $projectroot (Ausgangspunkt) zu begrenzen; das bedeutet, dass Verzeichnisse, die weiter von $projectroot entfernt sind als $project_maxdepth, übersprungen werden.

Repository nur anzeigen, wenn diese Datei existiert (im Repository). Nur wirksam, wenn diese Variable auf wahr ausgewertet wird. Kann beim Bauen von Gitweb durch Setzen von GITWEB_EXPORT_OK gesetzt werden. Dieser Pfad ist relativ zu GIT_DIR. git-daemon[1] verwendet git-daemon-export-ok, es sei denn, es wird mit --export-all gestartet. Standardmäßig ist diese Variable nicht gesetzt, was bedeutet, dass diese Funktion ausgeschaltet ist.

Funktion, die verwendet wird, um zu bestimmen, welche Repositories angezeigt werden sollen. Diese Unterroutine sollte einen Parameter erhalten, den vollständigen Pfad zu einem Projekt, und wenn sie wahr zurückgibt, wird dieses Projekt in die Projektliste aufgenommen und kann über Gitweb zugegriffen werden, solange es die anderen Anforderungen erfüllt, die von $export_ok, $projects_list und $projects_maxdepth beschrieben werden. Beispiel

our $export_auth_hook = sub { return -e "$_[0]/git-daemon-export-ok"; };

our $export_ok = "git-daemon-export-ok";

Nur die Anzeige von Repositories erlauben, die auch auf der Übersichtsseite angezeigt werden. Dies bewirkt beispielsweise, dass die Datei $export_ok entscheidet, ob ein Repository verfügbar ist und nicht nur, ob es angezeigt wird. Wenn $projects_list auf eine Datei mit einer Projektliste verweist, wären nur die dort aufgeführten Repositories für Gitweb verfügbar. Kann während des Baus von Gitweb über GITWEB_STRICT_EXPORT gesetzt werden. Standardmäßig ist diese Variable nicht gesetzt, was bedeutet, dass Sie direkt auf die Repositories zugreifen können, die von der Projektlistenseite ausgeblendet sind (z.B. sind sie nicht in der Datei $projects_list aufgeführt).

Kern-Git-Executable, das verwendet werden soll. Standardmäßig auf $GIT_BINDIR/git gesetzt, was wiederum standardmäßig auf $(bindir)/git gesetzt ist. Wenn Sie Git aus einem Binärpaket installiert haben, sollten Sie dies normalerweise auf "/usr/bin/git" setzen. Dies kann auch einfach "git" sein, wenn Ihr Webserver einen sinnvollen PATH hat; aus Sicherheitssicht ist es besser, den absoluten Pfad zur Git-Binärdatei zu verwenden. Wenn Sie mehrere Git-Versionen installiert haben, kann dies verwendet werden, um zu wählen, welche verwendet werden soll. Muss (korrekt) gesetzt sein, damit Gitweb funktionieren kann.

Datei, die für (anhand der Dateiendung basierende) MIME-Typ-Schätzungen verwendet wird, bevor /etc/mime.types versucht wird. **HINWEIS**: Dieser Pfad wird, falls relativ, als relativ zum aktuellen Git-Repository und nicht zum CGI-Skript interpretiert. Wenn nicht gesetzt, wird nur /etc/mime.types verwendet (falls auf dem Dateisystem vorhanden). Wenn keine Mimetypen-Datei gefunden wird, ist die Schätzung von Mimetypen basierend auf der Dateiendung deaktiviert. Standardmäßig nicht gesetzt.

Pfad zur zu verwendenden Highlight-Executable (es muss diejenige von http://andre-simon.de/zip/download.php sein, aufgrund von Annahmen über Parameter und Ausgabe). Standardmäßig auf highlight gesetzt; setzen Sie es auf den vollständigen Pfad zur Highlight-Executable, falls diese nicht im PATH Ihres Webservers installiert ist. Beachten Sie, dass die Funktion highlight gesetzt sein muss, damit Gitweb tatsächlich Syntax-Hervorhebung verwendet.

our %highlight_ext;
$highlight_ext{'phtml'} = 'php';

Liste von URIs von Stylesheets (relativ zur Basis-URI einer Seite). Sie können mehr als ein Stylesheet angeben, z.B. um "gitweb.css" als Basis zu verwenden und sitespezifische Modifikationen in einem separaten Stylesheet vorzunehmen, um das Upgrade von Gitweb zu erleichtern. Zum Beispiel können Sie ein site-Stylesheet hinzufügen, indem Sie

push @stylesheets, "gitweb-site.css";

Verweist auf den Speicherort, an dem Sie git-logo.png auf Ihrem Webserver platziert haben, oder generischer auf die URI des Logos, 72x27 Pixel groß. Dieses Bild wird in der oberen rechten Ecke jeder Gitweb-Seite angezeigt und als Logo für den Atom-Feed verwendet. Relativ zur Basis-URI von Gitweb (als Pfad). Kann beim Bauen von Gitweb mit der Variablen GITWEB_LOGO angepasst werden. Standardmäßig auf static/git-logo.png gesetzt.

Verweist auf den Speicherort, an dem Sie git-favicon.png auf Ihrem Webserver platziert haben, oder generischer auf die URI des Favicons, das als "image/png" Typ serviert wird. Webbrowser, die Favicons (Website-Symbole) unterstützen, können diese in der Adressleiste des Browsers und neben dem Seitennamen in den Lesezeichen anzeigen. Relativ zur Basis-URI von Gitweb. Kann zur Build-Zeit mit der Variablen GITWEB_FAVICON angepasst werden. Standardmäßig auf static/git-favicon.png gesetzt.

Verweist auf den Speicherort, an dem Sie gitweb.js auf Ihrem Webserver platziert haben, oder generischer auf die URI des von Gitweb verwendeten JavaScript-Codes. Relativ zur Basis-URI von Gitweb. Kann zur Build-Zeit mit der Build-Zeit-Konfigurationsvariable GITWEB_JS gesetzt werden.

Ziel des Home-Links am oberen Rand aller Seiten (der erste Teil der Ansicht "Breadcrumbs"). Standardmäßig ist er auf die absolute URI der aktuellen Seite gesetzt (auf den Wert der Variablen $my_uri oder auf "/", wenn $my_uri undefiniert oder eine leere Zeichenkette ist).

Beschriftung für den "Home-Link" am oberen Rand aller Seiten, der zu $home_link führt (normalerweise die Hauptseite von Gitweb, die die Projektliste enthält). Er wird als erste Komponente des Gitweb-"Breadcrumb Trails" verwendet: <home-link> / <project> / <action>. Kann zur Build-Zeit mit der Variablen GITWEB_HOME_LINK_STR gesetzt werden. Standardmäßig ist er auf "projects" gesetzt, da dieser Link zur Projektliste führt. Eine andere beliebte Wahl ist, ihn auf den Namen der Seite zu setzen. Beachten Sie, dass er als rohes HTML behandelt wird und daher nicht aus nicht vertrauenswürdigen Quellen gesetzt werden sollte.

Zusätzliche Links, die am Anfang des Breadcrumb-Trails vor dem Home-Link hinzugefügt werden sollen, zu Seiten, die logisch "oberhalb" der Gitweb-Projektliste liegen, wie z.B. die Organisation und die Abteilung, die den Gitweb-Server hosten. Jedes Element der Liste ist ein Verweis auf ein Array, in dem Element 0 der Linktext ist (entspricht $home_link_str) und Element 1 die Ziel-URL ist (entspricht $home_link).

    our @extra_breadcrumbs = (
      [ 'home' => 'https://www.example.org/' ],
      [ 'dev'  => 'https://dev.example.org/' ],
    );

URI und Beschriftung (Titel) für den Git-Logo-Link (oder Ihr Seitenlogo, falls Sie ein anderes Logo verwenden). Standardmäßig verweisen beide auf die Git-Homepage, https://git-scm.de; in der Vergangenheit verwiesen sie auf die Git-Dokumentation unter https://www.kernel.org.

Name Ihrer Seite oder Organisation, der in den Seitentiteln erscheinen soll. Setzen Sie ihn auf etwas Beschreibendes für deutlichere Lesezeichen usw. Wenn diese Variable nicht gesetzt ist oder leer ist, verwendet Gitweb den Wert der CGI-Umgebungsvariablen SERVER_NAME und setzt den Seitennamen auf "$SERVER_NAME Git" oder "Untitled Git", wenn diese Variable nicht gesetzt ist (z.B. wenn Gitweb als eigenständiges Skript ausgeführt wird).

HTML-Snippet, das in den <head>-Abschnitt jeder Seite aufgenommen werden soll. Kann zur Build-Zeit über GITWEB_SITE_HTML_HEAD_STRING gesetzt werden. Kein Standardwert.

Name einer Datei mit HTML, die am Anfang jeder Seite aufgenommen werden soll. Relativ zum Verzeichnis, das das gitweb.cgi-Skript enthält. Kann zur Build-Zeit über GITWEB_SITE_HEADER gesetzt werden. Kein Standardwert.

Name einer Datei mit HTML, die am Ende jeder Seite aufgenommen werden soll. Relativ zum Verzeichnis, das das gitweb.cgi-Skript enthält. Kann zur Build-Zeit über GITWEB_SITE_FOOTER gesetzt werden. Kein Standardwert.

Name einer HTML-Datei, die, falls sie existiert, auf der Gitweb-Projektübersichtsseite ("projects_list"-Ansicht) aufgenommen wird. Relativ zum Verzeichnis, das das gitweb.cgi-Skript enthält. Der Standardwert kann zur Build-Zeit mit der Variablen GITWEB_HOMETEXT angepasst werden. Standardmäßig auf indextext.html gesetzt.

Die Breite (in Zeichen) der Spalte "Beschreibung" in der Projektliste. Längere Beschreibungen werden abgeschnitten (Versuch, an Wortgrenzen zu schneiden); die vollständige Beschreibung ist im title-Attribut verfügbar (wird normalerweise beim Überfahren mit der Maus angezeigt). Der Standardwert ist 25, was zu klein sein könnte, wenn Sie lange Projektbeschreibungen verwenden.

Standardwert für die Sortierung von Projekten auf der Projektlistenseite, d.h. die Sortierung, die verwendet wird, wenn Sie die Projektliste nicht explizit sortieren (wenn kein "o" CGI-Query-Parameter in der URL vorhanden ist). Gültige Werte sind "none" (unsortiert), "project" (Projekte nach Projektname, d.h. Pfad zum Repository relativ zu $projectroot), "descr" (Projektbeschreibung), "owner" und "age" (nach Datum des letzten Commits).

Standard-MIME-Typ für die blob_plain (rohe) Ansicht, wenn die MIME-Typ-Überprüfung nicht zu einem anderen Typ führt; standardmäßig "text/plain". Gitweb errät den MIME-Typ einer anzuzeigenden Datei basierend auf der Erweiterung ihres Dateinamens, wobei $mimetypes_file (falls gesetzt und Datei vorhanden) und /etc/mime.types-Dateien verwendet werden (siehe Manpage mime.types(5); nur Regeln für Dateiendungen werden von Gitweb unterstützt).

Standard-Charset für Textdateien. Wenn dies nicht gesetzt ist, wird die Webserver-Konfiguration verwendet. Standardmäßig nicht gesetzt.

Gitweb nimmt diese Zeichenkodierung an, wenn eine Zeile Nicht-UTF-8-Zeichen enthält. Die Fallback-Dekodierung wird ohne Fehlerprüfung verwendet, daher kann sie sogar "utf-8" sein. Der Wert muss eine gültige Kodierung sein; siehe Manpage Encoding::Supported(3pm) für eine Liste. Der Standardwert ist "latin1", alias "iso-8859-1".

Optionen zur Erkennung von Umbenennungen für git-diff und git-diff-tree. Standard ist ('-M'); setzen Sie es auf ('-C') oder ('-C', '-C'), um auch Kopien zu erkennen, oder setzen Sie es auf () d.h. eine leere Liste, wenn Sie keine Erkennung von Umbenennungen wünschen.

Liste von Git-Basis-URLs. Diese URLs werden verwendet, um URLs zu generieren, die beschreiben, von wo ein Projekt abgeholt werden kann, und die auf der Projektzusammenfassungsseite angezeigt werden. Die vollständige Fetch-URL lautet "$git_base_url/$project" für jedes Element dieser Liste. Sie können mehrere Basis-URLs einrichten (z.B. eine für das git://-Protokoll und eine für das http://-Protokoll).

Ob die Gruppierung von Projekten nach Kategorie auf der Projektlistenseite aktiviert werden soll. Die Kategorie eines Projekts wird durch die Datei $GIT_DIR/category oder die Variable gitweb.category in der Konfiguration jedes Repositories bestimmt. Standardmäßig deaktiviert (auf 0 gesetzt).

Standardkategorie für Projekte, für die keine angegeben ist. Wenn dies auf eine leere Zeichenkette gesetzt ist, bleiben solche Projekte unkategorisiert und werden am Anfang, oberhalb der kategorisierten Projekte, aufgelistet. Nur verwendet, wenn Projektkategorien aktiviert sind, was bedeutet, wenn $projects_list_group_categories wahr ist. Standardmäßig auf "" (leere Zeichenkette) gesetzt.

Wenn wahr, werden einige Gitweb-Funktionen deaktiviert, um zu verhindern, dass Inhalte in Repositories Cross-Site-Scripting (XSS)-Angriffe starten. Setzen Sie dies auf wahr, wenn Sie den Inhalt Ihrer Repositories nicht vertrauen. Standardmäßig falsch (auf 0 gesetzt).

Wird verwendet, um die maximale Last einzustellen, bei der wir noch auf Gitweb-Anfragen reagieren. Wenn die Serverlast diesen Wert überschreitet, gibt Gitweb einen "503 Service Unavailable"-Fehler zurück. Die Serverlast wird als 0 angenommen, wenn Gitweb ihren Wert nicht ermitteln kann. Derzeit funktioniert dies nur unter Linux, wo /proc/loadavg verwendet wird; die Last dort ist die Anzahl der aktiven Aufgaben im System – tatsächlich laufende Prozesse – gemittelt über die letzte Minute.

Wenn wahr, wird die Spalte mit dem Datum des letzten Commits auf der Projektlistenseite weggelassen. Dies kann etwas I/O und einen Fork pro Repository einsparen.

Wenn wahr, wird die Anzeige von Informationen über den Repository-Besitzer verhindert.

Wenn dies auf einen Code-Referenz gesetzt ist, wird es einmal pro Anfrage ausgeführt. Sie können Teile der Konfiguration, die sich pro Sitzung ändern, auf diese Weise setzen. Zum Beispiel könnte man den folgenden Code in einer Gitweb-Konfigurationsdatei verwenden

our $per_request_config = sub {
	$ENV{GL_USER} = $cgi->remote_user || "gitweb";
};

Gitweb-Version, wird beim Erstellen von gitweb.cgi aus gitweb.perl automatisch gesetzt. Möglicherweise möchten Sie sie ändern, wenn Sie ein modifiziertes Gitweb ausführen, zum Beispiel

our $version .= " with caching";

Vollständige URL und absolute URL des Gitweb-Skripts; in früheren Versionen von Gitweb mussten Sie diese Variablen möglicherweise setzen, aber jetzt sollte es keinen Bedarf mehr dafür geben. Siehe $per_request_config, wenn Sie sie trotzdem setzen müssen.

Basis-URL für relative URLs in von Gitweb generierten Seiten (z.B. $logo, $favicon, @stylesheets, wenn sie relative URLs sind), benötigt und verwendet <base href="$base_url"> nur für URLs mit nicht leerem PATH_INFO. Normalerweise setzt Gitweb seinen Wert korrekt, und es besteht kein Bedarf, diese Variable zu setzen, z.B. auf $my_uri oder "/". Siehe $per_request_config, wenn Sie sie dennoch überschreiben möchten.

Aktiviert die "blame"- und "blame_incremental"-Blob-Ansichten, die für jede Zeile den letzten Commit anzeigen, der sie geändert hat; siehe git-blame[1]. Dies kann sehr CPU-intensiv sein und ist daher standardmäßig deaktiviert.

Aktiviert und konfiguriert die "snapshot"-Aktion, mit der der Benutzer ein komprimiertes Archiv eines beliebigen Trees oder Commits herunterladen kann, wie es von git-archive[1] erzeugt wird und möglicherweise zusätzlich komprimiert ist. Dies kann potenziell hohen Traffic erzeugen, wenn Sie ein großes Projekt haben.

Aktiviert die grep-Suche, die die Dateien im aktuell ausgewählten Tree (Verzeichnis) auflistet, die den angegebenen String enthalten; siehe git-grep[1]. Dies kann natürlich potenziell CPU-intensiv sein. Standardmäßig aktiviert.

Aktiviert die sogenannte "Pickaxe"-Suche, die die Commits auflistet, die einen gegebenen String in einer Datei eingeführt oder entfernt haben. Dies kann eine praktische und recht schnelle Alternative zur "blame"-Aktion sein, ist aber immer noch potenziell CPU-intensiv. Standardmäßig aktiviert.

Aktiviert die Anzeige der Größe von Blobs (gewöhnliche Dateien) in der "tree"-Ansicht in einer separaten Spalte, ähnlich wie ls -l es tut; siehe Beschreibung der Option -l in der Manpage git-ls-tree[1]. Dies kostet etwas I/O. Standardmäßig aktiviert.

Aktiviert und konfiguriert die "patches"-Ansicht, die eine Liste von Commits im E-Mail-Format (Plain Text) anzeigt; siehe auch git-format-patch[1]. Der Wert ist die maximale Anzahl von Patches in einem Patchset, das in der "patches"-Ansicht generiert wird. Setzen Sie das Feld default auf eine Liste, die ein einzelnes Element enthält, oder auf eine leere Liste, um die Patch-Ansicht zu deaktivieren, oder auf eine Liste, die eine einzelne negative Zahl enthält, um jede Begrenzung zu entfernen. Der Standardwert ist 16.

Avatar-Unterstützung. Wenn dieses Feature aktiviert ist, zeigen Ansichten wie "shortlog" oder "commit" einen Avatar an, der mit der E-Mail jedes Committer und Autors verknüpft ist.

E-Mail-Adressen aus dem generierten HTML usw. Inhalt entfernen. Dies verschleiert E-Mail-Adressen, die aus den Absender-/Committer- und Kommentarabschnitten des Git-Logs abgerufen werden. Es soll Web-Crawler behindern, die Adressen sammeln und missbrauchen. Solche Crawler respektieren möglicherweise robots.txt nicht. Beachten Sie, dass Benutzer und Benutzerwerkzeuge die Adressen ebenfalls als geschwärzt sehen. Wenn Gitweb nicht der letzte Schritt in einem Workflow ist, können nachfolgende Schritte aufgrund der geschwärzten Informationen, die sie erhalten, fehlschlagen. Standardmäßig deaktiviert.

Server-seitige Syntax-Highlight-Unterstützung in der "blob"-Ansicht. Dies erfordert, dass das Programm $highlight_bin verfügbar ist (siehe Beschreibung dieser Variablen im Abschnitt "Konfigurationsvariablen" oben) und ist daher standardmäßig deaktiviert.

Aktiviert die Anzeige von Remote-Heads (Remote-Tracking-Branches) in der "heads"-Liste. In den meisten Fällen ist die Liste der Remote-Tracking-Branches ein unnötiges internes Detail, und dieses Feature ist daher standardmäßig deaktiviert. git-instaweb[1], das normalerweise zum Durchsuchen lokaler Repositories verwendet wird, aktiviert und nutzt dieses Feature.

Aktiviert die Textsuche, die die Commits auflistet, die Autor, Committer oder Commit-Text mit einem gegebenen String abgleichen; siehe die Beschreibung der Optionen --author, --committer und --grep in der Manpage git-log[1]. Standardmäßig aktiviert.

Wenn dieses Feature aktiviert ist, betrachtet gitweb Projekte in Unterverzeichnissen des Projekt-Roots (Basisname) als Forks bestehender Projekte. Für jedes Projekt $projname.git werden Projekte im Verzeichnis $projname/ und seinen Unterverzeichnissen nicht in der Hauptprojektliste angezeigt. Stattdessen wird neben $projname ein '+' -Zeichen angezeigt, das zu einer "Forks"-Ansicht führt, die alle Forks (alle Projekte im Unterverzeichnis $projname/) auflistet. Zusätzlich ist eine "Forks"-Ansicht für ein Projekt von der Projekt-Zusammenfassungsseite aus verlinkt.

Fügt benutzerdefinierte Links zur Aktionsleiste aller Projektseiten ein. Dies ermöglicht es Ihnen, auf Skripte von Drittanbietern zu verlinken, die sich in gitweb integrieren.

$feature{'actions'}{'default'} =
	[ ('graphiclog', '/git-browser/by-commit.html?r=%n', 'summary')];

Aktiviert die Anzeige, wie viel Zeit und wie viele Git-Befehle zum Generieren und Anzeigen jeder Seite im Seitenfuß (am Ende der Seite) benötigt wurden. Zum Beispiel könnte der Fuß enthalten: "Diese Seite dauerte 6,53325 Sekunden und 13 Git-Befehle zur Generierung." Standardmäßig deaktiviert.

Aktiviert und konfiguriert die Möglichkeit, eine gemeinsame Zeitzone für Datumsangaben in der gitweb-Ausgabe über JavaScript zu ändern. Datumsangaben in der gitweb-Ausgabe umfassen authordate und committerdate in den Ansichten "commit", "commitdiff" und "log" sowie taggerdate in der Ansicht "tag". Standardmäßig aktiviert.

$feature{'javascript-timezone'}{'default'}[0] = "utc";

Liste zusätzlicher Verzeichnisse unter "refs", die als Branch-Refs verwendet werden. Zum Beispiel, wenn Sie ein Gerrit-Setup haben, bei dem alle Branches unter refs/heads/ offiziell sind, nach Überprüfung gepusht werden und Branches unter refs/sandbox/, refs/wip und refs/other benutzerbezogen sind und die Berechtigungen viel weiter gefasst sind, dann möchten Sie diese Variable möglicherweise wie folgt setzen

$feature{'extra-branch-refs'}{'default'} =
	['sandbox', 'wip', 'other'];

[gitweb]
	extraBranchRefs = sandbox wip other

[gitweb]
	extraBranchRefs = sandbox
	extraBranchRefs = wip other