34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
+++
|
|
title = "Example: Image References"
|
|
draft = false
|
|
+++
|
|
|
|
This note demonstrates the three image reference scenarios that the pipeline
|
|
must handle.
|
|
|
|
|
|
## Scenario 1: External image (URL) {#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) {#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: </span>Quartz logo (local, same notes dir)" >}}
|
|
|
|
|
|
## Scenario 3: External image (outside notes directory) {#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: </span>Quartz logo (outside notes dir)" >}}
|