A lume
template for building a blog.
- You need a copy of
deno
, available at deno.land. - Clone this repository locally.
rm -rf .git
to remove the version control history if you want to. - Edit your
_data/site.yml
and_config.ts
to add your name, description, any links. - OPTIONAL If you want to host with GitHub Pages with your own domain name,
follow these
instructions
and add a
CNAME
file to this repository. git init && git add . && git commit -m "init: blog"
to reinitialise version control for this repository.- Run
deno task serve
to preview your blog. Add posts toposts/
. When happy, commit.
- Checkout to a new
post
branch, egpost/your-new-post
. - Add post to
posts
. - Commit when you're happy.
- Rebase onto
main
.
- Checkout to a new
page
branch, egpost/your-new-page
. - Add page the root of this directory, eg
page.md
. - Add the following YAML header to your new page:
---
layout: layout/post.njk
title: Your Page
templateClass: tmpl-post
menu:
visible: true
order: 2
---
- Rebase onto
main
.
This includes a working GitHub Pages workflow by default. Just look inside
.github/workflows/publish.yaml
, which runs on push to main. It checks out to
main, compiles the site, and publishes it to GitHub pages.
Stick any CSS into styles.css
after the imports. For example, if you want the
font to be smaller, add this:
:root {
font-size: 14px;
}