Initial commit

EXAMPLES.md

@@ -0,0 +1,183 @@
+# Usage Examples
+
+## Real-World Examples
+
+### Example 1: Business Plan Report
+```bash
+# Original file: 202510_Alpha_Intelligence_BP.html (71 KB)
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py 202510_Alpha_Intelligence_BP.html
+
+# Output:
+# - 202510_Alpha_Intelligence_BP_fullpage.png (6.1 MB)
+# - 202510_Alpha_Intelligence_BP_fullpage.pdf (1.6 MB, 1 page)
+```
+
+**Result**: Single-page PDF with no page breaks, perfect for online presentation!
+
+### Example 2: Simple Test
+```bash
+# Create test HTML
+echo '<h1>Test</h1><p>Hello World</p>' > test.html
+
+# Convert
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py test.html
+
+# Output:
+# - test_fullpage.png (12 KB)
+# - test_fullpage.pdf (20 KB)
+```
+
+### Example 3: Multi-File Batch Conversion
+```bash
+# Convert all HTML files in a directory
+cd /path/to/html/files
+
+for file in *.html; do
+    echo "Converting $file..."
+    python ~/.claude/skills/html-to-pdf/html_to_long_image.py "$file"
+done
+
+# Check results
+ls -lh *_fullpage.pdf
+```
+
+### Example 4: With Custom Path
+```bash
+# Specify full paths
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py \
+    /Users/yonggao/Documents/report.html
+```
+
+## Integration Examples
+
+### Use in Shell Script
+```bash
+#!/bin/bash
+# convert_reports.sh
+
+HTML_CONVERTER=~/.claude/skills/html-to-pdf/html_to_long_image.py
+
+for report in reports/*.html; do
+    python "$HTML_CONVERTER" "$report"
+    echo "✓ Converted: $report"
+done
+
+echo "All reports converted!"
+```
+
+### Use in Makefile
+```makefile
+# Makefile
+CONVERTER = python ~/.claude/skills/html-to-pdf/html_to_long_image.py
+
+%.pdf: %.html
+	$(CONVERTER) $<
+
+all: report.pdf presentation.pdf
+
+clean:
+	rm -f *_fullpage.pdf *_fullpage.png
+```
+
+### Use in Python Script
+```python
+import subprocess
+import sys
+
+def convert_html_to_pdf(html_file):
+    """Convert HTML to PDF using the skill."""
+    converter = "~/.claude/skills/html-to-pdf/html_to_long_image.py"
+    result = subprocess.run(
+        [sys.executable, converter, html_file],
+        capture_output=True,
+        text=True
+    )
+    return result.returncode == 0
+
+# Usage
+if convert_html_to_pdf("report.html"):
+    print("Success!")
+```
+
+## Comparison with Original Files
+
+| File | Type | Size | Pages | Notes |
+|------|------|------|-------|-------|
+| 202510_Alpha_Intelligence_BP.html | HTML | 71 KB | - | Source file |
+| 202510_Alpha_Intelligence_BP_fullpage.png | PNG | 6.1 MB | 1 | High-quality screenshot |
+| 202510_Alpha_Intelligence_BP_fullpage.pdf | PDF | 1.6 MB | 1 | **Best for viewing** |
+| 202510_Alpha_Intelligence_BP_final.pdf | PDF | 5.7 MB | 22 | Multi-page (with breaks) |
+
+## Performance Data
+
+Based on real usage:
+
+| HTML Size | Processing Time | PNG Size | PDF Size |
+|-----------|----------------|----------|----------|
+| 71 KB | ~5 seconds | 6.1 MB | 1.6 MB |
+| 5 KB | ~3 seconds | 12 KB | 20 KB |
+| 200 KB | ~8 seconds | 15 MB | 4 MB |
+
+## Tips & Tricks
+
+### Optimize for File Size
+The PNG is always larger than the PDF. If you only need the PDF:
+```bash
+# Generate both, then delete PNG
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py report.html
+rm report_fullpage.png
+```
+
+### Preview Before Converting
+```bash
+# Open HTML in browser first
+open report.html
+
+# Then convert
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py report.html
+```
+
+### Auto-open Result
+```bash
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py report.html && \
+    open report_fullpage.pdf
+```
+
+### Check Page Count
+```bash
+python -c "
+from pypdf import PdfReader
+r = PdfReader('report_fullpage.pdf')
+print(f'Pages: {len(r.pages)}')
+"
+```
+
+## Troubleshooting Examples
+
+### Problem: Script not found
+```bash
+# Solution: Use full path
+python ~/.claude/skills/html-to-pdf/html_to_long_image.py file.html
+```
+
+### Problem: Permission denied
+```bash
+# Solution: Make executable
+chmod +x ~/.claude/skills/html-to-pdf/html_to_long_image.py
+```
+
+### Problem: Playwright not installed
+```bash
+# Solution: Install dependencies
+pip install playwright pillow pypdf
+playwright install chromium
+```
+
+### Problem: Content appears cut off
+```bash
+# This is automatically handled by the script which:
+# 1. Scrolls through entire page
+# 2. Waits for animations
+# 3. Forces all content visible
+# No action needed!
+```