jekyll-slides 0.1.0

data/doc/Jekyll/Slides/Assets.md

@@ -0,0 +1,12 @@
+# Module Jekyll::Slides::Assets <a id="module-Jekyll-Slides-Assets"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/jekyll/slides/assets.rb |
+
+## Public Class Methods
+### `asset_files()` <a id="method-c-asset_files"></a> <a id="asset_files-class_method"></a>
+Not documented.
+
+### `install(site)` <a id="method-c-install"></a> <a id="install-class_method"></a>
+Not documented.

data/doc/Jekyll/Slides/ComponentRenderer/RenderedDocument.md

@@ -0,0 +1,15 @@
+# Class Jekyll::Slides::ComponentRenderer::RenderedDocument <a id="class-Jekyll-Slides-ComponentRenderer-RenderedDocument"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Struct |
+| **Defined in** | lib/jekyll/slides/component_renderer.rb |
+
+## Attributes
+### `components` [RW] <a id="attribute-i-components"></a> <a id="components-instance_method"></a>
+Returns the value of attribute components
+- **@return** [Object] the current value of components
+
+### `fragments` [RW] <a id="attribute-i-fragments"></a> <a id="fragments-instance_method"></a>
+Returns the value of attribute fragments
+- **@return** [Object] the current value of fragments

data/doc/Jekyll/Slides/ComponentRenderer.md

@@ -0,0 +1,33 @@
+# Class Jekyll::Slides::ComponentRenderer <a id="class-Jekyll-Slides-ComponentRenderer"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/component_renderer.rb |
+
+## Constants
+### `FRAGMENT_PATTERN` <a id="constant-FRAGMENT_PATTERN"></a> <a id="FRAGMENT_PATTERN-constant"></a>
+Not documented.
+
+### `LONG_CODE_LINE_THRESHOLD` <a id="constant-LONG_CODE_LINE_THRESHOLD"></a> <a id="LONG_CODE_LINE_THRESHOLD-constant"></a>
+Advisory only: available space depends on the slide layout and component size.
+
+### `SIZES` <a id="constant-SIZES"></a> <a id="SIZES-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `render(markdown, warning: = nil, options: = {})` <a id="method-c-render"></a> <a id="render-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(warning: = nil, rouge_renderer: = nil, options: = {})` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [ComponentRenderer] a new instance of ComponentRenderer
+
+### `render(markdown)` <a id="method-i-render"></a> <a id="render-instance_method"></a>
+Not documented.
+
+### `render_document(markdown, id_prefix: = "")` <a id="method-i-render_document"></a> <a id="render_document-instance_method"></a>
+Not documented.
+
+### `render_fragments(markdown, id_prefix: = "")` <a id="method-i-render_fragments"></a> <a id="render_fragments-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/JekyllIntegration.md

@@ -0,0 +1,28 @@
+# Module Jekyll::Slides::JekyllIntegration <a id="module-Jekyll-Slides-JekyllIntegration"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/jekyll/slides/jekyll_integration.rb |
+
+## Constants
+### `BOOLEAN_OPTIONS` <a id="constant-BOOLEAN_OPTIONS"></a> <a id="BOOLEAN_OPTIONS-constant"></a>
+Not documented.
+
+### `DEFAULTS` <a id="constant-DEFAULTS"></a> <a id="DEFAULTS-constant"></a>
+Not documented.
+
+### `OPTION_KEYS` <a id="constant-OPTION_KEYS"></a> <a id="OPTION_KEYS-constant"></a>
+Not documented.
+
+### `THEMES` <a id="constant-THEMES"></a> <a id="THEMES-constant"></a>
+Not documented.
+
+## Public Class Methods
+### `install!()` <a id="method-c-install-21"></a> <a id="install!-class_method"></a>
+Not documented.
+
+### `process(document)` <a id="method-c-process"></a> <a id="process-class_method"></a>
+Not documented.
+
+### `process_site(site)` <a id="method-c-process_site"></a> <a id="process_site-class_method"></a>
+Not documented.

data/doc/Jekyll/Slides/Layout.md

@@ -0,0 +1,10 @@
+# Class Jekyll::Slides::Layout <a id="class-Jekyll-Slides-Layout"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Jekyll::Layout |
+| **Defined in** | lib/jekyll/slides/layout.rb |
+
+## Public Instance Methods
+### `initialize(site)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [Layout] a new instance of Layout

data/doc/Jekyll/Slides/Presentation.md

@@ -0,0 +1,19 @@
+# Class Jekyll::Slides::Presentation <a id="class-Jekyll-Slides-Presentation"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/presentation.rb |
+
+Renders a Markdown deck into slide sections without the page layout.
+
+## Public Instance Methods
+### `initialize(markdown, warning: = nil, options: = {})` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@param** `markdown` [String] Markdown without page YAML front matter
+- **@param** `warning` [#call, nil] receives advisory rendering warnings
+- **@param** `options` [Hash] kramdown options
+- **@return** [Presentation] a new instance of Presentation
+
+### `render(markdown = @markdown)` <a id="method-i-render"></a> <a id="render-instance_method"></a>
+- **@param** `markdown` [String] optional replacement for the initial Markdown
+- **@return** [String] rendered slide section HTML

data/doc/Jekyll/Slides/PresentationParser.md

@@ -0,0 +1,17 @@
+# Class Jekyll::Slides::PresentationParser <a id="class-Jekyll-Slides-PresentationParser"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/presentation_parser.rb |
+
+## Public Class Methods
+### `parse(body)` <a id="method-c-parse"></a> <a id="parse-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(body = nil)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [PresentationParser] a new instance of PresentationParser
+
+### `parse(body = @body)` <a id="method-i-parse"></a> <a id="parse-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/RangeParser.md

@@ -0,0 +1,21 @@
+# Class Jekyll::Slides::RangeParser <a id="class-Jekyll-Slides-RangeParser"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/range_parser.rb |
+
+## Constants
+### `MAX_RANGE_SIZE` <a id="constant-MAX_RANGE_SIZE"></a> <a id="MAX_RANGE_SIZE-constant"></a>
+Prevent author-controlled ranges from forcing unbounded allocation.
+
+## Public Class Methods
+### `parse(value, warning: = nil, max_line: = nil)` <a id="method-c-parse"></a> <a id="parse-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(value = nil, warning: = nil, max_line: = nil)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [RangeParser] a new instance of RangeParser
+
+### `parse()` <a id="method-i-parse"></a> <a id="parse-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/Renderer.md

@@ -0,0 +1,10 @@
+# Class Jekyll::Slides::Renderer <a id="class-Jekyll-Slides-Renderer"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Jekyll::Renderer |
+| **Defined in** | lib/jekyll/slides/renderer.rb |
+
+## Public Instance Methods
+### `convert(content)` <a id="method-i-convert"></a> <a id="convert-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/RougeRenderer.md

@@ -0,0 +1,16 @@
+# Class Jekyll::Slides::RougeRenderer <a id="class-Jekyll-Slides-RougeRenderer"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/rouge_renderer.rb |
+
+## Public Instance Methods
+### `initialize(warning: = nil)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [RougeRenderer] a new instance of RougeRenderer
+
+### `render(source, language)` <a id="method-i-render"></a> <a id="render-instance_method"></a>
+Not documented.
+
+### `render_lines(source, language)` <a id="method-i-render_lines"></a> <a id="render_lines-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/SlideMetadata.md

@@ -0,0 +1,43 @@
+# Class Jekyll::Slides::SlideMetadata <a id="class-Jekyll-Slides-SlideMetadata"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/slide_metadata.rb |
+
+## Constants
+### `BACKGROUNDS` <a id="constant-BACKGROUNDS"></a> <a id="BACKGROUNDS-constant"></a>
+Not documented.
+
+### `KEYS` <a id="constant-KEYS"></a> <a id="KEYS-constant"></a>
+Not documented.
+
+### `LAYOUTS` <a id="constant-LAYOUTS"></a> <a id="LAYOUTS-constant"></a>
+Not documented.
+
+## Attributes
+### `background` [R] <a id="attribute-i-background"></a> <a id="background-instance_method"></a>
+Returns the value of attribute background.
+
+### `content` [R] <a id="attribute-i-content"></a> <a id="content-instance_method"></a>
+Returns the value of attribute content.
+
+### `custom_class` [R] <a id="attribute-i-custom_class"></a> <a id="custom_class-instance_method"></a>
+Returns the value of attribute custom_class.
+
+### `layout` [R] <a id="attribute-i-layout"></a> <a id="layout-instance_method"></a>
+Returns the value of attribute layout.
+
+### `values` [R] <a id="attribute-i-values"></a> <a id="values-instance_method"></a>
+Returns the value of attribute values.
+
+## Public Class Methods
+### `parse(content, index: = 0, warning: = nil, components: = nil)` <a id="method-c-parse"></a> <a id="parse-class_method"></a>
+Not documented.
+
+## Public Instance Methods
+### `initialize(content, index: = 0, warning: = nil)` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [SlideMetadata] a new instance of SlideMetadata
+
+### `parse(components: = nil)` <a id="method-i-parse"></a> <a id="parse-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/SlideRenderer.md

@@ -0,0 +1,13 @@
+# Class Jekyll::Slides::SlideRenderer <a id="class-Jekyll-Slides-SlideRenderer"></a>
+
+|  |  |
+| --- | --- |
+| **Inherits** | Object |
+| **Defined in** | lib/jekyll/slides/slide_renderer.rb |
+
+## Public Instance Methods
+### `initialize(warning: = nil, component_renderer: = nil, options: = {})` <a id="method-i-initialize"></a> <a id="initialize-instance_method"></a>
+- **@return** [SlideRenderer] a new instance of SlideRenderer
+
+### `render(markdown)` <a id="method-i-render"></a> <a id="render-instance_method"></a>
+Not documented.

data/doc/Jekyll/Slides/Support.md

@@ -0,0 +1,12 @@
+# Module Jekyll::Slides::Support <a id="module-Jekyll-Slides-Support"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/jekyll/slides/support.rb |
+
+## Public Class Methods
+### `escape(value)` <a id="method-c-escape"></a> <a id="escape-class_method"></a>
+Not documented.
+
+### `warn(warning, message)` <a id="method-c-warn"></a> <a id="warn-class_method"></a>
+Not documented.

data/doc/Jekyll/Slides.md

@@ -0,0 +1,50 @@
+# Module Jekyll::Slides <a id="module-Jekyll-Slides"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/jekyll/slides.rb, lib/jekyll/slides/assets.rb, lib/jekyll/slides/layout.rb, lib/jekyll/slides/support.rb, lib/jekyll/slides/version.rb, lib/jekyll/slides/renderer.rb, lib/jekyll/slides/presentation.rb, lib/jekyll/slides/range_parser.rb, lib/jekyll/slides/rouge_renderer.rb, lib/jekyll/slides/slide_metadata.rb, lib/jekyll/slides/slide_renderer.rb, lib/jekyll/slides/component_renderer.rb, lib/jekyll/slides/jekyll_integration.rb, lib/jekyll/slides/presentation_parser.rb |
+
+Markdown presentations for Jekyll, with editor and terminal components.
+
+Add <code>jekyll-slides</code> to the site's plugins and choose the
+`presentation` layout on a Markdown page. Separate slides with
+<code>---</code> outside fenced code blocks. The plugin supplies layouts,
+includes, styles, scripts, and offline fonts while preserving the site's theme
+and local overrides.
+
+Configure defaults under <code>slides:</code> in _config.yml, or use front
+matter on individual decks. Themes are `midnight`, <code>minimal-light</code>,
+<code>minimal-dark</code>, and `ruby`. The supported aspect ratio is 16:9;
+quote this value in YAML.
+
+Jekyll runs Liquid before rendering each slide as one Markdown document.
+Jekyll::Slides::Presentation also renders slide HTML directly when Jekyll
+integration is not needed; it does not evaluate Liquid or wrap the
+presentation layout.
+
+## Constants
+### `LAYOUT_NAME` <a id="constant-LAYOUT_NAME"></a> <a id="LAYOUT_NAME-constant"></a>
+Not documented.
+
+### `ROOT` <a id="constant-ROOT"></a> <a id="ROOT-constant"></a>
+Not documented.
+
+### `VERSION` <a id="constant-VERSION"></a> <a id="VERSION-constant"></a>
+Not documented.
+
+# Documentation
+
+- [Slides/Assets/SiteAssetFile.md](Slides/Assets/SiteAssetFile.md)
+- [Slides/Assets.md](Slides/Assets.md)
+- [Slides/ComponentRenderer/RenderedDocument.md](Slides/ComponentRenderer/RenderedDocument.md)
+- [Slides/ComponentRenderer.md](Slides/ComponentRenderer.md)
+- [Slides/JekyllIntegration.md](Slides/JekyllIntegration.md)
+- [Slides/Layout.md](Slides/Layout.md)
+- [Slides/Presentation.md](Slides/Presentation.md)
+- [Slides/PresentationParser.md](Slides/PresentationParser.md)
+- [Slides/RangeParser.md](Slides/RangeParser.md)
+- [Slides/Renderer.md](Slides/Renderer.md)
+- [Slides/RougeRenderer.md](Slides/RougeRenderer.md)
+- [Slides/SlideMetadata.md](Slides/SlideMetadata.md)
+- [Slides/SlideRenderer.md](Slides/SlideRenderer.md)
+- [Slides/Support.md](Slides/Support.md)

data/doc/Jekyll.md

@@ -0,0 +1,5 @@
+# Module Jekyll <a id="module-Jekyll"></a>
+
+|  |  |
+| --- | --- |
+| **Defined in** | lib/jekyll/slides.rb, lib/jekyll/slides/assets.rb, lib/jekyll/slides/layout.rb, lib/jekyll/slides/support.rb, lib/jekyll/slides/version.rb, lib/jekyll/slides/renderer.rb, lib/jekyll/slides/presentation.rb, lib/jekyll/slides/range_parser.rb, lib/jekyll/slides/rouge_renderer.rb, lib/jekyll/slides/slide_metadata.rb, lib/jekyll/slides/slide_renderer.rb, lib/jekyll/slides/component_renderer.rb, lib/jekyll/slides/jekyll_integration.rb, lib/jekyll/slides/presentation_parser.rb |

data/doc/README.md

@@ -0,0 +1,180 @@
+# Jekyll Slides
+
+`jekyll-slides` turns one Markdown page into a polished, accessible 16:9 presentation. It is a plugin that supplies its own presentation layout and assets without replacing the site's theme.
+
+## Install
+
+Add the gem and plugin to the site:
+
+```ruby
+# Gemfile
+gem "jekyll-slides"
+```
+
+```yaml
+# _config.yml
+plugins:
+  - jekyll-slides
+```
+
+Keep the site's existing `theme:` setting, if any. The plugin provides the `presentation` layout itself; a site-local layout or asset with the same path takes precedence.
+
+Run `bundle install`, then `bundle exec jekyll serve`. The gem supports Ruby 3.1+ and Jekyll 4.3–4.x. Use Jekyll 4.4 or newer with Ruby 3.4 or newer; Jekyll 4.3 relies on libraries that those Ruby versions no longer bundle.
+
+## Author a deck
+
+Set `layout: presentation` in the page front matter. YAML front matter is the first `---` pair and belongs to the page; every later line containing only `---` separates slides. A separator inside a fenced code block is code, not a slide break. Because exact `---` lines are separators, setext level-two headings are not supported in decks; use `## Heading` instead.
+
+```markdown
+---
+layout: presentation
+title: A short talk
+---
+
+<!--
+layout: title
+background: gradient
+-->
+# A short talk
+
+---
+
+<!--
+layout: content
+-->
+# The idea
+
+One clear thought per slide.
+```
+
+Slide comments are optional. Supported layouts are `title`, `statement`, `content`, `code`, `code-left`, `code-right`, `split-code`, and `code-result`. Without a comment, layout is inferred: the first text slide is a title, code/editor slides become code layouts, editor pairs become split-code, and an editor plus terminal becomes code-result.
+
+Supported backgrounds are `plain`, `gradient`, `grid`, and `spotlight`. Add `class: my-class` in the comment for a custom slide class:
+
+```html
+<!--
+layout: statement
+background: spotlight
+class: keynote
+-->
+```
+
+## Editors and terminals
+
+Put a kramdown inline attribute list immediately after a fenced block. Attribute values must be quoted; class and ID tokens such as `.editor` and `#order-total` do not need quotes. `.editor` renders a syntax-highlighted editor window; `.terminal` renders a terminal window.
+
+````markdown
+```ruby
+class Order
+  def total
+    items.sum(&:price)
+  end
+end
+```
+{: .editor #order-total title="app/models/order.rb" size="lg" focus="2-4" highlight="3" line_numbers="true"}
+
+```text
+$ bundle exec ruby -v
+ruby 3.4.1
+```
+{: .terminal #ruby-version title="terminal" size="sm"}
+````
+
+Editor/terminal attributes are `title`, `id` (or `#id`), `size` (`sm`, `md`, `lg`), `line_numbers` (`true`/`false`), `focus`, and `highlight`. Ranges accept comma-separated lines and ranges such as `2,4-6,9`; invalid values fall back safely with a Jekyll warning. Terminal prompts beginning with `$ `, `> `, or `❯ ` are styled separately. Source remains server-rendered and copyable.
+
+Long editor and terminal blocks scroll within the slide. Blocks over 20 lines produce an advisory build warning; the amount that fits depends on the layout and font size. Split long examples across slides for print, where scrolling is unavailable.
+
+Liquid runs before slide rendering, just as it does on ordinary Jekyll pages. Wrap examples that contain Liquid syntax in `{% raw %}` and `{% endraw %}`. Because each slide is converted as one Markdown document, the raw block may surround an editor fence without being separated from it.
+
+Code remains selectable and copyable with normal browser controls; version 0.1 does not add a copy button.
+
+## Themes and configuration
+
+Presentation themes are `minimal-light`, `minimal-dark`, `midnight` (the default), and `ruby`. These style the slides without replacing the site's Jekyll theme. Configure defaults under `slides:`:
+
+```yaml
+slides:
+  theme: midnight
+  aspect_ratio: "16:9"
+  progress: true
+  slide_numbers: true
+  overview: true
+  fullscreen: true
+```
+
+The same keys can be overridden per presentation in front matter (`theme`, `aspect_ratio`, `progress`, `slide_numbers`, `overview`, and `fullscreen`), including Jekyll's scoped `defaults:` for pages and collection documents. The runtime currently supports the fixed `16:9` aspect ratio; invalid values use the safe default. Always quote `"16:9"` in YAML to prevent it from being parsed as a number.
+
+For a light presentation, set `slides: { theme: minimal-light }` in `_config.yml`, or `theme: minimal-light` in the deck's front matter. The [readability example](https://github.com/lucianghinda/jekyll-slides/blob/main/examples/readability.md) demonstrates the light theme with code, terminal output, tables, and prose.
+
+## Typography and readability
+
+The gem bundles Atkinson Hyperlegible Next for text and Atkinson Hyperlegible Mono for code, including variable upright and italic faces. Fonts load from the site's own assets and work offline. The font files retain their SIL Open Font License; source revisions, checksums, and notices are in [assets/fonts](https://github.com/lucianghinda/jekyll-slides/blob/main/assets/fonts/README.md).
+
+On the 1920×1080 slide canvas, body text is 44px, section headings are 72px, and code sizes `sm`, `md`, and `lg` are 32px, 38px, and 42px. These sizes scale with the slide. Filenames and line numbers remain readable, and focused lines use borders and background color while keeping surrounding code fully visible. All four themes check syntax-token contrast against normal, highlighted, and focused code surfaces.
+
+Prefer medium or large code and short examples for projection. Long blocks can scroll, but an audience cannot reveal hidden lines independently; split examples when presenting or printing. Screen contrast tests do not replace checking the actual projector and viewing distance.
+
+## Navigation and accessibility
+
+Use `ArrowLeft`/`ArrowRight`, `PageUp`/`PageDown`, `Home`, and `End` to navigate. `Space` advances, `O` toggles overview, and `F` toggles fullscreen. The current slide is synchronized in the URL hash (`#3` for slide three), so links and browser history work. The controls include accessible labels and focus states; reduced-motion preferences are respected. Print the deck with the browser print dialog (slides are paginated and chrome is hidden). If JavaScript is disabled, all slides remain in document order as complete aspect-ratio frames with readable content.
+
+## Demo and development
+
+In a repository checkout (the demo is intentionally not included in the runtime gem), build the included ten-slide refactoring story:
+
+```sh
+cd examples
+bundle install
+bundle exec jekyll build --source . --destination _site
+```
+
+From the gem directory, run `bundle install` and `npm ci`, then `bundle exec rake` to run Ruby tests, JavaScript tests, the Tailwind build and CSS contract tests, gem verification, and the example build. The demo can also be served with `bundle exec jekyll serve --source examples --destination examples/_site`.
+
+Tailwind source is in `src/css`; the committed runtime stylesheet is `assets/css/presentation.css`:
+
+```sh
+npm install
+npm run build:css
+npm run dev:css
+npm run test:javascript
+npm run test:css
+```
+
+Users do not need Node or Tailwind at runtime; they are development tools for this repository.
+
+## Generated documentation
+
+Generate Markdown API documentation and the LLM index from the Ruby source:
+
+```sh
+bundle exec rake docs
+```
+
+This replaces `doc/` with fresh YARD Markdown, updates the documentation index in
+`doc/Jekyll/Slides.md`, and writes `llm.txt` with links relative to the gem root.
+The generated files are checked in and shipped with the gem. Internal plans,
+temporary files, and Node dependencies are excluded. YARD and `yard-markdown`
+are development tools only.
+
+For the individual steps, run `bundle exec rake yard`, then
+`ruby bin/generate_llm.rb`. To verify everything, regenerate documentation, and
+build the versioned gem and SHA-256 checksum in `pkg/`, run:
+
+```sh
+bin/prepare_release
+```
+
+Release preparation stops if a check or generation step fails. It does not
+commit, tag, push, or publish the gem.
+
+Rendering and toolchain decisions that should not be re-derived casually are recorded in the [architecture decision record](https://github.com/lucianghinda/jekyll-slides/blob/main/docs/architecture-decisions.md).
+
+Maintainers can follow the [release instructions](https://github.com/lucianghinda/jekyll-slides/blob/main/docs/releasing.md) to verify, build, tag, and publish a gem.
+
+## 0.1 limitations and extension
+
+Version 0.1 intentionally supports Markdown/Kramdown, a fixed 16:9 canvas, the curated layouts/themes above, and a small dependency-free browser runtime. It does not provide speaker notes, transitions, nested slide sections, a theme editor, or an authoring UI. JavaScript is enhancement-only; server-side HTML is the source of truth.
+
+The plugin injects its `_layouts`, `_includes`, and `assets` into Jekyll without participating in theme resolution. A site can override the `presentation` layout, any `slides/*` include, or either compiled asset by placing a file with the same path in its own source tree. Copy the stylesheet only when you need a complete CSS fork; otherwise add a custom slide class and site CSS after the gem stylesheet. Keep `plugins: [jekyll-slides]` enabled even when overriding the layout so Markdown rendering and normalized slide settings remain active.
+
+Released under the Apache-2.0 license.

data/doc/index.csv

@@ -0,0 +1,71 @@
+name,type,path
+README.md,File,README.md
+CHANGELOG.md,File,CHANGELOG.md
+Jekyll,Module,Jekyll.md
+Jekyll::Slides,Module,Jekyll/Slides.md
+Jekyll::Slides.ROOT,Constant,Jekyll/Slides.md#constant-ROOT
+Jekyll::Slides.LAYOUT_NAME,Constant,Jekyll/Slides.md#constant-LAYOUT_NAME
+Jekyll::Slides.VERSION,Constant,Jekyll/Slides.md#constant-VERSION
+Jekyll::Slides::Assets,Module,Jekyll/Slides/Assets.md
+Jekyll::Slides::Assets.asset_files,Method,Jekyll/Slides/Assets.md#method-c-asset_files
+Jekyll::Slides::Assets.install,Method,Jekyll/Slides/Assets.md#method-c-install
+Jekyll::Slides::Support,Module,Jekyll/Slides/Support.md
+Jekyll::Slides::Support.escape,Method,Jekyll/Slides/Support.md#method-c-escape
+Jekyll::Slides::Support.warn,Method,Jekyll/Slides/Support.md#method-c-warn
+Jekyll::Slides::JekyllIntegration,Module,Jekyll/Slides/JekyllIntegration.md
+Jekyll::Slides::JekyllIntegration.DEFAULTS,Constant,Jekyll/Slides/JekyllIntegration.md#constant-DEFAULTS
+Jekyll::Slides::JekyllIntegration.THEMES,Constant,Jekyll/Slides/JekyllIntegration.md#constant-THEMES
+Jekyll::Slides::JekyllIntegration.BOOLEAN_OPTIONS,Constant,Jekyll/Slides/JekyllIntegration.md#constant-BOOLEAN_OPTIONS
+Jekyll::Slides::JekyllIntegration.OPTION_KEYS,Constant,Jekyll/Slides/JekyllIntegration.md#constant-OPTION_KEYS
+Jekyll::Slides::JekyllIntegration.install!,Method,Jekyll/Slides/JekyllIntegration.md#method-c-install-21
+Jekyll::Slides::JekyllIntegration.process,Method,Jekyll/Slides/JekyllIntegration.md#method-c-process
+Jekyll::Slides::JekyllIntegration.process_site,Method,Jekyll/Slides/JekyllIntegration.md#method-c-process_site
+Jekyll::Slides::Assets::SiteAssetFile,Class,Jekyll/Slides/Assets/SiteAssetFile.md
+Jekyll::Slides::Assets::SiteAssetFile.write,Method,Jekyll/Slides/Assets/SiteAssetFile.md#method-i-write
+Jekyll::Slides::Layout,Class,Jekyll/Slides/Layout.md
+Jekyll::Slides::Layout.initialize,Method,Jekyll/Slides/Layout.md#method-i-initialize
+Jekyll::Slides::Renderer,Class,Jekyll/Slides/Renderer.md
+Jekyll::Slides::Renderer.convert,Method,Jekyll/Slides/Renderer.md#method-i-convert
+Jekyll::Slides::Presentation,Class,Jekyll/Slides/Presentation.md
+Jekyll::Slides::Presentation.initialize,Method,Jekyll/Slides/Presentation.md#method-i-initialize
+Jekyll::Slides::Presentation.render,Method,Jekyll/Slides/Presentation.md#method-i-render
+Jekyll::Slides::RangeParser,Class,Jekyll/Slides/RangeParser.md
+Jekyll::Slides::RangeParser.MAX_RANGE_SIZE,Constant,Jekyll/Slides/RangeParser.md#constant-MAX_RANGE_SIZE
+Jekyll::Slides::RangeParser.initialize,Method,Jekyll/Slides/RangeParser.md#method-i-initialize
+Jekyll::Slides::RangeParser.parse,Method,Jekyll/Slides/RangeParser.md#method-i-parse
+Jekyll::Slides::RangeParser.parse,Method,Jekyll/Slides/RangeParser.md#method-c-parse
+Jekyll::Slides::RougeRenderer,Class,Jekyll/Slides/RougeRenderer.md
+Jekyll::Slides::RougeRenderer.initialize,Method,Jekyll/Slides/RougeRenderer.md#method-i-initialize
+Jekyll::Slides::RougeRenderer.render,Method,Jekyll/Slides/RougeRenderer.md#method-i-render
+Jekyll::Slides::RougeRenderer.render_lines,Method,Jekyll/Slides/RougeRenderer.md#method-i-render_lines
+Jekyll::Slides::SlideMetadata,Class,Jekyll/Slides/SlideMetadata.md
+Jekyll::Slides::SlideMetadata.LAYOUTS,Constant,Jekyll/Slides/SlideMetadata.md#constant-LAYOUTS
+Jekyll::Slides::SlideMetadata.BACKGROUNDS,Constant,Jekyll/Slides/SlideMetadata.md#constant-BACKGROUNDS
+Jekyll::Slides::SlideMetadata.KEYS,Constant,Jekyll/Slides/SlideMetadata.md#constant-KEYS
+Jekyll::Slides::SlideMetadata.initialize,Method,Jekyll/Slides/SlideMetadata.md#method-i-initialize
+Jekyll::Slides::SlideMetadata.parse,Method,Jekyll/Slides/SlideMetadata.md#method-i-parse
+Jekyll::Slides::SlideMetadata.parse,Method,Jekyll/Slides/SlideMetadata.md#method-c-parse
+Jekyll::Slides::SlideMetadata.background,Attribute,Jekyll/Slides/SlideMetadata.md#attribute-i-background
+Jekyll::Slides::SlideMetadata.content,Attribute,Jekyll/Slides/SlideMetadata.md#attribute-i-content
+Jekyll::Slides::SlideMetadata.custom_class,Attribute,Jekyll/Slides/SlideMetadata.md#attribute-i-custom_class
+Jekyll::Slides::SlideMetadata.layout,Attribute,Jekyll/Slides/SlideMetadata.md#attribute-i-layout
+Jekyll::Slides::SlideMetadata.values,Attribute,Jekyll/Slides/SlideMetadata.md#attribute-i-values
+Jekyll::Slides::SlideRenderer,Class,Jekyll/Slides/SlideRenderer.md
+Jekyll::Slides::SlideRenderer.initialize,Method,Jekyll/Slides/SlideRenderer.md#method-i-initialize
+Jekyll::Slides::SlideRenderer.render,Method,Jekyll/Slides/SlideRenderer.md#method-i-render
+Jekyll::Slides::ComponentRenderer,Class,Jekyll/Slides/ComponentRenderer.md
+Jekyll::Slides::ComponentRenderer.FRAGMENT_PATTERN,Constant,Jekyll/Slides/ComponentRenderer.md#constant-FRAGMENT_PATTERN
+Jekyll::Slides::ComponentRenderer.SIZES,Constant,Jekyll/Slides/ComponentRenderer.md#constant-SIZES
+Jekyll::Slides::ComponentRenderer.LONG_CODE_LINE_THRESHOLD,Constant,Jekyll/Slides/ComponentRenderer.md#constant-LONG_CODE_LINE_THRESHOLD
+Jekyll::Slides::ComponentRenderer.initialize,Method,Jekyll/Slides/ComponentRenderer.md#method-i-initialize
+Jekyll::Slides::ComponentRenderer.render,Method,Jekyll/Slides/ComponentRenderer.md#method-i-render
+Jekyll::Slides::ComponentRenderer.render_document,Method,Jekyll/Slides/ComponentRenderer.md#method-i-render_document
+Jekyll::Slides::ComponentRenderer.render_fragments,Method,Jekyll/Slides/ComponentRenderer.md#method-i-render_fragments
+Jekyll::Slides::ComponentRenderer.render,Method,Jekyll/Slides/ComponentRenderer.md#method-c-render
+Jekyll::Slides::ComponentRenderer::RenderedDocument,Class,Jekyll/Slides/ComponentRenderer/RenderedDocument.md
+Jekyll::Slides::ComponentRenderer::RenderedDocument.components,Attribute,Jekyll/Slides/ComponentRenderer/RenderedDocument.md#attribute-i-components
+Jekyll::Slides::ComponentRenderer::RenderedDocument.fragments,Attribute,Jekyll/Slides/ComponentRenderer/RenderedDocument.md#attribute-i-fragments
+Jekyll::Slides::PresentationParser,Class,Jekyll/Slides/PresentationParser.md
+Jekyll::Slides::PresentationParser.initialize,Method,Jekyll/Slides/PresentationParser.md#method-i-initialize
+Jekyll::Slides::PresentationParser.parse,Method,Jekyll/Slides/PresentationParser.md#method-i-parse
+Jekyll::Slides::PresentationParser.parse,Method,Jekyll/Slides/PresentationParser.md#method-c-parse

data/lib/jekyll/slides/assets.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Slides
+    module Assets
+      class SiteAssetFile < Jekyll::StaticFile
+        def write(dest)
+          return false if site_item_claims_destination?(dest)
+
+          super
+        end
+
+        private
+
+        def site_item_claims_destination?(dest)
+          site_items.any? do |item|
+            item.write? && item.destination(dest) == destination(dest)
+          end
+        end
+
+        def site_items
+          @site.pages + @site.documents
+        end
+      end
+
+      module_function
+
+      def install(site)
+        asset_files.each do |path|
+          relative_path = path.delete_prefix("#{ROOT}/")
+          next if site.static_files.any? { |file| file.relative_path.delete_prefix("/") == relative_path }
+
+          site.static_files << SiteAssetFile.new(
+            site,
+            ROOT,
+            File.dirname(relative_path),
+            File.basename(relative_path)
+          )
+        end
+      end
+
+      def asset_files
+        Dir[File.join(ROOT, "assets", "**", "*")].select { |path| File.file?(path) }.sort
+      end
+    end
+  end
+end