schoenenberg/zola-paper

A clean theme inspired from hugo-paper.

Zola-Paper

A clean theme inspired from hugo-paper.

Zola port of Hugo-Paper (with a few tweaks).

Demo: https://schoenenberg.github.com/zola-paper

Installation

The easiest way to install this theme is to either clone it ...

git clone https://github.com/schoenenberg/zola-paper.git themes/zola-paper

... or to use it as a submodule.

git submodule add https://github.com/schoenenberg/zola-paper.git themes/zola-paper

Either way, you will have to enable the theme in your config.toml.

theme = "zola-paper"

Open Graph Integration

This theme has an integration of Open Graph meta tags. These are set based on context and available information. See the following example:

+++
title = "Lorem ipsum!"

[extra]
author = "Max Mustermann"
author_url = "https://www.facebook.com/example.profile.3"
banner_path = "default-banner"

[taxonomies]
tags = ["rust", "zola", "blog"]
+++

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc eu feugiat sapien. Aenean ligula nunc, laoreet id sem in, interdum bibendum felis. Donec vel dui neque.
<!-- more -->
Ut luctus dolor ut tortor hendrerit, sed hendrerit augue scelerisque. Suspendisse quis sodales dui, at tempus ante. Nulla at tempor metus. Aliquam vitae rutrum diam. Curabitur iaculis massa dui, quis varius nulla finibus a. Praesent eu blandit justo. Suspendisse pharetra, arcu in rhoncus rutrum, magna magna viverra erat, ...

Required attributes of the extra section is author. All other attributes are optional. The path for the banner_path attribute has to be relative to the content directory.

zola-paper's Issues

Responsive design for Code Blocks

Code blocks on small screens look horrible.. Need to fix that!

Articles require `<!-- more -->` otherwise page will crash

Description

Following up on getzola/zola#1298, the theme appears to use a redundant call to | markdown(inline = true), which causes a crash when page.summary is null, i.e., when <!-- more --> is not defined. This makes summaries required, and imo, they shouldn't be! :)

Relevant area of code:

zola-paper/templates/index.html

Line 17 in 643041d

{% if page.summary %}<meta name="description" content="{{ page.summary | markdown(inline=true) }}">{% endif %}

Reproduction steps

1. Remove <!-- more --> from any article in content/
2. Attempt to compile
3. Observe this error:

Reason: Failed to render 'page.html' (error happened in 'index.html').
Reason: Filter call 'markdown' failed
Reason: Filter `markdown` was called on an incorrect value: got `null` but expected a String