diff --git a/.gitignore b/.gitignore index 732964a5a..557bdac18 100644 --- a/.gitignore +++ b/.gitignore @@ -13,6 +13,8 @@ erl_crash.dump # content/ is generated by the export script; only keep the placeholder content/* !content/.gitkeep +# static/ox-hugo/ is populated by ox-hugo during export +static/ox-hugo/ # Elixir/Mix build artifacts for the pipeline project scripts/pipeline/_build/ scripts/pipeline/deps/ diff --git a/notes-external/external-location-image.jpg b/notes-external/external-location-image.jpg new file mode 100644 index 000000000..acfe6af22 Binary files /dev/null and b/notes-external/external-location-image.jpg differ diff --git a/notes/example-images.org b/notes/example-images.org new file mode 100644 index 000000000..c630f57a4 --- /dev/null +++ b/notes/example-images.org @@ -0,0 +1,33 @@ +:PROPERTIES: +:ID: example-images +:END: +#+title: Example: Image References + +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. + +#+ATTR_HTML: :alt Quartz logo (external URL) +[[https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSkzsTuLOt8esM6enoKwkzqA52G3p9hldlf2g&s][file:quartz-logo.jpg]] + +* 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. + +#+CAPTION: Quartz logo (local, same notes dir) +[[file:quartz-logo.jpg]] + +* 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. + +#+CAPTION: Quartz logo (outside notes dir) +[[file:/home/ignaciobll/code/quartz-org-roam/notes-external/external-location-image.jpg]] diff --git a/notes/quartz-logo.jpg b/notes/quartz-logo.jpg new file mode 100644 index 000000000..acfe6af22 Binary files /dev/null and b/notes/quartz-logo.jpg differ