Is it just me, or is the search path unclear when calling shortcodes from markdown?

[JohnEmhoff]

I spent a frustrating hour or two trying to figure out how the path parameter is interpreted in {{ resize_image(path=...) }}. I was a little surprised it seems different from the markdown itself (which will find co-located assets without issue). I finally strace-d it and discovered that it searches, in this order:

1. / (i.e. the root of the zola project)
2. static/
3. content/
4. public/
5. themes/current-theme/static

The absence of CWD (i.e., the directory containing the .md file) is what triggered this odyssey. Is this a peculiarity of resize_image, or is this fundamental to zola? Either way the behavior is surprising to me and I didn't see it in the docs. Happy to provide a PR if you'd like.

[Keats]

As you found out, it searches through that: https://github.com/getzola/zola/blob/master/components/templates/src/global_fns/helpers.rs#L7-L18 and doesn't now from where it's being called.
Is the example in https://www.getzola.org/documentation/content/shortcodes/#page-or-section not enough for colocated images or are you trying to do something different?

[JohnEmhoff]

Is the example in https://www.getzola.org/documentation/content/shortcodes/#page-or-section not enough for colocated images or are you trying to do something different?

I think that example is partially the source of my confusion. I tried to do something like {{ resize_image(path=page.colocated_path ~ ...,) }} but it would fail silently because (I think?) the concatenation is illegal in the markdown and must be done in the template. At the time I couldn't figure out exactly what was happening -- the site would successfully build but the braced statement would render directly into my page.

I also don't see the search order listed there?

[Keats]

Ah yes, you can't do any Tera stuff in the markdown. I'll take PRs to clear up the docs though.

I also don't see the search order listed there?

It's kind of an implementation detail. If you think it helps understanding, we can add it to the docs

[JohnEmhoff]

Cool, just submitted #2227