Skip to content
Snippets Groups Projects
Commit 193b0149 authored by Malthe's avatar Malthe
Browse files

Change text boxes to code blocks

Remove unnecessary #'s

Change website design to use material, and modify theme accordingly.

Add site deploy workflow
Add gitignore for site
Move overrides to site_overrides
parent e109199e
No related branches found
No related tags found
No related merge requests found
Showing
with 60 additions and 35 deletions
name: deploy_website
on:
push:
branches:
- master
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-python@v2
with:
python-version: 3.x
- run: pip install mkdocs-material
- run: pip install https://github.com/mitya57/python-markdown-math/archive/master.zip
- run: pip install pip install mkdocs-exclude
- run: pip install mkdocs-redirects
- run: mkdocs gh-deploy --force
site/*
\ No newline at end of file
File moved
File moved
/*Container for footer*/
.container-flexible {
display: grid;
width:min(700px,100%);
margin:auto;
}
.footerColumn {
float: left;
width: 33.33%;
padding: 10px;
}
/* Responsive layout - makes the three columns stack on top of each other instead of next to each other */
@media screen and (max-width: 605px) {
.footerColumn {
width: 100%;
}
}
\ No newline at end of file
# The mathematics of the STACK logo # # The mathematics of the STACK logo
The STACK logo is based on the following problem. The STACK logo is based on the following problem.
......
...@@ -2,8 +2,6 @@ ...@@ -2,8 +2,6 @@
1 - First question | [2 - Question variables](Authoring_quick_start_2.md) | [3 - Feedback](Authoring_quick_start_3.md) | [4 - Randomisation](Authoring_quick_start_4.md) | [5 - Question tests](Authoring_quick_start_5.md) | [6 - Multipart questions](Authoring_quick_start_6.md) | [7 - Simplification](Authoring_quick_start_7.md) | [8 - Quizzes](Authoring_quick_start_8.md) 1 - First question | [2 - Question variables](Authoring_quick_start_2.md) | [3 - Feedback](Authoring_quick_start_3.md) | [4 - Randomisation](Authoring_quick_start_4.md) | [5 - Question tests](Authoring_quick_start_5.md) | [6 - Multipart questions](Authoring_quick_start_6.md) | [7 - Simplification](Authoring_quick_start_7.md) | [8 - Quizzes](Authoring_quick_start_8.md)
The authoring quick start guide shows you how to write STACK questions. Part 1 gets a minimal question working. The following video explains the process: The authoring quick start guide shows you how to write STACK questions. Part 1 gets a minimal question working. The following video explains the process:
<iframe width="560" height="315" src="https://www.youtube.com/embed/cpwo-D6EUgA" frameborder="0" allowfullscreen></iframe> <iframe width="560" height="315" src="https://www.youtube.com/embed/cpwo-D6EUgA" frameborder="0" allowfullscreen></iframe>
...@@ -35,10 +33,8 @@ You must give the question a name, for example `question1`. ...@@ -35,10 +33,8 @@ You must give the question a name, for example `question1`.
Let's focus on the problem of differentiating \((x-1)^3\) with respect to \(x\). We need to write the question text itself. Copy the following into the Question text box: Let's focus on the problem of differentiating \((x-1)^3\) with respect to \(x\). We need to write the question text itself. Copy the following into the Question text box:
<textarea readonly="readonly" rows="2" cols="50">
Differentiate \((x-1)^3\) with respect to x. Differentiate \((x-1)^3\) with respect to x.
[[input:ans1]] [[validation:ans1]] [[input:ans1]] [[validation:ans1]]
</textarea>
Notes: Notes:
......
...@@ -35,10 +35,8 @@ Notice we are using the CAS to determine the model answer by calling the `int()` ...@@ -35,10 +35,8 @@ Notice we are using the CAS to determine the model answer by calling the `int()`
Now it will be a lot faster to fill out the rest of the question. Add the following to the question text: Now it will be a lot faster to fill out the rest of the question. Add the following to the question text:
<textarea readonly="readonly" rows="3" cols="50">
Find \(\int{@exp@} \mathrm{d}x\) Find \(\int{@exp@} \mathrm{d}x\)
[[input:ans1]] [[validation:ans1]] [[input:ans1]] [[validation:ans1]]
</textarea>
Notice that we have defined a local variable `exp`, and used the value of this in the Question text. There is a difference between mathematics enclosed between `\(..\)` symbols and `{@..@}` symbols. All the text-based fields in the question, including feedback, are [CAS text](CASText.md). This is HTML into which mathematics can be inserted. LaTeX is placed between `\(..\)`s, and CAS expressions (including your variables) between matching `{@..@}` symbols. The CAS expressions are evaluated in the context of the question variables and displayed as LaTeX. Notice that we have defined a local variable `exp`, and used the value of this in the Question text. There is a difference between mathematics enclosed between `\(..\)` symbols and `{@..@}` symbols. All the text-based fields in the question, including feedback, are [CAS text](CASText.md). This is HTML into which mathematics can be inserted. LaTeX is placed between `\(..\)`s, and CAS expressions (including your variables) between matching `{@..@}` symbols. The CAS expressions are evaluated in the context of the question variables and displayed as LaTeX.
......
...@@ -62,12 +62,10 @@ __Question text__ ...@@ -62,12 +62,10 @@ __Question text__
Copy the following text into the editor. Copy the following text into the editor.
<textarea readonly="readonly" rows="5" cols="120">
Find the equation of the line tangent to {@exp@} at the point \(x={@pt@}\). Find the equation of the line tangent to {@exp@} at the point \(x={@pt@}\).
1. Differentiate {@exp@} with respect to \(x\). [[input:ans1]] [[validation:ans1]] [[feedback:prt1]] 1. Differentiate {@exp@} with respect to \(x\). [[input:ans1]] [[validation:ans1]] [[feedback:prt1]]
2. Evaluate your derivative at \(x={@pt@}\). [[input:ans2]] [[validation:ans2]] [[feedback:prt2]] 2. Evaluate your derivative at \(x={@pt@}\). [[input:ans2]] [[validation:ans2]] [[feedback:prt2]]
3. Hence, find the equation of the tangent line. \(y=\)[[input:ans3]] [[validation:ans3]] [[feedback:prt3]] 3. Hence, find the equation of the tangent line. \(y=\)[[input:ans3]] [[validation:ans3]] [[feedback:prt3]]
</textarea>
Fill in the answer for `ans1` (which exists by default) and remove the `feedback` tag from the "specific feedback" section. We choose to embed feedback within parts of this question, so that relevant feedback is shown directly underneath the relevant part. Notice there is one potential response tree for each "part". Fill in the answer for `ans1` (which exists by default) and remove the `feedback` tag from the "specific feedback" section. We choose to embed feedback within parts of this question, so that relevant feedback is shown directly underneath the relevant part. Notice there is one potential response tree for each "part".
...@@ -113,9 +111,7 @@ Node 1: did they evaluate their expression in part 1 correctly? If "yes", then g ...@@ -113,9 +111,7 @@ Node 1: did they evaluate their expression in part 1 correctly? If "yes", then g
Node 2: did they get part 1 correct? if "yes" then this is the ideal situation, full marks. If "no" then choose marks as suit your taste in this situation, and add some feedback, such as the following: Node 2: did they get part 1 correct? if "yes" then this is the ideal situation, full marks. If "no" then choose marks as suit your taste in this situation, and add some feedback, such as the following:
<textarea readonly="readonly" rows="2" cols="50">
You have correctly evaluated your answer to part 1 at the given point, but your answer to part 1 is wrong. Please try both parts again. You have correctly evaluated your answer to part 1 at the given point, but your answer to part 1 is wrong. Please try both parts again.
</textarea>
# Next step # # Next step #
......
...@@ -43,10 +43,8 @@ In this context the teacher's answer and the student's answer is a list. The wh ...@@ -43,10 +43,8 @@ In this context the teacher's answer and the student's answer is a list. The wh
Copy the following text into the Question text box: Copy the following text into the Question text box:
<textarea readonly="readonly" rows="2" cols="50">
Expand {@p@}, remembering to show your working. Expand {@p@}, remembering to show your working.
[[input:ans1]] [[validation:ans1]] [[input:ans1]] [[validation:ans1]]
</textarea>
### Setting the input options ### ### Setting the input options ###
......
# Feedback # # Feedback
The purpose of STACK is to assess students' answers to mathematical questions, The purpose of STACK is to assess students' answers to mathematical questions,
and on the basis of the properties we establish to assign _feedback_. and on the basis of the properties we establish to assign _feedback_.
......
# Buggy rules # # Buggy rules
In order to establish that the student has done something In order to establish that the student has done something
particular but wrong, it is useful for us to be able to apply particular but wrong, it is useful for us to be able to apply
......
# Inequalities # # Inequalities
The non-strict inequalities \(\geq\) and \(\leq\) are created as infix operators with the respective syntax The non-strict inequalities \(\geq\) and \(\leq\) are created as infix operators with the respective syntax
......
# Numbers in STACK # # Numbers in STACK
Numerical answer tests are documented in a page dedicated to [numerical answer tests](../Authoring/Answer_tests_numerical.md). Numerical answer tests are documented in a page dedicated to [numerical answer tests](../Authoring/Answer_tests_numerical.md).
......
# Writing a permutation as a product of disjoint cycles # Writing a permutation as a product of disjoint cycles
Let \(f= \left(\begin{matrix} 1 & 2 & 3 & 4 & 5 & 6 & 7 \\ 3 & 1 & 5 & 7 & 2 & 6 & 4 \end{matrix}\right)\) Let \[f= \left( \begin{array}{ccccccc} 1 & 2 & 3 & 4 & 5 & 6 & 7 \\ 3 & 1 & 5 & 7 & 2 & 6 & 4 \end{array}\right)\]
In pure mathematics we might ask students to write a permutation such as this as a product of disjoint cycles. In pure mathematics we might ask students to write a permutation such as this as a product of disjoint cycles.
......
# Random objects # # Random objects
STACK can generate structured random objects. STACK provides a [Maxima](Maxima.md) function `rand()` which can be used in the question and answer variables. STACK can generate structured random objects. STACK provides a [Maxima](Maxima.md) function `rand()` which can be used in the question and answer variables.
......
# Displaying mathematics for STACK in Moodle # # Displaying mathematics for STACK in Moodle
STACK generates LaTeX code on the fly and expects to use a Moodle filter to convert this into something the user's browser will display. For Moodle 2.7 or later, MathJax is distributed as a filter. We strongly recommend using the Moodle MathJax filter. One reason for adopting MathJax is that it aids [accessibility](../Students/Accessibility.md). STACK generates LaTeX code on the fly and expects to use a Moodle filter to convert this into something the user's browser will display. For Moodle 2.7 or later, MathJax is distributed as a filter. We strongly recommend using the Moodle MathJax filter. One reason for adopting MathJax is that it aids [accessibility](../Students/Accessibility.md).
......
...@@ -112,7 +112,7 @@ Use the underscore character to denote a subscript. For example, \(a_b\) should ...@@ -112,7 +112,7 @@ Use the underscore character to denote a subscript. For example, \(a_b\) should
* **Modulus function**: The modulus function, sometimes called the absolute value of _x_, * **Modulus function**: The modulus function, sometimes called the absolute value of _x_,
is written as |_x_| in traditional notation. This must be entered as `abs(x)`. is written as |_x_| in traditional notation. This must be entered as `abs(x)`.
### **Trigonometrical functions** ### ### Trigonometrical functions ###
Things to remember: Things to remember:
...@@ -126,7 +126,7 @@ Things to remember: ...@@ -126,7 +126,7 @@ Things to remember:
This traditional notation is really rather unfortunate and is not used by the CAS; instead, This traditional notation is really rather unfortunate and is not used by the CAS; instead,
\(\sin^{-1}(x)\) should be entered as `asin(x)`. Similarly, \(\tan^{-1}(x)\) should be entered as `atan(x)` and so on. \(\sin^{-1}(x)\) should be entered as `asin(x)`. Similarly, \(\tan^{-1}(x)\) should be entered as `atan(x)` and so on.
### **Exponentials** and **Logarithms** ### ### Exponentials and Logarithms ###
* To enter the exponential function type `exp(x)`. Typing `e^x` should work in STACK, but gets you into bad habits when using a CAS later! * To enter the exponential function type `exp(x)`. Typing `e^x` should work in STACK, but gets you into bad habits when using a CAS later!
* Type `ln(x)` or `log(x)` to enter the _natural logarithm_ of \(x\) with base \(e\approx 2.71\cdots\). Note that both of these start with a lower case l for logarithm, not a capital I (`i`). * Type `ln(x)` or `log(x)` to enter the _natural logarithm_ of \(x\) with base \(e\approx 2.71\cdots\). Note that both of these start with a lower case l for logarithm, not a capital I (`i`).
......
# Frequently asked questions # # Frequently asked questions
This page is designed to help student users of STACK, rather than question authors. This page is designed to help student users of STACK, rather than question authors.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment