Update themes gallery (#1589)

Co-authored-by: GitHub Action <action@github.com>
This commit is contained in:
Vincent Prouillet 2021-08-18 15:32:46 +02:00 committed by GitHub
parent 3bedb42b0b
commit 8802e77880
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
37 changed files with 416 additions and 105 deletions

View file

@ -3,11 +3,11 @@
title = "DeepThought" title = "DeepThought"
description = "A simple blog theme focused on writing powered by Bulma and Zola." description = "A simple blog theme focused on writing powered by Bulma and Zola."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/RatanShreshtha/DeepThought.git" repository = "https://github.com/RatanShreshtha/DeepThought.git"
homepage = "https://github.com/RatanShreshtha/DeepThought" homepage = "https://github.com/RatanShreshtha/DeepThought"
minimum_version = "0.9.0" minimum_version = "0.9.0"

View file

@ -3,11 +3,11 @@
title = "Ergo" title = "Ergo"
description = "A simple blog Theme focused on writing, inspired by svbtle" description = "A simple blog Theme focused on writing, inspired by svbtle"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/InsidiousMind/Ergo.git" repository = "https://github.com/InsidiousMind/Ergo.git"
homepage = "https://github.com/insipx/Ergo" homepage = "https://github.com/insipx/Ergo"
minimum_version = "0.4.1" minimum_version = "0.4.1"

View file

@ -3,11 +3,11 @@
title = "Zulma" title = "Zulma"
description = "A zola theme based off bulma.css" description = "A zola theme based off bulma.css"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/Worble/Zulma" repository = "https://github.com/Worble/Zulma"
homepage = "https://github.com/Worble/Zulma" homepage = "https://github.com/Worble/Zulma"
minimum_version = "0.6.0" minimum_version = "0.6.0"

View file

@ -3,11 +3,11 @@
title = "adidoks" title = "adidoks"
description = "AdiDoks is a Zola theme helping you build modern documentation." description = "AdiDoks is a Zola theme helping you build modern documentation."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/aaranxu/adidoks.git" repository = "https://github.com/aaranxu/adidoks.git"
homepage = "https://github.com/aaranxu/adidoks" homepage = "https://github.com/aaranxu/adidoks"
minimum_version = "0.13.0" minimum_version = "0.13.0"

View file

@ -3,11 +3,11 @@
title = "after-dark" title = "after-dark"
description = "A robust, elegant dark theme" description = "A robust, elegant dark theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/after-dark.git" repository = "https://github.com/getzola/after-dark.git"
homepage = "https://github.com/getzola/after-dark" homepage = "https://github.com/getzola/after-dark"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "anatole-zola" title = "anatole-zola"
description = "A port of farbox-theme-Anatole for zola" description = "A port of farbox-theme-Anatole for zola"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/longfangsong/anatole-zola.git" repository = "https://github.com/longfangsong/anatole-zola.git"
homepage = "https://github.com/longfangsong/anatole-zola" homepage = "https://github.com/longfangsong/anatole-zola"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "Anpu" title = "Anpu"
description = "A port of the Hugo Anubis theme" description = "A port of the Hugo Anubis theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/zbrox/anpu-zola-theme.git" repository = "https://github.com/zbrox/anpu-zola-theme.git"
homepage = "https://github.com/zbrox/anpu-zola-theme" homepage = "https://github.com/zbrox/anpu-zola-theme"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "book" title = "book"
description = "A book theme inspired from GitBook/mdBook" description = "A book theme inspired from GitBook/mdBook"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/book.git" repository = "https://github.com/getzola/book.git"
homepage = "https://github.com/getzola/book" homepage = "https://github.com/getzola/book"
minimum_version = "0.5.0" minimum_version = "0.5.0"

View file

@ -3,11 +3,11 @@
title = "Clean Blog" title = "Clean Blog"
description = "A port of Start Bootstrap Clean Blog for Zola" description = "A port of Start Bootstrap Clean Blog for Zola"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/dave-tucker/zola-clean-blog" repository = "https://github.com/dave-tucker/zola-clean-blog"
homepage = "https://github.com/dave-tucker/zola-clean-blog" homepage = "https://github.com/dave-tucker/zola-clean-blog"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "codinfox-zola" title = "codinfox-zola"
description = "Codinfox theme for Zola" description = "Codinfox theme for Zola"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/svavs/codinfox-zola" repository = "https://github.com/svavs/codinfox-zola"
homepage = "https://github.com/svavs/codinfox-zola" homepage = "https://github.com/svavs/codinfox-zola"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "dinkleberg" title = "dinkleberg"
description = "The Rust BR theme for Gutenberg" description = "The Rust BR theme for Gutenberg"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/rust-br/dinkleberg.git" repository = "https://github.com/rust-br/dinkleberg.git"
homepage = "https://github.com/rust-br/dinkleberg" homepage = "https://github.com/rust-br/dinkleberg"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "Docsascode_theme" title = "Docsascode_theme"
description = "A modern simple Zola's theme related to docs as code methodology" description = "A modern simple Zola's theme related to docs as code methodology"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/codeandmedia/zola_docsascode_theme.git" repository = "https://github.com/codeandmedia/zola_docsascode_theme.git"
homepage = "https://github.com/codeandmedia/zola_docsascode_theme" homepage = "https://github.com/codeandmedia/zola_docsascode_theme"
minimum_version = "0.10.0" minimum_version = "0.10.0"

View file

@ -3,11 +3,11 @@
title = "dose" title = "dose"
description = "a small blog theme" description = "a small blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/oltd/dose.git" repository = "https://github.com/oltd/dose.git"
homepage = "https://github.com/oltd/dose" homepage = "https://github.com/oltd/dose"
minimum_version = "0.13.0" minimum_version = "0.13.0"

View file

@ -3,11 +3,11 @@
title = "even" title = "even"
description = "A robust, elegant dark theme" description = "A robust, elegant dark theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/even.git" repository = "https://github.com/getzola/even.git"
homepage = "https://github.com/getzola/even" homepage = "https://github.com/getzola/even"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "feather" title = "feather"
description = "A modern blog theme" description = "A modern blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/piedoom/feather" repository = "https://github.com/piedoom/feather"
homepage = "https://github.com/piedoom/feather" homepage = "https://github.com/piedoom/feather"
minimum_version = "0.5.1" minimum_version = "0.5.1"

View file

@ -3,11 +3,11 @@
title = "Float" title = "Float"
description = "An elegant blog theme" description = "An elegant blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://gitlab.com/float-theme/float.git" repository = "https://gitlab.com/float-theme/float.git"
homepage = "https://float-theme.netlify.app/" homepage = "https://float-theme.netlify.app/"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "hallo" title = "hallo"
description = "A single-page theme to introduce yourself." description = "A single-page theme to introduce yourself."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/flyingP0tat0/zola-hallo.git" repository = "https://github.com/flyingP0tat0/zola-hallo.git"
homepage = "https://github.com/janbaudisch/zola-hallo" homepage = "https://github.com/janbaudisch/zola-hallo"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "hyde" title = "hyde"
description = "A classic blog theme" description = "A classic blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/getzola/hyde.git" repository = "https://github.com/getzola/hyde.git"
homepage = "https://github.com/getzola/hyde" homepage = "https://github.com/getzola/hyde"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "juice" title = "juice"
description = "An intuitive, elegant, and lightweight Zola theme for product sites." description = "An intuitive, elegant, and lightweight Zola theme for product sites."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/huhu/juice" repository = "https://github.com/huhu/juice"
homepage = "https://github.com/huhu/juice" homepage = "https://github.com/huhu/juice"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "lightspeed" title = "lightspeed"
description = "Zola theme with a perfect Lighthouse score" description = "Zola theme with a perfect Lighthouse score"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/carpetscheme/lightspeed" repository = "https://github.com/carpetscheme/lightspeed"
homepage = "https://github.com/carpetscheme/lightspeed" homepage = "https://github.com/carpetscheme/lightspeed"
minimum_version = "0.10.0" minimum_version = "0.10.0"

View file

@ -3,11 +3,11 @@
title = "ntun-zola-theme" title = "ntun-zola-theme"
description = "A classic resume theme" description = "A classic resume theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/Netoun/ntun" repository = "https://github.com/Netoun/ntun"
homepage = "https://github.com/netoun/ntun" homepage = "https://github.com/netoun/ntun"
minimum_version = "0.1.0" minimum_version = "0.1.0"

View file

@ -3,11 +3,11 @@
title = "Oceanic Zen" title = "Oceanic Zen"
description = "Minimalistic blog theme" description = "Minimalistic blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/barlog-m/oceanic-zen.git" repository = "https://github.com/barlog-m/oceanic-zen.git"
homepage = "https://github.com/barlog-m/oceanic-zen" homepage = "https://github.com/barlog-m/oceanic-zen"
minimum_version = "0.12.0" minimum_version = "0.12.0"

View file

@ -0,0 +1,311 @@
+++
title = "Papaya"
description = "A clean blogging theme with projects"
template = "theme.html"
date = 2021-08-18T01:00:57-07:00
[extra]
created = 2021-08-18T01:00:57-07:00
updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/justint/papaya.git"
homepage = "https://github.com/justint/papaya"
minimum_version = "0.14.0"
license = "MIT"
demo = ""
[extra.author]
name = "Justin Tennant"
homepage = "https://justintennant.me"
+++
# Papaya
A clean [Zola](https://getzola.org) theme for blogging and projects, forked from [Anpu](https://github.com/zbrox/anpu-zola-theme).
**Demo site**: https://justintennant.me/papaya/
![index](pics/index.png)
![projects](pics/projects.png)
![project](pics/project.png)
## Features
- Blog posts
- Project pages
- Categories and tags
- Featured images for posts/pages
- Smart image embedding shortcode (`{{/* img() */}}`)
- GitHub repository star/fork counts
- [Open Graph Protocol](https://ogp.me/) tags
- Social/contact links
- 100% Google Lighthouse score
## Installation
1. Clone this repository to your `themes` folder:
```bash
git clone https://github.com/justint/papaya.git themes/papaya
```
2. Set your theme setting in `config.toml` to `papaya`:
```toml
theme = "papaya"
```
3. This theme requires both the `tags` and `categories` taxonomies.
```toml
taxonomies = [
{ name = "categories" },
{ name = "tags" },
]
```
4. In your `content` directory, add new `blog` and `projects` directories. Copy the `_index.md` file from Papaya's `content/blog` into your `content/blog`, and the `_index.md` and `categories.json` files from Papaya's `content/projects` into your `content/projects`.
Your `content` directory structure should look like this:
```
content
├── blog
│ └── _index.md
└── projects
└── _index.md
└── categories.json
```
5. _(optional)_ To enable GitHub repository stars/fork counts (disabled by default to avoid hitting API rate limits), set the `$ZOLA_ENV` environment variable to `prod` prior to your `zola serve`/`zola build` execution.
For csh/tsch:
```shell
setenv ZOLA_ENV prod
```
For bash/ksh/zsh:
```shell
export ZOLA_ENV=prod
```
## Customization
Here are the customizable features of Papaya:
- Navigation menu links
- Post/project date formats
- Post/project featured images
- Project categories
- Open Graph Protocol locale/profile information
- Social/contact links
### Navigation menu links
In your `config.toml` under the `[extra]` section you need to set the `papaya_menu_links` list.
Example:
```toml
[extra]
papaya_menu_links = [
{ url = "$BASE_URL/about/", name = "About" },
]
```
If you include `$BASE_URL` in the URL of a link it will be replaced with the base URL of your site.
### Post/project date formats
In your `config.toml` under the `[extra]` section you need to set the `papaya_date_format` value.
Example:
```toml
[extra]
papaya_date_format = "%e %B %Y"
```
The formatting uses the standard `date` filter in Tera. The date format options you can use are listed in the [chrono crate documentation](https://tera.netlify.app/docs/#date).
### Post/project featured images
Posts and projects can have featured images which display at the top of their page before the page contents.
```toml
[extra]
featured_image = "image.jpg"
featured_image_alt = "A lodge overlooks a forested mountain range."
```
![Featured image](pics/featured_image.png)
Featured images can also be extended to the full width of the viewport:
```toml
[extra]
featured_image = "image.jpg"
featured_image_alt = "A lodge overlooks a forested mountain range."
featured_image_extended = true
```
![Featured image, extended](pics/featured_image_extended.png)
### Project categories
In your `content/projects/categories.json`, you can specify the categories of projects. The formatting of the file is:
```json
{
"title": "keyword"
}
```
- `"title"`: the title text displayed for each category grouping on your projects page.
- `"keyword"`: the taxonomy term you'll use in your project pages.
A project can have multiple categories, and will be displayed once in each category configured.
Projects without categories will be displayed in the "Other" category listing of your project page. If you don't want the "Other" category displayed, you can copy the `templates/projects.html` to your own `templates` directory and delete/comment out the "Other" category code.
Example `categories.json`:
```json
{
"Software": "software",
"Films": "film"
}
```
Example project page front matter:
```toml
title = "Example software project"
date = 2021-08-11
[taxonomies]
categories = ["software"]
```
The example project page above would be grouped into & displayed within the "Software" category of your projects page.
### Open Graph Protocol locale/profile information
In your `config.toml` you can add a `[extra.ogp]` section to specify your Open Graph Protocol locale and profile information.
Open Graph Protocol provides you control over how your website's content should be displayed on social media sites.
For the more information on Open Graph Protocol and valid property values, visit the official [website](https://ogp.me/).
Example:
```toml
[extra.ogp]
locale = "en_US"
first_name = "Papaya"
last_name = "Tiliqua"
gender = "female"
username = "tiliquasp"
```
### Social/contact links
In your `config.toml` you can add a `[extra.social]` section to specify your social network/contact accounts. Changing these will update what links appear on your website's footer.
Example:
```toml
[extra.social]
email = "papaya@tiliqua.sp"
github = "papaya"
linkedin = "papayatiliqua"
```
## Image embedding shortcode
Included with Papaya is a shortcode for embedding images into your posts:
```
img(path, alt, caption, class, extended_width_pct)
```
### Arguments
- `path`: The path to the image relative to the `content` directory in the [directory structure](https://www.getzola.org/documentation/getting-started/directory-structure/).
- `alt`: _(optional)_ The alternate text for the image.
- `caption`: _(optional)_ A caption for the image. Text/HTML/Tera templates supported.
- `class`: _(optional)_ Any CSS classes to assign to the image. Multiple classes should be separated with a space (`" "`).
- `extended_width_pct`: _(optional)_ The percentage by which the image's width should be expanded past it's default figure width, up to maximum configured pixel width.
Range is `0.0-1.0`, or `-1` for document width.
Max pixel width can be defined in your `config.toml` with the `extra.images.max_width` property (2500px default).
See [Extended width images](#extended-width-images) section for more details and examples.
The benefits of using this shortcode over regular Markdown/HTML image embedding are:
- Images are automatically resized for best performance, using Zola's [image processing functions](https://www.getzola.org/documentation/content/image-processing/)
- Images & captions are ✨pre-styled✨ for you
- Images can have their width extended past the document's width (see: [Extended width images](#extended-width-images))
- Less HTML/CSS boilerplate to write
### Extended width images
Images embedded into pages using the `img` shortcode can be configured to extend past their document width. This is especially nice for displaying wide/landscape images at higher resolutions.
By default, images embedded with the `img` shortcode will be inserted as a `figure` with default margins:
```js
{{/* img(path="image.jpg",
alt="A very cute leopard gecko.",
caption="A very cute leopard gecko. Default sizing.") */}}
```
![Default sized image](pics/img_default.png)
With the `extended_width_pct` argument, we can specify a percentage of how much the image should expand outside its default figure width, up to your maximum configured image width (`config.extras.images.max_width`, 2500px default).
Here's an example with `extended_width_pct=0.1`:
```js
{{/* img(path="image.jpg",
alt="A very cute leopard gecko.",
caption="A very cute leopard gecko. extended_width_pct=0.1",
extended_width_pct=0.1) */}}
```
![Image extended by 0.1](pics/img_0.1.png)
The image is now displayed with a 10% larger width, while maintaining its original aspect ratio.
Here's an even wider example:
```js
{{/* img(path="image.jpg",
alt="A very cute leopard gecko.",
caption="A very cute leopard gecko. extended_width_pct=0.2",
extended_width_pct=0.2) */}}
```
![Image extended by 0.2](pics/img_0.2.png)
The images will resize in resolution up to your maximum configured image width, and will display on the webpage up to the maximum width of the viewport.
You can also force the image width to match the document's width by setting `extended_width_pct` to `-1`:
```js
{{/* img(path="image.jpg",
alt="A very cute leopard gecko.",
caption="A very cute leopard gecko. extended_width_pct=-1",
extended_width_pct=-1) */}}
```
![Image fixed to document width](pics/img_-1.png)
## Why "Papaya"?
🦎

Binary file not shown.

After

Width:  |  Height:  |  Size: 342 KiB

View file

@ -3,11 +3,11 @@
title = "sam" title = "sam"
description = "A Simple and Minimalist theme with a focus on typography and content." description = "A Simple and Minimalist theme with a focus on typography and content."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/janbaudisch/zola-sam.git" repository = "https://github.com/janbaudisch/zola-sam.git"
homepage = "https://github.com/janbaudisch/zola-sam" homepage = "https://github.com/janbaudisch/zola-sam"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "simple-dev-blog" title = "simple-dev-blog"
description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags." description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "Slim" title = "Slim"
description = "Slim is a minimal, clean and beautiful theme for Zola." description = "Slim is a minimal, clean and beautiful theme for Zola."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/jameshclrk/zola-slim" repository = "https://github.com/jameshclrk/zola-slim"
homepage = "https://github.com/jameshclrk/zola-slim" homepage = "https://github.com/jameshclrk/zola-slim"
minimum_version = "0.8.0" minimum_version = "0.8.0"

View file

@ -3,11 +3,11 @@
title = "solar-theme-zola" title = "solar-theme-zola"
description = "A port of solar-theme-hugo for zola" description = "A port of solar-theme-hugo for zola"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/hulufei/solar-theme-zola.git" repository = "https://github.com/hulufei/solar-theme-zola.git"
homepage = "https://github.com/hulufei/solar-theme-zola" homepage = "https://github.com/hulufei/solar-theme-zola"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "tale-zola" title = "tale-zola"
description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog." description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/aaranxu/tale-zola.git" repository = "https://github.com/aaranxu/tale-zola.git"
homepage = "https://github.com/aaranxu/tale-zola" homepage = "https://github.com/aaranxu/tale-zola"
minimum_version = "0.13.0" minimum_version = "0.13.0"

View file

@ -3,11 +3,11 @@
title = "Toucan" title = "Toucan"
description = "Inspired from Pelican default theme" description = "Inspired from Pelican default theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://git.42l.fr/HugoTrentesaux/toucan.git" repository = "https://git.42l.fr/HugoTrentesaux/toucan.git"
homepage = "https://git.42l.fr/HugoTrentesaux/toucan" homepage = "https://git.42l.fr/HugoTrentesaux/toucan"
minimum_version = "0.8.0" minimum_version = "0.8.0"

View file

@ -3,11 +3,11 @@
title = "zerm" title = "zerm"
description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo" description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/ejmg/zerm.git" repository = "https://github.com/ejmg/zerm.git"
homepage = "https://github.com/ejmg/zerm" homepage = "https://github.com/ejmg/zerm"
minimum_version = "0.8.0" minimum_version = "0.8.0"

View file

@ -3,11 +3,11 @@
title = "henry" title = "henry"
description = "A timeless blog theme" description = "A timeless blog theme"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/sirodoht/zola-henry" repository = "https://github.com/sirodoht/zola-henry"
homepage = "https://github.com/sirodoht/zola-henry" homepage = "https://github.com/sirodoht/zola-henry"
minimum_version = "0.4.0" minimum_version = "0.4.0"

View file

@ -3,11 +3,11 @@
title = "zola-paper" title = "zola-paper"
description = "A clean theme inspired from hugo-paper." description = "A clean theme inspired from hugo-paper."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/schoenenberg/zola-paper.git" repository = "https://github.com/schoenenberg/zola-paper.git"
homepage = "https://github.com/schoenenberg/zola-paper" homepage = "https://github.com/schoenenberg/zola-paper"
minimum_version = "0.11.0" minimum_version = "0.11.0"

View file

@ -3,11 +3,11 @@
title = "pickles" title = "pickles"
description = "A modern, simple, clean blog theme for Zola." description = "A modern, simple, clean blog theme for Zola."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/lukehsiao/zola-pickles.git" repository = "https://github.com/lukehsiao/zola-pickles.git"
homepage = "https://github.com/lukehsiao/zola-pickles" homepage = "https://github.com/lukehsiao/zola-pickles"
minimum_version = "0.13.0" minimum_version = "0.13.0"

View file

@ -3,11 +3,11 @@
title = "Hikari" title = "Hikari"
description = "Fluid, responsive blog theme for Zola" description = "Fluid, responsive blog theme for Zola"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/waynee95/zola-theme-hikari" repository = "https://github.com/waynee95/zola-theme-hikari"
homepage = "https://github.com/waynee95/zola-theme-hikari" homepage = "https://github.com/waynee95/zola-theme-hikari"
minimum_version = "0.5.1" minimum_version = "0.5.1"

View file

@ -3,11 +3,11 @@
title = "zola.386" title = "zola.386"
description = "Zola port of the BOOTSTRA.386 theme." description = "Zola port of the BOOTSTRA.386 theme."
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/lopes/zola.386" repository = "https://github.com/lopes/zola.386"
homepage = "https://github.com/lopes/zola.386" homepage = "https://github.com/lopes/zola.386"
minimum_version = "0.10.1" minimum_version = "0.10.1"

View file

@ -3,11 +3,11 @@
title = "EasyDocs" title = "EasyDocs"
description = "An easy way to create docs for your project" description = "An easy way to create docs for your project"
template = "theme.html" template = "theme.html"
date = 2021-08-02T23:30:47+09:00 date = 2021-08-18T01:00:57-07:00
[extra] [extra]
created = 2021-08-02T23:30:47+09:00 created = 2021-08-18T01:00:57-07:00
updated = 2021-08-02T23:30:47+09:00 updated = 2021-08-18T01:00:57-07:00
repository = "https://github.com/codeandmedia/zola_easydocs_theme.git" repository = "https://github.com/codeandmedia/zola_easydocs_theme.git"
homepage = "https://github.com/codeandmedia/zola_easydocs_theme" homepage = "https://github.com/codeandmedia/zola_easydocs_theme"
minimum_version = "0.13.0" minimum_version = "0.13.0"