@windcoder/astro-theme-orchid 0.3.0 → 0.4.1

package/src/components/Sidebar.astro

@@ -4,13 +4,16 @@ import config from "virtual:theme/config";
 import { Icon } from "astro-icon/components";
 import { t } from "../i18n/index.js";
 import { resolveThemeIcon } from "../icons.js";
+import { resolveSiteImage } from "../utils/image.js";
 import {
 	collectCategories,
 	collectTags,
+	countTotalWords,
 	daysSince,
 	type PostLike,
 } from "../utils.js";
 import Calendar from "./Calendar.astro";
+import MusicWidget from "./MusicWidget.astro";
 import type { TocHeading } from "./Toc.astro";
 
 interface Props {
@@ -38,6 +41,8 @@ const shownTags = tagCount > 0 ? tags.slice(0, tagCount) : tags;
 const tagHidden = tags.length - shownTags.length;
 
 const runDays = config.since ? daysSince(config.since) : null;
+// §4.99 站点信息总字数：全站文章 words 之和（frontmatter words 字段），0 时隐藏该行
+const totalWords = countTotalWords(posts);
 
 // widget 开关与顺序（P2 侧栏改造）：config.sidebar.widgets 数组即渲染顺序；
 // 两个方向的显隐（对齐参考模板 showOnPostPage/hideOnNonPostPage）：
@@ -61,12 +66,18 @@ const annLink = Boolean(ann.link.text && ann.link.url);
 const profile = config.profile;
 const showProfile = Boolean(profile.name || profile.avatar || profile.bio);
 const profileInitial = (profile.name || "?").trim().slice(0, 1) || "?";
+// 头像三格式解析（§4.97）：相对路径相对站点 src/ 构建期解析
+const profileAvatar = profile.avatar
+	? await resolveSiteImage(profile.avatar)
+	: "";
 
 // 广告 widget（P2 保留项，默认关）：enabled + 至少一项内容 + 未过期才渲染
 const ad = config.advertisement;
 const adExpired = ad.expireDate ? new Date() > new Date(ad.expireDate) : false;
 const showAd =
 	ad.enabled && Boolean(ad.image || ad.content || ad.link.text) && !adExpired;
+// 广告图三格式解析（§4.97）
+const adImage = ad.image ? await resolveSiteImage(ad.image) : "";
 
 // 友链 widget（决策 8）：与友链页同源 themeConfig.friends.list；
 // random=false 时 featured 优先、其余按 weight 降序，取前 count 个。
@@ -84,6 +95,12 @@ if (fw?.type === "friends") {
 			});
 	sideFriends = pool.slice(0, sc.count);
 }
+// 友链头像三格式解析（§4.97）：空串跳过（留空用字头像）
+const sideFriendImgs = await Promise.all(
+	sideFriends.map((f) =>
+		f.image ? resolveSiteImage(f.image) : Promise.resolve(""),
+	),
+);
 ---
 
 <aside class="sidebar">
@@ -102,13 +119,13 @@ if (fw?.type === "friends") {
             {profile.url ? (
               <a class="profile-avatar-link" href={profile.url} aria-label={profile.name}>
                 {profile.avatar ? (
-                  <img class="profile-avatar" src={profile.avatar} alt={profile.name} loading="lazy" />
+                  <img class="profile-avatar" src={profileAvatar} alt={profile.name} loading="lazy" />
                 ) : (
                   <span class="profile-avatar avatar-fallback">{profileInitial}</span>
                 )}
               </a>
             ) : profile.avatar ? (
-              <img class="profile-avatar" src={profile.avatar} alt={profile.name} loading="lazy" />
+              <img class="profile-avatar" src={profileAvatar} alt={profile.name} loading="lazy" />
             ) : (
               <span class="profile-avatar avatar-fallback">{profileInitial}</span>
             )}
@@ -132,7 +149,7 @@ if (fw?.type === "friends") {
                   // 未命中跳过图标只渲染文字
                   const icon = lk.icon
                     ? lk.icon.startsWith("<")
-                      ? { html: lk.icon }
+                      ? { html: lk.icon, name: undefined }
                       : resolveThemeIcon(lk.icon)
                     : null;
                   return (
@@ -218,10 +235,10 @@ if (fw?.type === "friends") {
           <section class:list={["side-card", "card", "reveal", { "side-hide-m": w.hideOnMobile }]}>
             <h3>{t('friendLinks')}</h3>
             <div class="side-friends">
-              {sideFriends.map((f) => (
+              {sideFriends.map((f, i) => (
                 <a href={f.site} target="_blank" rel="noopener" title={f.title}>
                   {f.image ? (
-                    <img src={f.image} alt={f.title} loading="lazy" />
+                    <img src={sideFriendImgs[i]} alt={f.title} loading="lazy" />
                   ) : (
                     <span class="avatar-fallback">{f.title.slice(0, 1)}</span>
                   )}
@@ -250,6 +267,9 @@ if (fw?.type === "friends") {
             </nav>
           </section>
         )}
+        {w.type === 'music' && config.music.enabled && config.music.playlist.length > 0 && (
+          <MusicWidget hideMobile={w.hideOnMobile} />
+        )}
         {w.type === 'siteInfo' && (
           <section class:list={["side-card", "card", "reveal", { "side-hide-m": w.hideOnMobile }]}>
             <h3>{t('siteInfo')}</h3>
@@ -258,6 +278,7 @@ if (fw?.type === "friends") {
               <div class="row"><span>{t('categories')}</span><b>{cats.length}</b></div>
               <div class="row"><span>{t('tags')}</span><b>{tags.length}</b></div>
               {runDays !== null && <div class="row"><span>{t('running')}</span><b>{t('daysCount', { n: runDays })}</b></div>}
+              {totalWords > 0 && <div class="row"><span>{t('totalWords')}</span><b>{totalWords.toLocaleString()}</b></div>}
             </div>
           </section>
         )}
@@ -278,10 +299,10 @@ if (fw?.type === "friends") {
               {ad.image &&
                 (ad.imageLink ? (
                   <a href={ad.imageLink} target="_blank" rel="noopener">
-                    <img src={ad.image} alt={ad.imageAlt} loading="lazy" />
+                    <img src={adImage} alt={ad.imageAlt} loading="lazy" />
                   </a>
                 ) : (
-                  <img src={ad.image} alt={ad.imageAlt} loading="lazy" />
+                  <img src={adImage} alt={ad.imageAlt} loading="lazy" />
                 ))}
               {ad.content && <p>{ad.content}</p>}
               {ad.link.text && (

package/src/i18n/en.ts

@@ -5,6 +5,7 @@ import type { UiKey } from "./zh-CN.js";
 
 const en: Record<UiKey, string> = {
 	skipToContent: "Skip to content",
+	scrollDown: "Scroll down",
 	backToTop: "Back to top",
 	mainNav: "Main navigation",
 	toggleMode: "Toggle dark mode",
@@ -97,6 +98,8 @@ const en: Record<UiKey, string> = {
 	searchNoResults: "No results found",
 	searchUnavailable: "Search index available after build",
 	searchTypeSomething: "Type to search",
+	searchMore: "View all {n} results",
+	searchResultsTotal: "{n} results",
 	galleryPhotos: "{n} photos",
 	backToAlbums: "Back to albums",
 	searchAlbums: "Search albums…",
@@ -168,6 +171,39 @@ const en: Record<UiKey, string> = {
 	codeFoldCollapse: "Collapse code",
 	codeFoldExpanded: "Code block expanded",
 	codeFoldCollapsed: "Code block collapsed",
+	/* Wallpaper (§4.98): header control button aria-label/title */
+	wpPlay: "Play wallpaper video",
+	wpPause: "Pause wallpaper video",
+	wpPrev: "Previous video",
+	wpNext: "Next video",
+	wpMode: "Switch wallpaper mode",
+	/* Display settings panel (§4.103): gear entry + three tabs + group controls */
+	displaySettings: "Display Settings",
+	tabAppearance: "Appearance",
+	tabWallpaper: "Wallpaper",
+	tabEffects: "Effects",
+	wallpaperMode: "Wallpaper Mode",
+	modeBanner: "Banner",
+	modeFullscreen: "Fullscreen",
+	modeOverlay: "Overlay",
+	modeNone: "Solid Color",
+	fullscreenLayout: "Fullscreen Layout",
+	layoutClassic: "Classic",
+	layoutHero: "Hero",
+	wallpaperSettings: "Wallpaper Settings",
+	homeWallpaperTitle: "Home Wallpaper Title",
+	wallpaperCarousel: "Wallpaper Carousel",
+	wavesAnimation: "Waves Animation",
+	gradientTransition: "Gradient Transition",
+	overlaySettings: "Transparency",
+	wallpaperOpacity: "Wallpaper Opacity",
+	backgroundBlur: "Background Blur",
+	cardOpacity: "Card Opacity",
+	sakuraEffect: "Sakura Effect",
+	/* Site info total words (§4.99): sidebar siteInfo card */
+	totalWords: "Total words",
+	/* Sidebar music widget (§4.100): title; play/prev/next reuse music* keys */
+	musicWidget: "Music",
 };
 
 export default en;

package/src/i18n/ja.ts

@@ -0,0 +1,213 @@
+/**
+ * 日本語言語パック：Record<UiKey, string> 强制与中文键源一一对应，缺译会在编译期报错。
+ */
+import type { UiKey } from "./zh-CN.js";
+
+const ja: Record<UiKey, string> = {
+	skipToContent: "本文へスキップ",
+	scrollDown: "下にスクロール",
+	backToTop: "トップへ戻る",
+	mainNav: "メインナビゲーション",
+	toggleMode: "ダークモード切り替え",
+	menu: "メニュー",
+	palette: "テーマカラー",
+	paletteTitle: "アクセントカラー",
+	reset: "リセット",
+	hueValue: "色相 {n}",
+	pinned: "ピン留め",
+	wordsCount: "{n} 文字",
+	minutesCount: "約 {n} 分",
+	prevNext: "前後の記事",
+	prevPost: "前の記事",
+	nextPost: "次の記事",
+	firstPost: "これが最初の記事です",
+	lastPost: "これが最新の記事です",
+	relatedPosts: "関連記事",
+	randomPosts: "ランダム記事",
+	smartRecommend: "スマート",
+	randomRecommend: "ランダム",
+	noRelatedPosts: "関連記事はありません",
+	noRandomPosts: "ランダム記事はありません",
+	licensePrefix: "この記事は",
+	licenseSuffix:
+		"ライセンスで提供しています。転載の際は出典と作者を明記してください。",
+	toc: "目次",
+	tocTitle: "目 次",
+	pagination: "ページネーション",
+	prevPage: "前のページ",
+	nextPage: "次のページ",
+	pageOf: "{total} ページ中 {current} ページ目",
+	closeAnnouncement: "お知らせを閉じる",
+	closeAd: "広告を閉じる",
+	categories: "カテゴリー",
+	tags: "タグ",
+	friendLinks: "リンク",
+	siteInfo: "サイト情報",
+	posts: "記事",
+	running: "稼働期間",
+	daysCount: "{n} 日",
+	dayPostsCount: "{n} 件",
+	heatWeekTip: "{m} 第 {w} 週 · {n}",
+	tagsMore: "…もっと見る",
+	calendarHome: "今月へ戻る",
+	calendarPick: "年月を選択",
+	layoutSwitch: "リスト / グリッド表示切り替え",
+	layoutList: "リスト表示",
+	layoutGrid: "グリッド表示",
+	emptyPosts: "まだ記事がありません。content/posts で書きましょう。",
+	pageN: "{n} ページ目",
+	archive: "アーカイブ",
+	home: "ホーム",
+	categoryNav: "カテゴリーナビゲーション",
+	more: "もっと見る",
+	totalPosts: "全 {n} 件の記事",
+	postsInYear: "{n} 件",
+	yearUnit: "{n} 年",
+	totalTags: "全 {n} 個のタグ",
+	tagTitle: "タグ：{tag}",
+	totalCategories: "全 {n} 個のカテゴリー",
+	categoryTitle: "カテゴリー：{category}",
+	publishedOn: "{date} 公開",
+	updatedOn: "{date} 更新",
+	pageviews: "閲覧数",
+	notFound: "ページが見つかりません",
+	notFoundDesc: "ページが存在しないか、移動されました。",
+	backHome: "ホームへ戻る",
+	about: "私について",
+	aboutEmpty: "src/content/spec/about.md にこのページの内容を書いてください",
+	avatarAlt: "{name} のアバター",
+	noFriends: "リンクはまだありません",
+	applyFriend: "リンク申請",
+	/* 番組視聴ページ */
+	bangumiEmpty: "視聴中の番組はまだありません",
+	bangumiFail:
+		"番組データの取得に失敗しました。サイトを再ビルドして再試行してください",
+	epProgress: "第 {n} / {total} 話まで視聴",
+	epProgressOpen: "第 {n} 話まで視聴",
+	myRate: "私の評価 {n}",
+	guestbook: "ゲストブック",
+	guestbookSub: "あなたの足跡を残してください",
+	commentComingSoon: "コメント欄は近日公開予定です。お楽しみに。",
+	qrAlt: "{name} の QR コード",
+	goSponsor: "寄付する",
+	qrPlaceholder: "QR コードのプレースホルダー",
+	sponsorList: "支援者一覧",
+	noSponsors: "まだ支援がありません。最初の支援者になりましょう",
+	search: "検索",
+	searchShortcut: "/ または Ctrl+K で検索",
+	searchLoading: "検索中…",
+	searchNoResults: "関連する結果が見つかりません",
+	searchUnavailable: "検索インデックスはビルド後に利用可能です",
+	searchTypeSomething: "キーワードを入力して検索",
+	searchMore: "すべての結果（{n} 件）を見る",
+	searchResultsTotal: "{n} 件の結果",
+	galleryPhotos: "写真 {n} 枚",
+	backToAlbums: "アルバムに戻る",
+	searchAlbums: "アルバムを検索…",
+	allTags: "すべて",
+	galleryNoAlbums:
+		"アルバムがまだありません。テーマ設定の gallery.albums に追加してください。",
+	galleryNoPhotos: "このアルバムには写真がありません",
+	/* つぶやきページ */
+	momentsTitle: "つぶやき",
+	momentsEmpty: "つぶやきはまだありません。",
+	encryptedAlbum: "暗号化アルバム",
+	searchAlbumNoResults: "一致するアルバムがありません",
+	postEncrypted: "暗号化済み",
+	passwordProtected: "パスワード保護",
+	passwordProtectedDesc:
+		"この内容はパスワードで保護されています。閲覧するにはパスワードを入力してください。",
+	passwordHint: "ヒント",
+	passwordPlaceholder: "パスワードを入力",
+	passwordSubmit: "ロック解除",
+	passwordError: "パスワードが正しくありません。もう一度お試しください。",
+	close: "閉じる",
+	prevImage: "前の画像",
+	nextImage: "次の画像",
+	copied: "コピーしました",
+	fullscreen: "全画面",
+	slideshow: "自動再生",
+	thumbs: "サムネイル",
+	/* シェアポスター */
+	sharePoster: "シェアポスターを作成",
+	generatingPoster: "ポスターを生成中…",
+	copyLink: "リンクをコピー",
+	savePoster: "ポスターを保存",
+	scanToRead: "QR コードを読み取って全文を読む",
+	author: "作者",
+	supportTitle: "サポート",
+	supportDesc: "この記事が役に立ったら、寄付やシェアをいただけると嬉しいです。",
+	sponsorMe: "支援する",
+	lastModifiedPrefix: "最終更新日 ",
+	lastModifiedDaysAgo: "、{days} 日経過",
+	lastModifiedOutdated: "一部の内容は古くなっている可能性があります。",
+	/* シリーズ */
+	series: "シリーズ",
+	seriesTotal: "全 {n} 個のシリーズ",
+	seriesPostsCount: "{n} 件",
+	seriesUpdated: "{date} 更新",
+	seriesEmpty:
+		"シリーズがまだありません。記事の frontmatter に series を記入すると作成できます。",
+	seriesProgress: "{cur} / {total}",
+	seriesCatalog: "シリーズ目次",
+	/* 音楽プレイヤー */
+	musicOpen: "音楽プレイヤー",
+	musicClose: "プレイヤーを閉じる",
+	musicPlay: "再生",
+	musicPause: "一時停止",
+	musicPrev: "前の曲",
+	musicNext: "次の曲",
+	musicModeList: "リスト再生",
+	musicModeOne: "1 曲リピート",
+	musicModeRandom: "シャッフル再生",
+	musicLyrics: "歌詞",
+	musicPlaylist: "プレイリスト",
+	musicNoLyrics: "歌詞なし",
+	musicEmpty: "プレイリストは空です",
+	musicSeek: "再生位置",
+	musicVolume: "音量",
+	l2dHome: "ホームへ戻る",
+	l2dScrollTop: "トップへ戻る",
+	l2dSleep: "ひと休み",
+	l2dSwitchModel: "モデルを変える",
+	/* コード折りたたみ */
+	codeFoldExpand: "コードを展開",
+	codeFoldCollapse: "コードを折りたたむ",
+	codeFoldExpanded: "コードブロックを展開しました",
+	codeFoldCollapsed: "コードブロックを折りたたみました",
+	/* 壁紙 */
+	wpPlay: "壁紙動画を再生",
+	wpPause: "壁紙動画を一時停止",
+	wpPrev: "前の動画",
+	wpNext: "次の動画",
+	wpMode: "壁紙モードを切り替え",
+	/* 表示設定パネル（§4.103）：歯車エントリ + 3タブ + 各グループコントロール */
+	displaySettings: "表示設定",
+	tabAppearance: "外観",
+	tabWallpaper: "壁紙",
+	tabEffects: "エフェクト",
+	wallpaperMode: "壁紙モード",
+	modeBanner: "バナー壁紙",
+	modeFullscreen: "全画面壁紙",
+	modeOverlay: "オーバーレイ透明",
+	modeNone: "単色背景",
+	fullscreenLayout: "全画面レイアウト",
+	layoutClassic: "クラシック",
+	layoutHero: "Hero",
+	wallpaperSettings: "壁紙設定",
+	homeWallpaperTitle: "ホーム壁紙タイトル",
+	wallpaperCarousel: "壁紙カルーセル",
+	wavesAnimation: "波紋アニメーション",
+	gradientTransition: "グラデーション遷移",
+	overlaySettings: "透明設定",
+	wallpaperOpacity: "壁紙の不透明度",
+	backgroundBlur: "背景ぼかし",
+	cardOpacity: "カードの不透明度",
+	sakuraEffect: "桜エフェクト",
+	/* サイト情報の総文字数 */
+	totalWords: "総文字数",
+	/* サイドバー音楽ウィジェット */
+	musicWidget: "音楽",
+};
+
+export default ja;

package/src/i18n/ko.ts

@@ -0,0 +1,212 @@
+/**
+ * 한국어 언어 팩：Record<UiKey, string> 强制与中文键源一一对应，缺译会在编译期报错。
+ */
+import type { UiKey } from "./zh-CN.js";
+
+const ko: Record<UiKey, string> = {
+	skipToContent: "본문으로 건어뛰기",
+	scrollDown: "아래로 스크롤",
+	backToTop: "맨 위로",
+	mainNav: "메인 내비게이션",
+	toggleMode: "다크 모드 전환",
+	menu: "메뉴",
+	palette: "테마 색상",
+	paletteTitle: "강조 색상",
+	reset: "초기화",
+	hueValue: "색조 {n}",
+	pinned: "고정",
+	wordsCount: "{n} 자",
+	minutesCount: "약 {n}분",
+	prevNext: "이전 / 다음 글",
+	prevPost: "이전 글",
+	nextPost: "다음 글",
+	firstPost: "가장 오래된 글입니다",
+	lastPost: "가장 최신 글입니다",
+	relatedPosts: "관련 글",
+	randomPosts: "랜덤 글",
+	smartRecommend: "스마트",
+	randomRecommend: "랜덤",
+	noRelatedPosts: "관련 글이 없습니다",
+	noRandomPosts: "랜덤 글이 없습니다",
+	licensePrefix: "이 글은 ",
+	licenseSuffix: " 라이선스를 따르며, 전재 시 출처와 저자를 밝혀 주세요.",
+	toc: "목차",
+	tocTitle: "목 차",
+	pagination: "페이지네이션",
+	prevPage: "이전 페이지",
+	nextPage: "다음 페이지",
+	pageOf: "{total} 페이지 중 {current} 페이지",
+	closeAnnouncement: "공지 닫기",
+	closeAd: "광고 닫기",
+	categories: "카테고리",
+	tags: "태그",
+	friendLinks: "친구 링크",
+	siteInfo: "사이트 정보",
+	posts: "글",
+	running: "운영 기간",
+	daysCount: "{n}일",
+	dayPostsCount: "{n}편",
+	heatWeekTip: "{m} {w}주차 · {n}",
+	tagsMore: "…더 보기",
+	calendarHome: "이번 달로",
+	calendarPick: "연도 및 월 선택",
+	layoutSwitch: "목록 / 그리드 보기 전환",
+	layoutList: "목록 보기",
+	layoutGrid: "그리드 보기",
+	emptyPosts: "아직 글이 없습니다. content/posts에서 작성해 보세요.",
+	pageN: "{n} 페이지",
+	archive: "아카이브",
+	home: "홈",
+	categoryNav: "카테고리 내비게이션",
+	more: "더 보기",
+	totalPosts: "총 {n}편의 글",
+	postsInYear: "{n}편",
+	yearUnit: "{n}년",
+	totalTags: "총 {n}개의 태그",
+	tagTitle: "태그: {tag}",
+	totalCategories: "총 {n}개의 카테고리",
+	categoryTitle: "카테고리: {category}",
+	publishedOn: "{date} 게시",
+	updatedOn: "{date} 수정",
+	pageviews: "조회수",
+	notFound: "페이지를 찾을 수 없습니다",
+	notFoundDesc: "페이지가 존재하지 않거나 이동되었습니다.",
+	backHome: "홈으로 돌아가기",
+	about: "소개",
+	aboutEmpty: "src/content/spec/about.md에서 이 페이지를 작성하세요",
+	avatarAlt: "{name}의 아바타",
+	noFriends: "아직 링크가 없습니다",
+	applyFriend: "링크 신청",
+	/* 애니 시청 페이지 */
+	bangumiEmpty: "시청 중인 애니메이션이 없습니다",
+	bangumiFail:
+		"데이터를 가져오지 못했습니다. 사이트를 다시 빌드한 후 재시도하세요",
+	epProgress: "{n} / {total}화 시청",
+	epProgressOpen: "{n}화 시청",
+	myRate: "내 평점 {n}",
+	guestbook: "방명록",
+	guestbookSub: "흔적을 남겨 주세요",
+	commentComingSoon: "댓글 창이 곧 열릴 예정입니다. 기대해 주세요.",
+	qrAlt: "{name}의 QR 코드",
+	goSponsor: "후원하기",
+	qrPlaceholder: "QR 코드 자리 표시",
+	sponsorList: "후원자 명단",
+	noSponsors: "아직 후원이 없습니다. 첫 번째 후원자가 되어 보세요",
+	search: "검색",
+	searchShortcut: "/ 또는 Ctrl+K로 빠른 검색",
+	searchLoading: "검색 중…",
+	searchNoResults: "관련 결과를 찾을 수 없습니다",
+	searchUnavailable: "검색 인덱스는 빌드 후 사용할 수 있습니다",
+	searchTypeSomething: "키워드를 입력해 검색하세요",
+	searchMore: "전체 {n}개 결과 보기",
+	searchResultsTotal: "{n}개 결과",
+	galleryPhotos: "사진 {n}장",
+	backToAlbums: "앨범으로 돌아가기",
+	searchAlbums: "앨범 검색…",
+	allTags: "전체",
+	galleryNoAlbums:
+		"아직 앨범이 없습니다. 테마 설정의 gallery.albums에 추가하세요.",
+	galleryNoPhotos: "이 앨범에는 사진이 없습니다",
+	/* 짧은 글 페이지 */
+	momentsTitle: "일상",
+	momentsEmpty: "아직 글이 없습니다.",
+	encryptedAlbum: "암호화된 앨범",
+	searchAlbumNoResults: "일치하는 앨범이 없습니다",
+	postEncrypted: "암호화됨",
+	passwordProtected: "비밀번호 보호",
+	passwordProtectedDesc:
+		"이 내용은 비밀번호로 보호되어 있습니다. 보려면 비밀번호를 입력하세요.",
+	passwordHint: "힌트",
+	passwordPlaceholder: "비밀번호를 입력하세요",
+	passwordSubmit: "잠금 해제",
+	passwordError: "비밀번호가 잘못되었습니다. 다시 시도하세요.",
+	close: "닫기",
+	prevImage: "이전 이미지",
+	nextImage: "다음 이미지",
+	copied: "복사됨",
+	fullscreen: "전체 화면",
+	slideshow: "자동 재생",
+	thumbs: "썸네일",
+	/* 공유 포스터 */
+	sharePoster: "공유 포스터 만들기",
+	generatingPoster: "포스터 생성 중…",
+	copyLink: "링크 복사",
+	savePoster: "포스터 저장",
+	scanToRead: "QR 코드를 스캔하여 전문 보기",
+	author: "저자",
+	supportTitle: "응원하기",
+	supportDesc: "이 글이 도움이 되었다면 후원이나 공유를 부탁드립니다.",
+	sponsorMe: "후원하기",
+	lastModifiedPrefix: "마지막 업데이트: ",
+	lastModifiedDaysAgo: ", {days}일 경과",
+	lastModifiedOutdated: "일부 내용이 오래되었을 수 있으니 유의하세요.",
+	/* 시리즈 */
+	series: "시리즈",
+	seriesTotal: "총 {n}개의 시리즈",
+	seriesPostsCount: "{n}편",
+	seriesUpdated: "{date} 업데이트",
+	seriesEmpty:
+		"아직 시리즈가 없습니다. 글 frontmatter에 series를 입력하면 생성됩니다.",
+	seriesProgress: "{cur} / {total}",
+	seriesCatalog: "시리즈 목차",
+	/* 음악 플레이어 */
+	musicOpen: "음악 플레이어",
+	musicClose: "플레이어 접기",
+	musicPlay: "재생",
+	musicPause: "일시정지",
+	musicPrev: "이전 곡",
+	musicNext: "다음 곡",
+	musicModeList: "목록 반복",
+	musicModeOne: "한 곡 반복",
+	musicModeRandom: "랜덤 재생",
+	musicLyrics: "가사",
+	musicPlaylist: "재생 목록",
+	musicNoLyrics: "가사 없음",
+	musicEmpty: "재생 목록이 비어 있습니다",
+	musicSeek: "재생 진행률",
+	musicVolume: "음량",
+	l2dHome: "홈으로",
+	l2dScrollTop: "맨 위로",
+	l2dSleep: "잠시 쉬기",
+	l2dSwitchModel: "모델 바꾸기",
+	/* 코드 접기 */
+	codeFoldExpand: "코드 펼치기",
+	codeFoldCollapse: "코드 접기",
+	codeFoldExpanded: "코드 블록이 펼쳐졌습니다",
+	codeFoldCollapsed: "코드 블록이 접혔습니다",
+	/* 배경화면 */
+	wpPlay: "배경화면 동영상 재생",
+	wpPause: "배경화면 동영상 일시정지",
+	wpPrev: "이전 동영상",
+	wpNext: "다음 동영상",
+	wpMode: "배경화면 모드 전환",
+	/* 디스플레이 설정 패널（§4.103）：기어 진입 + 세 탭 + 그룹 컨트롤 */
+	displaySettings: "디스플레이 설정",
+	tabAppearance: "외관",
+	tabWallpaper: "배경화면",
+	tabEffects: "효과",
+	wallpaperMode: "배경화면 모드",
+	modeBanner: "배너 배경화면",
+	modeFullscreen: "전체 화면 배경화면",
+	modeOverlay: "오버레이 투명",
+	modeNone: "단색 배경",
+	fullscreenLayout: "전체 화면 레이아웃",
+	layoutClassic: "클래식 모드",
+	layoutHero: "Hero 모드",
+	wallpaperSettings: "배경화면 설정",
+	homeWallpaperTitle: "홈 배경화면 제목",
+	wallpaperCarousel: "배경화면 캐러셀",
+	wavesAnimation: "물결 애니메이션",
+	gradientTransition: "그라데이션 전환",
+	overlaySettings: "투명도 설정",
+	wallpaperOpacity: "배경화면 불투명도",
+	backgroundBlur: "배경 블러",
+	cardOpacity: "카드 불투명도",
+	sakuraEffect: "벚꽃 효과",
+	/* 사이트 정보 총 글자 수 */
+	totalWords: "총 글자 수",
+	/* 사이드바 음악 위젯 */
+	musicWidget: "음악",
+};
+
+export default ko;

package/src/i18n/resolve.ts

@@ -8,15 +8,24 @@
  */
 
 import en from "./en.js";
+import ja from "./ja.js";
+import ko from "./ko.js";
+import ru from "./ru.js";
 import zhCN, { type UiKey } from "./zh-CN.js";
+import zhTW from "./zh-TW.js";
 
 type Pack = Partial<Record<UiKey, string>>;
 
-/** 已内置语言包（键为归一化 lang：小写、下划线转连字符） */
+/** 已内置语言包（键为归一化 lang：小写、下划线转连字符；ja-jp/ko-kr 等经基础语言回退命中） */
 const packs: Record<string, Pack> = {
 	en: en,
 	"en-us": en,
 	"en-gb": en,
+	"zh-tw": zhTW,
+	"zh-hant": zhTW,
+	ja: ja,
+	ko: ko,
+	ru: ru,
 };
 
 function norm(lang: string): string {