diff --git a/cms/djangoapps/contentstore/features/component.py b/cms/djangoapps/contentstore/features/component.py index 029dc01f87..818b5b2d77 100644 --- a/cms/djangoapps/contentstore/features/component.py +++ b/cms/djangoapps/contentstore/features/component.py @@ -55,9 +55,9 @@ def see_a_multi_step_component(step, category): if category == 'HTML': html_matcher = { 'Text': '\n \n', - 'Announcement': '
Words of encouragement! This is a short note that most students will read.
', + 'Announcement': 'This template is similar to the Text template. The only difference is', } actual_html = world.css_html(selector, index=idx) diff --git a/common/lib/xmodule/xmodule/templates/html/announcement.yaml b/common/lib/xmodule/xmodule/templates/html/announcement.yaml index 821d2a6ec6..a0f4b07e4e 100644 --- a/common/lib/xmodule/xmodule/templates/html/announcement.yaml +++ b/common/lib/xmodule/xmodule/templates/html/announcement.yaml @@ -2,22 +2,17 @@ metadata: display_name: Announcement data: | -
To use this template, replace the example text with your own text.
+When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.
+Words of encouragement! This is a short note that most students will read.
- -Unfortunately, the internet throws a lot of text at students, and they - do not read everything that they are given. However, many students do read all that they are - given, and so detailed explainations in this section will benefit the most concientious. - Any essential information should be extremely quickly summarized in the primary section for skimmers.
-- Students appreciate knowing that the course staff is reading what they post, and one of several ways - that you can do this is by acknowledging the star posters in your announcements. -
-Short note that introduces the topic
+ +Announcement 1 text
+Announcement 2 text
+ \ No newline at end of file diff --git a/common/lib/xmodule/xmodule/templates/html/latex_html.yaml b/common/lib/xmodule/xmodule/templates/html/latex_html.yaml index 9163b3e8b9..f82c60ed8d 100644 --- a/common/lib/xmodule/xmodule/templates/html/latex_html.yaml +++ b/common/lib/xmodule/xmodule/templates/html/latex_html.yaml @@ -4,18 +4,18 @@ metadata: source_code: | \subsection{Example of E-text in LaTeX} - It is very convenient to write complex equations in LaTeX. + You can write complex equations in LaTeX. \begin{equation} x = \frac{-b\pm\sqrt{b^2-4*a*c}}{2a} \end{equation} - Seize the moment. - data: | -- It is very convenient to write complex equations in LaTeX. -
+You can write complex equations in LaTeX.
+When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.
+When editing this component, select Launch Latex Source Compiler to edit equations.
+Then, in the equation editor, select Save and Compile to edX XML to see the equation in the component.
diff --git a/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml b/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml index ae62459820..144ff0358b 100644 --- a/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml +++ b/common/lib/xmodule/xmodule/templates/problem/checkboxes_response.yaml @@ -2,23 +2,49 @@ metadata: display_name: Checkboxes markdown: | - A checkboxes problem presents checkbox buttons for student input. Students can select more than one option presented. - >>Select the answer that matches<< + Checkbox problems allow learners to select multiple options. Learners can see all the options along with the problem text. + + When you add the problem, be sure to select Settings to specify a Display Name and other values that apply. - [x] correct - [ ] incorrect - [x] correct + You can use the following example problem as a model. + _____________________________________________________________________________ + + >>The following languages are in the Indo-European family:<< + [x] Urdu + [ ] Finnish + [x] Marathi + [x] French + [ ] Hungarian + + Note: Make sure you select all of the correct options—there may be more than one! + + [explanation] + Urdu, Marathi, and French are all Indo-European languages, while Finnish and Hungarian are in the Uralic family. + [explanation] data: |A checkboxes problem presents checkbox buttons for student input. Students can select more than one option presented.
-Select the answer that matches
-Checkbox problems allow learners to select multiple options. Learners can see all the options along with the problem text.
+When you add the component, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+ +Note: Make sure you select all of the correct options—there may be more than one!
+Explanation
+Urdu, Marathi, and French are all Indo-European languages, while Finnish and Hungarian are in the Uralic family.
++ Circuit schematic problems allow students to create virtual circuits by + arranging elements such as voltage sources, capacitors, resistors, and + MOSFETs on an interactive grid. The system evaluates a DC, AC, or + transient analysis of the circuit. +
++ For more information, see + + Circuit Schematic Builder Problem in Building and Running an edX Course.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problems as models.
+ +Explanation
-A voltage divider that evenly divides the input voltage can be formed with two identically valued resistors, with the sampled voltage taken in between the two.
+You can form a voltage divider that evenly divides the input voltage with two identically valued resistors, with the sampled voltage taken in between the two.

A simple high-pass filter without any further constaints can be formed by simply putting a resister in series with a capacitor. The actual values of the components do not really matter in order to meet the constraints of the problem.
+You can form a simple high-pass filter without any further constraints by simply putting a resistor in series with a capacitor. The actual values of the components do not really matter in this problem.

- A custom python-evaluated input problem accepts one or more lines of text input from the - student, and evaluates the inputs for correctness based on evaluation using a - python script embedded within the problem. +
+ In custom Python-evaluated input (also called "write-your-own-grader" + problems), the grader uses a Python script that you create and embed in + the problem to evaluate a learner's response or provide hints. These + problems can be any type. Numerical input and text input problems are + the most common write-your-own-grader problems.
++ You can use script tag format or answer tag format to create these problems. +
++ You can create custom Python-evaluated input problems that provide + partial credit or that randomize variables in the Python code. You can + also add images to the solution by using an HTML "img" tag. Note that + the "img" tag must be between the "div" tags that are inside the + "solution" tags, and that learners do not see these images until they + click the "Show Answer" button. +
+For more information, see + Write-Your-Own-Grader Problem in Building and Running an edX Course. +
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+______________________________________________________________________________
- -Enter two integers which sum to 10:
-Enter two integers which sum to 20:
-Explanation
-Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.
-You can also add images within the solution clause like so:
-
- Explanation
+Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.
+To add an image to the solution, use an HTML "img" tag. Make sure to include alt text.
+
+ + In drag and drop problems, students respond to a question by dragging text or objects to a specific location on an image. +
++ For more information, see + + Drag and Drop Problem in Building and Running an edX Course.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problems as models.
+_____________________________________________________________________________
Please label hydrogen atoms connected with left carbon atom.
-- A math expression input problem accepts a line of text representing a mathematical expression from the - student, and evaluates the input for equivalence to a mathematical expression provided by the - grader. Correctness is based on numerical sampling of the symbolic expressions. + In math expression input problems, learners enter text that represents a + mathematical expression into a field, and text is converted to a symbolic + expression that appears below that field. You can refer learners to + + Entering Mathematical and Scientific Expressions in the edX Guide for + Students for information about how to enter text into the field.
- The answer is correct if both the student provided response and the grader's mathematical - expression are equivalent to specified numerical tolerance, over a specified range of values for each - variable. + Math expression problems can include unknown variables and relatively + complicated symbolic expressions. The grader uses a numerical sampling to + determine whether the student’s response matches your math expression, to a + specified numerical tolerance. You must specify the allowed variables in the + expression as well as the range of values for each variable.
++ To create these problems, you use MathJax to change your plain text into + "beautiful math." For more information about how to use MathJax in Studio, + see + A Brief Introduction to MathJax in Studio in Building and Running an edx + Course. +
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problems as models.
+_____________________________________________________________________________
-This kind of response checking can handle symbolic expressions, but places an extra burden - on the problem author to specify the allowed variables in the expression, and the - numerical ranges over which the variables must be sampled in order to test for correctness.
+Write an expression for the product of \( R_1\), \( R_2\), and + the inverse of \( R_3\) .
+Give an equation for the relativistic energy of an object with mass m. Explicitly indicate multiplication with a * symbol.
-Let \( x\) be a variable, and let \( n\) be an arbitrary constant. + What is the derivative of \( x^n\)?
+ + + +The answer to this question is (R_1*R_2)/R_3.
- -Explanation
-The mathematical summary of many of the theory of relativity developed by Einstein is that the amount of energy contained in a mass m is the mass time the speed of light squared.
-As you can see with the formula entry, the answer is \(\frac{R_1*R_2}{R_3}\)
-- An image mapped input problem presents an image for the student. - Input is given by the location of mouse clicks on the image. - Correctness of input can be evaluated based on expected dimensions of a rectangle. -
-Which animal shown below is a kitten?
++ In an image mapped input problem, also known as a "pointing on a picture" + problem, students click inside a defined region in an image. You define this + region by including coordinates in the body of the problem. You can define + one rectangular region, multiple rectangular regions, or one non-rectangular + region. For more information, see + Image Mapped Input + Problem in Building and Running an edx Course. +
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+_____________________________________________________________________________
+ + +Explanation
+Egypt is home to not only the Pyramids, Cairo, and Memphis, but also + the Sphinx and the ancient Royal Library of Alexandria.
++ In these problems (also called custom JavaScript problems or JS Input + problems), you add a problem or tool that uses JavaScript in Studio. + Studio embeds the problem in an IFrame so that your students can + interact with it in the LMS. You can grade your students' work using + JavaScript and some basic Python, and the grading is integrated into the + edX grading system. +
++ The JS Input problem that you create must use HTML, JavaScript, and cascading + style sheets (CSS). You can use any application creation tool, such as the + Google Web Toolkit (GWT), to create your JS Input problem. +
++ For more information, see + + Custom JavaScript Problem in Building and Running an edX Course. +
+JavaScript developers shoud also see + Custom JavaScript Applications in the edX Developer's Guide.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+_____________________________________________________________________________
+ -- The shapes below can be selected (yellow) or unselected (cyan). - Clicking on them repeatedly will cycle through these two states. -
-- If the cone is selected (and not the cube), a correct answer will be - generated after pressing "Check". Clicking on either "Check" or "Save" - will register the current state. -
+In the following image, click the objects until the cone is yellow + and the cube is blue.
-
- Where is the earth?
-+
If you have a problem that is already written in LaTeX, you can use this problem type to + easily convert your code into XML. After you paste your code into the LaTeX editor, + you only need to make a few minor adjustments.
+For more information, see + + Problem Written in LaTeX in Building and Running an edX Course.
+You can use the following example problems as models.
+Example Option Problem
+ +Explanation
+India became an independent nation on August 15, 1947.
+Example Multiple Choice Problem
+ +Explanation
+According to September 2014 estimates:
+The population of Indonesia is approximately 250 million.
+The population of Brazil is approximately 200 million.
+The population of Russia is approximately 146 million.
+The population of Germany is approximately 81 million.
+Example Math Expression Problem
+ +Example Numerical Problem
+ +Example Fill-in-the-Blank Problem
+ +Explanation
+Nanjing Higher Normal Institute first admitted female students in 1920.
+Example Custom Python-Evaluated Input Problem
+ + + +Explanation
+Any set of integers on the line \(y = 10 - x\) and \(y = 20 - x\) satisfy these constraints.
+To add an image to the solution, use an HTML "img" tag. Make sure to include alt text.
+
+ Example Image Mapped Input Problem
+ +Explanation
+Egypt is home to not only the Pyramids, Cairo, and Memphis, but also + the Sphinx and the ancient Royal Library of Alexandria.
+Example Hidden Explanation
+You can provide additional information that only appears at certain times by including a "showhide" flag.
| More explanation [show] | +More Information [show] |
|---|
- A multiple choice problem presents radio buttons for student - input. Students can only select a single option presented. Multiple Choice questions have been the subject of many areas of research due to the early invention and adoption of bubble sheets.
-One of the main elements that goes into a good multiple choice question is the existence of good distractors. That is, each of the alternate responses presented to the student should be the result of a plausible mistake that a student might make. -
- -What Apple device competed with the portable CD player?
-Explanation
-The release of the iPod allowed consumers to carry their entire music library with them in a format that did not rely on fragile and energy-intensive spinning disks.
-Multiple choice problems allow learners to select only one option. + Learners can see all the options along with the problem text.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+ +Explanation
+According to September 2014 estimates:
+The population of Indonesia is approximately 250 million.
+The population of Brazil is approximately 200 million.
+The population of Russia is approximately 146 million.
+The population of Germany is approximately 81 million.
+- A numerical input problem accepts a line of text input from the - student, and evaluates the input for correctness based on its - numerical value. -
+- The answer is correct if it is within a specified numerical tolerance - of the expected answer. -
- +In a numerical input problem, learners enter numbers or a specific and + relatively simple mathematical expression. Learners enter the response in + plain text, and the system then converts the text to a symbolic expression + that learners can see below the response field.
-Enter the numerical value of Pi:
-
Enter the approximate value of 502*9:
-
The system can handle several types of characters, including basic + operators, fractions, exponents, and common constants such as i. You can + refer learners to + + Entering Mathematical and Scientific Expressions in the edX Guide for + Students for information about how to enter text into the field.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
-Enter the number of fingers on a human hand:
-
Explanation
-Pi, or the the ratio between a circle's circumference to its diameter, is an irrational number known to extreme precision. It is value is approximately equal to 3.14.
-Although you can get an exact value by typing 502*9 into a calculator, the result will be close to 500*10, or 5,000. The grader accepts any response within 15% of the true value, 4518, so that you can use any estimation technique that you like.
-If you look at your hand, you can count that you have five fingers.
-You can use the following example problems as models.
+_____________________________________________________________________________
+ + + + +Explanation
+The sun is 93,000,000, or 9.3*10^6, miles away from Earth.
+-100 is the square of 10 times the imaginary number, i.
+Dropdown problems give a limited set of options for students to respond with, and present those options - in a format that encourages them to search for a specific answer rather than being immediately presented with options from which to recognize the correct answer.
- -- The answer options and the identification of the correct answer is defined in the optioninput tag. -
-Translation between Dropdown and __________ is extremely straightforward:
-
-
Explanation
-Multiple Choice also allows students to select from a variety of pre-written responses, although the format makes it easier for students to read very long response options. Optionresponse also differs slightly because students are more likely to think of an answer and then search for it rather than relying purely on recognition to answer the question.
-Dropdown problems allow learners to select only one option from a list of options.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+ +Explanation
+India became an independent nation on August 15, 1947.
+- - A text input problem accepts a line of text from the - student, and evaluates the input for correctness based on an expected - answer. -
-- The answer is correct if it matches every character of the expected answer. This can be a problem with international spelling, dates, or anything where the format of the answer is not clear. -
- -Which US state has Lansing as its capital?
-Explanation
-Lansing is the capital of Michigan, although it is not Michigan's largest city, or even the seat of the county in which it resides.
-In text input problems, also known as "fill-in-the-blank" problems, + learners enter text into a response field. The text that the learner enters + must match your specified answer text exactly. You can specify more than + one correct answer. Learners must enter a response that matches one of the + correct answers exactly.
+When you add the problem, be sure to select Settings + to specify a Display Name and other values that apply.
+You can use the following example problem as a model.
+ +Explanation
+Nanjing Higher Normal Institute first admitted female students in 1920.
+