@stonedeck/html-plugin 0.7.5 → 0.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +61 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,61 @@
1
+ # @stonedeck/html-plugin
2
+
3
+ > Export StoneDeck presentations to HTML
4
+
5
+ ## What is this?
6
+
7
+ This package takes a StoneDeck presentation and turns it into interactive HTML slides - no internet required, works in any browser.
8
+
9
+ **You probably don't need to use this directly** - the [@stonedeck/cli](../cli) already includes this.
10
+
11
+ ## When to use this
12
+
13
+ Use this package if you're building custom tooling and need to programmatically generate HTML from StoneDeck presentations.
14
+
15
+ ## Quick Example
16
+
17
+ ```typescript
18
+ import { processStoneDeck } from '@stonedeck/core';
19
+ import { HtmlPlugin } from '@stonedeck/html-plugin';
20
+ import * as fs from 'fs';
21
+
22
+ // 1. Process your markdown
23
+ const markdown = fs.readFileSync('slides.md', 'utf-8');
24
+ const presentation = processStoneDeck(markdown, 'slides.md');
25
+
26
+ // 2. Convert to HTML
27
+ const plugin = new HtmlPlugin();
28
+ const html = plugin.export(presentation);
29
+
30
+ // 3. Save it
31
+ fs.writeFileSync('slides.html', html);
32
+ ```
33
+
34
+ ## What you get
35
+
36
+ The HTML file includes:
37
+ - All your slides, ready to present
38
+ - Navigation buttons (Previous/Next)
39
+ - Keyboard controls (arrow keys work!)
40
+ - Print-friendly styles for PDF export
41
+ - Everything embedded (no internet needed)
42
+
43
+ ## Creating PDFs
44
+
45
+ 1. Open the HTML file in Chrome/Firefox/Edge
46
+ 2. Press Ctrl+P (or Cmd+P on Mac)
47
+ 3. Choose "Save as PDF"
48
+ 4. Make sure "Background graphics" is enabled
49
+ 5. Save!
50
+
51
+ ## Need help?
52
+
53
+ Check the main [StoneDeck documentation](../../README.md)
54
+
55
+ ## Repository
56
+
57
+ [https://github.com/matheuspellisoli/StoneDeck](https://github.com/matheuspellisoli/StoneDeck)
58
+
59
+ ## License
60
+
61
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stonedeck/html-plugin",
3
- "version": "0.7.5",
3
+ "version": "0.7.6",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -21,4 +21,4 @@
21
21
  "typescript": "^5.0.0",
22
22
  "@types/node": "^20.0.0"
23
23
  }
24
- }
24
+ }