GitLabの外観

GitLabの自己管理インスタンスの外観をカスタマイズするために、いくつかのオプションが用意されています。これらの設定にアクセスするには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 設定 > 外観を選択します。

デフォルトでは、ナビゲーションバーにはGitLabのロゴが表示されますが、これは好きな画像でカスタマイズすることができます。高さ28pxの画像（幅は問いません）に最適化されていますが、どんな画像でも使用することができ（1MB以下）、自動的にリサイズされます。

画像を選択しアップロードしたら、ページ下部のUpdate appearance settingsを選択し、GitLabインスタンスで有効にします。

note
GitLabパイプラインメールは、ロゴがSVG形式でない限り、カスタムロゴも表示します。カスタムロゴがSVG形式の場合、SVG形式は多くのメールクライアントでサポートされていないため、デフォルトのロゴが代わりに使われます。

ファビコン

デフォルトでは、ファビコン（ブラウザのタブアイコンやCIステータスのアイコンとして使用）はGitLabのロゴを使用しています。これは好きなアイコンでカスタマイズすることができます。32x32.png または.ico の画像でなければなりません。

アイコンを選択してアップロードしたら、ページの一番下にあるUpdate appearance settingsを選択してGitLabインスタンスで有効にします。

GitLab 15.9で導入されたメールのヘッダーとフッターを有効にするチェックボックス。

小さなヘッダーメッセージ、小さなフッターメッセージ、またはその両方をGitLabインスタンスのインターフェイスに追加することができます。これらのメッセージは、サインイン／サインアップページを含む、インスタンスのすべてのプロジェクトやページに表示されます。デフォルトの色はオレンジの背景に白のテキストですが、Customize colors を選択することでカスタマイズすることができます。

太字、斜体、リンクなど、限られたMarkdownがサポートされています。ヘッダーとフッターのメッセージは1行のみであるため、リスト、画像、引用符を含む他のMarkdown機能はサポートされていません。

Enable header and footer inemailsを選択すると、GitLabインスタンスから送信されるすべてのメールにヘッダーとフッターのテキストが追加されます。

メッセージを追加したら、ページ下部のUpdate appearance settingsを選択し、GitLabインスタンスで有効にします。

サインイン / サインアップページ

サインイン/サインアップページのデフォルトのメッセージをあなた自身のメッセージとロゴに置き換えることができます。説明文ではMarkdownをフル活用できます。

ロゴの最適なサイズは128 x 128ピクセルですが、どんな画像でも使用することができ（1MB以下）、自動的にリサイズされます。ロゴ画像はサインアップページの左側、タイトルと説明文の間に表示されます。

メッセージを追加したら、ページ下部のUpdate appearance settingsを選択し、GitLabインスタンスで有効にします。サインインページを選択して、保存した外観設定をレビューすることもできます：

note
サインインメッセージの下にカスタマイズしたhcelpメッセージを追加したり、サインインテキストメッセージを追加することもできます。

プログレッシブウェブアプリ

GitLab 15.9 で導入されました。

GitLabはProgressive Web App (PWA)としてインストールすることができます。Progressive Web Appの設定を使って、名前、説明、アイコンなどの外観をカスタマイズしてください。

PWAの設定

PWAの設定を行います：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. 設定 > 外観を選択します。
  4. Progressive Web App(PWA)セクションまでスクロールします。
  5. 各項目を入力してください。
    • アイコン：標準のGitLabアイコンを使用する場合、サイズは192x192ピクセル、512x512ピクセル、マスク可能なアイコンもあります。カスタムアイコンを使用する場合は、192x192ピクセルか512x512ピクセルのどちらかのサイズでなければなりません。
  6. 外観設定の更新を選択します。

新しいプロジェクトページ

GitLabの新規プロジェクトページに新規プロジェクトのガイドラインメッセージを追加することができます。説明文にはMarkdownをフル活用できます：

メッセージはNew Project ページの左側、New Projectメッセージの下に表示されます。

メッセージを追加したら、ページの一番下にあるUpdate appearance settingsを選択して GitLab インスタンスで有効にします。また、New project page を選択すると新しいプロジェクトページが表示され、変更をレビューすることができます。

Libravatar

LibravatarはGitLabでアバター画像のためにサポートされていますが、サービスを使うにはGitLabインスタンスで手動でLibravatarサポートを有効にする必要があります。