excel2moodle 0.5.0__tar.gz → 0.5.1__tar.gz

excel2moodle-0.5.1/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: excel2moodle
+Version: 0.5.1
+Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
+Author: Jakob Bosse
+License-Expression: GPL-3.0-or-later
+Project-URL: Repository, https://gitlab.com/jbosse3/excel2moodle.git
+Project-URL: Documentation, https://jbosse3.gitlab.io/excel2moodle
+Keywords: moodle,XML,teaching,question,converter,open educational Ressource
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyside6>=6.8.0
+Requires-Dist: pandas>=2.1.3
+Requires-Dist: lxml>=5.4.0
+Requires-Dist: asteval>=1.0.6
+Requires-Dist: python-calamine>=0.3.2
+Dynamic: license-file
+
+# excel 2 Moodle
+![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=35%}
+
+This Python program helps to create Moodle questions in less time.
+The idea is to write the questions data into a spreadsheet file, from which the program generates the moodle compliant xml Files. 
+All questions or a selection of questions can be exported into one xml file to be imported into moodle.
+
+## Concept
+The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
+
+A `settings` sheet contains global settings to be used for all questions and categories.
+Another sheet stores metadata for the different categories of questions.
+And each category lives inside a separate sheet inside the spreadsheet document. 
+
+## Getting Started
+
+### Installation
+To get started with excel2moodle first have a look at the [installation](https://jbosse3.gitlab.io/excel2moodle/howto.html#excel2moodle-unter-windows-installieren)
+If you already have python and uv installed, it is as easy as running `uv tool install excel2moodle`.
+
+### [ Documentation ](https://jbosse3.gitlab.io/excel2moodle/index.html)
+Once excel2moodle is installed you can checkout the [example question sheet](https://gitlab.com/jbosse3/excel2moodle/-/tree/master/example?ref_type=heads) 
+in the repository.
+
+Some steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
+you can follow along.
+
+And please have a look into the [**user Reference**](https://jbosse3.gitlab.io/excel2moodle/userReference.html)
+of the documentation. 
+That part explains each part of defining a question.
+
+
+## Functionality
+* Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+* Question Preview:
+    + This helps you when selecting the correct questions for the export.
+* Export Options:
+    + you can export the questions preserving the categories in moodle
+
+### Question Types
+* Generate multiple Choice Questions:
+    + The answers can be pictures or normal text
+* Generate Numeric Questions
+* Generate parametrized numeric Questions
+* Generate parametrized cloze Questions
+
+
+![MainWindow](mainWindow.png "Logo excel2moodle"){width=80%}
+
+## Licensing and authorship
+excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
+Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse
+
+## Supporting
+A special thanks goes to the [Civil Engineering Departement of the Fachhochschule Potsdam](https://www.fh-potsdam.de/en/study-further-education/departments/civil-engineering-department) 
+where i was employed as a student associate to work on this project.
+
+If You want to support my work as well, you can by me a [coffee](https://ko-fi.com/jbosse3)
+
+# Changelogs
+
+## 0.5.1 (2025-06-24)
+Minor docs improvement and question variant bugfix
+
+### bugfix (1 change)
+
+- [Bullet points variant didn't get updated](https://gitlab.com/jbosse3/excel2moodle/-/commit/7b4ad9e9c8a4216167ae019859ebaa8def81d57f)
+
+## 0.5.0 (2025-06-20)
+settings handling improved
+
+### feature (2 changes)
+
+- [Pixmaps and vector graphics scaled to fit in preview](https://gitlab.com/jbosse3/excel2moodle/-/commit/00a6ef13fb2a0046d7641e24af6cf6f08642390e)
+- [feature: category Settings implemented](https://gitlab.com/jbosse3/excel2moodle/-/commit/d673cc3f5ba06051aa37bc17a3ef0161121cb730)
+
+### improvement (1 change)
+
+- [Tolerance is harmonized by questionData.get()](https://gitlab.com/jbosse3/excel2moodle/-/commit/8d1724f4877e1584cc531b6b3f278bdea68b5831)
+
+### Settings Errors are logged (1 change)
+
+- [Log Errors in settings Sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/07e58f957c69ea818db1c5679cf89e287817ced3)
+

excel2moodle-0.5.1/README.md

@@ -0,0 +1,85 @@
+# excel 2 Moodle
+![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=35%}
+
+This Python program helps to create Moodle questions in less time.
+The idea is to write the questions data into a spreadsheet file, from which the program generates the moodle compliant xml Files. 
+All questions or a selection of questions can be exported into one xml file to be imported into moodle.
+
+## Concept
+The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
+
+A `settings` sheet contains global settings to be used for all questions and categories.
+Another sheet stores metadata for the different categories of questions.
+And each category lives inside a separate sheet inside the spreadsheet document. 
+
+## Getting Started
+
+### Installation
+To get started with excel2moodle first have a look at the [installation](https://jbosse3.gitlab.io/excel2moodle/howto.html#excel2moodle-unter-windows-installieren)
+If you already have python and uv installed, it is as easy as running `uv tool install excel2moodle`.
+
+### [ Documentation ](https://jbosse3.gitlab.io/excel2moodle/index.html)
+Once excel2moodle is installed you can checkout the [example question sheet](https://gitlab.com/jbosse3/excel2moodle/-/tree/master/example?ref_type=heads) 
+in the repository.
+
+Some steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
+you can follow along.
+
+And please have a look into the [**user Reference**](https://jbosse3.gitlab.io/excel2moodle/userReference.html)
+of the documentation. 
+That part explains each part of defining a question.
+
+
+## Functionality
+* Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+* Question Preview:
+    + This helps you when selecting the correct questions for the export.
+* Export Options:
+    + you can export the questions preserving the categories in moodle
+
+### Question Types
+* Generate multiple Choice Questions:
+    + The answers can be pictures or normal text
+* Generate Numeric Questions
+* Generate parametrized numeric Questions
+* Generate parametrized cloze Questions
+
+
+![MainWindow](mainWindow.png "Logo excel2moodle"){width=80%}
+
+## Licensing and authorship
+excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
+Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse
+
+## Supporting
+A special thanks goes to the [Civil Engineering Departement of the Fachhochschule Potsdam](https://www.fh-potsdam.de/en/study-further-education/departments/civil-engineering-department) 
+where i was employed as a student associate to work on this project.
+
+If You want to support my work as well, you can by me a [coffee](https://ko-fi.com/jbosse3)
+
+# Changelogs
+
+## 0.5.1 (2025-06-24)
+Minor docs improvement and question variant bugfix
+
+### bugfix (1 change)
+
+- [Bullet points variant didn't get updated](https://gitlab.com/jbosse3/excel2moodle/-/commit/7b4ad9e9c8a4216167ae019859ebaa8def81d57f)
+
+## 0.5.0 (2025-06-20)
+settings handling improved
+
+### feature (2 changes)
+
+- [Pixmaps and vector graphics scaled to fit in preview](https://gitlab.com/jbosse3/excel2moodle/-/commit/00a6ef13fb2a0046d7641e24af6cf6f08642390e)
+- [feature: category Settings implemented](https://gitlab.com/jbosse3/excel2moodle/-/commit/d673cc3f5ba06051aa37bc17a3ef0161121cb730)
+
+### improvement (1 change)
+
+- [Tolerance is harmonized by questionData.get()](https://gitlab.com/jbosse3/excel2moodle/-/commit/8d1724f4877e1584cc531b6b3f278bdea68b5831)
+
+### Settings Errors are logged (1 change)
+
+- [Log Errors in settings Sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/07e58f957c69ea818db1c5679cf89e287817ced3)
+

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/exampleQuestions.html

@@ -36,6 +36,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -87,7 +88,7 @@
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">Fragenbeispiele</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/exampleQuestions.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/exampleQuestions.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/excel2moodle.core.html

@@ -35,6 +35,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -284,7 +285,7 @@
           <li class="breadcrumb-item"><a href="excel2moodle.html">excel2moodle package</a></li>
       <li class="breadcrumb-item active">excel2moodle.core package</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/excel2moodle.core.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/excel2moodle.core.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/excel2moodle.extra.html

@@ -35,6 +35,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -90,7 +91,7 @@
           <li class="breadcrumb-item"><a href="excel2moodle.html">excel2moodle package</a></li>
       <li class="breadcrumb-item active">excel2moodle.extra package</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/excel2moodle.extra.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/excel2moodle.extra.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/excel2moodle.html

@@ -35,6 +35,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -85,7 +86,7 @@
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">excel2moodle package</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/excel2moodle.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/excel2moodle.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/excel2moodle.ui.html

@@ -34,6 +34,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -154,7 +155,7 @@
           <li class="breadcrumb-item"><a href="excel2moodle.html">excel2moodle package</a></li>
       <li class="breadcrumb-item active">excel2moodle.ui package</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/excel2moodle.ui.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/excel2moodle.ui.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/genindex.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Index &mdash; excel2moodle 0.5.0 documentation</title>
+  <title>Index &mdash; excel2moodle 0.5.1 documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
       <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
 
@@ -14,7 +14,7 @@
   
         <script src="_static/jquery.js?v=5d32c60e"></script>
         <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="_static/documentation_options.js?v=1dd76d02"></script>
+        <script src="_static/documentation_options.js?v=b9afe91b"></script>
         <script src="_static/doctools.js?v=9bcbadda"></script>
         <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/js/theme.js"></script>
@@ -32,9 +32,10 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                0.5.0
+                0.5.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
@@ -72,6 +73,7 @@
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">Index</li>
       <li class="wy-breadcrumbs-aside">
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/genindex" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/howto.html

@@ -35,6 +35,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -93,7 +94,7 @@
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">How To - Schritt für Schritt Anleitung</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/howto.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/howto.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/index.html

@@ -34,6 +34,7 @@
           
           <a href="#" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -74,7 +75,7 @@
       <li><a href="#" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">excel2moodle User Guide</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/index.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/py-modindex.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Python Module Index &mdash; excel2moodle 0.5.0 documentation</title>
+  <title>Python Module Index &mdash; excel2moodle 0.5.1 documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
       <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
 
@@ -14,7 +14,7 @@
   
         <script src="_static/jquery.js?v=5d32c60e"></script>
         <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="_static/documentation_options.js?v=1dd76d02"></script>
+        <script src="_static/documentation_options.js?v=b9afe91b"></script>
         <script src="_static/doctools.js?v=9bcbadda"></script>
         <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/js/theme.js"></script>
@@ -35,9 +35,10 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                0.5.0
+                0.5.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="search.html" method="get">

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/search.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Search &mdash; excel2moodle 0.5.0 documentation</title>
+  <title>Search &mdash; excel2moodle 0.5.1 documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
       <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
 
@@ -15,7 +15,7 @@
   
         <script src="_static/jquery.js?v=5d32c60e"></script>
         <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="_static/documentation_options.js?v=1dd76d02"></script>
+        <script src="_static/documentation_options.js?v=b9afe91b"></script>
         <script src="_static/doctools.js?v=9bcbadda"></script>
         <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/js/theme.js"></script>
@@ -35,9 +35,10 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                0.5.0
+                0.5.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="#" method="get">

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/docs/_build/html/userReference.html

@@ -36,6 +36,7 @@
           
           <a href="index.html" class="icon icon-home">
             excel2moodle
+              <img src="_static/excel2moodleLogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
                 0.5.0
@@ -90,7 +91,7 @@
       <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
       <li class="breadcrumb-item active">User Reference</li>
       <li class="wy-breadcrumbs-aside">
-            <a href="_sources/userReference.rst.txt" rel="nofollow"> View page source</a>
+              <a href="https://gitlab.com//jbosse3/excel2moodle/blob/master/docs/userReference.rst" class="fa fa-gitlab"> Edit on GitLab</a>
       </li>
   </ul>
   <hr/>

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/excel2moodle/core/question.py

@@ -162,14 +162,14 @@ class Question:
         """Assemble the question to the valid xml Tree."""
         mainText = self._getTextElement()
         self.logger.debug("Starting assembly")
-        self._setAnswerElement(variant=variant)
-        textParts = self._assembleMainTextParts()
+        self._assembleAnswer(variant=variant)
+        textParts = self._assembleText(variant=variant)
         if hasattr(self, "picture") and self.picture.ready:
             mainText.append(self.picture.element)
             self.logger.debug("Appended Picture element to text")
         mainText.append(etHelpers.getCdatTxtElement(textParts))
 
-    def _assembleMainTextParts(self, variant=0) -> list[ET.Element]:
+    def _assembleText(self, variant=0) -> list[ET.Element]:
         """Assemble the Question Text.
 
         Intended for the cloze question, where the answers parts are part of the text.
@@ -202,7 +202,7 @@ class Question:
             return self.bulletList
         return None
 
-    def _setAnswerElement(self, variant: int = 0) -> None:
+    def _assembleAnswer(self, variant: int = 0) -> None:
         pass
 
     def _setID(self, id=0) -> None:
@@ -229,7 +229,7 @@ class ParametricQuestion(Question):
         def replaceMatch(match: Match[str]) -> str | int | float:
             key = match.group(1)
             if key in self.variables:
-                value = self.variables[key][variant]
+                value = self.variables[key][variant - 1]
                 return f"{value}".replace(".", ",\\!")
             return match.group(0)  # keep original if no match
 

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/excel2moodle/question_types/cloze.py

@@ -30,7 +30,7 @@ class ClozeQuestion(ParametricQuestion):
         self.questionTexts: dict[int, list[ET.Element]] = {}
         self.partsNum: int = 0
 
-    def _setAnswerElement(self, variant: int = 1) -> None:
+    def _assembleAnswer(self, variant: int = 1) -> None:
         for part, ans in self.answerVariants.items():
             result = ans[variant - 1]
             if self.answerTypes.get(part, None) == "MC":
@@ -49,8 +49,8 @@ class ClozeQuestion(ParametricQuestion):
             self.logger.debug("Appended Question Parts %s to main text", part)
             self.questionTexts[part].append(ET.Element("hr"))
 
-    def _assembleMainTextParts(self, variant=0) -> list[ET.Element]:
-        textParts = super()._assembleMainTextParts(variant=variant)
+    def _assembleText(self, variant=0) -> list[ET.Element]:
+        textParts = super()._assembleText(variant=variant)
         self.logger.debug("Appending QuestionParts to main text")
         for paragraphs in self.questionTexts.values():
             for par in paragraphs:

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/excel2moodle/question_types/nfm.py

@@ -30,7 +30,7 @@ class NFMQuestion(ParametricQuestion):
         super().__init__(*args, **kwargs)
         self.answerVariants: list[ET.Element]
 
-    def _setAnswerElement(self, variant: int = 1) -> None:
+    def _assembleAnswer(self, variant: int = 1) -> None:
         prevAnsElement = self.element.find(XMLTags.ANSWER)
         if prevAnsElement is not None:
             self.element.remove(prevAnsElement)

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/excel2moodle/ui/dialogs.py

@@ -164,16 +164,20 @@ class AboutDialog(QtWidgets.QMessageBox):
         self.setStandardButtons(QtWidgets.QMessageBox.StandardButton.Close)
 
         self.aboutMessage: str = f"""
-        <h1> About {e2mMetadata["name"]} v {e2mMetadata["version"]}</h1><br>
+        <h1> About {e2mMetadata["name"]} v{e2mMetadata["version"]}</h1><br>
         <p style="text-align:center">
 
                 <b><a href="{e2mMetadata["homepage"]}">{e2mMetadata["name"]}</a> - {e2mMetadata["description"]}</b>
         </p>
         <p style="text-align:center">
-            A <b>
-            <a href="{e2mMetadata["documentation"]}">documentation</a></b>
-            is also available.
+            If you need help you can find some <a href="https://gitlab.com/jbosse3/excel2moodle/-/example/"> examples.</a>
             </br>
+            A Documentation can be viewed by clicking "F1",
+            or onto the documentation button.
+            </br>
+        </p>
+        <p style="text-align:center">
+        To see whats new in version {e2mMetadata["version"]} see the <a href="https://gitlab.com/jbosse3/excel2moodle#changelogs"> changelogs.</a>
         </p>
         <p style="text-align:center">
         This project is maintained by {e2mMetadata["author"]}.
@@ -181,7 +185,7 @@ class AboutDialog(QtWidgets.QMessageBox):
         Development takes place at <a href="{e2mMetadata["homepage"]}"> GitLab: {e2mMetadata["homepage"]}</a>
         contributions are very welcome
         </br>
-        If you encounter any issues please report them under the repositories issues page.
+        If you encounter any issues please report them under the <a href="https://gitlab.com/jbosse3/excel2moodle/-/issues/"> repositories issues page </a>.
         </br>
         </p>
         <p style="text-align:center">

excel2moodle-0.5.1/excel2moodle.egg-info/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: excel2moodle
+Version: 0.5.1
+Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
+Author: Jakob Bosse
+License-Expression: GPL-3.0-or-later
+Project-URL: Repository, https://gitlab.com/jbosse3/excel2moodle.git
+Project-URL: Documentation, https://jbosse3.gitlab.io/excel2moodle
+Keywords: moodle,XML,teaching,question,converter,open educational Ressource
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyside6>=6.8.0
+Requires-Dist: pandas>=2.1.3
+Requires-Dist: lxml>=5.4.0
+Requires-Dist: asteval>=1.0.6
+Requires-Dist: python-calamine>=0.3.2
+Dynamic: license-file
+
+# excel 2 Moodle
+![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=35%}
+
+This Python program helps to create Moodle questions in less time.
+The idea is to write the questions data into a spreadsheet file, from which the program generates the moodle compliant xml Files. 
+All questions or a selection of questions can be exported into one xml file to be imported into moodle.
+
+## Concept
+The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
+
+A `settings` sheet contains global settings to be used for all questions and categories.
+Another sheet stores metadata for the different categories of questions.
+And each category lives inside a separate sheet inside the spreadsheet document. 
+
+## Getting Started
+
+### Installation
+To get started with excel2moodle first have a look at the [installation](https://jbosse3.gitlab.io/excel2moodle/howto.html#excel2moodle-unter-windows-installieren)
+If you already have python and uv installed, it is as easy as running `uv tool install excel2moodle`.
+
+### [ Documentation ](https://jbosse3.gitlab.io/excel2moodle/index.html)
+Once excel2moodle is installed you can checkout the [example question sheet](https://gitlab.com/jbosse3/excel2moodle/-/tree/master/example?ref_type=heads) 
+in the repository.
+
+Some steps are already documented as [ tutorials ](https://jbosse3.gitlab.io/excel2moodle/howto.html)
+you can follow along.
+
+And please have a look into the [**user Reference**](https://jbosse3.gitlab.io/excel2moodle/userReference.html)
+of the documentation. 
+That part explains each part of defining a question.
+
+
+## Functionality
+* Equation Verification:
+    + this tool helps you to validate the correct equation for the parametrized Questions.
+* Question Preview:
+    + This helps you when selecting the correct questions for the export.
+* Export Options:
+    + you can export the questions preserving the categories in moodle
+
+### Question Types
+* Generate multiple Choice Questions:
+    + The answers can be pictures or normal text
+* Generate Numeric Questions
+* Generate parametrized numeric Questions
+* Generate parametrized cloze Questions
+
+
+![MainWindow](mainWindow.png "Logo excel2moodle"){width=80%}
+
+## Licensing and authorship
+excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
+Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse
+
+## Supporting
+A special thanks goes to the [Civil Engineering Departement of the Fachhochschule Potsdam](https://www.fh-potsdam.de/en/study-further-education/departments/civil-engineering-department) 
+where i was employed as a student associate to work on this project.
+
+If You want to support my work as well, you can by me a [coffee](https://ko-fi.com/jbosse3)
+
+# Changelogs
+
+## 0.5.1 (2025-06-24)
+Minor docs improvement and question variant bugfix
+
+### bugfix (1 change)
+
+- [Bullet points variant didn't get updated](https://gitlab.com/jbosse3/excel2moodle/-/commit/7b4ad9e9c8a4216167ae019859ebaa8def81d57f)
+
+## 0.5.0 (2025-06-20)
+settings handling improved
+
+### feature (2 changes)
+
+- [Pixmaps and vector graphics scaled to fit in preview](https://gitlab.com/jbosse3/excel2moodle/-/commit/00a6ef13fb2a0046d7641e24af6cf6f08642390e)
+- [feature: category Settings implemented](https://gitlab.com/jbosse3/excel2moodle/-/commit/d673cc3f5ba06051aa37bc17a3ef0161121cb730)
+
+### improvement (1 change)
+
+- [Tolerance is harmonized by questionData.get()](https://gitlab.com/jbosse3/excel2moodle/-/commit/8d1724f4877e1584cc531b6b3f278bdea68b5831)
+
+### Settings Errors are logged (1 change)
+
+- [Log Errors in settings Sheet](https://gitlab.com/jbosse3/excel2moodle/-/commit/07e58f957c69ea818db1c5679cf89e287817ced3)
+

{excel2moodle-0.5.0 → excel2moodle-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "excel2moodle"
-version = "0.5.0"
+version = "0.5.1"
 authors = [
   { name="Jakob Bosse" },
 ]

excel2moodle-0.5.0/PKG-INFO

@@ -1,63 +0,0 @@
-Metadata-Version: 2.4
-Name: excel2moodle
-Version: 0.5.0
-Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
-Author: Jakob Bosse
-License-Expression: GPL-3.0-or-later
-Project-URL: Repository, https://gitlab.com/jbosse3/excel2moodle.git
-Project-URL: Documentation, https://jbosse3.gitlab.io/excel2moodle
-Keywords: moodle,XML,teaching,question,converter,open educational Ressource
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyside6>=6.8.0
-Requires-Dist: pandas>=2.1.3
-Requires-Dist: lxml>=5.4.0
-Requires-Dist: asteval>=1.0.6
-Requires-Dist: python-calamine>=0.3.2
-Dynamic: license-file
-
-# excel 2 Moodle
-[Deutsche README](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/README.de.md)
-
-![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=50%}
-
-This Python program helps to create Moodle questions in less time.
-The aim is to put alle the information for the questions into a spreadsheet file, and then parse it, to generate Moodle compliant XML-Files.
-
-Furthermore this program lets you create a single XML-File with a selection of questions, that then can be imported to a Moodle-Test.
-
-## Concept
-The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
-
-There Should be a sheet called "Kategorien", where an overview over the different categories is stored.
-This sheet stores The names and descriptions, for all categories. The name have to be the same as the actual sheet names with the questions.
-Furthermore the points used for grading, are set in the "Kategorien" sheet
-
-
-## Development State
-This program is still quite rough, with very litte robustness against faulty user input inside the Spreadsheet.
-
-## Functionality
-* Parse multiple Choice Questions, each into one XML file
-* Parse Numeric Questions, each into one XML file
-* create single XML File from a selection of questions
-
-## Development Goals
-* [X] creating an example spreadsheet
-* [X] Export function, to create numerical Question version from a matrix of variables and corresponding correct Answers:
-  * similar to the calculated question Type, but with the benefit, of serving all students the same exact question
-* [.] making it more robust:
-  * [X] Adding Error Messages when exporting
-  * [X] Creating logging
-  * [ ] Logging Errors to File
-  * [ ] making it Image File-Type agnostic
-* [ ] Creating a Settings Menu
-  * [ ] Making keys in spreadsheet selectable in the Settings
-  * [ ] Setting image folder
-
-## Licensing and authorship
-excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
-Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse

excel2moodle-0.5.0/README.md

@@ -1,42 +0,0 @@
-# excel 2 Moodle
-[Deutsche README](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/README.de.md)
-
-![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=50%}
-
-This Python program helps to create Moodle questions in less time.
-The aim is to put alle the information for the questions into a spreadsheet file, and then parse it, to generate Moodle compliant XML-Files.
-
-Furthermore this program lets you create a single XML-File with a selection of questions, that then can be imported to a Moodle-Test.
-
-## Concept
-The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
-
-There Should be a sheet called "Kategorien", where an overview over the different categories is stored.
-This sheet stores The names and descriptions, for all categories. The name have to be the same as the actual sheet names with the questions.
-Furthermore the points used for grading, are set in the "Kategorien" sheet
-
-
-## Development State
-This program is still quite rough, with very litte robustness against faulty user input inside the Spreadsheet.
-
-## Functionality
-* Parse multiple Choice Questions, each into one XML file
-* Parse Numeric Questions, each into one XML file
-* create single XML File from a selection of questions
-
-## Development Goals
-* [X] creating an example spreadsheet
-* [X] Export function, to create numerical Question version from a matrix of variables and corresponding correct Answers:
-  * similar to the calculated question Type, but with the benefit, of serving all students the same exact question
-* [.] making it more robust:
-  * [X] Adding Error Messages when exporting
-  * [X] Creating logging
-  * [ ] Logging Errors to File
-  * [ ] making it Image File-Type agnostic
-* [ ] Creating a Settings Menu
-  * [ ] Making keys in spreadsheet selectable in the Settings
-  * [ ] Setting image folder
-
-## Licensing and authorship
-excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
-Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse

excel2moodle-0.5.0/excel2moodle.egg-info/PKG-INFO

@@ -1,63 +0,0 @@
-Metadata-Version: 2.4
-Name: excel2moodle
-Version: 0.5.0
-Summary: A package for converting questions from a spreadsheet, to valid moodle-xml
-Author: Jakob Bosse
-License-Expression: GPL-3.0-or-later
-Project-URL: Repository, https://gitlab.com/jbosse3/excel2moodle.git
-Project-URL: Documentation, https://jbosse3.gitlab.io/excel2moodle
-Keywords: moodle,XML,teaching,question,converter,open educational Ressource
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyside6>=6.8.0
-Requires-Dist: pandas>=2.1.3
-Requires-Dist: lxml>=5.4.0
-Requires-Dist: asteval>=1.0.6
-Requires-Dist: python-calamine>=0.3.2
-Dynamic: license-file
-
-# excel 2 Moodle
-[Deutsche README](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/README.de.md)
-
-![Logo](excel2moodleLogo.png "Logo excel2moodle"){width=50%}
-
-This Python program helps to create Moodle questions in less time.
-The aim is to put alle the information for the questions into a spreadsheet file, and then parse it, to generate Moodle compliant XML-Files.
-
-Furthermore this program lets you create a single XML-File with a selection of questions, that then can be imported to a Moodle-Test.
-
-## Concept
-The concept is, to store the different questions into categories of similar types and difficulties of questions, for each of which, a separated sheet in the Spreadsheet document should be created.
-
-There Should be a sheet called "Kategorien", where an overview over the different categories is stored.
-This sheet stores The names and descriptions, for all categories. The name have to be the same as the actual sheet names with the questions.
-Furthermore the points used for grading, are set in the "Kategorien" sheet
-
-
-## Development State
-This program is still quite rough, with very litte robustness against faulty user input inside the Spreadsheet.
-
-## Functionality
-* Parse multiple Choice Questions, each into one XML file
-* Parse Numeric Questions, each into one XML file
-* create single XML File from a selection of questions
-
-## Development Goals
-* [X] creating an example spreadsheet
-* [X] Export function, to create numerical Question version from a matrix of variables and corresponding correct Answers:
-  * similar to the calculated question Type, but with the benefit, of serving all students the same exact question
-* [.] making it more robust:
-  * [X] Adding Error Messages when exporting
-  * [X] Creating logging
-  * [ ] Logging Errors to File
-  * [ ] making it Image File-Type agnostic
-* [ ] Creating a Settings Menu
-  * [ ] Making keys in spreadsheet selectable in the Settings
-  * [ ] Setting image folder
-
-## Licensing and authorship
-excel2moodle is lincensed under the latest [GNU GPL license](https://gitlab.com/jbosse3/excel2moodle/-/blob/master/LICENSE)
-Initial development was made by Richard Lorenz, and later taken over by Jakob Bosse