SEO & Canonical ポリシー

このページでは、AIMO Standardが検索エンジン、監査人、外部参照に対してどのようにURL正規化を管理しているかを説明します。

本番サイト vs ミラーサイト

環境	URL	役割	インデックス可
本番（Production）	`https://standard.aimoaas.com/`	正規サイト（すべての目的で使用）	はい
GitHub Pages	`https://billyrise.github.io/aimo-standard/`	一時的なミラー / CIプレビュー	いいえ (noindex)

基本原則: 本番サイト（standard.aimoaas.com）が正規URLです。GitHub Pagesは一時的なバックアップ/ミラーとして機能し、監査レポートや外部参照で引用すべきではありません。

Canonical URL 戦略

Canonical URL の生成方法

AIMO StandardはMkDocs Materialを使用し、以下の設定で運用しています：

# mkdocs.yml
site_url: https://standard.aimoaas.com/

このsite_url設定により：

<link rel="canonical"> — 生成される各HTMLページに本番URLを指すcanonicalリンクが含まれます。
sitemap.xml — サイトマップ内のすべてのURLが本番を参照します。
robots.txt — サイトマップ参照が本番を指します。
hreflang alternates — 言語代替が本番URLを使用します。

言語別の Canonical URL

言語	URLパターン	例
英語（デフォルト）	`https://standard.aimoaas.com/{path}`	`https://standard.aimoaas.com/governance/`
日本語	`https://standard.aimoaas.com/ja/{path}`	`https://standard.aimoaas.com/ja/governance/`

各言語バージョンは自己参照のcanonicalを持ち、他の言語へのhreflang代替と、英語版を指すx-defaultを含みます。

バージョン管理とCanonical

AIMO Standardはドキュメントのバージョン管理にmikeを alias_type: redirect で使用しています：

バージョン	URLパターン	Canonical状態	インデックス可
バージョン指定（例：`0.0.1`）	`https://standard.aimoaas.com/0.0.1/`	特定バージョンの正規	はい
`latest`（エイリアス）	`https://standard.aimoaas.com/latest/`	現行リリースへリダイレクト	はい（ターゲット経由）
`dev`	`https://standard.aimoaas.com/dev/`	プレビューのみ	いいえ（noindex強制）

重要な区別：

側面	`/X.Y.Z/`	`/latest/`	`/dev/`
内容	固定スナップショット	`/X.Y.Z/`へリダイレクト	mainブランチプレビュー
可変性	不変	リリース時にポインタ更新	継続的
監査用	はい（推奨）	はい（固定に解決）	絶対不可
SEO	インデックス対象	ターゲット経由で対象	noindex

alias_type: redirect の動作：

ファイルをコピーする代わりに、/latest/ にはリダイレクトページが含まれます：

<!-- /latest/index.html -->
<meta http-equiv="refresh" content="0; url=../0.0.1/">
<link rel="canonical" href="https://standard.aimoaas.com/0.0.1/">

これにより：

コンテンツのドリフトなし — /latest/ は指すリリースと乖離できません。
重複コンテンツなし — 検索エンジンは1つの正規ソースを認識。
アトミックな更新 — エイリアスの変更で全ページを一度に更新。

!!! info "Git タグ vs. サイトパス" Git リリースタグは v プレフィックスを使用します（例：v0.0.1）が、サイトパスでは v を省略します（例：/0.0.1/）。これは mike などのドキュメントバージョン管理ツールの標準的な方法です。

監査人ガイダンス：引用すべきURL

監査レポート、コンプライアンス文書、または外部参照でAIMO Standardを引用する際：

推奨される引用URL

ユースケース	推奨URL
現行安定版仕様	`https://standard.aimoaas.com/latest/standard/current/`
特定バージョン（監査用）	`https://standard.aimoaas.com/{X.Y.Z}/standard/current/`
ガバナンス & ポリシー	`https://standard.aimoaas.com/latest/governance/`
Trust Package	`https://standard.aimoaas.com/latest/governance/trust-package/`

引用すべきでないURL

~~https://billyrise.github.io/aimo-standard/~~ — 一時的なミラー、正規ではない
~~https://standard.aimoaas.com/dev/~~ — 開発版、変更される可能性あり

不変性のためのバージョン指定引用

不変の参照が必要な正式監査では、バージョン指定スナップショットURLを使用してください：

https://standard.aimoaas.com/1.0.0/standard/current/01-overview/

バージョン指定スナップショットはリリース時点で凍結され、変更されません。

!!! note "URLフォーマット" サイトパスでは v プレフィックスを省略します。バージョン v1.0.0 の場合、URLでは /1.0.0/ を使用します。

技術的実装

生成されるHTMLの例

生成される各HTMLページの<head>には、canonicalとhreflangタグが含まれます：

<!-- Canonical（常に本番を指す） -->
<link rel="canonical" href="https://standard.aimoaas.com/latest/governance/">

<!-- 言語代替 -->
<link rel="alternate" hreflang="en" href="https://standard.aimoaas.com/latest/governance/">
<link rel="alternate" hreflang="ja" href="https://standard.aimoaas.com/latest/ja/governance/">
<link rel="alternate" hreflang="x-default" href="https://standard.aimoaas.com/latest/governance/">

robots.txt

User-agent: *
Allow: /

Sitemap: https://standard.aimoaas.com/sitemap.xml

サイトマップ

サイトマップはmkdocs-static-i18nプラグインによって生成され、以下を含みます：

すべての本番URL
各言語のhreflang代替

noindex 設定

`/dev/`（プレビュー）— 必須 noindex

/dev/ バージョンには未リリースのコンテンツが含まれており、以下を防ぐために noindex が必須です：

検索エンジンが不安定なコンテンツをインデックスすること
ユーザーが検索経由で /dev/ を見つけて監査で引用すること
リリース済みと未リリースのコンテンツの混乱

実装：

deploy-dev.yml ワークフローがテーマオーバーライド経由で /dev/ のすべてのページに noindex メタタグを挿入します：

<!-- /dev/ ページのみに挿入 -->
<meta name="robots" content="noindex, nofollow">

GitHub Pages ミラー — noindex

GitHub Pages（billyrise.github.io のミラーサイト）へのデプロイ時、重複インデックスを防ぐためにすべてのページに noindex を設定する必要があります：

<meta name="robots" content="noindex, nofollow">

これにより、検索エンジンは常に standard.aimoaas.com の本番 canonical URL を優先します。

検証方法

各ビルド後、以下の方法でcanonical URLを検証できます：

生成されたHTMLの確認 — mkdocs build後にsite/ディレクトリをチェック
ブラウザDevToolsの使用 — デプロイされたページの<head>セクションを検査
Google Search Console — どのURLがインデックスされているかを監視

検証コマンドの例：

mkdocs build
grep -r 'rel="canonical"' site/ | head -5

期待される出力は本番URLを表示します。例：

site/index.html:<link rel="canonical" href="https://standard.aimoaas.com/">
site/governance/index.html:<link rel="canonical" href="https://standard.aimoaas.com/governance/">