From 42d70380b03ddfb4eb6452d8c2c0a62f271b9e3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9rome=20Eertmans?= <jeertmans@icloud.com>
Date: Sat, 25 Feb 2023 17:29:42 +0100
Subject: [PATCH] chore(docs): add embed instructions (#135)

---
 docs/source/reference/sharing.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/source/reference/sharing.md b/docs/source/reference/sharing.md
index e14cbc6..92b13aa 100644
--- a/docs/source/reference/sharing.md
+++ b/docs/source/reference/sharing.md
@@ -106,6 +106,29 @@ Example:
 
 Then, you can simply open the HTML file with any web browser application.
 
+If you want to embed the presentation inside an HTML web page, a possibility is
+to use an `iframe`:
+
+```html
+<div style="position:relative;padding-bottom:56.25%;">
+    <!-- 56.25 comes from aspect ratio of 16:9, change this accordingly -->
+    <iframe
+        style="width:100%;height:100%;position:absolute;left:0px;top:0px;"
+        frameborder="0"
+        width="100%"
+        height="100%"
+        allowfullscreen
+        allow="autoplay"
+        src="basic_example.html">
+    </iframe>
+</div>
+```
+
+The additional code comes from
+[this article](https://faq.dailymotion.com/hc/en-us/articles/360022841393-How-to-preserve-the-player-aspect-ratio-on-a-responsive-page)
+and it there to preserve the original aspect ratio (16:9).
+
+
 ### Sharing ONE HTML file
 
 A future feature, that will be available once