lightspeed/README.md
2020-04-14 20:42:35 +02:00

2.2 KiB

Light Speed

An insanely fast and performance-based Zola theme, ported from Light Speed Jekyll.

Some fun facts about the theme:

  • Perfect score on Google's Lighthouse audit
  • Only ~600 bytes of CSS
  • No JavaScript

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


Contents

Installation

First download this theme to your themes directory:

$ cd themes
$ git clone https://github.com/carpetscheme/lightspeed.git

and then enable it in your config.toml:

theme = "lightspeed"

Posts should be placed directly in the content folder.

Options

Title

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

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

Sass

Styles are compiled from sass and imported inline to the header

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.

Set a field in extra with a key of footer_links:

[extra]

footer_links = [
    {url = "$BASE_URL/about", name = "About"},
    {url = "$BASE_URL/rss.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"

Netlify

Deployed on netlify? Let people know in the footer by setting netlify in extra as true.

[extra]

netlify = true

Original

This template is based on the Jekyll template Light Speed Jekyll by Bradley Taunt:

License

Open sourced under the MIT license.

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