@riebeckite/plugin-l10n 0.0.31 → 0.0.33

package/README.md

@@ -6,6 +6,10 @@ Content localization for Riebeckite Markdown. It detects a locale and a separate
 
 [日本語](./README_ja.md)
 
+## Live example
+
+The language switcher under the breadcrumbs links this page to its Japanese translation. Both URLs belong to the same translation group.
+
 ## Basic setup
 
 ```ts

package/README_ja.md

@@ -6,6 +6,10 @@ Riebeckite の Markdown コンテンツをローカライズするプラグイ
 
 [English](./README.md)
 
+## 実行例
+
+パンくずリストの下にある言語切り替えから、このページの日本語版へ移動できます。どちらの URL も同じ翻訳グループに属しています。
+
 ## 基本設定
 
 ```ts
@@ -16,7 +20,7 @@ l10n({ defaultLang: "ja", languages: ["ja", "en", "zh-CN"] });
 
 ## ロケール検出と翻訳グループ
 
-ファイル名はこのリポジトリの慣例に合わせ、ドットの `README.ja.md` 形式を推奨します。`README-ja.md`、`README_ja.md`、`README.en-US.md`、`README.zh-CN.md` も利用できます。ディレクトリ名による検出は行いません。
+ファイル名はこのリポジトリの慣例に合わせ、`README.ja.md` のようにドットで言語を区切る形式を推奨します。`README-ja.md`、`README_ja.md`、`README.en-US.md`、`README.zh-CN.md` も利用できます。ディレクトリ名による検出は行いません。
 
 frontmatter も利用できます。
 
@@ -27,9 +31,9 @@ translation: getting-started
 ---
 ```
 
-組み合わせた場合の組み込み規則の優先順位は **frontmatter > 独自検出 > ファイル名 > 既定言語** です。矛盾は `L10N_LANGUAGE_CONFLICT`、同一の翻訳 ID と言語の重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
+併用した場合、組み込みの判定は **frontmatter > 独自検出 > ファイル名 > 既定言語** の優先順位で行われます。言語の矛盾は `L10N_LANGUAGE_CONFLICT`、同じ翻訳 ID と言語の組み合わせの重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
 
-`translation` はロケール検出とは別です。異なるパス・ファイル名でも明示的な ID でグループ化できます。
+`translation` はロケール検出とは独立しています。異なるパス・ファイル名でも明示的な ID でグループ化できます。
 
 ```text
 日本語/はじめに.md        lang: ja, translation: getting-started
@@ -48,22 +52,22 @@ l10n({
 
 この場合、`translation: getting-started` の代わりに `translationId: getting-started` を使用します。既定値は `translation` です。
 
-翻訳がない言語のページを複製・生成することはありません。`getLocalization(manifest, slug)` は存在する翻訳だけを `availableLanguages` と言語ごとの `translations` に含め、`getLocalizedContent(manifest, slug, lang)` は見つからなければ `null` を返します。
+翻訳がない言語向けにページを複製したり生成したりすることはありません。`getLocalization(manifest, slug)` は存在する翻訳だけを `availableLanguages` と言語ごとの `translations` に含め、`getLocalizedContent(manifest, slug, lang)` は見つからなければ `null` を返します。
 
 ## URL・テーマ・SEO
 
-既定言語は既存の URL（`/about`）、その他は言語プレフィックス付き（`/en/about`）です。既存の Content Location を拡張するため、別の URL 解決プラグインとも併用できます。翻訳ごとに URL を変える場合は、異なるソースパスまたは permalink プラグインを使います。
+既定言語は既存の URL（`/about`）、その他は言語プレフィックス付き（`/en/about`）です。既存のコンテンツロケーション解決を拡張する作りなので、他の URL 解決プラグインとも併用できます。翻訳ごとに URL を変える場合は、異なるソースパスまたは permalink プラグインを使います。
 
-テーマは `getLocalization(manifest, slug)` から現在の言語、存在する言語、各翻訳の href を取得できます。`getLocalizedContent()` は翻訳がなければ `null` を返します。
+`getLocalization(manifest, slug)` を使うと、現在の言語、存在する言語、各翻訳の href を取得できます。`getLocalizedContent()` は翻訳がなければ `null` を返します。
 
-`l10n(...)` は標準記事レイアウトへ組み込みの言語切替 UI を登録します。標準 Site consumer がこの UI を描画するため、l10n 専用の記事レイアウト実装は不要です。実在する翻訳が 2 つ未満のページには表示されません。
+`l10n(...)` は、標準の記事レイアウトに組み込みの言語切替 UI を追加します。標準の Site consumer がこれを描画するため、l10n 専用の記事レイアウトを実装する必要はありません。実在する翻訳が 2 つ未満のページには表示されません。
 
-## CSS Hook
+## CSS フック
 
 言語切替 UI には `rr-l10n-switcher`、`rr-l10n-switcher__label`、
-`rr-l10n-switcher__list`、`rr-l10n-switcher__link` を使用します。default CSS はこれらの Hook を対象にします。
+`rr-l10n-switcher__list`、`rr-l10n-switcher__link` を使用します。既定の CSS はこれらのフックを対象にします。
 
-各ページには Core の `headTags` 拡張を通じ、実在する翻訳だけを対象に `hreflang` の alternate link を追加します。サイトシェルはこれらのタグの描画と、リクエストに応じた `<html lang>` の選択を担当します。WikiLink の Content Graph は同言語の翻訳を優先し、なければ元のリンク先を使います。本文では Obsidian WikiLink を `@riebeckite/plugin-obsidian-markdown` が解決した後、WikiLink と Markdown の内部リンクを同じ規則で処理します。現在のページと同じ言語の翻訳があればその URL に切り替え、なければ original/default のリンク先を維持します。クエリ文字列とフラグメントは維持し、外部 URL、フラグメントのみのリンク、不明な URL、asset などコンテンツ以外の URL は変更しません。リンク依存関係の追跡でも描画と同じ解析済み Markdown URL を使用するため、HTML 文字参照も同じように扱います。Content Graph と本文リンクは同じ解決ポリシーを使います。
+各ページには、Core の `headTags` 拡張を通じて、実在する翻訳だけを対象にした `hreflang` の alternate link が追加されます。サイトシェルはこれらのタグの描画と、リクエストに応じた `<html lang>` の選択を担当します。WikiLink の Content Graph は同じ言語の翻訳を優先し、なければ元のリンク先を使います。本文では、`@riebeckite/plugin-obsidian-markdown` が Obsidian WikiLink を解決した後に、WikiLink と Markdown の内部リンクを同じ規則で書き換えます。現在のページと同じ言語の翻訳があればその URL に切り替え、なければ元のリンク先を維持します。クエリ文字列とフラグメントは維持し、外部 URL、フラグメントのみのリンク、不明な URL、アセットなどコンテンツ以外の URL は変更しません。リンク依存関係の追跡でも描画と同じ解析済み Markdown URL を使用するため、HTML 文字参照も同じように扱います。Content Graph と本文リンクは同じ解決ポリシーを使います。
 
 ## 独自検出
 
@@ -76,7 +80,7 @@ l10n({
 });
 ```
 
-独自検出の言語は frontmatter より弱く、ファイル名より強く扱われます。`translationId` は明示的な翻訳グループ ID です。
+独自検出の言語は、frontmatter より優先度が低く、ファイル名より優先度が高くなります。`translationId` は明示的な翻訳グループ ID です。
 
 ## 関連リンク
 

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export type { LanguageSwitcherProps } from "./components/language-switcher.js";
 export { default as LanguageSwitcher } from "./components/language-switcher.js";
-export { getLanguageFromPath, getLocalization, getLocalizedContent, type L10nContent, type L10nDetectorContext, type L10nDetectorResult, type L10nOptions, type LocalizedContent, l10n, l10nPlugin, } from "./src/l10n.js";
+export { getLanguageFromPath, getLocalization, getLocalizedContent, type L10nContent, type L10nDetectorContext, type L10nDetectorResult, type L10nOptions, type LocalizedContent, l10n, } from "./src/l10n.js";

package/dist/index.js

@@ -78,7 +78,6 @@ function l10n(options) {
     addDiagnostics: () => state.diagnostics
   });
 }
-var l10nPlugin = l10n;
 function remarkLocalizedLinks(options) {
   return (tree) => {
     const source = options.sourceSlug ? options.state.contents.get(options.sourceSlug) : void 0;
@@ -630,6 +629,5 @@ export {
   getLanguageFromPath,
   getLocalization,
   getLocalizedContent,
-  l10n,
-  l10nPlugin
+  l10n
 };

package/dist/src/l10n.d.ts

@@ -28,7 +28,6 @@ export type LocalizedContent = {
     readonly translations: Readonly<Record<string, string>>;
 };
 export declare function l10n(options: L10nOptions): import("@riebeckite/core").RiebeckitePlugin<L10nOptions>;
-export declare const l10nPlugin: typeof l10n;
 /** Returns one entry's language and available real translations. */
 export declare function getLocalization(view: ContentManifest | PublicContentView, slug: string): LocalizedContent | null;
 /** Resolves an existing translation; missing translations return `null`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-l10n",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,14 +21,15 @@
     "./style.css": "./style.css"
   },
   "dependencies": {
+    "@riebeckite/core": "0.0.33",
+    "@riebeckite/ui": "0.0.33",
     "hono": "^4.12.25",
-    "yaml": "^2.9.0",
-    "@riebeckite/ui": "0.0.31",
-    "@riebeckite/core": "0.0.31"
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "tsx": "^4.22.4",
-    "@riebeckite/plugin-obsidian-markdown": "0.0.31"
+    "@riebeckite/plugin-obsidian-markdown": "0.0.33",
+    "@riebeckite/node": "0.0.33",
+    "tsx": "^4.22.4"
   },
   "publishConfig": {
     "access": "public"