math-exercises 1.3.0 → 1.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# math-exercises
|
|
2
2
|
|
|
3
|
-
This is a generator of Math exercises for middle school and high school.
|
|
3
|
+
This is a generator of Math exercises for middle school and high school.
|
|
4
4
|
|
|
5
|
-
So far, exercises are written in French, but any translation is welcome !
|
|
5
|
+
So far, exercises are written in French, but any translation is welcome !
|
|
6
6
|
|
|
7
7
|
This library is used by [Mathlive.fr](https://www.mathlive.fr) for collaborative quizzes.
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@ This library is used by [Mathlive.fr](https://www.mathlive.fr) for collaborative
|
|
|
10
10
|
|
|
11
11
|
This library is still in beta and the architecture may very well completely change in the future.
|
|
12
12
|
|
|
13
|
-
Incoming improvements :
|
|
13
|
+
Incoming improvements :
|
|
14
14
|
|
|
15
15
|
- Random images generation using tikZ
|
|
16
16
|
|
|
@@ -20,17 +20,18 @@ Incoming improvements :
|
|
|
20
20
|
|
|
21
21
|
- Better classification of exercises
|
|
22
22
|
|
|
23
|
-
|
|
24
23
|
## Exercises format
|
|
25
24
|
|
|
26
|
-
Each
|
|
25
|
+
Each Exercise has a `generator` that will return distinct questions for this exercise.
|
|
26
|
+
|
|
27
|
+
The Question in itself has an `instruction`, a `startStatement` and an `answer` (which are all tex strings).
|
|
27
28
|
|
|
28
|
-
|
|
29
|
+
You can see all the exercises implemented so far [by playing with the select input here](https://www.mathlive.fr/teacher/createActivity/quizCollab/623366c277e90f70691aee70/).
|
|
29
30
|
|
|
30
|
-
## How to use
|
|
31
|
+
## How to use
|
|
31
32
|
|
|
33
|
+
Example with (ax+b)^2 questions :
|
|
32
34
|
|
|
33
|
-
Example with (ax+b)^2 questions :
|
|
34
35
|
```
|
|
35
36
|
import { firstIdentity } from exercises/calculLitteral/distributivity/firstIdentity
|
|
36
37
|
|
|
@@ -39,18 +40,25 @@ const question = firstIdentity.generator(1)
|
|
|
39
40
|
console.log(question.startStatement)
|
|
40
41
|
console.log(question.answer)
|
|
41
42
|
|
|
42
|
-
//output :
|
|
43
|
-
// Développer et réduire :
|
|
43
|
+
//output :
|
|
44
|
+
// Développer et réduire :
|
|
44
45
|
// (2x+3)^2
|
|
45
46
|
// 4x^2 + 12x + 9
|
|
46
47
|
```
|
|
47
|
-
|
|
48
|
+
|
|
49
|
+
Beware, some exercises do not have instructions, because the instruction is directly in the question itself.
|
|
48
50
|
|
|
49
51
|
## Expression tree and latex parser
|
|
50
52
|
|
|
51
53
|
Math expressions are implemented via a tree of Nodes that you'll find inside `tree/nodes`.
|
|
52
54
|
|
|
53
|
-
|
|
55
|
+
Any expression can be turned into a valid latex output via the `.toTex()` method.
|
|
56
|
+
|
|
57
|
+
They also can be simplified via the `simplifyNode` method.
|
|
58
|
+
|
|
59
|
+
## Math objects
|
|
60
|
+
|
|
61
|
+
This library also aims to implement pretty much all mathematical objects and notions up to 12th grade : all types of numbers and operations on them, but also points, vectors, polynomials, sets... Thus it can also be used for basic mathematics work.
|
|
54
62
|
|
|
55
63
|
## Minimal dependencies
|
|
56
64
|
|
|
@@ -58,6 +66,6 @@ We're trying to keep to our dependencies to a minimum. So far we're only using m
|
|
|
58
66
|
|
|
59
67
|
## How to contribute
|
|
60
68
|
|
|
61
|
-
Any contribution is welcomed.
|
|
69
|
+
Any contribution is welcomed.
|
|
62
70
|
|
|
63
|
-
There are
|
|
71
|
+
There are tons of exercises left to implement !
|