Bug Report

Environment

Zola version: 0.8.0 Features used:

• shortcode
• collocated assets for page
• YYYY-MM-DD_ prefix for page
• resize_image() function

Setup

Directory structure like this:

content/section/2000-01-01_page/index.md
content/section/2000-01-01_page/image1.jpg
content/section/2000-01-01_page/image2.jpg

Attempt to create shortcode that would convert this (in index.md):

{{ render_image(path="image1.jpg", width=100, height=200) }}

Into this:

<div class="image">
<a href="/section/page/image1.jpg"><img src="static/processed_images/foo.jpg"></a>
</div>

Expected Behavior

I’ve expected that when I pass relative asset name to shortcode, I can use page from Tera context to compute both:

• path to image source to pass into resize_image()
• path to deployed image to pass into link

Current Behavior

The page.path points to path used in public directory (section/page/ - ie without prefix). It can’t be used to construct path for asset source location needed by resize_image().

The page.relative_path points section/2000-01-01_page/index.md file in correct - directory. But points to file not directory and can’t be used for computing source path for render_image()

Note: May be it could be use by sequence of split, remove last element, join, … operations, but I would not consider that very user friendly, especially for beginners 😃

Proposed solution

I can see two solutions:

1. Add page.relative_dir that would point to post directory (similar to page.relative_path)
2. Add dirname, basename, file_path filters to Tera to allow dissection and concatenation of paths

Personally, I find the second approach more desirable as it would benefit to Tera too and would be usable in wider range of applications, instead of fixing just one corner-case

Workaround

I’ve resorted into passing directory and file into shortcode separately:

{{ render_image(dir="section/2000-01-01_page", "file="image1.jpg", width=100, height=200) }}

And shortcode:

<div>
    {% set uri  = page.permalink ~ "/" ~ file %}
    {% set path = dir ~ "/" ~ file %}
    <a href="{{ uri }}"><img src="{{ resize_image(path=path, ....) }}" /></a>
</div>

I don’t like it much, because it forces me to hard-code page location in repository into index.md, which imho, negates some of the benefits of asset collocation - it will be harder to move pages around without extensive editing and breaking stuff.