code
cb64836901
Colors <pre><code> blocks site-wide via vendored highlight.js v11.11.1
(pinned to that stable tag, not main, which tracks an in-progress
11.0.0-beta1), auto-detected and restricted to
configure({ languages: ['php', 'bash', 'xml', 'css', 'python',
'javascript', 'yaml', 'json', 'ini'] }) - no per-block markup needed for
the ~60 existing code blocks across the site. css/python/javascript ship
in the core bundle; yaml/json/ini (ini covers .env-style files too)
don't and are vendored as separate per-language files.
Themes swap with the existing dark/light toggle: ir-black (dark) +
github (light, resolving the entry's own open question), via the same
data-theme-driven mechanism as the main palette
(syntax-highlight-init.twig/syntax-highlight.twig, mirroring
theme-init.twig/nav.twig's split) - a MutationObserver swaps the theme
link live without touching the existing toggle button's click handler.
Twig-syntax code blocks have no highlight.js grammar and are marked
class="nohighlight" by hand (15 blocks across 9 files, found by grepping
for literal {% %}/{{ }} syntax rather than guessing) rather than
force-matched into the restricted candidate set, which would color them
wrong instead of leaving them plain.
One correction to the original backlog entry's suggested approach: it
suggested vendoring highlight.js under novaconium/vendor/ next to Twig.
That would have silently 404ed on every request - Twig is server-side
PHP, never fetched by a browser, but highlight.js's .js/.css files are,
and only public/ is web-reachable. Vendored to public/vendor/highlightjs/
instead; documented in AGENTS.md and a new upgrading-highlightjs doc,
since public/ isn't touched by the usual novaconium/-swap framework
update workflow, so a future highlight.js bump won't propagate to
existing projects automatically the way it does for everything else
under novaconium/.
Caught two real bugs via testing rather than review: hljs.highlightAll()
silently no-ops if called before the document finishes parsing rather
than deferring itself, and a bash example starting with the word "php"
auto-detects as PHP, not bash.
Also adds App/pages/blog/code-highlighting/ - a new blog post
demonstrating the feature with a verified worked example in each of the
nine languages, plus how to force a language via an explicit
language-<name> class when auto-detection isn't enough.
Closes the "Syntax highlighting on code blocks" backlog item in
novaconium/ISSUES.md.
45 lines
2.1 KiB
PHP
45 lines
2.1 KiB
PHP
<?php
|
|
|
|
// Every post under App/pages/blog/ is now a plain, sidecar-less directory
|
|
// with its own index.twig — none of them are driven by a repository or
|
|
// database, so this listing is just a hand-maintained array pointing at
|
|
// each one. Add a new entry here whenever a new post directory is added.
|
|
// 'published' (YYYY-MM-DD) is used by App/pages/blog/feed/index.php to
|
|
// order and date entries in the RSS feed — illustrative dates here, not
|
|
// derived from real history (this repo's posts all arrived in one batch
|
|
// import, so there's no authentic per-post date to pull from).
|
|
return [
|
|
'posts' => [
|
|
[
|
|
'slug' => 'hello-world',
|
|
'title' => 'Hello, World!',
|
|
'excerpt' => 'The first post on this blog — a plain sidecar-less page, like every other post here now.',
|
|
'published' => '2026-07-11',
|
|
],
|
|
[
|
|
'slug' => 'second-post',
|
|
'title' => 'A Second Post',
|
|
'excerpt' => 'A second post at its own URL, showing that adding a new page under App/pages/blog/ needs nothing but a new directory.',
|
|
'published' => '2026-07-11',
|
|
],
|
|
[
|
|
'slug' => 'twig-syntax-guide',
|
|
'title' => 'Twig Syntax Guide',
|
|
'excerpt' => 'A tour of the Twig syntax used throughout this site — output, filters, control structures, template inheritance, and a few gotchas worth knowing.',
|
|
'published' => '2026-07-13',
|
|
],
|
|
[
|
|
'slug' => 'style-guide',
|
|
'title' => 'Style Guide',
|
|
'excerpt' => "A showcase of this theme's default styling for headings, lists, tables, code, and other common HTML elements.",
|
|
'published' => '2026-07-13',
|
|
],
|
|
[
|
|
'slug' => 'code-highlighting',
|
|
'title' => 'Code Highlighting',
|
|
'excerpt' => 'How syntax highlighting works on this site, with worked examples in bash, HTML, CSS, YAML, Python, JavaScript, JSON, and INI/env.',
|
|
'published' => '2026-07-14',
|
|
],
|
|
],
|
|
];
|