Update themes gallery (#1589)
Co-authored-by: GitHub Action <action@github.com>
This commit is contained in:
parent
3bedb42b0b
commit
8802e77880
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
311
docs/content/themes/papaya/index.md
Normal file
311
docs/content/themes/papaya/index.md
Normal 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"?
|
||||
|
||||
🦎
|
||||
|
||||
|
BIN
docs/content/themes/papaya/screenshot.png
Normal file
BIN
docs/content/themes/papaya/screenshot.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 342 KiB |
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
Loading…
Reference in a new issue