{"id":18388346,"url":"https://github.com/cecilapp/the-butler","last_synced_at":"2025-04-12T04:24:42.088Z","repository":{"id":38041944,"uuid":"84560380","full_name":"Cecilapp/the-butler","owner":"Cecilapp","description":"The Butler is a ready to use starter blog, powered by Cecil, your content driven static site generator.","archived":false,"fork":false,"pushed_at":"2024-11-02T02:07:22.000Z","size":8147,"stargazers_count":22,"open_issues_count":1,"forks_count":14,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T15:47:06.290Z","etag":null,"topics":["blog","cecil","cecil-demo","cecil-starter","netlify","static-site"],"latest_commit_sha":null,"homepage":"https://the-butler.cecil.app","language":"HTML","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/Cecilapp.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},"funding":{"github":"ArnaudLigny","open_collective":"cecil"}},"created_at":"2017-03-10T13:01:04.000Z","updated_at":"2025-02-03T10:17:13.000Z","dependencies_parsed_at":"2023-12-23T22:21:33.783Z","dependency_job_id":"ff368707-ac9d-4581-9847-02dd83b287bf","html_url":"https://github.com/Cecilapp/the-butler","commit_stats":{"total_commits":582,"total_committers":7,"mean_commits":83.14285714285714,"dds":0.02577319587628868,"last_synced_commit":"e542ff6923ed1d16e7fba749cc01ecd37c46021f"},"previous_names":[],"tags_count":60,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2Fthe-butler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2Fthe-butler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2Fthe-butler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cecilapp%2Fthe-butler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cecilapp","download_url":"https://codeload.github.com/Cecilapp/the-butler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248515136,"owners_count":21117116,"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":["blog","cecil","cecil-demo","cecil-starter","netlify","static-site"],"created_at":"2024-11-06T01:33:53.475Z","updated_at":"2025-04-12T04:24:42.063Z","avatar_url":"https://github.com/Cecilapp.png","language":"HTML","funding_links":["https://github.com/sponsors/ArnaudLigny","https://opencollective.com/cecil"],"categories":[],"sub_categories":[],"readme":"# The Butler\n\n_The Butler_ is a ready to use static blog, powered by [Cecil](https://cecil.app).\n\n[![The Butler screenshot](/docs/screenshot.png)](https://the-butler.cecil.app \"the-butler.cecil.app\")\n\n## There is a demo?\n\n:arrow_forward: [the-butler-demo.cecil.app](https://the-butler-demo.cecil.app) (theme: [Hyde](https://github.com/Cecilapp/theme-hyde#readme), host: [Netlify](https://www.netlify.com))  \n:arrow_forward: [the-butler-garth.vercel.app](https://the-butler-garth.vercel.app) (theme: [Garth](https://github.com/Cecilapp/theme-garth#readme), host: [Vercel](https://vercel.com))\n\n## How to use?\n\n### Managing content\n\n#### Manually\n\nCreate your own repository from the [GitHub template](https://github.com/Cecilapp/the-butler/generate), then just edit Markdown files in `pages/blog/`.\n\n#### Netlify CMS\n\nThe easiest way to deploy and manage your blog is certainly with [Netlify](https://www.netlify.com) + [Netlify CMS](https://www.netlifycms.org).\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://cecil.app/hosting/netlify/deploy/ \"Deploy to Netlify\")\n\n### Customize your blog\n\n1. Change configuration by editing [`config.yml`](https://github.com/Cecilapp/the-butler/blob/master/config.yml) file\n2. Change templates by copying files from `themes/\u003ctheme\u003e/layouts/` to your own `layouts/` directory to _override_ them\n   - [Hyde](https://github.com/Cecilapp/theme-hyde#readme): [`themes/hyde/layouts/`](https://github.com/Cecilapp/theme-hyde/tree/master/layouts)\n   - [Garth](https://github.com/Cecilapp/theme-garth#readme): [`themes/garth/layouts/`](https://github.com/Cecilapp/theme-garth/tree/master/layouts)\n\n### Build \u0026 deploy\n\n#### Locally\n\nRun the following command in a terminal:\n\n```bash\nbash ./scripts/build.sh\n```\n\n#### Cloud\n\n| Provider | Demo | Deploy |\n|----------|------|--------|\n| [Netlify](https://www.netlify.com) | \u003chttps://the-butler-demo.cecil.app\u003e | [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://cecil.app/hosting/netlify/deploy/ \"Deploy to Netlify\") |\n| [Vercel](https://vercel.com) | \u003chttps://the-butler.vercel.app\u003e | [![Deploy to Vercel](https://vercel.com/button)](https://cecil.app/hosting/vercel/deploy/ \"Deploy to Vercel\") |\n| [Cloudflare Pages](https://pages.cloudflare.com) | \u003chttps://the-butler.pages.dev\u003e | - Framework preset: `None`\u003cbr /\u003e- Build command: `curl -sSOL https://cecil.app/build.sh \u0026\u0026 bash ./build.sh`\u003cbr /\u003e- Build output directory: `_site` |\n| [GitHub](https://github.com/features/actions/) | \u003chttps://cecilapp.github.io/the-butler/\u003e | See [GitHub Actions workflow file](/.github/workflows/build-and-deploy.yml). |\n| [GitLab](https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/) | \u003chttps://cecilapp.gitlab.io/the-butler/\u003e | See [GitLab config file.](/.gitlab-ci.yml) |\n| ~~[Render](https://render.com)~~ | ~~\u003chttps://the-butler.onrender.com\u003e~~ | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://cecil.app/hosting/render/deploy/ \"Deploy to Render\") |\n| ~~[Travis CI](https://travis-ci.com)~~ | N/A | See [Travis config file.](/.travis.yml) |\n\nTo use [**Netlify CMS**](https://www.netlifycms.org) ([demo](https://the-butler-demo.cecil.app/admin/)) you must:\n\n1. enable [Netlify Identity](https://docs.netlify.com/visitor-access/git-gateway/#setup-and-settings) and Git Gateway\n2. invite a user\n3. connect to `https://\u003cyour-blog\u003e.netlify.com/admin/` with the user credentials\n\n## Need Help?\n\nRead the [Cecil's documentation](https://cecil.app/documentation/) and/or ask help in Cecil's [Discussions](https://github.com/Cecilapp/Cecil/discussions).\n\n## License\n\n_The Butler_ is a free software distributed under the terms of the MIT license.\n\n© [Arnaud Ligny](https://arnaudligny.fr)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcecilapp%2Fthe-butler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcecilapp%2Fthe-butler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcecilapp%2Fthe-butler/lists"}