Tapestry

Tapestry is a researcher profile website theme for the Zola static site generator.

Inspired by and derived from the terminus theme, specifically its aa8d8b67f9ab69ae48e1405f96e152d41f03e0ed commit, tapestry inherits a number of features from the terminus theme. The key differences include the following.

Try the demo at the following links.

Tapestry screenshot

Features

Requirements

Usage

  1. Initialise a Git repository in your Zola project directory, if you have not done it.

    git init
  2. Add this theme as a Git submodule.

    git submodule add https://github.com/anirbanbasu/tapestry.git themes/tapestry
  3. Enable this theme in your config.toml:

    theme = "tapestry"
  4. Set a website title of your liking in your config.toml:

    title = "My research profile"
  5. Create a text file named content/_index.md. This file controls how your home page looks. Choose exactly one of the following options:

    1. Serve yours posts from /:

      +++
      title = "Home"
      paginate_by = 5  # Show 5 posts per page.
      +++
    2. Serve posts from a different path, e.g. posts/:

      +++
      title = "Home"
      
      [extra]
      section_path = "posts/_index.md"  # Where to find your posts.
      max_posts = 5  # Show 5 posts and a link to posts section on home page.
      +++

Configuration

Beyond the homepage setup above, Tapestry reads a range of extra.* keys at the site, section, and page level — presentation style/variant selection, KaTeX, social/navigation links, image handling, content security policy, and more. Rather than duplicate that reference here, consult the live, always-up-to-date documentation on either demo site:

Contributing

Contributions to this theme are very welcome! However, if you want to contribute to the theme, please do so at the theme-tapestry-dev repository. Meanwhile, this repository exists only to serve the purpose of a Git submodule installable theme for your Zola project.

License

This project is licensed under the terms of the MIT license.