Alchemy attribute docs (EN → JA)
Truth sources
- English:
/// <summary>/ param XML on attributes inAlchemy/Assets/Alchemy/Runtime/Inspector/InspectorAttributes.csandGroupAttributes.cs(also reflected in generateddocs/articles/en/attributes/{slug}.md). - Localized:
scripts/docs/resources/i18n/{lang}.jsononly (ja.jsontoday; codes fromDocLanguage.All), one file with anattributesmap keyed by type name (e.g."ButtonAttribute": { ... }). Missing or blank JA fields fall back to English on generated pages. - Never hand-edit generated
docs/articles/ja/attributes/*.md.
i18n file shape
{
"attributes": {
"ButtonAttribute": {
"summary": "日本語の説明文。"
},
"HelpBoxAttribute": {
"summary": "フィールドの上にメモや警告を追加します。",
"notes": [
{ "type": "WARNING", "body": "注意書き(任意)" }
],
"params": {
"message": "パラメータの説明"
}
}
}
}
Omit params / notes when unused. Param keys must match documented constructor parameter names (or property names for named-argument attributes). EN notes come from <alchemy-attr-note type="WARNING"> on the attribute. Keep Japanese as UTF-8 text (do not \u-escape).
Workflow
- Read EN summary/params from XML or
docs/articles/en/attributes/{slug}.md. - Update the attribute entry in
scripts/docs/resources/i18n/ja.jsonwith natural, concise Japanese matching existing docs tone. - Regenerate pages:
dotnet run --project scripts/docs -- generate --no-capture
- Use full
generate(no--no-capture) only when Inspector screenshots should refresh (requires Unity CLI +tests/versions/Unity6000.3).
Style
- Keep summaries short (one or two sentences).
- Do not invent API behavior absent from EN.
- Prefer terminology already used in neighboring JA attribute pages.