breadcrumb-the-shire/pages/admin/docs/index($slug).php

<?php

use MintyPHP\Buffer;
use MintyPHP\Http\Request;
use MintyPHP\Router;
use MintyPHP\Service\Docs\DocsCatalogService;
use MintyPHP\Support\Guard;

Guard::requireLogin();
Guard::requireAbility(\MintyPHP\Service\Access\OperationsAuthorizationPolicy::ABILITY_ADMIN_DOCS_VIEW);

$docGroups = DocsCatalogService::docGroups();
$allDocs = DocsCatalogService::allDocs();
if ($allDocs === []) {
    Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
    return;
}
$defaultSlug = DocsCatalogService::defaultSlug();

$slug = trim((string) ($slug ?? ''));
if ($slug === '') {
    Router::redirect('admin/docs/' . $defaultSlug);
    return;
}

if (!array_key_exists($slug, $allDocs)) {
    Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
    return;
}

$rawMarkdown = DocsCatalogService::readMarkdown($slug);
if ($rawMarkdown === null) {
    Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
    return;
}

$prepared = DocsCatalogService::prepareRenderedDocument($rawMarkdown, [1, 2, 3]);
$renderedHtml = (string) $prepared['html'];
$tocItems = [];
foreach ($prepared['headings'] as $heading) {
    $level = (int) $heading['level'];
    if (!in_array($level, [2, 3], true)) {
        continue;
    }

    $tocItems[] = [
        'level' => $level,
        'text' => (string) $heading['text'],
        'anchor' => (string) $heading['anchor'],
    ];
}

$currentSlug = $slug;
$currentTitle = (string) $allDocs[$slug];

Buffer::set('title', $currentTitle . ' - ' . t('Documentation'));

$breadcrumbs = [
    ['label' => t('Home'), 'path' => 'admin'],
    ['label' => t('Documentation'), 'path' => 'admin/docs/' . $defaultSlug],
    ['label' => $currentTitle],
];
Buffer::set('style_groups', json_encode(['docs']));
Buffer::set('docs_rendered_html', $renderedHtml);