You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Move generators to html-generators/, add pre-built fat JAR
- Move generate.java and generate.py to html-generators/
- Add pre-built generate.jar (2.2MB fat JAR with Jackson bundled)
- Add build-generator.yml workflow to auto-rebuild JAR on changes
- Update deploy.yml to use fat JAR (no JBang/cache needed)
- Add html-generators/README.md with usage instructions
- Update all references in README, copilot-instructions, workflows
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
# Generate all HTML pages and data/snippets.json into site/
57
-
jbang generate.java
56
+
java -jar html-generators/generate.jar
58
57
59
58
# Serve locally
60
59
python3 -m http.server -d site 8090
61
60
# Open http://localhost:8090
62
61
```
63
62
64
-
The generator is a compact source file (Java 25) that uses Jackson for JSON parsing. On first run, JBang resolves the Jackson dependency (~2s); subsequent runs use a cached jar (~0.8s).
63
+
The fat JAR is a self-contained ~2.2 MB file with all dependencies bundled. No JBang installation needed.
65
64
66
-
A Python equivalent (`generate.py`) is also available and produces identical output:
67
-
68
-
```bash
69
-
python3 generate.py
70
-
```
65
+
For development on the generator itself, you can use JBang or Python — see [html-generators/README.md](html-generators/README.md) for details.
71
66
72
67
## Contributing
73
68
@@ -76,7 +71,7 @@ Contributions are welcome! Content is managed as JSON files — never edit gener
76
71
1. Fork the repo
77
72
2. Create or edit a JSON file in the appropriate content folder (e.g. `content/language/my-feature.json`)
78
73
3. Follow the [snippet JSON schema](.github/copilot-instructions.md) for all required fields
79
-
4. Run `jbang generate.java` to verify your changes build correctly
74
+
4. Run `java -jar html-generators/generate.jar` to verify your changes build correctly
80
75
5. Update `site/index.html` with a new preview card if adding a new snippet
This produces a self-contained ~2.2 MB JAR with all dependencies (Jackson) bundled. The `build-generator.yml` GitHub Action does this automatically when `generate.java` changes.
0 commit comments