@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.
- package/README.md +61 -0
- 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