livery.extensions.docs._tasks¶
livery.extensions.docs._tasks ¶
The docs extension's verbs, loaded through the extension's entry point.
Importing this module registers the docs group under the extension's
identity and the pre_tasks hook that links task names to their pages
on the site. The extension's steps, queries, CI jobs and the site's
theme override are declared in its extension.toml. The base's
plugin never imports it.
Attributes:
| Name | Type | Description |
|---|---|---|
docs_group |
|
link_task_pages ¶
link_task_pages(inv: Invocation) -> None
Link task names to their pages on the site, when the contract names it.
The root contract's [docs] site-url gives the address, and each
task links to its redirect page there. A configured docs-url and
the contract's [workspace] docs-url come first, whichever hook
runs first. The contract is read raw: the hook runs on every
command, fm sync among them, so an address a link template
cannot start with is named on stderr and links nothing, and the
command goes on.