From 86f8d527040f3c90e19cb59b4afe520c7865721b Mon Sep 17 00:00:00 2001
From: guidopinkernell <104351808+guidopinkernell@users.noreply.github.com>
Date: Fri, 3 May 2024 12:31:09 +0200
Subject: [PATCH] Update GeoGebra.md

added information about how to control the size and proportions of the applet
---
 doc/en/Authoring/GeoGebra.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/en/Authoring/GeoGebra.md b/doc/en/Authoring/GeoGebra.md
index 323300ff0..acd97be9f 100644
--- a/doc/en/Authoring/GeoGebra.md
+++ b/doc/en/Authoring/GeoGebra.md
@@ -32,6 +32,25 @@ An example `[[geogebra]]` [question block](Question_blocks/index.md) is shown be
 
 This illustrates how the material_id is used.
 
+## Control the size of the applet
+
+There are two places where the size of the applet can be defined:
+
+Within the block, adding values to the GeoGebra parameters width and height will define the section of the applet that is to be shown.
+
+Within the block's header, adding values to the iframe parameters width and height will enlarge or reduce the size of the applet, or even distort it.
+
+```
+[[geogebra height="100px" width="175px"]]
+params["material_id"]="seehz3km";
+params["height"]=200;
+params["width"]=350;
+[[/geogebra]]
+```
+In the block's head, `width="80%" aspect-ratio="2/3"` could be used instead to define relative sizes and possible distortions if needed.
+
+If no size is defined the default is to have `width="500px" height="400px"` and these are also the dimensions used if values are missing and no aspect-ratio has been defined.
+
 ## Using the sub-tags "set", "watch" and "remember"
 
 The "set", "watch" and "remember" tags to the `[[geogebra]]` question block link Maxima values to GeoGebra objects in various ways.
-- 
GitLab