OpenSite/Reference/Features/Message catalog - Revision history

BathAfrica: Link adjacent OpenSite reference pages in reading order

2026-10-29T21:15:20Z

Link adjacent OpenSite reference pages in reading order

← Older revision		Revision as of 14:15, 29 October 2026
Line 27:		Line 27:
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

	<div class="os-page-nav">{{Docnav\|OpenSite/~~Getting started~~\|OpenSite/~~Guides~~\|OpenSite/Guides\|All guides}}</div>		<div class="os-page-nav">{{Docnav\|OpenSite/Reference/Features/Extension platform\|OpenSite/Reference/Features/Plugins\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Reorganize OpenSite reference with shared scope and related workflows

2026-10-29T20:59:50Z

Reorganize OpenSite reference with shared scope and related workflows

← Older revision		Revision as of 13:59, 29 October 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{OpenSite scope}}
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
	\|id=localization.catalog		\|id=localization.catalog
	\|summary=Look up a message by a stable key, with English and then the key itself when a translation is missing.		\|summary=Look up a message by a stable key, with English and then the key itself when a translation is missing.
Line 14:		Line 14:
	}}		}}


			== Try this workflow ==
			[[OpenSite/Guides/Discover commands\|Discover commands]] — a worked lesson with expected results.

	== Documentation basis ==		== Documentation basis ==
Line 23:		Line 26:
	[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]		[[OpenSite\|OpenSite overview]] · [[OpenSite/Reference\|Reference]] · [[OpenSite/Guides\|Guides]]
	[[Category:OpenSite documentation]]		[[Category:OpenSite documentation]]

			<div class="os-page-nav">{{Docnav\|OpenSite/Getting started\|OpenSite/Guides\|OpenSite/Guides\|All guides}}</div>

BathAfrica: Use BathAfrica sidebar contents without duplicate inline contents box

2026-10-29T20:11:37Z

Use BathAfrica sidebar contents without duplicate inline contents box

← Older revision		Revision as of 13:11, 29 October 2026
Line 1:		Line 1:
			__NOTOC__
	{{BathAfrica Feature		{{BathAfrica Feature
	\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.		\|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.

BathAfrica: Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

2026-10-29T20:07:03Z

Publish Cursor documentation reconciled with OpenSite source 77c3fee; tests not rerun

New page

{{BathAfrica Feature
|review=Development documentation for OpenSite 0.0.1, source snapshot 77c3fee (Phase 13C). Reviewed against implementation on 29 October 2026. Tests and the Windows desktop were not rerun for this publication; this is not a released-product support claim.
|id=localization.catalog
|summary=Look up a message by a stable key, with English and then the key itself when a translation is missing.
|status=Implemented in the reviewed development source. Historical test evidence is recorded by the repository; no test rerun or product release is claimed by this publication.
|units=None. A catalog does not store a quantity.
|behavior=The document format is <code>opensite-message-catalog</code> version 1, JSON, UTF-8. Lookup tries the active tag, parent tags, English, then the key. Placeholders are named and must match the supplied names. The English plural rule, registered only for <code>en</code>, selects <code>one</code> when the count is 1 and <code>other</code> otherwise. Another language uses <code>other</code> until a host registers a rule. A plural rule that throws is recorded and the category <code>other</code> is used. A repeated key in the same language is rejected and does not replace the existing text. <code>CatalogSubscription</code> removes its observer when destroyed.
|errors=<code>corrupt_catalog</code>, <code>unsupported_version</code>, <code>duplicate_id</code>, <code>reentrant_call</code> when a lookup or a notice tries to change the catalog, and <code>invalid_argument</code> for a placeholder mismatch or a plugin key outside its prefix.
|limitations=The reviewed built-in catalogs use English. Selecting French does not supply a French translation. The GUI has English shell and extension catalog keys, but a complete translation set is not claimed. A provider adds messages only within its namespace. The English plural rule is not a universal grammar.
|hosts=Foundation catalog service, CLI, embedded Python, desktop shell and extension catalogs. The catalog itself remains GUI-independent.
|licensing=Catalog text is not an entitlement. A provider catalog does not grant a capability.
|verification=Repository evidence references (not rerun for this publication): CTest <code>foundation.catalog</code> and <code>cli.preferences</code>. ADR-0019 and ADR-0021.
}}

== Documentation basis ==
Source-reviewed against development commit <code>77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7</code>, branch <code>feature/phase-13c-properties-python-expressions</code>. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.

* <code>src/foundation/catalog.cpp</code>
* <code>src/gui/shell_catalog.cpp</code>

[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]]
[[Category:OpenSite documentation]]