@workshops.de/slidev-theme
v2.1.0
Published
[](https://www.npmjs.com/package/@workshops.de/slidev-theme)
Readme
@workshops.de/slidev-theme
A theme for workshops held by workshops.de.
Install
Add the following frontmatter to your slides.md. Start Slidev then it will prompt you to install the theme automatically.
Learn more about how to use a theme.
Layouts
This theme provides and overrides the following layouts:
| Layout | Description |
| ----------------- | --------------------------------------------------------------------------- |
| cover | Title slide with tech logo slot, centered title/subtitle, and logo footer. |
| section | Section divider with "Section" badge and centered content. |
| sub-section | Section divider with left accent border for nested sections. |
| task | Task slide with orange "Task" badge and left-aligned content. |
| little-what | Short primer slide with silver badge and left-aligned content. |
| why | Rationale slide with purple badge and left-aligned content. |
| what-if | Hypothetical slide with red badge and left-aligned content. |
| ask-me-anything | Centered big prompt for open Q&A. |
| default | Overrides Slidev default layout to use the theme surface. |
| two-cols | Overrides Slidev two-column layout to use the theme surface. |
| two-cols-header | Overrides two-column-header layout to use the theme surface. |
| image-left | Overrides image-left layout to use the theme surface on the text side. |
| image-right | Overrides image-right layout to use the theme surface on the text side. |
| end | Overrides end layout with the theme surface and centered "END" text. |
Layout usage
All layouts share a unified surface component (SectionSurface) and color variants matching SectionBadge. The default variant is blue.
Example:
Components
This theme provides the following components:
| Component | Description |
| ---------------- | ----------------------------------------------------- |
| SectionSurface | Base surface used by all layouts, with color variants |
| SectionBadge | Badge with matching color variants |
| Callout | Callout box with info/tip/important/warning/caution |
| SlideFooter | Footer component with workshops.de logo |
| WorkshopsLogo | SVG component for the workshops.de logo |
Contributing
npm installnpm run devto start theme preview ofexample.md- Edit the
example.mdand style to see the changes npm run exportto generate the preview PDFnpm run screenshotto generate the preview PNG
