Skip to content

The pages call the file a templates file, not a chrome file - #17

Merged
fabeat merged 2 commits into
mainfrom
feature/templates-file
Oct 30, 2026
Merged

fabeat merged 2 commits into
mainfrom
feature/templates-file

Conversation

@fabeat

@fabeat fabeat commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

The library renamed the frontmatter key that points at a file of template definitions.

chrome: is templates-file: now, and the file it names is a templates file. The word "chrome" keeps its other meaning in the library — the shapes a template draws — and the pages keep it there.

Was Is
chrome: ./chrome.md templates-file: ./templates.md
Exception\ChromeNotFound Exception\TemplatesFileNotFound
Exception\ChromeTooLarge Exception\TemplatesFileTooLarge
MalformedChrome MalformedChrome, for a template's body only
— Exception\MalformedTemplatesFile, for a file that holds a slide

The pages that change:

  • presentation/directives.md — the frontmatter key table, the sentence about which keys belong to the first slide, and the section that was "The chrome file" and is now "The templates file".
  • presentation/themes.md — the sentence about the path resolving against the deck's own directory.
  • presentation/errors.md — the exception table follows the library's split.
  • presentation/index.md — the MAX_BYTES ceiling is "the size of a templates file".

src/Reference/Vocabularies.php names TemplatesFile::MAX_BYTES rather than ChromeFile::MAX_BYTES, so the reference check reads the library's class rather than a name it cannot resolve.

This pull request cannot be built against main of the library

The site renders its examples with the library, and the claim tests render decks that use templates-file:. main of markdown-office/markdown-presentation does not have the rename yet, so the build needs the library's branch:

vars.MARKDOWN_PRESENTATION_REF = feature/templates-file

That is the case the variable exists for — a page about a feature the library does not have on main yet. It should go back to main once markdown-office/markdown-presentation#37 is merged.

Checks

composer check passes locally against the library's branch: the example render in strict mode, the reference check, the README link check, and 50 Pest tests over 135 assertions.

The library renamed the key that points at a file of template definitions:
`chrome:` is `templates-file:` now, and the file it names is a templates file.
The word "chrome" keeps its other meaning — the shapes a template draws — and
the pages keep it there.

The exceptions follow the library: `ChromeNotFound` and `ChromeTooLarge` are
`TemplatesFileNotFound` and `TemplatesFileTooLarge`, and a templates file that
holds a slide is now `MalformedTemplatesFile` rather than a case of
`MalformedChrome`.
@sonarqubecloud

Copy link
Copy Markdown

@fabeat
fabeat merged commit 52e1158 into main Oct 30, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant