docs: 新增 color-tokens 規範文件

assets/css/style.css

@@ -1,22 +1,25 @@
 @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+TC:wght@100..900&display=swap');
 
 :root {
-    --primary: #ffcc00;
-    --light-yellow: #fceea7;
-    --dark-yellow: #4e492b;
-    --black: #1a1a1a;
-    --deep-black: #0a0a0a;
-    --gray: #f4f4f4;
-    --text-color: #333;
-    --accent: #FFD700;
-    --text: #1a1a1a;
-    --card-bg: #1a1a1a;
-    --bg-alt: #fcfaf2;
-    --text-main: #333;
-    --text-muted: #4d4d4d;
-    --surface: #fffdf7;
-    --surface-soft: #fff9e8;
+    /* ── 品牌色 ── */
+    --color-brand: #ffcc00;
+    --color-brand-light: #fceea7;
+    --color-brand-dark: #4e492b;
 
+    /* ── 背景色 ── */
+    --color-bg: #0a0a0a;
+    --color-bg-raised: #1a1a1a;
+    --color-bg-alt: #fcfaf2;
+
+    /* ── 表面色（淺色內容區） ── */
+    --color-surface: #fffdf7;
+    --color-surface-soft: #fff9e8;
+
+    /* ── 文字色 ── */
+    --color-text: #333333;
+    --color-text-dark: #1a1a1a;
+    --color-text-muted: #4d4d4d;
+    --color-text-inverse: #f4f4f4;
 }
 
 /* 1. 先處理 body 和全域，確保沒人亂給外距 */
@@ -29,7 +32,7 @@
 
 html,
 body {
-    background-color: var(--deep-black);
+    background-color: var(--color-bg);
     color: #eeeeee;
     height: 100%;
     margin: 0;
@@ -39,7 +42,7 @@ body {
 
 body {
     font-family: 'Noto Sans TC', system-ui, sans-serif;
-    color: var(--text-color);
+    color: var(--color-text);
     line-height: 1.6;
 }
 
@@ -63,7 +66,7 @@ header#origin {
 
 /* 導覽列（排除 portal、B 站分集 tab 等自帶版面之 nav，避免 space-between／大 padding 破壞） */
 nav:not(.portal-nav):not(.bilivideo-episode-nav) {
-    background-color: var(--black);
+    background-color: var(--color-bg-raised);
     padding: 0.8rem;
     display: flex;
     justify-content: space-between;
@@ -120,7 +123,7 @@ nav a {
     width: 100%;
     margin: 0 0 14px;
     padding: 0.8rem 100px;
-    background-color: var(--black);
+    background-color: var(--color-bg-raised);
     border-radius: 0;
     box-shadow: none;
     overflow: visible;
@@ -144,11 +147,11 @@ nav a {
     border-radius: 10px;
     background: transparent;
     cursor: pointer;
-    color: var(--primary);
+    color: var(--color-brand);
 }
 
 .portal-nav__menu-toggle:focus-visible {
-    outline: 2px solid var(--primary);
+    outline: 2px solid var(--color-brand);
     outline-offset: 3px;
 }
 
@@ -211,7 +214,7 @@ nav a {
     text-align: center;
     line-height: 1.15;
     text-decoration: none;
-    color: var(--primary);
+    color: var(--color-brand);
     font-size: 0.95rem;
     letter-spacing: 1px;
     padding: 2px 4px;
@@ -482,7 +485,7 @@ nav a {
             max(0.85rem, env(safe-area-inset-top, 0px)) clamp(14px, 2vw + 10px, 32px) max(1rem, env(safe-area-inset-bottom, 0px));
         z-index: 10000;
         overflow: hidden;
-        background-color: var(--black);
+        background-color: var(--color-bg-raised);
         grid-template-columns: 1fr;
         grid-template-rows: auto minmax(0, 1fr);
         grid-template-areas:
@@ -498,7 +501,7 @@ nav a {
         position: relative;
         z-index: 2;
         flex-shrink: 0;
-        background-color: var(--black);
+        background-color: var(--color-bg-raised);
     }
 
     .portal-nav .logo {
@@ -599,7 +602,7 @@ nav a {
     .portal-nav.portal-nav--open>ul>li.open>a {
         border-color: transparent;
         border-radius: 0;
-        color: var(--primary);
+        color: var(--color-brand);
     }
 
     .portal-nav>ul>li {
@@ -972,13 +975,13 @@ footer {
 
 .hero p {
     font-size: 1.2rem;
-    color: var(--gray);
+    color: var(--color-text-inverse);
 }
 
 .btn {
     display: inline-block;
     padding: 10px 30px;
-    background: var(--primary);
+    background: var(--color-brand);
     color: #000;
     font-weight: bold;
     border-radius: 50px;
@@ -1007,7 +1010,7 @@ footer {
 }
 
 .section-title {
-    color: var(--primary);
+    color: var(--color-brand);
     text-align: center;
     font-size: 1.35rem;
     letter-spacing: 3px;
@@ -1020,7 +1023,7 @@ footer {
     display: block;
     width: 50px;
     height: 3px;
-    background: var(--primary);
+    background: var(--color-brand);
     margin: 15px auto 0;
 }
 
@@ -1036,7 +1039,7 @@ footer {
     content: "";
     flex: 1;
     height: 2px;
-    background-color: var(--primary);
+    background-color: var(--color-brand);
     max-width: 56px;
     opacity: 0.7;
 }
@@ -1059,7 +1062,7 @@ footer {
 }
 
 .card {
-    background: linear-gradient(135deg, var(--surface-soft) 0%, #ffffff 100%);
+    background: linear-gradient(135deg, var(--color-surface-soft) 0%, #ffffff 100%);
     backdrop-filter: blur(10px);
     border: 1px solid rgba(255, 204, 0, 0.18);
     border-radius: 14px;
@@ -1070,7 +1073,7 @@ footer {
 
 .card:hover {
     transform: translateY(-8px);
-    border-color: var(--primary);
+    border-color: var(--color-brand);
     box-shadow: 0 16px 32px rgba(0, 0, 0, 0.14);
 }
 
@@ -1087,7 +1090,7 @@ footer {
 section {
     margin-top: 0 !important;
     margin-bottom: 60px;
-    background: var(--surface);
+    background: var(--color-surface);
     padding: 44px 36px;
     border-radius: 16px;
     border: 1px solid rgba(255, 204, 0, 0.15);
@@ -1153,14 +1156,14 @@ section {
     width: 3.25rem;
     height: 4px;
     margin: 0.55rem 0 0;
-    background: linear-gradient(90deg, var(--primary), #ffe066);
+    background: linear-gradient(90deg, var(--color-brand), #ffe066);
     border-radius: 2px;
 }
 
 .mission-section .mission-logo-heading {
     font-size: 1.08rem;
     letter-spacing: 0.18em;
-    color: var(--primary);
+    color: var(--color-brand);
     margin: 0 0 0.85rem;
     font-weight: 800;
     text-transform: uppercase;
@@ -1199,7 +1202,7 @@ section {
     overflow: hidden;
     border: 1px solid rgba(255, 204, 0, 0.28);
     box-shadow: 0 10px 28px rgba(0, 0, 0, 0.12);
-    background: #1a1a1a;
+    background: var(--color-bg-raised);
 }
 
 .mission-section .mission-gif-frame img {
@@ -1281,7 +1284,7 @@ section {
     flex-shrink: 0;
     font-size: 0.95rem;
     line-height: 1;
-    color: var(--primary);
+    color: var(--color-brand);
     font-style: normal;
 }
 
@@ -1338,7 +1341,7 @@ section {
     top: 0.15em;
     font-size: 1.05em;
     line-height: 1;
-    color: var(--fa-before-color, var(--primary, #ffcc00));
+    color: var(--fa-before-color, var(--color-brand));
 }
 
 .fa-before-lead.fa-before-lead--balloon::before {
@@ -1347,7 +1350,7 @@ section {
     width: 1.15em;
     height: 1.15em;
     top: 0.1em;
-    background-color: var(--fa-before-color, var(--primary, #ffcc00));
+    background-color: var(--fa-before-color, var(--color-brand));
     -webkit-mask: url('../images/icon/balloon.svg') center / contain no-repeat;
     mask: url('../images/icon/balloon.svg') center / contain no-repeat;
 }
@@ -1383,7 +1386,7 @@ section {
     content: "";
     flex: 1;
     height: 2px;
-    background-color: var(--primary);
+    background-color: var(--color-brand);
     max-width: 56px;
     opacity: 0.7;
 }
@@ -1419,7 +1422,7 @@ section {
         linear-gradient(185deg, rgba(255, 255, 255, 0.65) 0%, rgba(255, 255, 255, 0) 42%),
         linear-gradient(168deg, #fffef8 0%, #fff6d2 52%, #fffce8 100%);
     border: 1px solid rgba(220, 185, 90, 0.42);
-    border-left: 5px solid var(--primary);
+    border-left: 5px solid var(--color-brand);
     border-radius: 14px;
     box-shadow:
         0 1px 0 rgba(255, 255, 255, 0.92) inset,
@@ -1463,8 +1466,8 @@ table {
 }
 
 table th {
-    background-color: var(--primary);
-    color: var(--black);
+    background-color: var(--color-brand);
+    color: var(--color-bg-raised);
     padding: 12px;
 }
 
@@ -1476,7 +1479,7 @@ table td {
 }
 
 a {
-    color: var(--text-color);
+    color: var(--color-text);
     text-decoration: none;
 }
 
@@ -1518,7 +1521,7 @@ a {
     max-width: 42rem;
     margin: 0 0 28px;
     padding: 16px 18px;
-    background: linear-gradient(135deg, var(--surface-soft) 0%, #fff 100%);
+    background: linear-gradient(135deg, var(--color-surface-soft) 0%, #fff 100%);
     border: 1px solid rgba(255, 204, 0, 0.18);
     border-radius: 12px;
     box-shadow: 0 10px 24px rgba(0, 0, 0, 0.1);
@@ -1560,7 +1563,7 @@ a {
     content: attr(data-era);
     position: absolute;
     top: -14px;
-    background-color: var(--primary);
+    background-color: var(--color-brand);
     color: #303030;
     font-size: 0.7rem;
     font-weight: 700;
@@ -1701,7 +1704,7 @@ a {
 }
 
 .merged-storyline .timeline-ebook-cta:focus-visible {
-    outline: 3px solid #1a1a1a;
+    outline: 3px solid var(--color-bg-raised);
     outline-offset: 3px;
 }
 
@@ -1802,7 +1805,7 @@ a {
 
 .merged-storyline .story-external-inline:hover,
 .merged-storyline .story-external-inline:focus-visible {
-    color: var(--dark-yellow);
+    color: var(--color-brand-dark);
 }
 
 .merged-storyline .story-external-inline i {
@@ -1861,7 +1864,7 @@ a {
 
 /* 頁尾 */
 footer {
-    background-color: var(--black);
+    background-color: var(--color-bg-raised);
     color: white;
     text-align: center;
     padding: 50px 0 20px;
@@ -1869,13 +1872,13 @@ footer {
 
 /* 全站：深色字重點（棕黃字色，與 <b> 不同於「顏色」） */
 .mark_b {
-    color: var(--dark-yellow);
+    color: var(--color-brand-dark);
     font-weight: bold;
 }
 
 /* 深色頁尾內的 mark_b：維持可讀與全站黃色語彙 */
 footer a .mark_b {
-    color: var(--primary);
+    color: var(--color-brand);
 }
 
 /* map.html — 主內容層；頂欄見全站 .portal-nav */
@@ -1921,7 +1924,7 @@ footer a .mark_b {
     align-items: flex-end;
     text-align: right;
     white-space: normal;
-    color: var(--primary);
+    color: var(--color-brand);
     text-decoration: none;
     font-size: 0.95rem;
     letter-spacing: 1px;
@@ -2196,7 +2199,7 @@ header.inner-page-header .sub-title {
 .site-header-inner .main-title {
     font-size: clamp(2rem, 4.5vw, 3.2rem);
     font-weight: 900;
-    color: var(--text-main, #333);
+    color: var(--color-text);
     letter-spacing: 6px;
     margin: 0;
     text-shadow: none;
@@ -2228,7 +2231,7 @@ header.inner-page-header .sub-title {
     flex: 0 0 auto;
     font-size: 0.92rem;
     letter-spacing: 4px;
-    color: var(--text-muted, #888);
+    color: var(--color-text-muted);
     margin: 0 18px;
     text-transform: uppercase;
 }
@@ -2268,7 +2271,7 @@ header.inner-page-header .sub-title {
 }
 
 #itinerary-search:focus {
-    border-color: #ffcc00;
+    border-color: var(--color-brand);
     box-shadow: 0 0 0 3px rgba(255, 204, 0, 0.2);
 }
 
@@ -2287,9 +2290,9 @@ header.inner-page-header .sub-title {
 
 .tab-btn:hover,
 .tab-btn.active {
-    background: #ffcc00;
+    background: var(--color-brand);
     color: #2f2f2f;
-    border-color: #ffcc00;
+    border-color: var(--color-brand);
 }
 
 .map-sticky {
@@ -2641,7 +2644,7 @@ header.inner-page-header .sub-title {
 }
 
 .mode-btn.active {
-    background: var(--primary);
+    background: var(--color-brand);
     color: #161616;
 }
 
@@ -3111,7 +3114,7 @@ body.totoga2-page .totoga2-plot .intro-text {
 }
 
 body.totoga2-page .totoga2-plot .intro-text a {
-    color: var(--dark-yellow);
+    color: var(--color-brand-dark);
     font-weight: 700;
     text-decoration: underline;
 }
@@ -3257,7 +3260,7 @@ body.member-crystal-page .member-crystal-intro__title {
 }
 
 body.member-crystal-page .member-crystal-intro--black .member-crystal-intro__title {
-    color: var(--yellow);
+    color: var(--color-brand);
 }
 
 body.member-crystal-page .member-crystal-intro__en {
@@ -3677,7 +3680,7 @@ body.site-guide-page .site-guide-grid {
 }
 
 body.site-guide-page .site-guide-card {
-    background: linear-gradient(135deg, var(--surface-soft) 0%, #fff 100%);
+    background: linear-gradient(135deg, var(--color-surface-soft) 0%, #fff 100%);
     border-radius: 14px;
     padding: 1.25rem 1.35rem;
     border: 1px solid rgba(255, 204, 0, 0.18);
@@ -3690,7 +3693,7 @@ body.site-guide-page .site-guide-card h3 {
 }
 
 body.site-guide-page .site-guide-card h3 a {
-    color: var(--dark-yellow);
+    color: var(--color-brand-dark);
     font-weight: 800;
     text-decoration: none;
 }
@@ -3852,7 +3855,7 @@ body.minister-page .minister-hero-lead {
 }
 
 body.minister-page .minister-hero-lead .mark_b {
-    color: var(--light-yellow);
+    color: var(--color-brand-light);
 }
 
 body.minister-page .variety-block .intro-text {
@@ -3888,8 +3891,8 @@ body.minister-page .minister-hashtag,
     font-size: clamp(0.78rem, 1.65vw, 0.9rem);
     letter-spacing: 0.06em;
     line-height: 1.2;
-    color: var(--dark-yellow);
-    background: linear-gradient(180deg, rgba(255, 253, 247, 0.98) 0%, var(--surface-soft) 100%);
+    color: var(--color-brand-dark);
+    background: linear-gradient(180deg, rgba(255, 253, 247, 0.98) 0%, var(--color-surface-soft) 100%);
     border: 1px solid rgba(255, 204, 0, 0.52);
     box-shadow:
         0 1px 0 rgba(255, 255, 255, 0.88) inset,
@@ -3972,12 +3975,4 @@ body.minister-page .minister-photo--dual img {
 }
 
 body.minister-page .minister-back {
-    text-align: center;
-    margin: 2rem 0 0;
-}
-
-@media (max-width: 640px) {
-    body.minister-page .minister-photo--dual {
-        grid-template-columns: 1fr;
-    }
-}
+    text-