{"id":31627011,"url":"https://github.com/thecsw/darkness","last_synced_at":"2026-01-14T21:22:49.251Z","repository":{"id":62980331,"uuid":"467202869","full_name":"thecsw/darkness","owner":"thecsw","description":"The noblest static site generator 🥬","archived":false,"fork":false,"pushed_at":"2026-01-11T21:43:07.000Z","size":17369,"stargazers_count":37,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-12T01:21:47.770Z","etag":null,"topics":["hacktoberfest","orgmode","static-site-generator","website-generation"],"latest_commit_sha":null,"homepage":"https://sandyuraz.com/darkness","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thecsw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-07T17:57:42.000Z","updated_at":"2026-01-11T21:43:11.000Z","dependencies_parsed_at":"2024-01-07T06:44:10.630Z","dependency_job_id":"a3f6f10e-0d6d-428e-b1f6-d9305f0dab03","html_url":"https://github.com/thecsw/darkness","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/thecsw/darkness","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecsw%2Fdarkness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecsw%2Fdarkness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecsw%2Fdarkness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecsw%2Fdarkness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thecsw","download_url":"https://codeload.github.com/thecsw/darkness/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecsw%2Fdarkness/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28434865,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["hacktoberfest","orgmode","static-site-generator","website-generation"],"created_at":"2025-10-06T20:01:05.456Z","updated_at":"2026-01-14T21:22:49.218Z","avatar_url":"https://github.com/thecsw.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# I love Darkness 🥬\n\n![darkness](./darkness.png)\n\n\u003cdiv id='badges' align='center'\u003e\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/thecsw/darkness)](https://goreportcard.com/report/github.com/thecsw/darkness)\n[![GoDoc](https://godoc.org/github.com/thecsw/darkness?status.svg)](https://godoc.org/github.com/thecsw/darkness)\n[![Go CI/CD](https://github.com/thecsw/darkness/actions/workflows/go.yml/badge.svg)](https://github.com/thecsw/darkness/actions/workflows/go.yml)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n\u003c/div\u003e\n\n## Motivation\n\nI have been writing and maintaining [my website](https://sandyuraz.com) for more \nthan five years! Asciidoctor was a nice way to bootstrap quick and good-looking\nweb pages in a matter of minutes. However, my desire for \n[quirky designs](https://sandyuraz.com/blogs/design) and \n[math support](https://sandyuraz.com/blogs/sqrt2irrational), made the issue\nof bulding it [annoyingly complicated](https://sandyuraz.com/blogs/web-legacy).\nI just want a nice website that **can do anything**.\n\n## Darkness\n \nIt is my honor and pleasure to introduce you to [Darkness](https://sandyuraz.com/darkness).\nThe most noble static website generator. To keep the long story short, check out\n[my current website](https://sandyuraz.com), which is dutifully built by Darkness.\n\nShe supports all org mode (and markdown!) formatting, \n[native flex galleries](https://sandyuraz.com/plastic) \n(with automatic blurry previews generations and lazy loading!), \n[full math support](https://sandyuraz.com/blogs/diffeq),\nsocial embeds ([youtube](https://sandyuraz.com/blogs/best_web),\n[spotify](https://sandyuraz.com/blogs/wrapped-2/), etc.),\n[drop caps](https://sandyuraz.com/blogs/cameraman) \n([they look fancy](https://support.microsoft.com/en-us/office/insert-a-drop-cap-817fd19f-40fe-4b73-95e8-f3c0f5e01278)),\n[automatic code highlighting](https://sandyuraz.com/blogs/mira_reddit), and much more 😈\n\nAlso, did I tell you it's **super fast**?\n\n## Performance\n\n```sh\nsandyuraz:source λ darkness build\nProcessed 128 files in 112 ms\nfarewell\n```\n\n*Each* page takes \u003c1ms to process on my 2020 M1 MacBook Pro. With all the IO time included\nas well. Heavily optimized with [komi pools](https://github.com/thecsw/komi),\n[hunting heap moves](https://hmarr.com/blog/go-allocation-hunting/), and\n[heavy profiling](https://sandyuraz.com/blogs/pprof).\n\nYou can play with best performance by tuning parallelization parameters with `-workers N`,\nand other flags you can use by calling `darkness -help`!\n\nHere is a benchmark with `hyperfine` on the same config as above,\n\n```sh\nsandyuraz:source λ hyperfine \"darkness build\"\nBenchmark 1: darkness build\n  Time (mean ± σ):     112.3 ms ±   6.6 ms    [User: 413.7 ms, System: 92.3 ms]\n  Range (min … max):   103.1 ms … 124.3 ms    26 runs\n```\n\n## How to get it\n\nIt's simple! If you have go1.22 installed, you can install it through `go` tool with\n\n```sh\ngo install -v github.com/thecsw/darkness/v3@v3.0.2\n```\n\nOr you can also grab pre-built binaries from the \n[releases page](https://github.com/thecsw/darkness/releases).\n\n## Building your Darkness website\n\nDarkness and I provide you with a template website that you can get a copy of \nthrough the binary! Run the below, which will create a new directory, for example,\nhere called `ishmael`,\n\n```sh\ndarkness new ishmael\n```\n\nGo and run the website locally with `darkness serve` and explore Darkness in action!\n\nHere is the [web version of ishmael](https://sandyuraz.com/ishmael) to browse around!\n\nOkay, **go, go**! I'll see you later 😘\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecsw%2Fdarkness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecsw%2Fdarkness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecsw%2Fdarkness/lists"}