lume-simple-blog

A lume template for building a blog.

How To Use It

0. You need a copy of deno, available at deno.land.
1. Clone this repository locally. rm -rf .git to remove the version control history if you want to.
2. Edit your _data/site.yml and _config.ts to add your name, description, any links.
3. 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.
4. git init && git add . && git commit -m "init: blog" to reinitialise version control for this repository.
5. Run deno task serve to preview your blog. Add posts to posts/. When you're happy with it, run deno task build to generate your site, add your posts and your generated output in docs/ to your repo, and push.

Workflow

New posts

0. Checkout to a new post branch, eg post/your-new-post.
1. Add post to posts.
2. Run deno task build.
3. Add changes including generated HTML in docs/, and commit. The generated HTML and the source Markdown must be in the same commit.
4. Rebase onto main.

New pages

0. Checkout to a new page branch, eg post/your-new-page.
1. Add page the root of this directory, eg page.md.
2. Add the following YAML header to your new page:

---
layout: layout/post.njk
title: Your Page
templateClass: tmpl-post
menu:
    visible: true
    order: 2
---

3. Run deno task build.
4. Add changes including generated HTML in docs/, and commit. The generated HTML and the source Markdown must be in the same commit.
5. Rebase onto main.

Technology Used

• deno
• lume
• Simple.css
• highlight.js