Keycloak: Keycloak 主題結構說明

此文件屬於自訂外觀指南的一部分。請在此處查看完整指南：在 Stackhero 上輕鬆為您的 Keycloak 登入頁面、帳戶控制台及電郵進行品牌化：設定您的顏色、標誌、文字，甚至可利用內置的線上編輯器建立完整自訂主題。。

👋 歡迎瀏覽 Stackhero 文件！

Stackhero 提供 Keycloak cloud 服務，讓您只需 2 分鐘即可輕鬆部署一個可用於生產環境的身份認證服務：

• 無限用戶、realms 及 clients
• 支援 OpenID Connect、OAuth 2.0、SAML 2.0、社交登入、LDAP 及 Active Directory 聯合
• 自訂網域名稱，內建 HTTPS，確保安全連線（例如 https://login.your-company.com）
• 自訂主題：可利用內置的線上編輯器輕鬆為登入頁面、帳戶控制台及電郵加上您的品牌風格
• 專屬 電郵伺服器，支援 SPF、DKIM 及 DMARC，協助您自動處理帳戶確認及重設密碼
• 內建 PostgreSQL 資料庫，管理控制台可於獨立且可關閉的連接埠上存取
• 一鍵更新，讓您的系統隨時保持最新，無需手動操作

專注於開發，無需煩惱設定：您可以在 5 分鐘內體驗 Stackhero 的 Keycloak cloud 解決方案。

主題是一個目錄，內含各頁面類型的子目錄：

themes/
  acme/
    login/                             # 用戶登入頁
      theme.properties                 # 主題繼承與 CSS 引用
      resources/css/stackhero.css      # 您的 CSS
      resources/img/logo.svg           # 您的圖片
      messages/messages_en.properties  # 您的文字
    account/                           # 用戶資料管理
    admin/                             # 管理控制台外觀
    email/                             # 電郵模板

主題會繼承標準 Keycloak 主題，只需覆蓋所需部分。典型的 login/theme.properties 如下：

parent=keycloak.v2
styles=css/styles.css css/stackhero.css

• parent 設定基礎主題。
• styles 列出要載入的 CSS 檔案。請將您的 CSS 放在最後，以確保變更生效。

styles 列表會取代父主題的列表，而非擴充。請務必包含父主題的樣式表（css/styles.css），否則頁面將失去預設樣式。

只有在需要更改 HTML 結構時，才需 FreeMarker 模板（.ftl 檔案）。如只需調整顏色、標誌、背景、文字及語言，無需編輯模板。詳情請參閱 Keycloak 主題官方文件。