$logger : \Psr\Log\LoggerInterface
$plantumlRenderer : \phpDocumentor\Transformer\Writer\Graph\PlantumlRenderer
asset(array $context, string $path) : string
Copies the referenced asset and returns the canonical path to that asset; thus taking the BASE tag into account.
The layout for guides includes a BASE tag in the head, which creates the need for all relative urls to actually be relative not to the current file's path; but the root of the Documentation Set. This means that, when rendering paths, you always need to include the canonical path; not that relative to the current file.