1.3 KiB
+++ title = "Example: Image References" draft = false +++
This note demonstrates the three image reference scenarios that the pipeline must handle.
Scenario 1: External image (URL)
An image hosted on the web — ox-hugo passes the URL through as-is and no local file handling is needed.
{{< figure src="quartz-logo-external.png" link=""https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSkzsTuLOt8esM6enoKwkzqA52G3p9hldlf2g&s"" >}}
Scenario 2: Local image (same notes directory)
An image sitting next to this .org file inside the notes directory.
ox-hugo copies files referenced with a relative path into the Hugo static/
assets tree automatically.
{{< figure src="/ox-hugo/quartz-logo.png" caption="<span class="figure-number">Figure 1: Quartz logo (local, same notes dir)" >}}
Scenario 3: External image (outside notes directory)
An image that lives outside the notes directory entirely — for example a
shared assets folder or a system path. ox-hugo still copies it into static/
and rewrites the reference.
{{< figure src="/ox-hugo/external-location-image.png" caption="<span class="figure-number">Figure 2: Quartz logo (outside notes dir)" >}}