Release 3.14.1: example links, language and code blocks stay in their examples

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 `<base href>` 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 `<html>` 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 `<pre><code>` 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

VERSION

@@ -1 +1 @@
-3.14.0
+3.14.1

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.
 

docs/site/content/en/start/first-component.md

@@ -88,15 +88,15 @@ 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 '<aside data-docara-smart="project.notice-card" class="flex flex-col gap-1/2 p-2 radius-surface border bg-surface-0 m-bottom-1">'
+echo '<aside data-docara-smart="project.notice-card" class="flex flex-col gap-1/2 p-2 radius-surface border bg-surface-page m-bottom-1">'
     . '<strong>' . $title . '</strong>'
     . '<p class="m-0">' . $text . '</p>'
     . '</aside>';
 ```
 
 - `htmlspecialchars` escapes the text, so nobody can slip markup in through
   the parameters. Do not remove it.
-- `flex`, `p-2`, `radius-surface`, `border` and `bg-surface-0` are SIMAI Framework
+- `flex`, `p-2`, `radius-surface`, `border` and `bg-surface-page` are SIMAI Framework
   utilities. Docara loads their styles itself and adapts the colours to the
   light and dark themes.
 

docs/site/content/ru/settings/layout-and-regions.md

@@ -288,9 +288,9 @@ Framework и два типа вызовов:
 шаблонам остаются недоступны.
 
 Разрешённые утилиты перечислены в `resources/framework/view-utilities.json`;
-это классы SIMAI Framework, например `bg-surface-0` для фона поверхности и пара
-`border-bottom-1 border-bottom-solid` для нижней границы. Прежние имена
-`surface-0` и `border-bottom` во Framework не существуют, но Docara их
+это классы SIMAI Framework, например `bg-surface-page` для фона страницы и пара
+`border-bottom-1 border-bottom-solid` для нижней границы. Прежних имён
+`surface-0`, `bg-surface-0` и `border-bottom` во Framework больше нет, но Docara их
 по-прежнему принимает: на странице вместо них выводятся эти классы Framework, а
 замена отмечается в плане страницы (`deprecated_utilities`). В новых файлах
 пишите имена Framework.

docs/site/content/ru/start/first-component.md

@@ -88,15 +88,15 @@ 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 '<aside data-docara-smart="project.notice-card" class="flex flex-col gap-1/2 p-2 radius-surface border bg-surface-0 m-bottom-1">'
+echo '<aside data-docara-smart="project.notice-card" class="flex flex-col gap-1/2 p-2 radius-surface border bg-surface-page m-bottom-1">'
     . '<strong>' . $title . '</strong>'
     . '<p class="m-0">' . $text . '</p>'
     . '</aside>';
 ```
 
 - `htmlspecialchars` экранирует текст: так в параметры нельзя подложить
   чужую разметку. Не убирайте его.
-- Классы `flex`, `p-2`, `radius-surface`, `border`, `bg-surface-0` — утилиты
+- Классы `flex`, `p-2`, `radius-surface`, `border`, `bg-surface-page` — утилиты
   SIMAI Framework. Docara сама подключит их стили и подстроит цвета под
   светлую и тёмную тему.