livery.extensions.docs._overrides¶
livery.extensions.docs._overrides ¶
The site's theme override at the root, and the extensions' site assets it reads.
The extension's [fragments."overrides/main.html"] render is
overrides_template, which fm sync writes at the root while docs is
listed. A module a declaration names registers nothing when it is
imported, so this one holds no verb: the site's verbs live in the
module that assembles the site, which reads the assets from here.
Functions:
| Name | Description |
|---|---|
extension_assets |
Each mounted extension that ships site assets, with its assets directory. |
card_path |
The link-preview card's path in the site, or empty when there is none. |
overrides_template |
The site's theme override: link-preview tags, instance facts. |
Attributes:
| Name | Type | Description |
|---|---|---|
EXTENSION_ASSETS |
|
|
CONTENT_ASSETS |
|
|
CARD_IMAGE |
|
extension_assets ¶
Each mounted extension that ships site assets, with its assets directory.
In the workspace's extension order. An extension ships site assets under
content/docs/assets/ in its wheel; an extension without that
directory, or not installed, ships none and is not listed.
Source code in packages/extensions/docs/src/livery/extensions/docs/_overrides.py
card_path ¶
The link-preview card's path in the site, or empty when there is none.
The workspace's own docs/assets/og-card.png first, then the card
the last extension in the workspace's order ships, at the path the
build stages it under.
Source code in packages/extensions/docs/src/livery/extensions/docs/_overrides.py
overrides_template ¶
The site's theme override: link-preview tags, instance facts.
The extension's [fragments] render for overrides/main.html,
so fm sync writes the file at the root while docs is listed,
and the drift check keeps it matching. It opens with the
provenance header every generated file carries, in Jinja's comment
form.
The brand leads on the home page, because that is the URL that gets posted and a feed truncates from the right; elsewhere the page leads. The image tags name the workspace's own card, else the card an extension ships, else are left out. Every URL is absolute: a preview is fetched by someone else's server, which has no page to resolve a relative path against.