Bliss Template

Want a blog like this? In about... 30 seconds from now?

Features

• 0 Configuration (config.yaml builds itself)
• 0 Dependency on GitHub (just happens to work in push-button fashion here)
• Web interface (Bliss) and CLI tools (Hugo)
• Build at Home (localhost) or Abroad (GitHub Actions)
• Built-in Edit links

Make it Yours

1. GitHub Templates: Use this template
2. Pick a name - probably blog (or something else real nice and simple like)
   • (it will deploy to https://<owner>.github.io/<repo>)
3. Wait 30 seconds, and your blog will be ready.
   • See next steps in the new README.md!

Has it been 30 seconds?

Are you seeing this default README after created a new repo from our template?

Refresh the page ♻️.

You can also check your Actions tab. If the automatic configuration failed open an issue and I'll see if I can help.

What's Next?

A new README.md with additional instructions will appear in your new repo about 30s after you click Use this template.

It will contain direct links into your GitHub Pages Settings to click a few buttons. No muss, no fuss (and no searching for the right page).

Basically, you'll do this:

• Enable GitHub Pages for your default branch
  • Settings ➡️ Pages (left-hand side) ➡️ Branch: gh-pages
• Enable GitHub Issues as comments via utterances
• Create your first post using bliss.js.org as a front-end
  • The New Post link in the README will be pre-filled with your blog's repo.

Your site will be available at https://{owner}.github.io/{repo}/.

Custom Domains

If you'd like to use a custom domain, such as example.com:

1. Create a file CNAME in the root of the project
   (the obvious, normal, top-level directory)
2. Login to your Domain / DNS provider (such as name.com) and replace any example.com records with

• EITHER an ANAME (also called ALIAS) record
  • the ANAME record should point to

    <user-or-organization>.github.io

• OR A and AAAA records
  • A records should point to

    185.199.108.153
    185.199.109.153
    185.199.110.153
    185.199.111.153

  • AAAA records should point to

    2606:50c0:8000::153
    2606:50c0:8001::153
    2606:50c0:8002::153
    2606:50c0:8003::153

For more info, see https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain

Other Sites using the eon theme:

• ryanburnette.com
• therootcompany.com