/the-butler

Primary LanguageHTMLMIT LicenseMIT

The Butler

A ready to use static blog, powered by Cecil.

Cecil preview

There is a demo?

▶️ the-butler-demo.cecil.app (theme: Hyde, host: Netlify)
▶️ the-butler-garth.vercel.app (theme: Garth, host: Vercel)

How to use?

Managing content

Manually

Click on the button Use this template.

Then just edit Markdown files in content/blog/ directly from your repository.

Forestry CMS

If your goal is managing content quickly, and decide later where to deploy to it, use the following button to import the starter blog to Forestry CMS and start editing immediatelly!

Import to Forestry

Build & deploy

Locally

Run the following command in a terminal:

bash ./scripts/build.sh

Cloud

Solution Demo Deploy
Netlify https://the-butler-demo.cecil.app Deploy to Netlify
Vercel https://the-butler.vercel.app Deploy to Vercel
Render https://the-butler.onrender.com Deploy to Render
Cloudflare Pages https://the-butler.pages.dev - Framework preset: None
- Build command: curl -sSOL https://cecil.app/build.sh && bash ./build.sh
- Build output directory: _site
GitHub https://cecilapp.github.io/the-butler/ See GitHub Actions workflow file.
GitLab CI https://cecilapp.gitlab.io/the-butler/ See GitLab config file.
Travis CI N/A See Travis config file.

To use Netlify CMS (demo) you must:

  1. enable Netlify Identity and Git Gateway
  2. invite a user
  3. connect to https://<your-blog>.netlify.com/admin/ with the user credentials

Customize your blog

  1. Change configuration by editing config.yml file
  2. Change templates by copying files from themes/<theme>/layouts/ to your own layouts/ directory to override them

Need Help?

Read the Cecil's documentation.

License

The Butler is a free software distributed under the terms of the MIT license.

© Arnaud Ligny