{"id":24401667,"url":"https://github.com/TrueSparrowSystems/ghost-static-website-generator","last_synced_at":"2025-09-30T08:31:38.983Z","repository":{"id":65158302,"uuid":"526503575","full_name":"TrueSparrowSystems/ghost-static-website-generator","owner":"TrueSparrowSystems","description":null,"archived":false,"fork":false,"pushed_at":"2023-08-03T10:04:53.000Z","size":21,"stargazers_count":22,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-14T07:44:46.636Z","etag":null,"topics":["aws","ghost","static-site"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/TrueSparrowSystems.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}},"created_at":"2022-08-19T07:21:00.000Z","updated_at":"2025-01-06T19:58:52.000Z","dependencies_parsed_at":"2023-02-19T17:45:31.961Z","dependency_job_id":null,"html_url":"https://github.com/TrueSparrowSystems/ghost-static-website-generator","commit_stats":null,"previous_names":["plg-works/ghost-static-website-generator"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TrueSparrowSystems%2Fghost-static-website-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TrueSparrowSystems%2Fghost-static-website-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TrueSparrowSystems%2Fghost-static-website-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TrueSparrowSystems%2Fghost-static-website-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TrueSparrowSystems","download_url":"https://codeload.github.com/TrueSparrowSystems/ghost-static-website-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234719574,"owners_count":18876524,"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":["aws","ghost","static-site"],"created_at":"2025-01-20T00:33:21.729Z","updated_at":"2025-09-30T08:31:33.672Z","avatar_url":"https://github.com/TrueSparrowSystems.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ghost Static Website Generator\n\nGenerate static HTML files for custom ghost hosting and publish them on AWS S3 as static website.\nTo host the static blog site under a path `/blog` (`https://yourdomain.com/blog`), the ghost needs to be hosted with the same path like `https://content.yourdomain.com/blog`.\n\nIf your blog is hosted under `https://content.yourdomain.com` and you want to host the static website under `https://yourdomain.com/blog`, this is not possible. Same applies for the other way around.\n\nYou can also replace certain text from the generated static files by passing the following arguments `custom_replace_keys` and `custom_replace_values`. For more details, refer Inputs and Example usage section. It doesn't support the multiline replacement as of now.\n\nOptionally, you can either host the static files on AWS S3 or on AWS Amplify.\n\nTo host Static Blog on AWS S3, provide the following input parameters:\n\n- `s3_bucket_name` (Make the bucket publicly accessible and enable static web hosting)\n\n- `aws_access_key_id`\n\n- `aws_secret_access_key`\n\n- `aws_region`\n\nTo host Static Blog on already existing AWS Amplify application, provide the following input parameters:\n\n- `aws_amplify_app_id`\n\n- `aws_amplify_branch_name`\n\n- `aws_access_key_id`\n\n- `aws_secret_access_key`\n\n- `aws_region`\n\n## Inputs\n\n## `ghost_hosted_url`\n\n**Required** Ghost hosted URL endpoint. (`ex: https://content.yourdomain.com/blog`)\n\n## `ghost_static_host_url`\n\n**Required** URL endpoint where static files needs to be hosted. (`ex: https://yourdomain.com/blog`)\n\n## `custom_replace_keys`\n\n**Optional** Comma separated list of items that needs to be replaced from the items in custom_replace_values at the same index.\n\n## `custom_replace_values`\n\n**Optional** Comma separated associated values for the item in custom_replace_keys.\n\n## `root_index_jsonld`\n\n**Optional** Replace ld+json data in the root index file.\n\n\n## `breadcrumb_root_index_jsonld`\n\n**Optional** Add Breadcrumb ld+json data in the root index file.\n\n## `s3_bucket_name`\n\n**Optional** S3 bucket name to upload static HTML files.\n\n## `aws_access_key_id`\n\n**Optional** AWS access key Id.\n\n## `aws_secret_access_key`\n\n**Optional** AWS secret access key.\n\n## `aws_region`\n\n**Optional** AWS region.\n\n## `aws_amplify_app_id`\n\n**Optional** Amplify App id.\n\n## `aws_amplify_branch_name`\n\n**Optional** Amplify branch name.\n\n## Example usage\n\n```yaml\nname: Generate Static HTML files\nuses: TrueSparrowSystems/ghost-static-website-generator@v4\nwith:\n  ghost_hosted_url: \"https://content.yourdomain.com/blog\"\n  ghost_static_host_url: \"https://yourdomain.com/blog\"\n  s3_bucket_name: \"your-s3-bucket-name\"\n  aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }} # Accessing it from the gihub secrets\n  aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} # Accessing it from the gihub secrets\n  aws_region: \"us-east-1\"\n  custom_replace_keys: \"key_1, key_2, key_n\"\n  custom_replace_values: \"value_1, value_2, value_n\"\n```\n\n### _Locally build and run with docker_\n\n```bash\ndocker build -t ghost-swg .\ndocker run -it --env-file .env.sample ghost-swg\n```\n\n\u003e Make appropriate changes to the `.env.sample` file.\n\u003e To Persist the generated HTML files in local (host system) directory, use bind mount option with `docker run` command, For example: `-v /path/to/local/dir:/src/content`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTrueSparrowSystems%2Fghost-static-website-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTrueSparrowSystems%2Fghost-static-website-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTrueSparrowSystems%2Fghost-static-website-generator/lists"}