Want a blog like this? In about... 30 seconds from now?
- 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
- GitHub Templates: Use this template
- Pick a name - probably
blog
(or something else real nice and simple like)- (it will deploy to
https://<owner>.github.io/<repo>
)
- (it will deploy to
- Wait 30 seconds, and your blog will be ready.
- See next steps in the new README.md!
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.
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.
- The New Post link in the
Your site will be available at https://{owner}.github.io/{repo}/.
If you'd like to use a custom domain, such as example.com
:
- Create a file
CNAME
in the root of the project
(the obvious, normal, top-level directory) - Login to your Domain / DNS provider (such as name.com) and replace any
example.com
records with
- EITHER an
ANAME
(also calledALIAS
) record- the
ANAME
record should point to<user-or-organization>.github.io
- the
- OR
A
andAAAA
recordsA
records should point to185.199.108.153 185.199.109.153 185.199.110.153 185.199.111.153
AAAA
records should point to2606: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