自分で構築したGitLabの外観を変える方法

この記事は[GitLab Advent Calendar 2022](https://qiita.com/advent-calendar/2022/gitlab)の16日目に参加しています。

# はじめに

こんにちは。2022年も、もうすぐ終わりですね。今年はどんな年でしたか？私はGitLabに出会った年でした:heart_eyes:
勉強のためにGitLabのOmnibusパッケージを自分の環境にインストール。多くのトラブルを乗り越え、無事動作できるようにりましたが、使い続けているうちに**デザインを変えたくなりました。**
たかが見た目ですが、結構重要だと思います！パッと見て「あ、違う」とわかると、例えばgitlab.comにもアカウントがあったり、会社など別のインスタンスも使っている場合に間違いが起こりにくいメリットがあるのではないでしょうか。
そこで**GitLabの外観を変える方法をまとめてみました！**


:::note info
この記事はGitLab15.5.6-ce Omnibusパッケージ版の動作を元にして記述しています。今後のバージョンアップ等でご紹介している機能に変更が加えられる場合があります。
公式ドキュメントへのリンクもありますので、自分の使用しているGitLabにその機能があるかはそちらでご確認下さい。
:::

# GitLab全体の外観を変えるには
公式ドキュメント解説：[GitLab Appearance](https://docs.gitlab.com/ee/user/admin_area/appearance.html)

Admin権限を持つアカウントでログインして、まずはこちらから設定画面へ。
メニューの**Admin Area**から、**Setting > Appearance**で、変更画面が表示されます。
(表示が日本語の場合：**管理者エリア**から**設定 > 外観**)


## GitLabのロゴ（左上のTanukiの画像）を変更するには

公式ドキュメント解説：[Top bar](https://docs.gitlab.com/ee/user/admin_area/appearance.html#top-bar)

まずは、いちばん目立っている、左上のオレンジのTanukiのロゴ。header logoといいます。これを好きな画像に変更することができます。

:::note warn
header logoに使用する画像について
- 使用できる画像のサイズは1MB以内
- 高さ24pxにリサイズして表示される
:::

Appearance（外観）画面の**Navigation bar**の項目で変更します。
「ファイルを選択」ボタンをクリックし、画像を選択します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/1857282c-c8d6-579f-d392-1058f638e836.png" width=500px />

その後、Appearance（外観）画面を一番下までスクロールして**Update appearance settings**ボタンを押すことで変更が有効となります。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/c3761fc2-fa15-01bc-1801-380b973880bf.png" width=500px />
変更できました！
![changed_logo_hidari.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/cd3f2a46-719e-1801-5d3a-07f97db1c452.png)

Header logoに設定できる画像は正方形だけではなく、このように横長の画像も可能です。高さは24pxに縮小されます。
とはいえ、画像の幅の分、検索バーやメニューが右へ移動してしまうので、ご注意下さい。
![橇のスクリーンショット.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/093d983c-b246-ac35-580b-89c96c24ce97.png)

設定したheader logoを削除してデフォルトに戻すには、赤いボタン**Remove header logo**をクリックします。（Update appearance settingsを押さなくても変更されます）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/cce2ba51-4e70-28e4-9432-02e2b854ddd9.png)

## Favicon（ブラウザのタブに表示される小さなアイコン）を変更するには
公式ドキュメント解説：[Favicon](https://docs.gitlab.com/ee/user/admin_area/appearance.html#favicon)

ブラウザのタブに表示されるfavicon。こちらもデフォルトのTanukiから好きな画像に変更することができます。

:::note warn
faviconに使用する画像について
- 使用できる画像のサイズは1MB以内、32x32px
- ファイル形式はPNG、ICOのみ
:::

Appearance（外観）画面の**Favicon**の項目で変更します。

「ファイルを選択」ボタンをクリックし、画像を選択します。適切なサイズとファイル形式で画像を用意しましょう。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/9222b17f-785f-e5c1-8d9a-127bbc6984bd.png" width=400px />
画像選択後、Appearance（外観）画面を一番下までスクロールして**Update appearance settings**ボタンを押すことで変更が有効となります。

変更できました！
![faviconを変えました.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/0a429175-4ccf-3664-4afa-788c98d4842f.png)

デフォルトに戻すには、header logoの場合と同様、赤いボタン**Remove favicon**をクリックします。

## GitLabのすべての画面でヘッダーとフッターにメッセージを表示するには

公式ドキュメント解説：[System header and footer](https://docs.gitlab.com/ee/user/admin_area/appearance.html#system-header-and-footer-messages)

ロゴとfaviconを変えただけでもだいぶ雰囲気が変わりました。
さて、ヘッダとフッタにテキスト表示する機能を発見！
試してみましょう。

Appearance（外観）画面の**System header and footer**の項目で変更します。

表示するテキストにはMarkdownの一部が使えます。絵文字もOKです！
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/2f187bbf-5325-3bb4-4e13-506b85de0817.png)

下にある小さな文字、**Customize colors**のリンクをクリックすると、表示する帯状エリアの背景色と、文字色を選ぶことができます。
スポイトも使えるほか、このようにRGB、HSL、HEXでの指定も可能です。
設定後は「Update appearance settings」ボタンで反映させるのを忘れずに。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/3c324005-2d37-4ba1-6d40-d506187f8b6f.png" width=300px />

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/631c61ef-a595-3243-6139-87cc5833fbed.png" width=300px />

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/41c29aa8-6204-afe4-e8cf-8aa56af142ed.png" width=300px />

こんな風に表示できました！上と下に表示された文字がわかりますでしょうか。
（スクショのためにブラウザを狭く表示しています）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/d915ae35-acea-e0cf-9221-e7150d98fa8c.png)

似たような機能に、[Broadcast messages](https://docs.gitlab.com/ee/user/admin_area/broadcast_messages.html#broadcast-messages)があります。こちらはログインしてGitLabを利用しているユーザにメッセージを送るもので、一致するURLでのみ表示などの機能があります。
System header and footerで設定したメッセージはGitLabのすべての画面で同じように表示されます。
ログイン前の画面も同様です。ログアウトしなくても表示の確認ができます。
Appearance（外観）画面を一番下までスクロールすると、Update appearance settingsボタンの下にある、Preview last save: **Sign-in page**というボタンがありますので、それをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/b8f68a04-4a8c-4197-175e-621586340633.png)
これがプレビューしている状態です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3020765/e8b5ae56-222b-0a27-1d3d-b5f95f8c553e.png)

## Appearance（外観）の他の設定機能
Appearance（外観）画面では、他にもこのような設定項目がありますので、興味がある方は試してみてください！
- [Sign in/Sign up pages](https://docs.gitlab.com/ee/user/admin_area/appearance.html#sign-in--sign-up-pages)
    - ログイン前の画面に表示するタイトルとテキスト、画像（ロゴ）を設定できます。
- [New project pages](https://docs.gitlab.com/ee/user/admin_area/appearance.html#new-project-pages)
    - 新規にプロジェクトを作成する際にガイドラインとして表示するテキストを設定できます。
- Profile image guideline
    - ユーザがEdit profile画面で、Public avatar（自分のアバター)を設定する項目でガイドラインとして表示するテキストを設定できます。

# おわりに
クリスマスっぽくGitLabの外観を変えてみました！
**🎄:santa:🎁🎄:santa:🎁 それではみなさん、よいクリスマスを♪🎁:santa:🎄🎁:santa:🎄**