microsoft/hve-core

---
description: 'Global style YAML schema template with dimensions, layout mappings, metadata, and defaults'
---

# Style YAML Template

Use this template when creating or updating the `global/style.yaml` file for a slide deck. This file defines dimensions, template configuration, layout mappings, metadata, defaults, and theme information.

## Instructions

* Place this file at `content/global/style.yaml` within the working directory.
* Dimensions control the slide canvas size. Standard 16:9 is 13.333" x 7.5".
* Template and layout configuration is optional and used with template-based builds.
* Metadata fields populate the presentation file properties.
* Defaults define per-element-type styling fallbacks.
* The `themes` section (populated during extraction) describes detected visual themes across the deck for contextual reference.

## Template

```yaml
# Slide dimensions
dimensions:
  width_inches: 13.333
  height_inches: 7.5
  format: "16:9"

# Template configuration (optional)
template:
  path: "template.pptx"            # path to template PPTX file
  preserve_dimensions: true         # keep template slide dimensions

# Layout mapping (optional, used with templates)
layouts:
  title: "Title Slide"             # content.yaml layout name -> PowerPoint layout name
  content: "Title and Content"
  section: "Section Header"
  blank: 6                          # integer index fallback

# Presentation metadata (optional)
metadata:
  title: "HVE Workshop Deck"
  author: "Allen Greaves"
  subject: "AI-Assisted Engineering"
  keywords: "HVE, Copilot, AI"
  category: "Presentation"

# Default element styling
defaults:
  title_bar:
    height_inches: 0.05
    color: "#0078D4"
    top_inches: 0
  accent_bar:
    height_inches: 0.03
    color: "#0078D4"
  card:
    fill: "#2D2D35"
    corner_radius_inches: 0.15
    border_color: "#3D3D45"
    border_width_pt: 1
  speaker_notes_required: true

# Detected visual themes (populated during extraction)
themes:
  - name: "light"
    slides: [1, 3, 5]
    colors:
      text_primary: "#1A1A2E"
      text_secondary: "#6B6B7B"
      bg_card: "#E8E8F0"
  - name: "dark"
    slides: [2, 4, 6]
    colors:
      bg_dark: "#1A1A2E"
      text_primary: "#FFFFFF"
      text_secondary: "#B0B0C0"
      bg_card: "#2D2D35"
```

## Field Reference

| Section | Field | Description |
|---|---|---|
| `dimensions` | `width_inches`, `height_inches` | Slide canvas size in inches |
| `dimensions` | `format` | Aspect ratio label (informational) |
| `template` | `path` | Path to a template PPTX file for themed builds |
| `template` | `preserve_dimensions` | Keep the template's slide dimensions when `true` |
| `layouts` | `<name>: <layout>` | Maps content.yaml layout names to PowerPoint layout names or indices |
| `metadata` | `title` | Presentation title set in file properties |
| `metadata` | `author` | Presentation author |
| `metadata` | `subject` | Presentation subject |
| `metadata` | `keywords` | Presentation keywords |
| `metadata` | `category` | Presentation category |
| `defaults` | `title_bar`, `accent_bar` | Default bar dimensions and colors (`#RRGGBB` hex) |
| `defaults` | `card` | Default card fill, corner radius, and border |
| `defaults` | `speaker_notes_required` | Whether speaker notes are enforced during validation |
| `themes[]` | `name` | Theme identifier (`light` or `dark`) |
| `themes[]` | `slides` | Sorted list of slide numbers belonging to this theme |
| `themes[]` | `colors` | Role-to-hex color map (`text_primary`, `text_secondary`, `bg_card`, `bg_dark`) |

*🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.*