feat: 翻訳状態にオリジナルコンテンツを追加

Author: 3w36zj6

website/src/components/ui/common/TranslationStatusAlert.tsx

@@ -43,6 +43,16 @@ const getStatusConfig = (status: TranslationStatus): StatusConfig => {
 				message:
 					"このページはまだ翻訳されていません。原文の内容が表示されています。",
 			};
+		case "original":
+			return {
+				bgColor: "bg-cyan-50",
+				borderColor: "border-cyan-200",
+				textColor: "text-cyan-800",
+				iconColor: "text-cyan-600",
+				label: "日本語版オリジナル",
+				message:
+					"このページの内容は公式ドキュメントには含まれておらず、日本語コミュニティが独自に追加したものです。",
+			};
 	}
 };
 

website/src/utils/translationStatus.test.ts

@@ -151,6 +151,46 @@ describe("translationStatus", () => {
 			expect(result).toBe(0.625);
 		});
 
+		it("originalページは計算から除外される", async () => {
+			const { calculateTranslationProgressRate } = await import(
+				"./translationStatus"
+			);
+
+			const status = {
+				$schema: "./translation-status.schema.json",
+				"/docs/page1/": "translated", // 1.0
+				"/docs/page2/": "partially_translated", // 0.5
+				"/docs/original1/": "original", // 除外
+				"/docs/original2/": "original", // 除外
+				"/docs/page3/": "untranslated", // 0.0
+			};
+
+			mockFs.readFileSync.mockReturnValue(JSON.stringify(status));
+
+			const result = calculateTranslationProgressRate();
+
+			// (1.0 + 0.5 + 0.0) / 3 = 0.5
+			expect(result).toBe(0.5);
+		});
+
+		it("全てoriginalページの場合は0を返す", async () => {
+			const { calculateTranslationProgressRate } = await import(
+				"./translationStatus"
+			);
+
+			const status = {
+				$schema: "./translation-status.schema.json",
+				"/docs/original1/": "original",
+				"/docs/original2/": "original",
+			};
+
+			mockFs.readFileSync.mockReturnValue(JSON.stringify(status));
+
+			const result = calculateTranslationProgressRate();
+
+			expect(result).toBe(0);
+		});
+
 		it("ページが存在しない場合は0を返す", async () => {
 			const { calculateTranslationProgressRate } = await import(
 				"./translationStatus"

website/src/utils/translationStatus.ts

@@ -4,7 +4,8 @@ import path from "node:path";
 export type TranslationStatus =
 	| "translated"
 	| "partially_translated"
-	| "untranslated";
+	| "untranslated"
+	| "original";
 
 export type TranslationStatusMap = {
 	[route: string]: TranslationStatus;
@@ -67,19 +68,23 @@ export const registerRoutes = (routes: string[]): void => {
 /**
  * 翻訳の進捗率を計算する。
  * `translated`は1.0、`partially_translated`は0.5の重みを持つ。
+ * `original`は翻訳対象外のため計算から除外される。
  * @returns [0.0, 1.0]の範囲で表される翻訳率
  */
 export const calculateTranslationProgressRate = (): number => {
 	const status = loadTranslationStatus();
 	const routes = Object.keys(status).filter((key) => key !== "$schema");
+	const translationTargetRoutes = routes.filter(
+		(route) => status[route] !== "original",
+	);
 
-	if (routes.length === 0) {
+	if (translationTargetRoutes.length === 0) {
 		return 0;
 	}
 
 	let translationScore = 0;
 
-	for (const route of routes) {
+	for (const route of translationTargetRoutes) {
 		const currentStatus = status[route];
 		if (currentStatus === "translated") {
 			translationScore += 1;
@@ -88,7 +93,7 @@ export const calculateTranslationProgressRate = (): number => {
 		}
 	}
 
-	return translationScore / routes.length;
+	return translationScore / translationTargetRoutes.length;
 };
 
 let translationStatusCache: TranslationStatusMap | null = null;

website/translation-status.json

@@ -187,9 +187,9 @@
 	"/docs/changelog/0.2.0/": "untranslated",
 	"/docs/changelog/0.1.0/": "untranslated",
 	"/docs/changelog/earlier/": "untranslated",
-	"/docs/japanese/": "translated",
-	"/docs/japanese/templates/": "translated",
-	"/docs/japanese/packages/": "translated",
-	"/docs/japanese/articles/": "translated",
-	"/docs/glossary/": "translated"
+	"/docs/japanese/": "original",
+	"/docs/japanese/templates/": "original",
+	"/docs/japanese/packages/": "original",
+	"/docs/japanese/articles/": "original",
+	"/docs/glossary/": "original"
 }

website/translation-status.schema.json

@@ -11,7 +11,7 @@
 	},
 	"additionalProperties": {
 		"type": "string",
-		"enum": ["translated", "partially_translated", "untranslated"],
+		"enum": ["translated", "partially_translated", "untranslated", "original"],
 		"description": "ページの翻訳状態"
 	}
 }