{"id":15089152,"url":"https://github.com/sea-grass/goku","last_synced_at":"2025-03-21T14:17:31.669Z","repository":{"id":251995231,"uuid":"839030090","full_name":"sea-grass/goku","owner":"sea-grass","description":"A Static Site Generator written in Zig.","archived":false,"fork":false,"pushed_at":"2025-03-20T21:31:31.000Z","size":827,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T22:05:35.903Z","etag":null,"topics":["markdown","static-site-generator","yaml","zig","zig-package"],"latest_commit_sha":null,"homepage":"http://christophergrass.com/goku/","language":"Zig","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/sea-grass.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-08-06T20:30:30.000Z","updated_at":"2025-03-20T21:31:12.000Z","dependencies_parsed_at":"2024-11-26T06:19:08.669Z","dependency_job_id":"15af3dcd-12b5-436c-81d2-152d9a0d71b7","html_url":"https://github.com/sea-grass/goku","commit_stats":{"total_commits":83,"total_committers":1,"mean_commits":83.0,"dds":0.0,"last_synced_commit":"0c5af078e68d946096e9363b1dbedd0e9eddee93"},"previous_names":["sea-grass/goku"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-grass%2Fgoku","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-grass%2Fgoku/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-grass%2Fgoku/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-grass%2Fgoku/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sea-grass","download_url":"https://codeload.github.com/sea-grass/goku/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244811375,"owners_count":20514276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["markdown","static-site-generator","yaml","zig","zig-package"],"created_at":"2024-09-25T08:41:21.866Z","updated_at":"2025-03-21T14:17:31.629Z","avatar_url":"https://github.com/sea-grass.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Goku\n\nGoku is a Static Site Generator written in Zig.\n\n## Introduction\n\nA static site generator (SSG) is typically run on some input source to produce a folder of html files, suitable for hosting on any HTTP server. Goku aims to be a SSG that can operate on a variety of input sources to generate static sites of up to hundreds of thousands of pages.\n\n## Notice\n\n\u003e [!NOTE]  \n\u003e Goku is in its early stages. The roadmap for features is prioritized on an as-needed basis. If you want to use Goku but it's lacking a key feature you need, feel free to check out the [contributing](#contributing) section of the readme.\n\n## Requirements\n\n- Officially supported Zig: `0.14.0-dev.1710+8ee52f99c` (you can get it from the [Zig Releases page](https://ziglang.org/download/))\n\n## Installation\n\nUse Zig to build the application binary. With a shell open in this project's directory:\n\n```\nzig build -Doptimize=ReleaseSafe\n```\n\nThe goku binary will be available at `zig-out/bin/goku`.\n\n## Usage\n\nSee [the docs](./site/pages/docs/site.md) on how to scaffold your first Goku site.\n\nOnce you've set up your site, you can use goku to build it:\n\n```\ngoku site -o build\n```\n\nIn the above example, Goku will scan `site/pages` recursively for all `.md` files, parse their yaml frontmatter for a `slug`, and then place the built sites into the `build` folder according to each page's `slug`. It will provide a build summary with the time elapsed and the source and destination directories.\n\nOnce you've built the site, you can try previewing it on your local machine using your preferred file server. For example, if you have `python3` on your system, you can try:\n\n```\nsh -c 'cd build; python3 -m http.server'\n```\n\n## Further Work\n\nIn its current form, Goku is very basic. There is no support for theming, asset management, etc. If there's a feature you'd like to see, please open a GitHub issue.\n\n## Contributing\n\nContributions are welcome, but I do request that if there's no open GitHub issue regarding your ideal change that you open one first! It's likely that I'm already working on the feature, so following this process helps to ensure that we're not spending double the time.\n\n## Bug reports\n\nIf you find a bug in the software, please report it using the GitHub issue tracker for this project's repository.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsea-grass%2Fgoku","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsea-grass%2Fgoku","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsea-grass%2Fgoku/lists"}