diff --git a/.github/actions/services/Bucket.js b/.github/actions/services/Bucket.js index b5a8dc6..faf57d1 100644 --- a/.github/actions/services/Bucket.js +++ b/.github/actions/services/Bucket.js @@ -14,24 +14,7 @@ const blogPrefix = 'blog'; const contentPrefix = 'src/content'; const features = { syntax: [ - 'banner', - 'bleed', - 'button', - 'callout', - 'cards', - 'code', - 'collapse', - 'featurecard', - 'filetree', - 'footnotes', - 'hero', - 'image', - 'mermaid', - 'steps', - 'table', - 'tabs', - 'var', - 'video' + 'code' ] }; const mediaPrefix = 'public'; diff --git a/CLAUDE.md b/CLAUDE.md index bc1f459..6a4ea88 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -85,78 +85,61 @@ Required fields (workflow throws if any are missing): - Start the body with `# {{title}}` matching the frontmatter `title`, followed by opening prose; use `##` and below for section headings - Relative links to other blog entries use `/blog/{{YYYY}}/{{MM}}/{{DD}}.md` form -- Links to `https://axivo.com` website are stripped to relative paths automatically +- Literal `https://axivo.com` string is stripped from the body during upload as a safety net for accidental absolute references in prose ## Features -Some renderer work — shiki syntax highlighting today, math and diagram caches in the future — is too expensive to do per request and too volatile to ship in the bundle. Authors opt entries into precomputation by declaring features in frontmatter. The workflow validates each `:` against the canonical list and writes the validated set as R2 custom metadata. The website's prebuild expands declarations into precomputed data inline in the per-collection manifest. Entries without a `features` block produce no precomputed output and render with safe-mdx defaults. - -### Syntax - -Use when the entry contains code that should be syntax-highlighted with `shiki`: +Blog entries can be enhanced with JSX Components and Markdown/GFM Features, they render out of the box. The only opt-in is `code` — declare it into frontmatter when the entry contains code that should be syntax-highlighted. ```yaml features: syntax: - - {{ name }} + - {{name}} ``` -The `syntax` type accepts the names listed below. - -#### JSX Components - -- `banner` — highlight code inside a `` block -- `bleed` — highlight code inside a `` block -- `button` — highlight code inside or referenced by a `