プロジェクトパスの前に付加される絶対ファイルシステムパス。リポジトリへのパスは$projectroot/$projectです。インストール中に$GITWEB_PROJECTROOTに設定されます。gitwebがリポジトリを見つけるには、この変数を正しく設定する必要があります。

our $projectroot = "/srv/git";

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

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

プロジェクトをリストするプレーンテキストファイルの名前、またはプロジェクトをスキャンするディレクトリの名前。

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

$projects_list変数が設定されていない場合、gitwebはファイルシステムを再帰的にスキャンしてGitリポジトリを検索します。$project_maxdepthは、$projectroot（開始点）からの相対的な走査深度を制限するために使用されます。つまり、$projectrootから$project_maxdepthよりも遠いディレクトリはスキップされます。

このファイルが存在する場合（リポジトリ内）のみリポジトリを表示します。この変数がtrueと評価される場合にのみ有効です。GITWEB_EXPORT_OKを設定してgitwebをビルドするときに設定できます。このパスは、GIT_DIRに対して相対的です。git-daemon[1]は、--export-allを指定して起動しない限り、git-daemon-export-okを使用します。デフォルトでは、この変数は設定されていません。つまり、この機能はオフになっています。

表示する必要があるリポジトリを決定するために使用される関数。このサブルーチンは、プロジェクトへのフルパスである1つのパラメーターを取り、trueを返す場合、そのプロジェクトはプロジェクトリストに含まれ、$export_ok、$projects_list、および$projects_maxdepthで説明されている他の要件を満たしている限り、gitweb経由でアクセスできます。例

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

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

概要ページにも表示されているリポジトリのみを表示できるようにします。たとえば、これにより$export_okファイルは、リポジトリが表示されているかどうかだけでなく、リポジトリが利用可能かどうかを決定します。$projects_listがプロジェクトのリストを含むファイルを指している場合、リストされているリポジトリのみがgitwebで利用可能になります。GITWEB_STRICT_EXPORTを介してgitwebをビルドするときに設定できます。デフォルトでは、この変数は設定されていません。つまり、プロジェクトリストページから非表示になっているリポジトリ（たとえば、$projects_listファイルにリストされていないリポジトリ）に直接アクセスできます。

使用するコアgit実行可能ファイル。デフォルトでは、$GIT_BINDIR/gitに設定され、これはデフォルトで$(bindir)/gitに設定されます。バイナリパッケージからインストールされたGitを使用する場合は、通常、これを「/usr/bin/git」に設定する必要があります。Webサーバーに適切なPATHがある場合は、「git」にすることもできます。セキュリティの観点からは、gitバイナリへの絶対パスを使用する方が優れています。複数のGitバージョンがインストールされている場合は、使用するバージョンを選択するために使用できます。gitwebが機能できるように、（正しく）設定する必要があります。

/etc/mime.typesを試す前に、（ファイル拡張子に基づいた）MIMEタイプの推測に使用するファイル。注このパスが相対パスの場合、CGIスクリプトではなく、現在のGitリポジトリに対する相対パスとして扱われます。設定されていない場合は、/etc/mime.typesのみが使用されます（ファイルシステムに存在する場合）。mimetypesファイルが見つからない場合、ファイルの拡張子に基づくmimetypeの推測は無効になります。デフォルトでは設定されていません。

使用する highlight 実行ファイルへのパス（パラメータと出力に関する前提があるため、http://andre-simon.de/zip/download.php のものを使用する必要があります）。デフォルトではhighlightに設定されています。WebサーバーのPATHにインストールされていない場合は、highlight実行ファイルのフルパスに設定してください。なお、構文ハイライトを実際に使用するには、gitwebでhighlight機能を設定する必要があります。

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

スタイルシートの URI リスト（ページのベース URI を基準とした相対パス）。複数のスタイルシートを指定できます。たとえば、"gitweb.css" を基本として使用し、サイト固有の変更を別のスタイルシートで行うことで、gitweb のアップグレードを容易にすることができます。例えば、次のように記述すると、site スタイルシートを追加できます。

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

Webサーバー上の git-logo.png を置いた場所、またはより一般的にはロゴの URI（72x27 サイズ）を指します。この画像は、各 gitweb ページの右上隅に表示され、Atom フィードのロゴとして使用されます。gitweb のベース URI を基準とした相対パスです。GITWEB_LOGO 変数を使用して gitweb のビルド時に調整できます。デフォルトでは static/git-logo.png に設定されています。

Webサーバー上の git-favicon.png を置いた場所、またはより一般的にはファビコンの URI を指します。これは "image/png" タイプとして提供されます。ファビコン（Webサイトのアイコン）をサポートするWebブラウザーは、ブラウザーのURLバーやブックマーク内のサイト名の横にファビコンを表示する場合があります。gitweb のベース URI を基準とした相対パスです。GITWEB_FAVICON 変数を使用して、ビルド時に調整できます。デフォルトでは static/git-favicon.png に設定されています。

Webサーバー上の gitweb.js を置いた場所、またはより一般的には gitweb で使用される JavaScript コードの URI を指します。gitweb のベース URI を基準とした相対パスです。GITWEB_JS ビルド時構成変数を使用して、ビルド時に設定できます。

すべてのページの上部にあるホームリンクのターゲット（ビューの「パンくずリスト」の最初の部分）。デフォルトでは、現在のページの絶対 URI（$my_uri 変数の値、または $my_uri が未定義または空文字列の場合は "/"）に設定されています。

すべてのページの上部にある「ホームリンク」のラベル。$home_link（通常、プロジェクトリストを含むメインの gitweb ページ）につながります。gitweb の「パンくずリスト」の最初のコンポーネントとして使用されます：<ホームリンク> / <プロジェクト> / <アクション>。GITWEB_HOME_LINK_STR 変数を使用して、ビルド時に設定できます。デフォルトでは、「projects」に設定されています。これは、このリンクがプロジェクトリストにつながるためです。もう1つの一般的な選択肢は、サイトの名前に設定することです。これは生の HTML として扱われるため、信頼できないソースから設定しないでください。

ホームリンクの前のパンくずリストの先頭に追加される、gitweb プロジェクトリストの論理的に「上位」にあるページ（gitweb サーバーをホストする組織や部署など）への追加リンク。リストの各要素は配列への参照であり、要素 0 はリンクテキスト（$home_link_str に相当）、要素 1 はターゲット URL（$home_link に相当）です。

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

Git ロゴリンク（または別のロゴ画像を使用することを選択した場合は、サイトロゴ）の URI とラベル（タイトル）。デフォルトでは、どちらも Git のホームページ、https://git.dokyumento.jp を参照します。以前は、https://www.kernel.org にある Git のドキュメントを指していました。

ページのタイトルに表示されるサイトまたは組織の名前。ブックマークなどをわかりやすくするために、説明的なものを設定してください。この変数が設定されていない場合、またはの場合、gitweb は SERVER_NAME CGI 環境変数の値を使用し、サイト名を "$SERVER_NAME Git" に設定します。この変数が設定されていない場合（例えば、gitweb をスタンドアロンスクリプトとして実行している場合）は、「Untitled Git」に設定されます。

各ページの <head> セクションに含める HTML スニペット。ビルド時に GITWEB_SITE_HTML_HEAD_STRING を使用して設定できます。デフォルト値はありません。

各ページの上部に含める HTML を含むファイルの名前。gitweb.cgi スクリプトを含むディレクトリを基準とした相対パス。ビルド時に GITWEB_SITE_HEADER を使用して設定できます。デフォルト値はありません。

各ページの下部に含める HTML を含むファイルの名前。gitweb.cgi スクリプトを含むディレクトリを基準とした相対パス。ビルド時に GITWEB_SITE_FOOTER を使用して設定できます。デフォルト値はありません。

gitweb プロジェクトの概要ページ（"projects_list" ビュー）に存在する場合に含める HTML ファイルの名前。gitweb.cgi スクリプトを含むディレクトリを基準とした相対パス。デフォルト値は、ビルド時に GITWEB_HOMETEXT 変数を使用して調整できます。デフォルトでは indextext.html に設定されています。

プロジェクトリストの「説明」列の幅（文字数）。長い説明は切り捨てられます（単語の区切りで切るように試みます）。完全な説明は title 属性で利用できます（通常、マウスオーバー時に表示されます）。デフォルトは 25 です。これは、長いプロジェクトの説明を使用している場合は小さすぎる可能性があります。

プロジェクトリストページのプロジェクトの順序のデフォルト値。これは、プロジェクトリストを明示的にソートしない場合（URL に "o" CGI クエリパラメーターがない場合）に使用される順序を意味します。有効な値は、"none"（ソートなし）、"project"（プロジェクト名、つまり $projectroot を基準としたリポジトリへのパスでソート）、"descr"（プロジェクトの説明）、"owner"、および "age"（最新のコミットの日付順）です。

MIME タイプチェックで他のタイプにならない場合の、blob_plain（raw）ビューのデフォルトの MIME タイプ。デフォルトでは "text/plain" です。Gitweb は、ファイル名の拡張子に基づいて表示するファイルの MIME タイプを推測します。$mimetypes_file（設定されておりファイルが存在する場合）と /etc/mime.types ファイルを使用します（mime.types(5) man ページを参照。ファイル名拡張子ルールのみが gitweb でサポートされています）。

テキストファイルのデフォルトの文字セット。これが設定されていない場合は、Web サーバーの設定が使用されます。デフォルトでは設定されていません。

Gitweb は、行に UTF-8 以外の文字が含まれている場合、この文字セットを想定します。フォールバックデコードはエラーチェックなしで使用されるため、"utf-8" であってもかまいません。値は有効なエンコーディングである必要があります。リストについては、Encoding::Supported(3pm) man ページを参照してください。デフォルトは "latin1"（別名 "iso-8859-1"）です。

git-diff と git-diff-tree の名前変更検出オプション。デフォルトは ('-M') です。コピーも検出する場合は ('-C') または ('-C', '-C') に設定し、名前変更検出を不要にする場合は ()、つまり空のリストに設定します。

Git ベース URL のリスト。これらの URL は、プロジェクトの取得元を記述する URL を生成するために使用され、プロジェクトのサマリーページに表示されます。完全な取得 URL は、このリストの各要素に対して "$git_base_url/$project" となります。複数のベース URL を設定できます（例えば、git:// プロトコル用に1つ、http:// プロトコル用に1つなど）。

プロジェクトリストページでプロジェクトをカテゴリ別にグループ化するかどうか。プロジェクトのカテゴリは、$GIT_DIR/category ファイルまたは各リポジトリの設定の gitweb.category 変数によって決定されます。デフォルトでは無効（0 に設定）です。

カテゴリが指定されていないプロジェクトのデフォルトカテゴリ。これが空文字列に設定されている場合、そのようなプロジェクトはカテゴリ化されずに、カテゴリ化されたプロジェクトの上にリストされます。プロジェクトカテゴリが有効な場合、つまり $projects_list_group_categories が true の場合にのみ使用されます。デフォルトでは "" (空文字列) に設定されています。

true の場合、リポジトリ内のコンテンツがクロスサイトスクリプティング (XSS) 攻撃を開始するのを防ぐために、一部の gitweb 機能が無効になります。リポジトリのコンテンツを信頼しない場合は、これを true に設定してください。デフォルトでは false (0 に設定) です。

gitweb クエリに応答する最大負荷を設定するために使用されます。サーバー負荷がこの値を超えると、gitweb は「503 Service Unavailable」エラーを返します。gitweb がその値を判断できない場合、サーバー負荷は 0 と見なされます。現在、Linux でのみ動作し、/proc/loadavg を使用します。そこでの負荷は、過去 1 分間に平均したシステム上のアクティブなタスクの数、つまり実際に実行されているプロセスの数です。

true の場合、プロジェクトリストページの最新コミットの日付を含む列を省略します。これにより、I/O とリポジトリごとのフォークを少し節約できます。

true の場合、リポジトリ所有者に関する情報の表示を防止します。

これがコード参照に設定されている場合、リクエストごとに 1 回実行されます。この方法でセッションごとに変化する設定の一部を設定できます。たとえば、gitweb 設定ファイルで次のコードを使用できます。

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

Gitweb のバージョン。gitweb.perl から gitweb.cgi を作成するときに自動的に設定されます。たとえば、変更された gitweb を実行している場合は、それを変更する必要があるかもしれません。

our $version .= " with caching";

gitweb スクリプトの完全な URL と絶対 URL。以前のバージョンの gitweb では、これらの変数を設定する必要があったかもしれませんが、現在ではその必要はないはずです。それでも設定する必要がある場合は、$per_request_config を参照してください。

gitweb によって生成されたページの相対 URL のベース URL（たとえば、$logo、$favicon、@stylesheets が相対 URL の場合）。空でない PATH_INFO を持つ URL にのみ <base href="$base_url"> が必要で、使用されます。通常、gitweb はその値を正しく設定するため、この変数を $my_uri や "/" に設定する必要はありません。どうしてもオーバーライドする必要がある場合は、$per_request_config を参照してください。

「blame」および「blame_incremental」blob ビューを有効にし、各行について、それを変更した最後のコミットを表示します。 git-blame[1] を参照してください。これは CPU を非常に消費する可能性があるため、デフォルトでは無効になっています。

「snapshot」アクションを有効にして構成します。これにより、ユーザーは、git-archive[1] によって生成され、必要に応じて追加で圧縮された、任意のツリーまたはコミットの圧縮アーカイブをダウンロードできます。大規模なプロジェクトがある場合は、トラフィックが大きくなる可能性があります。

grep 検索を有効にします。これにより、指定された文字列を含む、現在選択されているツリー（ディレクトリ）内のファイルがリストされます。git-grep[1] を参照してください。これはもちろん、CPU を消費する可能性があります。デフォルトで有効になっています。

いわゆる pickaxe 検索を有効にします。これにより、ファイル内の指定された文字列を導入または削除したコミットがリストされます。これは、「blame」アクションの実用的かつかなり高速な代替手段になる可能性がありますが、それでも CPU を消費する可能性があります。デフォルトで有効になっています。

「tree」ビューで、ls -l と同様に、blob（通常のファイル）のサイズを別の列に表示できるようにします。 git-ls-tree[1] man ページの -l オプションの説明を参照してください。これにより、少し I/O が発生します。デフォルトで有効になっています。

「patches」ビューを有効にして構成します。これにより、電子メール（プレーンテキスト）出力形式でコミットのリストが表示されます。git-format-patch[1] も参照してください。値は、「patches」ビューで生成されるパッチセット内の最大パッチ数です。default フィールドを単一の項目を含むリストに設定するか、空のリストに設定してパッチビューを無効にするか、単一の負の数を含むリストに設定して制限を削除します。デフォルト値は 16 です。

アバターのサポート。この機能を有効にすると、「shortlog」や「commit」などのビューに、各コミッターと著者のメールに関連付けられたアバターが表示されます。

生成された HTML などからメールアドレスを隠蔽します。これにより、Git ログの著者/コミッターやコメントセクションから取得したメールアドレスが不明瞭になります。これは、アドレスを収集して悪用する Web クローラーを妨害することを目的としています。このようなクローラーは robots.txt を尊重しない場合があります。ユーザーおよびユーザーツールも、アドレスが隠蔽された状態で表示されることに注意してください。Gitweb がワークフローの最終ステップではない場合、後続のステップは、受け取る情報が隠蔽されているために誤動作する可能性があります。デフォルトでは無効になっています。

"blob" ビューでのサーバーサイドの構文強調表示のサポート。$highlight_bin プログラムが利用可能である必要があります（上記の「設定変数」セクションのこの変数の説明を参照）。したがって、デフォルトでは無効になっています。

"heads" リストにリモートヘッド（リモート追跡ブランチ）を表示できるようにします。ほとんどの場合、リモート追跡ブランチのリストは不要な内部的な詳細であるため、この機能はデフォルトでは無効になっています。通常、ローカルリポジトリの閲覧に使用されるgit-instaweb[1]は、この機能を有効にして使用します。

テキスト検索を有効にします。これにより、著者、コミッター、またはコミットテキストが指定された文字列に一致するコミットが一覧表示されます。 git-log[1] のマニュアルページの --author、--committer、--grep オプションの説明を参照してください。デフォルトで有効になっています。

この機能が有効な場合、gitweb はプロジェクトルート（ベース名）のサブディレクトリにあるプロジェクトを既存のプロジェクトのフォークとみなします。各プロジェクト $projname.git について、$projname/ ディレクトリとそのサブディレクトリ内のプロジェクトは、メインのプロジェクトリストには表示されません。代わりに、$projname の横に '+' マークが表示され、フォークを一覧表示する「フォーク」ビューにリンクされます（$projname/ サブディレクトリ内のすべてのプロジェクト）。さらに、プロジェクト概要ページからプロジェクトの「フォーク」ビューにリンクされます。

すべてのプロジェクトページの操作バーにカスタムリンクを挿入します。これにより、gitweb に統合されたサードパーティのスクリプトにリンクできます。

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

各ページの生成と表示に要した時間と Git コマンドの数をページフッター（ページの下部）に表示できるようにします。たとえば、フッターには「このページの生成には 6.53325 秒と 13 個の Git コマンドが必要でした」と表示されます。デフォルトでは無効になっています。

JavaScript を介して gitweb 出力の日付の共通タイムゾーンを変更する機能を有効化および構成します。gitweb 出力の日付には、「commit」、「commitdiff」、「log」ビューの authordate および committerdate、および「tag」ビューの taggerdate が含まれます。デフォルトで有効になっています。

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

「refs」の下に追加のディレクトリのリストで、ブランチ ref として使用されます。たとえば、refs/heads/ の下のすべてのブランチが公式のプッシュ後レビューブランチであり、refs/sandbox/、refs/wip および refs/other の下のブランチが権限がはるかに広いユーザーブランチである gerrit 設定がある場合、この変数を次のように設定できます。

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

[gitweb]
	extraBranchRefs = sandbox wip other

[gitweb]
	extraBranchRefs = sandbox
	extraBranchRefs = wip other