Prepending parent object's title in child object's caption for includes?

[taliaperry]

For includes that feature a child object, I'm looking for a way to prepend the parent's title as part of the caption. I've poked around in the code a bit but don't have much experience with Liquid/Ruby so struggling a bit with this...
As an example:
If the parent objectid "example01" is in a "multiple" format titled "Special Thing", and child objectid "example01a" is an "image" titled "Front View", and I add to the page the following include:
{% include feature/image.html objectid="example01a" width="75" %}
which will display a caption of "Front View" by default, is there a way to adjust the "feature/image.html" file to make the caption read "Special Thing - Front View" (or similar)?

[evanwill]

@taliaperry that's a good question for that usecase! A couple thoughts (as related to CB-CSV, CB-Gh would be a bit different):

First, this might come up regularly for "multiple" items just like you describe. Generally, in those cases in CB-CSV the parent record has a image_small and image_thumb that matches the images of the first child (think of a postcard front)--so people tend to just use the parent record. In your example, this would miss out of the "Front View" part, but have the full item title.

Second, the quick way to do it, without customizing the code, would be to use the caption option and manually put the title you want, i.e. {% include feature/image.html objectid="example01a" caption="Special Thing - Front View" width="75" %}. This works well for a few items!

Finally, customizing the include is definitely possible if this is something that would regularly come up in your collection (and something we will think about in the template too). In the file "_includes/feature/image.html", look at line 38 which currently looks like:

{%- capture image_caption -%}{{ captions[forloop.index0] | default: figure.title }}{%- endcapture -%}

We will replace that line with a bit more complicated logic:

{% if captions[forloop.index0] %}{%- capture image_caption -%}{{ captions[forloop.index0] }}{% endcapture %}{% elsif figure.parentid %}{% assign parent = site.data[site.metadata] | where: "objectid", figure.parentid | first %}{% capture image_caption %}{{ parent.title }} - {{ figure.title }}{% endcapture %}{% else %}{% capture image_caption %}{{ figure.title }}{% endcapture %}{%- endif -%}

This Liquid will first check if you manually set a caption (and use it), then if it is has a parent it will find the parent title and use it + the item title, otherwise just use the title title.

[taliaperry]

Perfect, thanks for your thorough reply! Yes, customizing the include is ideal for repeated use. I'm technically using CB-GH, with some customization, and looks like it works!