{"id":41595441,"url":"https://github.com/hahwul/hwaro","last_synced_at":"2026-04-26T09:04:25.450Z","repository":{"id":334355314,"uuid":"1136152464","full_name":"hahwul/hwaro","owner":"hahwul","description":"Hwaro (화로) is a lightweight and fast Static Site Generator(SSG) written in Crystal.","archived":false,"fork":false,"pushed_at":"2026-04-25T10:13:45.000Z","size":10659,"stargazers_count":22,"open_issues_count":16,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T10:24:36.509Z","etag":null,"topics":["blog-engine","crystal","hwaro","jinja2","markdown","seo","ssg","static-site-generator"],"latest_commit_sha":null,"homepage":"https://hwaro.hahwul.com","language":"Crystal","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hahwul.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"hahwul"}},"created_at":"2026-01-17T06:44:38.000Z","updated_at":"2026-04-25T10:08:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hahwul/hwaro","commit_stats":null,"previous_names":["hahwul/hwaro"],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/hahwul/hwaro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahwul%2Fhwaro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahwul%2Fhwaro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahwul%2Fhwaro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahwul%2Fhwaro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hahwul","download_url":"https://codeload.github.com/hahwul/hwaro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hahwul%2Fhwaro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32291347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T08:29:33.829Z","status":"ssl_error","status_checked_at":"2026-04-26T08:29:18.366Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog-engine","crystal","hwaro","jinja2","markdown","seo","ssg","static-site-generator"],"created_at":"2026-01-24T10:06:22.864Z","updated_at":"2026-04-26T09:04:25.445Z","avatar_url":"https://github.com/hahwul.png","language":"Crystal","funding_links":["https://github.com/sponsors/hahwul"],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Hwaro Logo\" src=\"docs/static/hwaro-wide.webp\" width=\"500px;\"\u003e\n  \u003cp\u003eA lightweight and fast static site generator written in Crystal.\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/hahwul/hwaro/blob/main/CONTRIBUTING.md\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/CONTRIBUTIONS-WELCOME-000000?style=for-the-badge\u0026labelColor=black\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/hahwul/hwaro/releases\"\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/hahwul/hwaro?style=for-the-badge\u0026color=black\u0026labelColor=black\u0026logo=web\"\u003e\u003c/a\u003e\n\u003ca href=\"https://crystal-lang.org\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Crystal-000000?style=for-the-badge\u0026logo=crystal\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hwaro.hahwul.com/start/\"\u003eDocumentation\u003c/a\u003e •\n  \u003ca href=\"https://hwaro.hahwul.com/start/installation/\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"https://hwaro.hahwul.com/deploy/github-pages/\"\u003eGithub Action\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"CHANGELOG.md\"\u003eChangelog\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nHwaro processes Markdown content with TOML, YAML, or JSON front matter and Jinja2-compatible templates (Crinja) to build high-performance static sites. It features parallel builds, incremental caching, and a built-in dev server with live reload.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFeatures\u003c/strong\u003e\u003c/summary\u003e\n\n### Content \u0026 Templating\n- Markdown with TOML/YAML/JSON front matter\n- Jinja2 templates (inheritance, includes, macros)\n- Markdown extensions: task lists, footnotes, definition lists, math (KaTeX/MathJax), Mermaid diagrams, emoji, etc\n- Built-in shortcodes (YouTube, Vimeo, Gist, Alert, Figure, Tweet, CodePen) and custom shortcode support\n- Syntax highlighting via Highlight.js\n- Table of contents (TOC) generation\n- Reading time and word count\n- Content summaries via `\u003c!-- more --\u003e` marker\n- Non-markdown content file publishing\n\n### Content Management\n- Draft, scheduled, and expiring post support\n- URL aliases and redirects\n- Archetypes for content scaffolding templates\n- Data files (YAML, JSON, TOML) accessible in templates\n- Author data aggregation and management\n- Page weight and custom sorting (by date, weight, title)\n\n### Build \u0026 Performance\n- Parallel processing and incremental build caching\n- Streaming build mode with memory limits\n- Pre/post build hooks\n- CSS/JS bundling, minification, and content-hash fingerprinting\n- Lazy loading images\n- Environment-specific config (`config.production.toml`, `config.staging.toml`, etc.)\n\n### SEO \u0026 Discovery\n- Auto-generated sitemap, robots.txt, RSS/Atom feeds\n- OpenGraph meta tags and auto-generated OG images (PNG)\n- Twitter Cards and JSON-LD structured data (Article, FAQ, HowTo, Organization, Person)\n- Canonical URLs and hreflang tags\n- `llms.txt` and `AGENTS.md` generation\n- Client-side search index (Fuse.js, ElasticLunr) with CJK tokenization\n\n### Site Features\n- Pagination, taxonomies (tags, categories, custom)\n- Content series and related posts\n- Breadcrumb navigation and previous/next page links\n- Multilingual (i18n) with per-language feeds and search\n- Image processing (resize, responsive images, LQIP blur-up placeholders, dominant color extraction) and auto-generated OG images\n- PWA support (manifest, service worker)\n- AMP page generation\n- Transparent sections for flexible content organization\n\n### Development \u0026 Deployment\n- Dev server with live reload and error overlay\n- Scaffolding with built-in themes (`blog`, `docs`, `blog-dark`, `docs-dark`)\n- Deploy to multiple targets with dry-run support\n- Platform config generation (Netlify, Vercel, Cloudflare Pages, GitHub Pages, GitLab CI)\n- Import from WordPress, Jekyll, Hugo\n- Link checker, config doctor, and front matter format conversion\n\n\u003c/details\u003e\n\n## Installation\n\n### Homebrew\n\n```bash\nbrew tap hahwul/hwaro\nbrew install hwaro\n```\n\n### From source\n\n```bash\n# Clone the repository\ngit clone https://github.com/hahwul/hwaro.git\ncd hwaro\n\n# Install dependencies\nshards install\n\n# Build\nshards build --release --no-debug --production\n```\n\n\u003e For more installation options including Docker and pre-built binaries, see the [Installation Guide](https://hwaro.hahwul.com/start/installation/).\n\n## Contributing\n\nHwaro is an open-source project made with ❤️. If you would like to contribute, please check [CONTRIBUTING.md](CONTRIBUTING.md) and submit a Pull Request.\n\n![](docs/static/CONTRIBUTORS.svg)\n\n## Why \"Hwaro\"?\n\nHwaro (화로) is the Korean word for **Furnace** — the same name used in Minecraft's Korean localization. In the game, the Furnace is an essential tool that transforms raw materials into useful items. Hwaro aims to serve the same role for static sites: feed in your content, and it crafts a complete website.\n\n![](docs/static/images/hwaro-minecraft.webp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahwul%2Fhwaro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhahwul%2Fhwaro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhahwul%2Fhwaro/lists"}