{"id":21631833,"url":"https://github.com/katef/vcl-static-site-generator","last_synced_at":"2026-02-03T06:32:35.070Z","repository":{"id":80763223,"uuid":"186214304","full_name":"katef/vcl-static-site-generator","owner":"katef","description":"Convert a directory of files to VCL","archived":false,"fork":false,"pushed_at":"2020-06-14T00:56:34.000Z","size":6,"stargazers_count":8,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-18T21:52:37.444Z","etag":null,"topics":["fastly","static-site","static-site-generation","static-site-generator","static-website","varnish","vcl","website-generation"],"latest_commit_sha":null,"homepage":null,"language":"VCL","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/katef.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2019-05-12T05:11:33.000Z","updated_at":"2023-08-06T06:30:02.000Z","dependencies_parsed_at":"2023-02-27T18:15:51.266Z","dependency_job_id":null,"html_url":"https://github.com/katef/vcl-static-site-generator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/katef/vcl-static-site-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katef%2Fvcl-static-site-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katef%2Fvcl-static-site-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katef%2Fvcl-static-site-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katef%2Fvcl-static-site-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/katef","download_url":"https://codeload.github.com/katef/vcl-static-site-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katef%2Fvcl-static-site-generator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263679238,"owners_count":23495014,"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":["fastly","static-site","static-site-generation","static-site-generator","static-website","varnish","vcl","website-generation"],"created_at":"2024-11-25T02:15:33.587Z","updated_at":"2026-02-03T06:32:35.001Z","avatar_url":"https://github.com/katef.png","language":"VCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kate's static website generator\n\nI don't want to run a web server because my sites are such low traffic that they'd always\nbe absent from cache, and need fetching every time. But code is free, so I made a static\nsite generator to convert a directory of files to a VCL table, and index it by URL.\n\nThis isn't a generator so much as an uploader. You need to provide your own directory\nof files.\n\n## Features\n\n- 404 page\n- Default to /index.html\n- Binary content not supported\n- You need `\u003cbase href=\"...\"/\u003e`\n\n## What to do\n\n1. Make a service, make an API key for that service\n2. [Make a non-dynamic snippet](//docs.fastly.com/vcl/vcl-snippets/using-regular-vcl-snippets/#creating-a-regular-vcl-snippet) for [main.vcl](/main.vcl)\n2. [Create a dynamic snippet](//docs.fastly.com/api/config#snippet) for the data:\n```\n; export SID= # service ID\n; export KEY= # API key\n; export VER= # unlocked (not yet activated) version\n; curl -X POST -s https://api.fastly.com/service/$SID/version/$VER/snippet \\\n  -H \"Fastly-Key:$KEY\" -H 'Content-Type: application/x-www-form-urlencoded' \\\n  --data $'name=data\u0026type=init\u0026dynamic=1\u0026content=table body {}\\n'\n{\"name\":\"synth\",\"type\":\"init\",\"dynamic\":1,\"content\":null,\"service_id\":\"...\",\n \"version\":\"...\",\"deleted_at\":null,\"id\":\"...\",\"updated_at\":\"...\",\"priority\":100,\n \"created_at\":\"...\"}\n```\n\n   Remember the snippet ID there - you'll need it for updates.\n\n3. Activate the service\n4. Update whenever you feel like it:\n```\n; KEY=... SID=... SNIPPET=... ./update.sh /path/to/htdocs\n```\n\n## FAQ\n\nQ. Why not use edge dictionaries?  \nA. [The API](//docs.fastly.com/api/config#dictionary) doesn't provide a “replace everything in one go” operation.\n   Also they render to VCL anyway; here I can generate the same VCL in the first place.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatef%2Fvcl-static-site-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkatef%2Fvcl-static-site-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatef%2Fvcl-static-site-generator/lists"}