
LibreOffice documents an EPUB popup workflow using a relative link from text or an image to an image in the export media directory. Prepare the target image and link deliberately, then check the resulting EPUB in the intended reader. Do not assume every reading system presents the same popup interface.
Key Takeaways
- The popup target must be an image available in the media directory.
- Use a relative link in the source document.
- Keep essential explanations understandable when popup behavior differs.
Prepare a meaningful detail image
Suppose a photo essay includes a small map and a separate close-up of a handwritten place name. Export the close-up as a distinct approved image, with enough detail for its actual purpose. Give it a stable filename such as quay-inscription-detail.png.
The LibreOffice EPUB export documentation describes relative image links into the media directory as popup inputs. Choose the export media folder intentionally rather than scattering targets across a temporary download directory.
Create the relationship in the manuscript
Use Insert > Hyperlink, choose Document, and inspect Path. In a proposed saved layout, put QuayEssay.odt in a project folder and quay-inscription-detail.png inside its sibling QuayEssay folder. The relative target from that manuscript is QuayEssay/quay-inscription-detail.png; the full image location is the project folder followed by that path. Select the link text, enter that relative target, and apply the hyperlink. This is a proposed construction, not a tested EPUB package. The official EPUB help identifies the same-name sibling folder as the default media directory. Use File > Export As > Export as EPUB and confirm the intended Custom media directory. Preserve the manuscript and media folder together. A descriptive phrase such as “View the inscription detail” tells the reader what to expect better than an unexplained symbol. Confirm that the target resolves before export.
Use the media directory selected for that book. In the default arrangement, its name matches the document base name. Keep the folder with the manuscript when transferring the project; the resource-package guide explains why missing dependencies can survive unnoticed until another editor exports.
Do not replace the main explanatory caption with a popup-only sentence if readers need that information to understand the essay.
Inspect the ebook, not the source link alone
Export and follow the link in the intended reading application. Verify the correct detail appears and that the reader can return to the main narrative. Test a second relevant reader if the publication must support it, recording any differences instead of claiming universal behavior.
The fixed versus reflowable guide helps keep layout expectations clear. The source link working on your computer does not prove that the EPUB contains the target.
Retain an accessible explanation
LibreOffice's accessibility check can help review source-image alternatives and structure. A popup containing essential lettering may still need an equivalent text explanation. Use the complex-visual description guide when an enlarged crop alone does not communicate the relevant information.
A reasonable acceptance rule is: the link has a clear purpose, the target is packaged, the correct detail opens, and the main argument remains understandable without relying on a particular popup animation. This example is hypothetical and the documented export behavior still requires reader-specific verification.
Include a short caption identifying the enlarged region. A reader who follows the detail link should understand which part of the original photograph is being examined.
Related tasks
- How Do I Explain a Diagram When One-Line Alt Text Is Not Enough?
- Why Are Images Missing When Someone Else Opens My InDesign or Photoshop Project?
- Should My AI-Illustrated Photo Book Use Fixed Layout or Reflowable Kindle Formatting?
Sources and scope
- Export as EPUB: Relative image links and custom media directory, with reader compatibility testing.
- Hyperlink Dialog: LibreOffice 26.8 Insert > Hyperlink menu route, Document type and Apply.
- Document hyperlink: Document tab Path identifies file URL, distinct from Target within document.
Documentation-based guidance; proposed review checks have not been run on a sample file.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: AI-generated conceptual editorial illustration; not a real application screenshot, observed output or before-and-after test.