lightspeed/README.md
2020-09-13 15:08:54 +02:00

2.6 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
  • Now with SEO!

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.

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

SEO header tags are enabled by default. Most fields are picked up from the page data, 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"

To disable SEO set field seo in extra to false.

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.

Netlify

Deployed on netlify? Add a link 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.