| ... |
... |
@@ -1,38 +1,27 @@ |
| 1 |
1 |
{{TOC}} |
| 2 |
2 |
|
| 3 |
|
-This page explains how you, as an author of MUMIE content (i.e. as a WebMiau user), can prepare problems for the |
| 4 |
|
-problem pool and assemble worksheets in the pool browser. |
|
3 |
+This page explains how you, as an author of MUMIE content (i.e. as a WebMiau user), can prepare problems for the problem pool and assemble worksheets in the pool browser. |
| 5 |
4 |
|
| 6 |
5 |
## Best practice for creating problems (in WebMiau) |
| 7 |
6 |
|
| 8 |
|
-* Use a meaningful name for the `\name{}` command in a problem's meta information. |
| 9 |
|
-It is used to display the problem in lists. Therefore, try to avoid names like "Task 1" etc. |
|
7 |
+* Use a meaningful name for the `\name{}` command in a problem's meta information. It is used to display the problem in lists. Therefore, try to avoid names like "Task 1" etc. |
| 10 |
8 |
* If the problem is available in several languages, use the `\lang{}{}` command for the individual languages. |
| 11 |
|
-* Problems in the problem pool should be usable stand-alone. Therefore, avoid references to other |
| 12 |
|
-articles or problems, as these may not be available on the problem pool server. |
| 13 |
|
-Links to external pages are not a problem. |
| 14 |
|
-* Tag the problem with different [labels/taxonomies](Taxonomy.md) so that it can be found more easily |
| 15 |
|
-in the pool browser. |
|
9 |
+* Problems in the problem pool should be usable stand-alone. Therefore, avoid references to other articles or problems, as these may not be available on the problem pool server. Links to external pages are not a problem. |
|
10 |
+* Tag the problem with different [labels/taxonomies](Taxonomy.md) so that it can be found more easily in the pool browser. |
| 16 |
11 |
|
| 17 |
12 |
## Publishing the problem to the pool server |
| 18 |
13 |
|
| 19 |
|
-To do this, use the Publish button in WebMiau and select the pool server. If it is not yet listed in the server |
| 20 |
|
-list, you first need to set it up. How to do this is explained [here](Publish.md#publish-to-aufgabenpool). |
|
14 |
+To do this, use the Publish button in WebMiau and select the pool server. If it is not yet listed in the server list, you first need to set it up. How to do this is explained [here](Publish.md#publish-to-aufgabenpool). |
| 21 |
15 |
|
| 22 |
16 |
Note that only tasks located in WebMiau in a subdirectory of _pool_ will appear in the pool browser. |
| 23 |
17 |
|
| 24 |
18 |
## Pool browser with login |
| 25 |
19 |
|
| 26 |
|
-You probably already know the interface and functionalities of the pool browser as the |
| 27 |
|
-[_Problem Selector_](LMS-Problem-Selector.md#problem-selecting-from-pool-server) used when creating a MUMIE task. |
| 28 |
|
-As a WebMiau user, however, you have additional options, which are explained below. |
| 29 |
|
-For the general functionalities, such as filtering the list, please see |
| 30 |
|
-[_Problem Selector_](LMS-Problem-Selector.md#problem-selecting-from-pool-server). |
|
20 |
+You probably already know the interface and functionalities of the pool browser as the [_Problem Selector_](LMS-Problem-Selector.md#problem-selecting-from-pool-server) used when creating a MUMIE task. As a WebMiau user, however, you have additional options, which are explained below. For the general functionalities, such as filtering the list, please see [_Problem Selector_](LMS-Problem-Selector.md#problem-selecting-from-pool-server). |
| 31 |
21 |
|
| 32 |
22 |
### Login |
| 33 |
23 |
|
| 34 |
|
-Go to https://pool.mumie.net/pool/browser and log in with your WebMiau account. To do this, click |
| 35 |
|
-*Login* in the top right corner. |
|
24 |
+Go to https://pool.mumie.net/pool/browser and log in with your WebMiau account. To do this, click *Login* in the top right corner. |
| 36 |
25 |
|
| 37 |
26 |
 |
| 38 |
27 |
|
| ... |
... |
@@ -40,38 +29,27 @@ After logging in, you will see a list of all tasks available in the problem pool |
| 40 |
29 |
|
| 41 |
30 |
### Language setting |
| 42 |
31 |
|
| 43 |
|
-The problem pool is available in several languages. To change the display language, click the globe icon next to |
| 44 |
|
-the Login button in the top right corner and select the desired language. |
|
32 |
+The problem pool is available in several languages. To change the display language, click the globe icon next to the Login button in the top right corner and select the desired language. |
| 45 |
33 |
|
| 46 |
34 |
### Searching for tasks |
| 47 |
35 |
|
| 48 |
|
-On the left-hand side there are various filters that help you search for specific tasks. For example, you can |
| 49 |
|
-enter a search term to limit the list to tasks whose name contains that term. |
|
36 |
+On the left-hand side there are various filters that help you search for specific tasks. For example, you can enter a search term to limit the list to tasks whose name contains that term. |
| 50 |
37 |
|
| 51 |
38 |
 |
| 52 |
39 |
|
| 53 |
40 |
### Trying out tasks |
| 54 |
41 |
|
| 55 |
|
-If you click on a task in the list of displayed tasks, you will see (the latest version of) the |
| 56 |
|
-task and can try it out directly. |
| 57 |
|
-However, for a quick impression of a task, we recommend looking at the preview instead, which you can find via the |
| 58 |
|
-popup menu (click the three dots on the right). |
|
42 |
+If you click on a task in the list of displayed tasks, you will see (the latest version of) the task and can try it out directly. However, for a quick impression of a task, we recommend looking at the preview instead, which you can find via the popup menu (click the three dots on the right). |
| 59 |
43 |
|
| 60 |
44 |
### Editing tasks |
| 61 |
45 |
|
| 62 |
|
-For each pool task, the popup menu (click the three dots on the right) has a sub-item _Edit in WebMiau_. |
| 63 |
|
-This takes you to the tex file of the task (provided you have read permission for it), where you can directly fix |
| 64 |
|
-any errors in the task statement or correction (provided you have write permission for the file). |
| 65 |
|
- |
|
46 |
+For each pool task, the popup menu (click the three dots on the right) has a sub-item _Edit in WebMiau_. This takes you to the tex file of the task (provided you have read permission for it), where you can directly fix any errors in the task statement or correction (provided you have write permission for the file). |
| 66 |
47 |
|
| 67 |
48 |
 |
| 68 |
49 |
|
| 69 |
50 |
## Creating worksheets and adding them to an LMS course |
| 70 |
51 |
|
| 71 |
|
-Several problems can be embedded into your local LMS, such as Moodle, as a single MUMIE task. To do this, a |
| 72 |
|
-worksheet must be created containing these problems. |
| 73 |
|
-Such a worksheet also allows you to configure the workflow regarding how students work on it and how it is |
| 74 |
|
-corrected. |
|
52 |
+Several problems can be embedded into your local LMS, such as Moodle, as a single MUMIE task. To do this, a worksheet must be created containing these problems. Such a worksheet also allows you to configure the workflow regarding how students work on it and how it is corrected. |
| 75 |
53 |
|
| 76 |
54 |
In contrast, the workflow for stand-alone problems from the pool is fixed, namely: |
| 77 |
55 |
* Correction always happens immediately when students save their answers. |
| ... |
... |
@@ -91,19 +69,13 @@ Of course, you can also create a worksheet with just a single problem. |
| 91 |
69 |
| 5 | Click *Next* and review your settings before finally completing the creation process by clicking *Save*. | | |
| 92 |
70 |
| 6 | Import the worksheet into your local LMS (Moodle). **Important**: Enter the total score of the worksheet on the LMS side. | | |
| 93 |
71 |
|
| 94 |
|
-**Note**: A task (problem) can consist of several sub-tasks with corresponding answer fields. |
| 95 |
|
-By default, the task's score is distributed equally among the sub-tasks. However, the scoring can be changed as |
| 96 |
|
-desired in the source code, i.e. with the authoring tool WebMiau, using the `\score{}` command. |
|
72 |
+**Note**: A task (problem) can consist of several sub-tasks with corresponding answer fields. By default, the task's score is distributed equally among the sub-tasks. However, the scoring can be changed as desired in the source code, i.e. with the authoring tool WebMiau, using the `\score{}` command. |
| 97 |
73 |
|
| 98 |
|
-Example: A task has a maximum score of 3 and contains 2 sub-tasks. If we set `\score{2}` in the answer field of the |
| 99 |
|
-first sub-task and do not specify a score in the answer field of the second sub-task, the first sub-task receives |
| 100 |
|
-2 points and the second only 1 point, since the default value `\score{1}` is used for the second sub-task. |
|
74 |
+Example: A task has a maximum score of 3 and contains 2 sub-tasks. If we set `\score{2}` in the answer field of the first sub-task and do not specify a score in the answer field of the second sub-task, the first sub-task receives 2 points and the second only 1 point, since the default value `\score{1}` is used for the second sub-task. |
| 101 |
75 |
|
| 102 |
76 |
**Caution**: At present, a worksheet's properties can no longer be modified once it has been created. It can, however, still be deleted by the user who created it. |
| 103 |
77 |
|
| 104 |
|
-**Note**: You can also start with a copy of an existing worksheet by _adopting the properties_ from an |
| 105 |
|
-existing worksheet. This carries over the problems it contains and the workflow of the |
| 106 |
|
-existing worksheet. |
|
78 |
+**Note**: You can also start with a copy of an existing worksheet by _adopting the properties_ from an existing worksheet. This carries over the problems it contains and the workflow of the existing worksheet. |
| 107 |
79 |
 |
| 108 |
80 |
|
| 109 |
81 |
### Setting worksheet properties |
| ... |
... |
@@ -116,8 +88,7 @@ existing worksheet. |
| 116 |
88 |
| Order of tasks | The order in which the tasks are displayed. The order can be changed using the arrows on the left. | |
| 117 |
89 |
| Weighting in points | Determines how much weight is given to a task's points when the total score of the worksheet is calculated. | |
| 118 |
90 |
|
| 119 |
|
-Templates are available on the left-hand side for easily setting the workflow. However, the workflow can also be |
| 120 |
|
-configured individually, as described in the following table. |
|
91 |
+Templates are available on the left-hand side for easily setting the workflow. However, the workflow can also be configured individually, as described in the following table. |
| 121 |
92 |
|
| 122 |
93 |
| Worksheet workflow | Description | |
| 123 |
94 |
|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 124 |
95 |
|