/rtp-lume

Primary LanguageNunjucks

lume-base-blog

A starter repository showing how to build a blog with the Lume static site generator.

This project started as a fork of eleventy-base-blog but adapted to Lume and with the NetlifyCMS.

Getting Started

  1. Clone this Repository git clone https://github.com/lumeland/base-blog.git my-blog-name
  2. Edit _data/site.yml. Specifically have a look at _config.js to see if you want to configure any option differently. See the Lume documentation site.
  3. Make sure you have the latest version of Deno and lume installed: deno upgrade && lume upgrade
  4. Run Lume lume --serve

Implementation Notes

  • about.md shows how to add a content page.
  • talks/ has the blog talks but really they can live in any directory. The talks/_data.yml file adds the value for type and layout fields to all talks.
  • The menu field adds any page to the top level site navigation. For example, this is in use on index.njk and about.md. You can configure the order with menu.order and the text with menu.title.
  • css files are processed with postcss plugin. The imported styles are in _includes/css
  • img folder is copied as is, (keeping the same directory structure).
  • The blog talk feed template is in feed.xml.njk and feed.tmpl.js.
  • This example uses four layouts stored in _includes/layouts/:
    • base.njk: the top level HTML structure
    • home.njk: the home page template (wrapped into base.njk)
    • talk.njk: the blog talk template (wrapped into base.njk)
    • tag.njk: the tag page template (wrapped into base.njk)
  • _includes/templates/talklist.njk is a Nunjucks a reusable template used to display a list of all the talks. index.njk has an example of how to use it.
  • admin/ has the NetlifyCMS configuration so you can edit or create new talks using a friendly CMS.

Deployment

GitHub Pages

  • Get your own Lume blog on Github Pages
  • Open the file .github/workflows/build.yml and edit the --location option with the url of the site, for example --location=https://username.github.io/repo/
  • Enable Github Pages and select the branch gh-pages as source.
  • See a live demo

GitLab Pages

  • Open the file .github/workflows/build.yml and edit the --location option with the url of the site, for example --location=https://username.gitlab.io/repo/
  • See a live demo

Deno Deploy

  • Create a project in Deno Deploy and configure it.
    • Link to your git repository
    • Set the GitHub Actions deployment mode.
  • Open the file .github/workflows/deno_deploy.yml and edit the following:
    • The --location option with the url of the site, for example: --location=https://my-blog.deno.dev
    • The project name in the denoland/deployctl step with the name of your project.
  • See a live demo

Vercel

  • Get your own Lume blog on Vercel
  • You need to config your the project manually with the following values:
    • Build Command: curl -fsSL https://deno.land/x/install/install.sh | sh && /vercel/.deno/bin/deno task build --location=https://example.vercel.app/. Edit the --location option with the name of your domain.
    • Output directory: _site
  • See a live demo

Netlify

  • Get your own Lume blog on Netlify
  • Open the netlify.toml file and edit the --location=https://deno-blog.netlify.app/ option with your own domain.
  • See a live demo
  • If you want to use NetlifyCMS:
    • Activate the Identity service in your Netlify settings panel.
    • Activate the Git Gateway.
    • Invite the users to edit the content.

Fleek

Cloudflare Pages

  • Configure the project with the following values:
    • Build Command: curl -fsSL https://deno.land/x/install/install.sh | sh && /opt/buildhome/.deno/bin/deno task build --location=https://example.pages.dev/. Edit the --location option with the name of your domain.
    • Output directory: _site
  • See a live demo

AWS Amplify

  • Configure the amplify.yml file with the following values:
    version: 1
    frontend:
      phases:
        build:
          commands:
            - curl -fsSL https://deno.land/x/install/install.sh | sh
            - /root/.deno/bin/deno task build
      artifacts:
        baseDirectory: /_site
        files:
          - '**/*'
      cache:
        paths: []
  • See a live demo