refined-lightspeed

refined-lightspeed

A polished version of the Jekyll Lightspeed's Zola fork

Light Speed

A personalized fork of the original Light Speed Zola theme, applied Primer CSS (the CSS system powering Github)

Some features about the theme:

  • Perfect score on Google's Lighthouse audit
  • Only ~700 bytes of CSS
  • As less amount of Javascript as possible
  • SEO enabled

Demo: quirky-perlman-34d0da.netlify.com


Contents

Installation

First download this theme to your themes directory:

$ cd themes
$ git clone https://github.com/shanoaice/refined-lightspeed.git

# or use git submodules
$ git submodules add https://github.com/shanoaice/refined-lightspeed.git themes/lightspeed

and then enable it in your config.toml:

theme = "lightspeed"

Posts should be placed directly in the content folder.

To sort the post index by date, enable sort in your index section content/_index.md:

sort_by = "date"

Options

Title

Set a title and description in the config to appear in the site header:

title = "Different strokes"
description = "for different folks"

Set a field in extra with a key of footer_links:

[extra]

footer_links = [
    {url = "$BASE_URL/about", name = "About"},
    {url = "$BASE_URL/atom.xml", name = "RSS"},
    {url = "https://google.com", name = "Google"},
]

If you put $BASE_URL in a url, it will automatically be replaced by the actual site URL.

Create pages such as $BASE_URL/about by placing them in a subfolder of the content directory, and specifying the path in the frontmatter:

path = "about"

SEO

Most SEO tags are populated by the page metadata, but you can set the author and for the og:image tag provide the path to an image:

[extra]

author = "Grant Green"
ogimage = "Greenery.png"

By default the footer provides links to Zola and Netlify, and a tagline of "Maintained with :heart: for the web". To disable any of those parts, and/or add a custom tagline of your own, the following options are available:

[extra]

zola = true
netlify = false
maintained_with_love = false
footer_tagline = "What if everything is an illusion and nothing exists? In that case, I definitely overpaid for my carpet."

Sass

Styles are compiled from sass and imported inline to the header :zap:

You can overide the styles by enabling sass compilation in the config:

compile_sass = true

...and placing a replacement style.scss file in your sass folder.

Original

This template is based on the Jekyll template Light Speed Jekyll by Bradley Taunt and Zola template Light Speed Zola by El Carpet.

License

Open sourced under the MIT license.

This project is open source except for example articles found in content.

Original Zola template has such license above. I did not modify anything inside the content folder. If the original authore cc@carpetscheme or any maintainers of the original project thinks this is a license infringement, please contact me. I will remove them immediately.