diff --git a/docs/content/themes/DeepThought/index.md b/docs/content/themes/DeepThought/index.md index 477865e8..aced8cbc 100644 --- a/docs/content/themes/DeepThought/index.md +++ b/docs/content/themes/DeepThought/index.md @@ -3,11 +3,11 @@ title = "DeepThought" description = "A simple blog theme focused on writing powered by Bulma and Zola." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/RatanShreshtha/DeepThought.git" homepage = "https://github.com/RatanShreshtha/DeepThought" minimum_version = "0.9.0" diff --git a/docs/content/themes/Ergo/index.md b/docs/content/themes/Ergo/index.md index 652bdefd..a3556f07 100644 --- a/docs/content/themes/Ergo/index.md +++ b/docs/content/themes/Ergo/index.md @@ -3,11 +3,11 @@ title = "Ergo" description = "A simple blog Theme focused on writing, inspired by svbtle" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/InsidiousMind/Ergo.git" homepage = "https://github.com/insipx/Ergo" minimum_version = "0.4.1" diff --git a/docs/content/themes/Zulma/index.md b/docs/content/themes/Zulma/index.md index 53542ab3..078b5c5f 100644 --- a/docs/content/themes/Zulma/index.md +++ b/docs/content/themes/Zulma/index.md @@ -3,11 +3,11 @@ title = "Zulma" description = "A zola theme based off bulma.css" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/Worble/Zulma" homepage = "https://github.com/Worble/Zulma" minimum_version = "0.6.0" diff --git a/docs/content/themes/adidoks/index.md b/docs/content/themes/adidoks/index.md index c0e8730d..f6602763 100644 --- a/docs/content/themes/adidoks/index.md +++ b/docs/content/themes/adidoks/index.md @@ -3,11 +3,11 @@ title = "adidoks" description = "AdiDoks is a Zola theme helping you build modern documentation." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/aaranxu/adidoks.git" homepage = "https://github.com/aaranxu/adidoks" minimum_version = "0.13.0" diff --git a/docs/content/themes/after-dark/index.md b/docs/content/themes/after-dark/index.md index ccfb65e1..ec29f6b1 100644 --- a/docs/content/themes/after-dark/index.md +++ b/docs/content/themes/after-dark/index.md @@ -3,11 +3,11 @@ title = "after-dark" description = "A robust, elegant dark theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/getzola/after-dark.git" homepage = "https://github.com/getzola/after-dark" minimum_version = "0.11.0" diff --git a/docs/content/themes/anatole-zola/index.md b/docs/content/themes/anatole-zola/index.md index 0f866110..e1944f2d 100644 --- a/docs/content/themes/anatole-zola/index.md +++ b/docs/content/themes/anatole-zola/index.md @@ -3,11 +3,11 @@ title = "anatole-zola" description = "A port of farbox-theme-Anatole for zola" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/longfangsong/anatole-zola.git" homepage = "https://github.com/longfangsong/anatole-zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/anpu/index.md b/docs/content/themes/anpu/index.md index a0268f7a..a96ae5e6 100644 --- a/docs/content/themes/anpu/index.md +++ b/docs/content/themes/anpu/index.md @@ -3,11 +3,11 @@ title = "Anpu" description = "A port of the Hugo Anubis theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/zbrox/anpu-zola-theme.git" homepage = "https://github.com/zbrox/anpu-zola-theme" minimum_version = "0.11.0" diff --git a/docs/content/themes/book/index.md b/docs/content/themes/book/index.md index 8025c47f..3e14f6cb 100644 --- a/docs/content/themes/book/index.md +++ b/docs/content/themes/book/index.md @@ -3,11 +3,11 @@ title = "book" description = "A book theme inspired from GitBook/mdBook" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/getzola/book.git" homepage = "https://github.com/getzola/book" minimum_version = "0.5.0" diff --git a/docs/content/themes/clean-blog/index.md b/docs/content/themes/clean-blog/index.md index 47b98863..1c6fb304 100644 --- a/docs/content/themes/clean-blog/index.md +++ b/docs/content/themes/clean-blog/index.md @@ -3,11 +3,11 @@ title = "Clean Blog" description = "A port of Start Bootstrap Clean Blog for Zola" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/dave-tucker/zola-clean-blog" homepage = "https://github.com/dave-tucker/zola-clean-blog" minimum_version = "0.4.0" diff --git a/docs/content/themes/codinfox-zola/index.md b/docs/content/themes/codinfox-zola/index.md index 2248e598..b1d1f1f4 100644 --- a/docs/content/themes/codinfox-zola/index.md +++ b/docs/content/themes/codinfox-zola/index.md @@ -3,11 +3,11 @@ title = "codinfox-zola" description = "Codinfox theme for Zola" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/svavs/codinfox-zola" homepage = "https://github.com/svavs/codinfox-zola" minimum_version = "0.11.0" diff --git a/docs/content/themes/dinkleberg/index.md b/docs/content/themes/dinkleberg/index.md index 872a4173..8a203cb6 100644 --- a/docs/content/themes/dinkleberg/index.md +++ b/docs/content/themes/dinkleberg/index.md @@ -3,11 +3,11 @@ title = "dinkleberg" description = "The Rust BR theme for Gutenberg" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/rust-br/dinkleberg.git" homepage = "https://github.com/rust-br/dinkleberg" minimum_version = "0.4.0" diff --git a/docs/content/themes/docsascode-theme/index.md b/docs/content/themes/docsascode-theme/index.md index 7473678d..2e8a8ec1 100644 --- a/docs/content/themes/docsascode-theme/index.md +++ b/docs/content/themes/docsascode-theme/index.md @@ -3,11 +3,11 @@ title = "Docsascode_theme" description = "A modern simple Zola's theme related to docs as code methodology" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/codeandmedia/zola_docsascode_theme.git" homepage = "https://github.com/codeandmedia/zola_docsascode_theme" minimum_version = "0.10.0" diff --git a/docs/content/themes/dose/index.md b/docs/content/themes/dose/index.md index 52b59e12..a1c3c10c 100644 --- a/docs/content/themes/dose/index.md +++ b/docs/content/themes/dose/index.md @@ -3,11 +3,11 @@ title = "dose" description = "a small blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/oltd/dose.git" homepage = "https://github.com/oltd/dose" minimum_version = "0.13.0" diff --git a/docs/content/themes/even/index.md b/docs/content/themes/even/index.md index d46f3de2..de1bb560 100644 --- a/docs/content/themes/even/index.md +++ b/docs/content/themes/even/index.md @@ -3,11 +3,11 @@ title = "even" description = "A robust, elegant dark theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/getzola/even.git" homepage = "https://github.com/getzola/even" minimum_version = "0.11.0" diff --git a/docs/content/themes/feather/index.md b/docs/content/themes/feather/index.md index 24ac288f..8ad44d9e 100644 --- a/docs/content/themes/feather/index.md +++ b/docs/content/themes/feather/index.md @@ -3,11 +3,11 @@ title = "feather" description = "A modern blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/piedoom/feather" homepage = "https://github.com/piedoom/feather" minimum_version = "0.5.1" diff --git a/docs/content/themes/float/index.md b/docs/content/themes/float/index.md index 9f6bacc7..fb86ccbc 100644 --- a/docs/content/themes/float/index.md +++ b/docs/content/themes/float/index.md @@ -3,11 +3,11 @@ title = "Float" description = "An elegant blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://gitlab.com/float-theme/float.git" homepage = "https://float-theme.netlify.app/" minimum_version = "0.11.0" diff --git a/docs/content/themes/hallo/index.md b/docs/content/themes/hallo/index.md index 5778bb25..34e14b27 100644 --- a/docs/content/themes/hallo/index.md +++ b/docs/content/themes/hallo/index.md @@ -3,11 +3,11 @@ title = "hallo" description = "A single-page theme to introduce yourself." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/flyingP0tat0/zola-hallo.git" homepage = "https://github.com/janbaudisch/zola-hallo" minimum_version = "0.4.0" diff --git a/docs/content/themes/hyde/index.md b/docs/content/themes/hyde/index.md index f52618f7..a6bbb3b7 100644 --- a/docs/content/themes/hyde/index.md +++ b/docs/content/themes/hyde/index.md @@ -3,11 +3,11 @@ title = "hyde" description = "A classic blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/getzola/hyde.git" homepage = "https://github.com/getzola/hyde" minimum_version = "0.11.0" diff --git a/docs/content/themes/juice/index.md b/docs/content/themes/juice/index.md index 24909db1..e8f1d6da 100644 --- a/docs/content/themes/juice/index.md +++ b/docs/content/themes/juice/index.md @@ -3,11 +3,11 @@ title = "juice" description = "An intuitive, elegant, and lightweight Zola theme for product sites." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/huhu/juice" homepage = "https://github.com/huhu/juice" minimum_version = "0.11.0" diff --git a/docs/content/themes/lightspeed/index.md b/docs/content/themes/lightspeed/index.md index 09d2b705..5cb78e60 100644 --- a/docs/content/themes/lightspeed/index.md +++ b/docs/content/themes/lightspeed/index.md @@ -3,11 +3,11 @@ title = "lightspeed" description = "Zola theme with a perfect Lighthouse score" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/carpetscheme/lightspeed" homepage = "https://github.com/carpetscheme/lightspeed" minimum_version = "0.10.0" diff --git a/docs/content/themes/ntun/index.md b/docs/content/themes/ntun/index.md index 5e602444..7e12deed 100644 --- a/docs/content/themes/ntun/index.md +++ b/docs/content/themes/ntun/index.md @@ -3,11 +3,11 @@ title = "ntun-zola-theme" description = "A classic resume theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/Netoun/ntun" homepage = "https://github.com/netoun/ntun" minimum_version = "0.1.0" diff --git a/docs/content/themes/oceanic-zen/index.md b/docs/content/themes/oceanic-zen/index.md index b371abd0..93252320 100644 --- a/docs/content/themes/oceanic-zen/index.md +++ b/docs/content/themes/oceanic-zen/index.md @@ -3,11 +3,11 @@ title = "Oceanic Zen" description = "Minimalistic blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/barlog-m/oceanic-zen.git" homepage = "https://github.com/barlog-m/oceanic-zen" minimum_version = "0.12.0" diff --git a/docs/content/themes/papaya/index.md b/docs/content/themes/papaya/index.md new file mode 100644 index 00000000..35ed932d --- /dev/null +++ b/docs/content/themes/papaya/index.md @@ -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"? + +🦎 + + \ No newline at end of file diff --git a/docs/content/themes/papaya/screenshot.png b/docs/content/themes/papaya/screenshot.png new file mode 100644 index 00000000..186850e6 Binary files /dev/null and b/docs/content/themes/papaya/screenshot.png differ diff --git a/docs/content/themes/sam/index.md b/docs/content/themes/sam/index.md index dfe8b1d9..961793da 100644 --- a/docs/content/themes/sam/index.md +++ b/docs/content/themes/sam/index.md @@ -3,11 +3,11 @@ title = "sam" description = "A Simple and Minimalist theme with a focus on typography and content." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/janbaudisch/zola-sam.git" homepage = "https://github.com/janbaudisch/zola-sam" minimum_version = "0.4.0" diff --git a/docs/content/themes/simple-dev-blog/index.md b/docs/content/themes/simple-dev-blog/index.md index 6866c72a..216ad213 100644 --- a/docs/content/themes/simple-dev-blog/index.md +++ b/docs/content/themes/simple-dev-blog/index.md @@ -3,11 +3,11 @@ title = "simple-dev-blog" description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" minimum_version = "0.4.0" diff --git a/docs/content/themes/slim/index.md b/docs/content/themes/slim/index.md index abf7e5c3..6539d9c4 100644 --- a/docs/content/themes/slim/index.md +++ b/docs/content/themes/slim/index.md @@ -3,11 +3,11 @@ title = "Slim" description = "Slim is a minimal, clean and beautiful theme for Zola." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/jameshclrk/zola-slim" homepage = "https://github.com/jameshclrk/zola-slim" minimum_version = "0.8.0" diff --git a/docs/content/themes/solar-theme-zola/index.md b/docs/content/themes/solar-theme-zola/index.md index 1f94509d..9deb8e3e 100644 --- a/docs/content/themes/solar-theme-zola/index.md +++ b/docs/content/themes/solar-theme-zola/index.md @@ -3,11 +3,11 @@ title = "solar-theme-zola" description = "A port of solar-theme-hugo for zola" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/hulufei/solar-theme-zola.git" homepage = "https://github.com/hulufei/solar-theme-zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/tale-zola/index.md b/docs/content/themes/tale-zola/index.md index 4c524feb..62c93d65 100644 --- a/docs/content/themes/tale-zola/index.md +++ b/docs/content/themes/tale-zola/index.md @@ -3,11 +3,11 @@ title = "tale-zola" description = "Tala-Zola is a minimal Zola theme helping you to build a nice and seo-ready blog." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/aaranxu/tale-zola.git" homepage = "https://github.com/aaranxu/tale-zola" minimum_version = "0.13.0" diff --git a/docs/content/themes/toucan/index.md b/docs/content/themes/toucan/index.md index 7efa0c42..1f1317ef 100644 --- a/docs/content/themes/toucan/index.md +++ b/docs/content/themes/toucan/index.md @@ -3,11 +3,11 @@ title = "Toucan" description = "Inspired from Pelican default theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://git.42l.fr/HugoTrentesaux/toucan.git" homepage = "https://git.42l.fr/HugoTrentesaux/toucan" minimum_version = "0.8.0" diff --git a/docs/content/themes/zerm/index.md b/docs/content/themes/zerm/index.md index 7903ed18..40427dae 100644 --- a/docs/content/themes/zerm/index.md +++ b/docs/content/themes/zerm/index.md @@ -3,11 +3,11 @@ title = "zerm" description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/ejmg/zerm.git" homepage = "https://github.com/ejmg/zerm" minimum_version = "0.8.0" diff --git a/docs/content/themes/zola-henry/index.md b/docs/content/themes/zola-henry/index.md index 9ff2a6a8..ae94d116 100644 --- a/docs/content/themes/zola-henry/index.md +++ b/docs/content/themes/zola-henry/index.md @@ -3,11 +3,11 @@ title = "henry" description = "A timeless blog theme" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/sirodoht/zola-henry" homepage = "https://github.com/sirodoht/zola-henry" minimum_version = "0.4.0" diff --git a/docs/content/themes/zola-paper/index.md b/docs/content/themes/zola-paper/index.md index b7dce098..cfc7d608 100644 --- a/docs/content/themes/zola-paper/index.md +++ b/docs/content/themes/zola-paper/index.md @@ -3,11 +3,11 @@ title = "zola-paper" description = "A clean theme inspired from hugo-paper." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/schoenenberg/zola-paper.git" homepage = "https://github.com/schoenenberg/zola-paper" minimum_version = "0.11.0" diff --git a/docs/content/themes/zola-pickles/index.md b/docs/content/themes/zola-pickles/index.md index 6012a842..990d0514 100644 --- a/docs/content/themes/zola-pickles/index.md +++ b/docs/content/themes/zola-pickles/index.md @@ -3,11 +3,11 @@ title = "pickles" description = "A modern, simple, clean blog theme for Zola." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/lukehsiao/zola-pickles.git" homepage = "https://github.com/lukehsiao/zola-pickles" minimum_version = "0.13.0" diff --git a/docs/content/themes/zola-theme-hikari/index.md b/docs/content/themes/zola-theme-hikari/index.md index f77f0ef4..6e5dc5e2 100644 --- a/docs/content/themes/zola-theme-hikari/index.md +++ b/docs/content/themes/zola-theme-hikari/index.md @@ -3,11 +3,11 @@ title = "Hikari" description = "Fluid, responsive blog theme for Zola" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/waynee95/zola-theme-hikari" homepage = "https://github.com/waynee95/zola-theme-hikari" minimum_version = "0.5.1" diff --git a/docs/content/themes/zola.386/index.md b/docs/content/themes/zola.386/index.md index 9d4eaea7..3324fd37 100644 --- a/docs/content/themes/zola.386/index.md +++ b/docs/content/themes/zola.386/index.md @@ -3,11 +3,11 @@ title = "zola.386" description = "Zola port of the BOOTSTRA.386 theme." template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/lopes/zola.386" homepage = "https://github.com/lopes/zola.386" minimum_version = "0.10.1" diff --git a/docs/content/themes/zola_easydocs_theme/index.md b/docs/content/themes/zola_easydocs_theme/index.md index 8e09a8a8..135670ca 100644 --- a/docs/content/themes/zola_easydocs_theme/index.md +++ b/docs/content/themes/zola_easydocs_theme/index.md @@ -3,11 +3,11 @@ title = "EasyDocs" description = "An easy way to create docs for your project" template = "theme.html" -date = 2021-08-02T23:30:47+09:00 +date = 2021-08-18T01:00:57-07:00 [extra] -created = 2021-08-02T23:30:47+09:00 -updated = 2021-08-02T23:30:47+09:00 +created = 2021-08-18T01:00:57-07:00 +updated = 2021-08-18T01:00:57-07:00 repository = "https://github.com/codeandmedia/zola_easydocs_theme.git" homepage = "https://github.com/codeandmedia/zola_easydocs_theme" minimum_version = "0.13.0"