diff --git a/CHANGELOG.md b/CHANGELOG.md index c5f86361..44b2fbc6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,31 @@ All notable changes to Docara are recorded here. The format follows ## [Unreleased] +## [3.14.1] - 2026-11-10 + +### Fixed + +- **A link to `#part` inside an example frame stays in the example.** The + frame document has a `` to its example folder, so a click on a + same-document link loaded that folder into the frame (a 404) and blanked + the example. The click now scrolls the example to its target, when it + has one; an example that handles the click itself keeps it. +- **An example frame starts in the page's language.** Its `` gets the + page's `lang` (and `dir="rtl"` on a right-to-left page) before any script + in it runs, so Framework scripts format sizes, dates and default labels + in that language (`106 Б` on a Russian page, not `106 B`). +- **Code blocks inside an inline HTML example are the example's own.** + Docara's code-block header no longer takes over a `
` in the
+  example's markup, so a Framework highlight there shows its language, its
+  `data-chrome` and `data-wrap` settings and its wrap button. Tables and
+  images inside the example are left as written too.
+- **Docara writes `bg-surface-page` instead of `bg-surface-0`.** SIMAI
+  Framework renamed the surface-0 background to the page surface; the
+  colour is the same. Example frames, cards, the skip link and the reader
+  settings use the new class. In `docara.json` layouts `bg-surface-0` is
+  still accepted: it renders as `bg-surface-page` and is noted in the page
+  plan's `deprecated_utilities`, as `surface-0` already was.
+
 ## [3.14.0] - 2026-11-10
 
 ### Added
diff --git a/VERSION b/VERSION
index f982feb4..49547fdc 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.14.0
+3.14.1
diff --git a/docs/site/content/en/settings/layout-and-regions.md b/docs/site/content/en/settings/layout-and-regions.md
index f6339a3d..ca1daffc 100644
--- a/docs/site/content/en/settings/layout-and-regions.md
+++ b/docs/site/content/en/settings/layout-and-regions.md
@@ -290,10 +290,10 @@ HTML, event handlers, JavaScript URLs, style or class strings, callbacks and
 template paths stay out of reach.
 
 The allowed utilities are listed in `resources/framework/view-utilities.json`;
-these are SIMAI Framework classes, for example `bg-surface-0` for the surface
+these are SIMAI Framework classes, for example `bg-surface-page` for the page
 background and the pair `border-bottom-1 border-bottom-solid` for a bottom
-border. The former names `surface-0` and `border-bottom` do not exist in the
-Framework, but Docara still accepts them: the page gets these Framework
+border. The former names `surface-0`, `bg-surface-0` and `border-bottom` are
+gone from the Framework, but Docara still accepts them: the page gets these Framework
 classes instead, and the replacement is noted in the page plan
 (`deprecated_utilities`). Write the Framework names in new files.
 
diff --git a/docs/site/content/en/start/first-component.md b/docs/site/content/en/start/first-component.md
index 01bd142f..0436c224 100644
--- a/docs/site/content/en/start/first-component.md
+++ b/docs/site/content/en/start/first-component.md
@@ -88,7 +88,7 @@ declare(strict_types=1);
 
 $title = htmlspecialchars((string) ($props['title'] ?? ''), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
 $text = htmlspecialchars((string) ($props['text'] ?? ''), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
-echo '