Merge pull request #1943 from edx/markhoeber/documentation/glossary
Markhoeber/documentation/glossary
This commit is contained in:
Binary file not shown.
|
Before Width: | Height: | Size: 8.7 KiB After Width: | Height: | Size: 9.1 KiB |
BIN
docs/course_authors/source/Images/LTI_policy_key.gif
Normal file
BIN
docs/course_authors/source/Images/LTI_policy_key.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.5 KiB |
@@ -17,10 +17,10 @@ templates for these problems, but the problems open directly in the
|
||||
create. These problems can be any type.
|
||||
- :ref:`Drag and Drop` Drag and drop problems require students to drag text
|
||||
or objects to a specific location on an image.
|
||||
- :ref:`JavaScript Input` JavaScript input problems allow you to incorporate
|
||||
problem types that you've created in HTML into Studio via an IFrame.
|
||||
- :ref:`Image Mapped Input` Image mapped input problems require students to
|
||||
click a specific location on an image.
|
||||
- :ref:`JavaScript Input` JavaScript input problems allow you to incorporate
|
||||
problem types that you've created in HTML into Studio via an IFrame.
|
||||
- :ref:`Math Expression Input` Math expression input problems require
|
||||
students to enter a mathematical expression as text, such as
|
||||
e=m\*c^2.
|
||||
@@ -136,6 +136,120 @@ To create a image mapped input problem:
|
||||
#. In the component editor, replace the example code with your own code.
|
||||
#. Click **Save**.
|
||||
|
||||
.. _JavaScript Input:
|
||||
|
||||
JavaScript Input
|
||||
----------------
|
||||
|
||||
The JavaScript Input problem type allows you to create your own learning tool
|
||||
using HTML and other standard Internet languages and then add the tool directly
|
||||
into Studio. When you use this problem type, Studio embeds your tool 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.
|
||||
|
||||
This problem type doesn't appear in the menu of advanced problems in Studio. To
|
||||
create a JavaScript input problem type, you'll create a blank advanced problem,
|
||||
and then enter your code into the component editor.
|
||||
|
||||
.. image:: /Images/JavaScriptInputExample.gif
|
||||
|
||||
Create a JavaScript Input Problem
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
#. Create your JavaScript application, and then upload all files associated with
|
||||
that application to the **Files & Uploads** page.
|
||||
#. In the unit where you want to create the problem, click **Problem**
|
||||
under **Add New Component**, and then click the **Advanced** tab.
|
||||
#. Click **Blank Advanced Problem**.
|
||||
#. In the component that appears, click **Edit**.
|
||||
#. Click the **Settings** tab.
|
||||
#. Set **Maximum Attempts** to a number larger than zero.
|
||||
#. In the component editor, enter your code.
|
||||
#. Click **Save**.
|
||||
|
||||
To re-create the example problem above, follow these steps.
|
||||
|
||||
#. Go to :ref:`Appendix F` and use the code samples to create the following files:
|
||||
|
||||
- webGLDemo.html
|
||||
- webGLDemo.js
|
||||
- webGLDemo.css
|
||||
- three.min.js
|
||||
|
||||
#. On the **Files & Uploads** page, upload the four files you just created.
|
||||
#. Create a new blank advanced problem component.
|
||||
#. On the **Settings** tab, set **Maximum Attempts** to a number larger than
|
||||
zero.
|
||||
#. In the problem component editor, paste the code below.
|
||||
#. Click **Save.**
|
||||
|
||||
|
||||
|
||||
JavaScript Input Problem Code
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
::
|
||||
|
||||
<problem display_name="webGLDemo">
|
||||
In the image below, click the cone.
|
||||
|
||||
<script type="loncapa/python">
|
||||
import json
|
||||
def vglcfn(e, ans):
|
||||
'''
|
||||
par is a dictionary containing two keys, "answer" and "state"
|
||||
The value of answer is the JSON string returned by getGrade
|
||||
The value of state is the JSON string returned by getState
|
||||
'''
|
||||
par = json.loads(ans)
|
||||
# We can use either the value of the answer key to grade
|
||||
answer = json.loads(par["answer"])
|
||||
return answer["cylinder"] and not answer["cube"]
|
||||
# Or we can use the value of the state key
|
||||
'''
|
||||
state = json.loads(par["state"])
|
||||
selectedObjects = state["selectedObjects"]
|
||||
return selectedObjects["cylinder"] and not selectedObjects["cube"]
|
||||
'''
|
||||
</script>
|
||||
<customresponse cfn="vglcfn">
|
||||
<jsinput
|
||||
gradefn="WebGLDemo.getGrade"
|
||||
get_statefn="WebGLDemo.getState"
|
||||
set_statefn="WebGLDemo.setState"
|
||||
width="400"
|
||||
height="400"
|
||||
html_file="/static/webGLDemo.html"
|
||||
/>
|
||||
</customresponse>
|
||||
</problem>
|
||||
|
||||
|
||||
.. notes:: When you create a JavaScript Input problem, keep the following in mind.
|
||||
|
||||
- The webGLDemo.js file defines the three JavaScript functions (**WebGLDemo.getGrade**,
|
||||
**WebGLDemo.getState**, and **WebGLDemo.setState**).
|
||||
|
||||
- The JavaScript input problem code uses **WebGLDemo.getGrade**, **WebGLDemo.getState**,
|
||||
and **WebGLDemo.setState** to grade, save, or restore a problem. These functions must
|
||||
be global in scope.
|
||||
|
||||
- **WebGLDemo.getState** and **WebGLDemo.setState** are optional. You only have to define
|
||||
these functions if you want to conserve the state of the problem.
|
||||
|
||||
- **Width** and **height** represent the dimensions of the IFrame that holds the
|
||||
application.
|
||||
|
||||
- When the problem opens, the cone and the cube are both blue, or "unselected." When
|
||||
you click either shape once, the shape becomes yellow, or "selected." To unselect
|
||||
the shape, click it again. Continue clicking the shape to select and unselect it.
|
||||
|
||||
- The response is graded as correct if the cone is selected (yellow) when the user
|
||||
clicks **Check**.
|
||||
|
||||
- Clicking **Check** or **Save** registers the problem's current state.
|
||||
|
||||
.. _Math Expression Input:
|
||||
|
||||
Math Expression Input
|
||||
|
||||
@@ -529,6 +529,7 @@ We urge usage of <formulaequationinput />. See the opening paragraphs of the
|
||||
|
||||
.. image:: ../Images/numericalresponse5.png
|
||||
|
||||
.. _Math Expression Syntax:
|
||||
|
||||
Math Expression Syntax
|
||||
----------------------
|
||||
@@ -788,6 +789,7 @@ XML Attribute Information
|
||||
|
||||
\newpage %
|
||||
|
||||
.. _Custom Response:
|
||||
|
||||
Custom Response
|
||||
===============
|
||||
@@ -916,6 +918,8 @@ Sample Problem:
|
||||
|
||||
\newpage %
|
||||
|
||||
.. _Chemical Equation Response:
|
||||
|
||||
Chemical Equation Response
|
||||
==========================
|
||||
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
.. _Common Problems:
|
||||
|
||||
#############################
|
||||
############################
|
||||
Common Problems
|
||||
#############################
|
||||
############################
|
||||
|
||||
*Common problems* are typical problems such as multiple choice problems
|
||||
and other problems whose answers are simple for students to select or
|
||||
|
||||
@@ -32,8 +32,8 @@ See the following topics:
|
||||
Create an HTML Component
|
||||
*****************************
|
||||
|
||||
To create a new HTML component in an existing Unit, ensure the Unit is Private.
|
||||
For more information on Public and Private Units, see :ref:`Public and Private Units`.
|
||||
To create a new HTML component in an existing unit, ensure the unit is private.
|
||||
For more information on public and private units, see :ref:`Public and Private Units`.
|
||||
|
||||
#. Under **Add New Component**, click the **html** icon.
|
||||
|
||||
|
||||
@@ -1,97 +1,188 @@
|
||||
**********************
|
||||
Create a LTI Component
|
||||
**********************
|
||||
.. _Working with LTI Components:
|
||||
|
||||
Description
|
||||
===========
|
||||
Working with LTI Components
|
||||
============================
|
||||
|
||||
The LTI XModule is based on the `IMS Global Learning Tools Interoperability <http://www.imsglobal.org/LTI/v1p1p1/ltiIMGv1p1p1.html>`_ Version 1.1.1 specifications.
|
||||
|
||||
Enabling LTI
|
||||
============
|
||||
Introduction to LTI Components
|
||||
------------------------------
|
||||
|
||||
It is not available from the list of general components. To turn it on, add
|
||||
"lti" to the "advanced_modules" key on the Advanced Settings page.
|
||||
You may have discovered or developed an external learning application
|
||||
that you want to add to your online course. Or, you may have a digital
|
||||
copy of your textbook that uses a format other than PDF. You can add
|
||||
external learning applications or textbooks to Studio by using a
|
||||
Learning Tools Interoperability (LTI) component. The LTI component is
|
||||
based on the `IMS Global Learning Tools
|
||||
Interoperability <http://www.imsglobal.org/LTI/v1p1p1/ltiIMGv1p1p1.html>`_
|
||||
version 1.1.1 specifications.
|
||||
|
||||
The module supports 2 modes of operation.
|
||||
You can use an LTI component in two ways.
|
||||
|
||||
1. Simple display of external LTI content
|
||||
2. Display of LTI content that will be graded by external provider
|
||||
- You can add external LTI content that is displayed only, such as
|
||||
textbook content that doesn’t require a student response.
|
||||
- You can add external LTI content that requires a student response. An
|
||||
external provider will grade student responses.
|
||||
|
||||
In both cases, before an LTI component from an external provider can be
|
||||
included in a unit, the following pieces of information must be known/decided
|
||||
upon:
|
||||
Before you create an LTI component from an external LTI provider in a
|
||||
unit, you need the following information.
|
||||
|
||||
**LTI id** [string]
|
||||
Internal string representing the external LTI provider. Can contain multi-
|
||||
case alphanumeric characters, and underscore.
|
||||
- The **LTI ID**. This is a value that you create to refer to the external LTI
|
||||
provider. You should create an LTI ID that you can remember easily.
|
||||
|
||||
**Client key** [string]
|
||||
Used for OAuth authentication. Issued by external LTI provider.
|
||||
The LTI ID can contain uppercase and lowercase alphanumeric
|
||||
characters, as well as underscore characters (_). It can contain any
|
||||
number of characters. For example, you may create an LTI ID that is
|
||||
as simple as **test_lti_id**, or your LTI ID may be a string of
|
||||
numbers and letters such as **id_21441** or
|
||||
**book_lti_provider_from_new_york**.
|
||||
- The **client key**. This value is a sequence of characters that you
|
||||
obtain from the LTI provider. The client key is used for
|
||||
authentication and can contain any number of characters. For example,
|
||||
your client key may be **b289378-f88d-2929-ctools.umich.edu**.
|
||||
- The **client secret**. This value is a sequence of characters that
|
||||
you obtain from the LTI provider. The client secret is used for
|
||||
authentication and can contain any number of characters. For example,
|
||||
your client secret may be something as simple as **secret**, or it
|
||||
may be a string of numbers and letters such as **23746387264** or
|
||||
**yt4984yr8**.
|
||||
- The **launch URL** (if the LTI component requires a student response
|
||||
that will be graded). You obtain the launch URL from the LTI
|
||||
provider. The launch URL is the URL that Studio sends to the external
|
||||
LTI provider so that the provider can send back students’ grades.
|
||||
|
||||
**Client secret** [string]
|
||||
Used for OAuth authentication. Issued by external LTI provider.
|
||||
Create an LTI Component
|
||||
-----------------------
|
||||
|
||||
LTI id is necessary to differentiate between multiple available external LTI
|
||||
providers that are added to an edX course.
|
||||
Creating an LTI component in your course has three steps.
|
||||
|
||||
The three fields above must be entered in "lti_passports" field in the format::
|
||||
#. Add LTI to the **advanced_modules** policy key.
|
||||
#. Register the LTI provider.
|
||||
#. Create the LTI component in an individual unit.
|
||||
|
||||
[
|
||||
"{lti_id}:{client_key}:{client_secret}"
|
||||
]
|
||||
Step 1. Add LTI to the Advanced Modules Policy Key
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Multiple external LTI providers are separated by commas::
|
||||
#. On the **Settings** menu, click **Advanced Settings**.
|
||||
#. On the **Advanced Settings** page, locate the **Manual Policy
|
||||
Definition** section, and then locate the **advanced_modules**
|
||||
policy key (this key is at the top of the list).
|
||||
|
||||
.. image:: Images/AdvancedModulesEmpty.gif
|
||||
|
||||
#. Under **Policy Value**, place your cursor between the brackets, and
|
||||
then enter **“lti”**. Make sure to include the quotation marks, but
|
||||
not the period.
|
||||
|
||||
.. image:: Images/LTI_Policy_Key.gif
|
||||
|
||||
[
|
||||
"{lti_id_1}:{client_key_1}:{client_secret_1}",
|
||||
"{lti_id_2}:{client_key_2}:{client_secret_2}",
|
||||
"{lti_id_3}:{client_key_3}:{client_secret_3}"
|
||||
]
|
||||
**Note** If the **Policy Value** field already contains text, place your
|
||||
cursor directly after the closing quotation mark for the final item, and
|
||||
then enter a comma followed by **“lti”** (make sure that you include the
|
||||
quotation marks).
|
||||
|
||||
Adding LTI to a unit
|
||||
====================
|
||||
#. At the bottom of the page, click **Save Changes**.
|
||||
|
||||
After LTI has been enabled, and an external provider has been registered, an
|
||||
instance of it can be added to a unit.
|
||||
The page refreshes automatically. At the top of the page,
|
||||
you see a notification that your changes have been saved.
|
||||
|
||||
LTI will be available from the Advanced Component category. After adding an LTI
|
||||
component to a unit, it can be configured by Editing it's settings (the Edit
|
||||
dialog). The following settings are available:
|
||||
Step 2. Register the External LTI Provider
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Display Name** [string]
|
||||
Title of the new LTI component instance
|
||||
To regiser the external LTI provider, you’ll add the LIT ID, the client
|
||||
key, and the client secret in the **lti_passports** policy key.
|
||||
|
||||
**custom_parameters** [string]
|
||||
With the "+ Add" button, multiple custom parameters can be
|
||||
added. Basically, each individual external LTI provider can have a separate
|
||||
format custom parameters. For example::
|
||||
#. On the **Advanced Settings** page, locate the **lti_passports**
|
||||
policy key.
|
||||
|
||||
#. Under **Policy Value**, place your cursor between the brackets, and
|
||||
then enter the LTI ID, client key, and client secret in the following
|
||||
format (make sure to include the quotation marks and the colons).
|
||||
|
||||
::
|
||||
|
||||
“lti_id:client_key:client_secret”
|
||||
|
||||
key=value
|
||||
For example, the value in the **lti_passports** field may be the following.
|
||||
|
||||
**graded** [boolean]
|
||||
Whether or not the grade for this particular LTI instance problem will be
|
||||
counted towards student's total grade.
|
||||
::
|
||||
|
||||
“test_lti_id:b289378-f88d-2929-ctools.umich.edu:secret”
|
||||
|
||||
**launch_url** [string]
|
||||
If `rgaded` above is set to `true`, then this must be
|
||||
the URL that will be passed to the external LTI provider for it to respond with
|
||||
a grade.
|
||||
If you have multiple LTI providers, separate the values with a comma.
|
||||
Make sure to surround each entry with quotation marks.
|
||||
|
||||
**lti_id** [string]
|
||||
Internal string representing the external LTI provider that
|
||||
will be used to display content. The same as was entered on the Advanced
|
||||
Settings page.
|
||||
::
|
||||
|
||||
"test_lti_id:b289378-f88d-2929-ctools.umich.edu:secret",
|
||||
"id_21441:b289378-f88d-2929-ctools.school.edu:23746387264",
|
||||
"book_lti_provider_from_new_york:b289378-f88d-2929-ctools.company.com:yt4984yr8"
|
||||
|
||||
**open_in_a_new_page** [boolean]
|
||||
If set to `true`, a link will be present for the student
|
||||
to click. When the link is clicked, a new window will open with the external
|
||||
LTI content. If set to `false`, the external LTI content will be loaded in the
|
||||
page in an iframe.
|
||||
|
||||
**weight** [float]
|
||||
If the problem will be graded by an external LTI provider,
|
||||
the raw grade will be in the range [0.0, 1.0]. In order to change this range,
|
||||
set the `weight`. The grade that will be stored is calculated by the formula::
|
||||
#. At the bottom of the page, click **Save Changes**.
|
||||
|
||||
stored_grade = raw_grade * weight
|
||||
The page refreshes automatically. At the top of the page,
|
||||
you see a notification that your changes have been saved, and you can
|
||||
see your entries in the **lti_passports** policy key.
|
||||
|
||||
Step 3. Add the LTI Component to a Unit
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
#. In the unit where you want to create the problem, click **Advanced**
|
||||
under **Add New Component**, and then click **LTI**.
|
||||
#. In the component that appears, click **Edit**.
|
||||
#. In the component editor, set the options that you want. See the table
|
||||
below for a description of each option.
|
||||
#. Click **Save**.
|
||||
|
||||
.. list-table::
|
||||
:widths: 10 80
|
||||
:header-rows: 1
|
||||
|
||||
* - `Setting`
|
||||
- Description
|
||||
* - `Display Name`
|
||||
- Specifies the name of the problem. This name appears above the problem and in
|
||||
the course ribbon at the top of the page in the courseware.
|
||||
* - `custom_parameters`
|
||||
- Enables you to add one or more custom parameters. For example, if you've added an
|
||||
e-book, a custom parameter may include the page that your e-book should open to.
|
||||
You could also use a custom parameter to set the background color of the LTI component.
|
||||
|
||||
Every custom parameter has a key and a value. You must add the key and value in the following format.
|
||||
|
||||
::
|
||||
|
||||
key=value
|
||||
|
||||
For example, a custom parameter may resemble the following.
|
||||
|
||||
::
|
||||
|
||||
bgcolor=red
|
||||
|
||||
page=144
|
||||
|
||||
To add a custom parameter, click **Add**.
|
||||
* - `graded`
|
||||
- Indicates whether the grade for the problem counts towards student's total grade. By
|
||||
default, this value is set to **False**.
|
||||
* - `has_score`
|
||||
- Specifies whether the problem has a numerical score. By default, this value
|
||||
is set to **False**.
|
||||
* - `launch_url`
|
||||
- Lists the URL that Studio sends to the external LTI provider so that the provider
|
||||
can send back students' grades. This setting is only used if **graded** is set to
|
||||
**True**.
|
||||
* - `lti_id`
|
||||
- Specifies the LTI ID for the external LTI provider. This value must be the same
|
||||
LTI ID that you entered on the **Advanced Settings** page.
|
||||
* - `open_in_a_new_page`
|
||||
- Indicates whether the problem opens in a new page. If you set this value to **True**,
|
||||
the student clicks a link that opens the LTI content in a new window. If you set
|
||||
this value to **False**, the LTI content opens in an IFrame in the current page.
|
||||
* - `weight`
|
||||
- Specifies the number of points possible for the problem. By default, if an
|
||||
external LTI provider grades the problem, the problem is worth 1 point, and
|
||||
a student’s score can be any value between 0 and 1.
|
||||
|
||||
For more information about problem weights and computing point scores, see :ref:`Problem Weight`.
|
||||
@@ -114,6 +114,8 @@ visible.
|
||||
- **Weight.** Different problems in a particular problem set may be
|
||||
given different weights.
|
||||
|
||||
.. _Studio UI:
|
||||
|
||||
==============================
|
||||
The Studio User Interface
|
||||
==============================
|
||||
@@ -204,6 +206,8 @@ Maximum Attempts
|
||||
This setting specifies the number of times a student can try to answer
|
||||
the problem. By default, a student has an unlimited number of attempts.
|
||||
|
||||
.. _Problem Weight:
|
||||
|
||||
==============================
|
||||
Problem Weight
|
||||
==============================
|
||||
|
||||
604
docs/course_authors/source/glossary.rst
Normal file
604
docs/course_authors/source/glossary.rst
Normal file
@@ -0,0 +1,604 @@
|
||||
.. _Glossary:
|
||||
|
||||
###################################################
|
||||
Glossary
|
||||
###################################################
|
||||
|
||||
.. _A:
|
||||
|
||||
****
|
||||
A
|
||||
****
|
||||
|
||||
.. _About Page:
|
||||
|
||||
**About Page**
|
||||
|
||||
The course page that provides potential students with a course summary, prerequisites, a course video and image,
|
||||
and important dates.
|
||||
|
||||
See :ref:`Setting up a New Course` for more information.
|
||||
|
||||
.. _Advanced Editor-g:
|
||||
|
||||
**Advanced Editor**
|
||||
|
||||
An XML-only editor in a Problem component that allows you to can create and edit any type of problem. For more information, see :ref:`Advanced Editor`.
|
||||
|
||||
|
||||
|
||||
|
||||
.. _Assignment Type:
|
||||
|
||||
**Assignment Type**
|
||||
|
||||
The category of graded student work, such as homework, exams, and exercises.
|
||||
|
||||
For more information, see :ref:`Establish a Grading Policy`.
|
||||
|
||||
.. _C:
|
||||
|
||||
****
|
||||
C
|
||||
****
|
||||
|
||||
|
||||
.. _Certificate:
|
||||
|
||||
**Certificate**
|
||||
|
||||
A document issued to a registered student who successfully completes a course.
|
||||
Not all edX courses offer certificates, and not all students register as certificate candidates.
|
||||
|
||||
|
||||
|
||||
.. _Checkbox Problem:
|
||||
|
||||
**Checkbox Problem**
|
||||
|
||||
A problem that prompts the student to select one or more options from a list of possible answers. For more information, see :ref:`Checkbox`.
|
||||
|
||||
|
||||
.. _Chemical Equation Response Problem:
|
||||
|
||||
**Chemical Equation Response Problem**
|
||||
|
||||
A problem that allows the student to enter chemical equations as answers. For
|
||||
more information, see :ref:`Chemical Equation Response`.
|
||||
|
||||
|
||||
.. _Circuit Schematic Builder Problem:
|
||||
|
||||
**Circuit Schematic Builder Problem**
|
||||
|
||||
A problem that allows the student to construct a schematic answer
|
||||
(such as an electronics circuit) on an interactive grid.
|
||||
|
||||
See :ref:`Circuit Schematic Builder` for more information.
|
||||
|
||||
|
||||
.. _Cohort:
|
||||
|
||||
**Cohort**
|
||||
|
||||
A group of students that participate in the class together. A cohort can have forum discussions apart from the rest of the students.
|
||||
|
||||
|
||||
.. _Component_g:
|
||||
|
||||
**Component**
|
||||
|
||||
The part of a unit that contains your actual course content. A unit can contain one or more components.
|
||||
For more information, see :ref:`Components`.
|
||||
|
||||
|
||||
.. _Course Accordion:
|
||||
|
||||
**Course Accordion**
|
||||
|
||||
The left-hand navigation bar in the courseware that shows the sections and subsections for a course.
|
||||
The word “accordion” is intended to evoke the folding and unfolding of an accordion,
|
||||
because when you click a section, the section expands to show subsections.
|
||||
|
||||
|
||||
.. _Course Catalog:
|
||||
|
||||
**Course Catalog**
|
||||
|
||||
The page that lists all courses offered in the edX learning management system.
|
||||
|
||||
|
||||
|
||||
.. _Course Handouts:
|
||||
|
||||
**Course Handouts**
|
||||
|
||||
Course handouts are files you make available to students in the Course Info page.
|
||||
|
||||
See :ref:`Add Course Handouts` for more information.
|
||||
|
||||
|
||||
.. _Course Info Page:
|
||||
|
||||
**Course Info Page**
|
||||
|
||||
The page that opens first every time students access your course. You can post announcements on the Course Info page.
|
||||
The Course Handouts sidebar appears in the right pane of this page.
|
||||
|
||||
|
||||
.. _Run:
|
||||
|
||||
**Course Run**
|
||||
|
||||
The term in which your course takes place. You set the course run when you create your course.
|
||||
For more information, see :ref:`Create a New Course`.
|
||||
|
||||
.. _Courseware:
|
||||
|
||||
|
||||
**Courseware**
|
||||
The page where students access the primary instructional materials for your course.
|
||||
Sections, subsections, units and components are all accessed from the Courseware page.
|
||||
|
||||
|
||||
.. _Custom Response Problem:
|
||||
|
||||
**Custom Response Problem**
|
||||
|
||||
A custom response problem evaluates text responses from students using an embedded Python script. These
|
||||
problems are also called "write-your-own-grader" problems.
|
||||
For more information, see :ref:`Custom Response` and :ref:`Write-Your-Own-Grader`.
|
||||
|
||||
.. _D:
|
||||
|
||||
****
|
||||
D
|
||||
****
|
||||
|
||||
.. _Discussion Forum:
|
||||
|
||||
**Discussion Forum**
|
||||
|
||||
The page where students can communicate with peers and staff by
|
||||
typing in questions and responding to each other.
|
||||
|
||||
See :ref:`Working with Discussion Components` for more information.
|
||||
|
||||
|
||||
.. _Discussion Component:
|
||||
|
||||
**Discussion Component**
|
||||
|
||||
Forums that course staff can add directly to units. For example, a Video component can be followed by a Discussion component so that students can discuss the
|
||||
video content without having to leave the page.
|
||||
|
||||
See :ref:`Working with Discussion Components` for more information.
|
||||
|
||||
.. _Dropdown Problem:
|
||||
|
||||
**Dropdown Problem**
|
||||
|
||||
A problem that asks students to choose from a collection of answer options, presented as a drop-down list. For
|
||||
more information, see :ref:`Dropdown`.
|
||||
|
||||
|
||||
.. _E:
|
||||
|
||||
****
|
||||
E
|
||||
****
|
||||
|
||||
.. _edX101_g:
|
||||
|
||||
**edX101**
|
||||
|
||||
edX’s online course about how to create online courses. The intended audience is faculty and university administrators
|
||||
It is also the first course ever to have been developed entirely using edX Studio.
|
||||
|
||||
.. _edX101: https://edge.edx.org/courses/edX/edX101/How_to_Create_an_edX_Course/about
|
||||
|
||||
|
||||
.. _edX Edge:
|
||||
|
||||
**edX Edge**
|
||||
|
||||
A less restricted site than edX.org. While only consortium members can create and post
|
||||
content on edX.org, any users with course creator permissions can create courses with Studio
|
||||
on studio.edge.edx.org, then view the courses on the learning management system at edge.edx.org.
|
||||
|
||||
.. _Edge: http://edge.edx.org
|
||||
|
||||
|
||||
|
||||
|
||||
.. _edX Studio:
|
||||
|
||||
**edX Studio**
|
||||
|
||||
The edX tool you use to build your courses.
|
||||
|
||||
See :ref:`What is Studio?` for more information.
|
||||
|
||||
|
||||
.. _Exercises:
|
||||
|
||||
**Exercises**
|
||||
|
||||
Practice or practical problems interspersed in edX course content to keep the learner engaged.
|
||||
Exercises are also an important measure of teaching effectiveness and learner comprehension.
|
||||
|
||||
|
||||
|
||||
.. _G:
|
||||
|
||||
****
|
||||
G
|
||||
****
|
||||
|
||||
.. _grade:
|
||||
|
||||
**Grade Range**
|
||||
|
||||
Thresholds that specify how numerical scores are associated with grades, and the score required to pass a course.
|
||||
|
||||
See :ref:`Set the Grade Range` for more information.
|
||||
|
||||
|
||||
|
||||
.. _Grading Rubric:
|
||||
|
||||
**Grading Rubric**
|
||||
|
||||
List of the items that a student's response should cover in an open response assessment.
|
||||
|
||||
See :ref:`Rubrics` for more information.
|
||||
|
||||
|
||||
.. _H:
|
||||
|
||||
****
|
||||
H
|
||||
****
|
||||
|
||||
.. _HTML Component:
|
||||
|
||||
**HTML Component**
|
||||
|
||||
The component where you add and format text for your course. An HTML component can contain text, lists, links and images.
|
||||
|
||||
See :ref:`Working with HTML Components` for more information.
|
||||
|
||||
|
||||
.. _HTML View:
|
||||
|
||||
**HTML View**
|
||||
|
||||
The view in the HTML component editor allows you to enter HTML code directly.
|
||||
|
||||
See :ref:`Work with the Visual and HTML Editors` for more information.
|
||||
|
||||
|
||||
.. _I:
|
||||
|
||||
****
|
||||
I
|
||||
****
|
||||
|
||||
|
||||
.. _Image Mapped Input Problem:
|
||||
|
||||
**Image Mapped Input Problem**
|
||||
|
||||
A problem that presents an image and accepts clicks on the image as an answer.
|
||||
|
||||
See :ref:`Image Mapped Input` for more information.
|
||||
|
||||
.. _Import:
|
||||
|
||||
**Import**
|
||||
|
||||
A tool in edX Studio that loads a new course into your existing course. When you use the
|
||||
Import tool, Studio replaces all of your existing course content
|
||||
with the content from the imported course.
|
||||
|
||||
See :ref:`Import a Course` for more information.
|
||||
|
||||
|
||||
|
||||
|
||||
.. _L:
|
||||
|
||||
****
|
||||
L
|
||||
****
|
||||
|
||||
|
||||
.. _LaTeX:
|
||||
|
||||
**LaTeX**
|
||||
|
||||
A document markup language and document preparation system for the TeX typesetting program.
|
||||
|
||||
In edX Studio, you can :ref:`Import Content from LaTex`.
|
||||
|
||||
You can also create a :ref:`Problem Written in LaTeX`.
|
||||
|
||||
|
||||
|
||||
.. _Learning Management System:
|
||||
|
||||
**Learning Management System (LMS)**
|
||||
|
||||
The platform that students use to view courses.
|
||||
|
||||
|
||||
|
||||
.. _Live Mode:
|
||||
|
||||
**Live Mode**
|
||||
|
||||
A view that allows course staff to review all public units as students see them,
|
||||
regardless of the release dates of the section and subsection that contain the units.
|
||||
|
||||
See :ref:`View Your Live Course` for more information.
|
||||
|
||||
|
||||
.. _M:
|
||||
|
||||
****
|
||||
M
|
||||
****
|
||||
|
||||
.. _Math Expression Input Problem:
|
||||
|
||||
**Math Expression Input Problem**
|
||||
|
||||
A problem that requires students to enter a mathematical expression as text, such as e=m*c^2.
|
||||
|
||||
See :ref:`Math Expression Syntax` for more information.
|
||||
|
||||
|
||||
.. _MathJax:
|
||||
|
||||
**MathJax**
|
||||
|
||||
A LaTeX-like language you use to write equations. Studio uses MathJax to render
|
||||
text input such as x^2 and sqrt(x^2-4) as "beautiful math."
|
||||
|
||||
See :ref:`MathJax in Studio` for more information.
|
||||
|
||||
|
||||
|
||||
|
||||
.. _Multiple Choice Problem:
|
||||
|
||||
**Multiple Choice Problem**
|
||||
|
||||
A problem that asks students to select one answer from a list of options.
|
||||
|
||||
See :ref:`Multiple Choice` for more information.
|
||||
|
||||
|
||||
.. _N:
|
||||
|
||||
****
|
||||
N
|
||||
****
|
||||
|
||||
.. _Numerical Input Problem:
|
||||
|
||||
**Numerical Input Problem**
|
||||
|
||||
A problem that asks students to enter numbers or specific and relatively simple mathematical expressions.
|
||||
|
||||
See :ref:`Numerical Input` for more information.
|
||||
|
||||
|
||||
|
||||
.. _P:
|
||||
|
||||
****
|
||||
P
|
||||
****
|
||||
|
||||
.. _Preview Mode:
|
||||
|
||||
**Preview Mode**
|
||||
|
||||
A view that allows you to see all the units of your course as students see them, regardless of whether the
|
||||
visibility of each unit is set to Public or Private and regardless of whether the release dates have passed.
|
||||
|
||||
See :ref:`Preview Your Course` for more information.
|
||||
|
||||
|
||||
.. _Private Unit:
|
||||
|
||||
**Private Unit**
|
||||
|
||||
A unit whose **Visibility** option is set to Private so that students cannot see the unit, even if it is located in a subsection that has been released.
|
||||
|
||||
See :ref:`Public and Private Units` for more information.
|
||||
|
||||
|
||||
|
||||
|
||||
.. _Problem Component:
|
||||
|
||||
**Problem Component**
|
||||
|
||||
A component that allows you to add interactive, automatically
|
||||
graded exercises to your course content. You can create many different
|
||||
types of problems.
|
||||
|
||||
See :ref:`Working with Problem Components` for more information.
|
||||
|
||||
|
||||
|
||||
.. _Progress Page:
|
||||
|
||||
**Progress Page**
|
||||
|
||||
The page in the learning management system that shows students their scores on graded assignments in the course.
|
||||
|
||||
|
||||
|
||||
.. _Public Unit:
|
||||
|
||||
**Public Unit**
|
||||
|
||||
A unit whose **Visibility** option is set to Public so that the unit is visible to students, if
|
||||
the subsection that contains the unit has been released.
|
||||
|
||||
See :ref:`Public and Private Units` for more information.
|
||||
|
||||
.. _R:
|
||||
|
||||
****
|
||||
R
|
||||
****
|
||||
|
||||
.. _Rubric:
|
||||
|
||||
**Rubric**
|
||||
|
||||
List of the items that a student's response should cover in an open response assessment.
|
||||
|
||||
See :ref:`Rubrics` for more information.
|
||||
|
||||
|
||||
|
||||
.. _S:
|
||||
|
||||
****
|
||||
S
|
||||
****
|
||||
|
||||
|
||||
|
||||
|
||||
.. _Section_g:
|
||||
|
||||
**Section**
|
||||
The topmost category in your course. A section can represent a time period in your course, or another organizing principle.
|
||||
|
||||
See :ref:`Sections` for more information.
|
||||
|
||||
|
||||
|
||||
.. _Simple Editor_g:
|
||||
|
||||
**Simple Editor**
|
||||
|
||||
The graphical user interface in a Problem component that contains formatting buttons and is available for some problem types.
|
||||
For more information, see :ref:`Studio UI`.
|
||||
|
||||
|
||||
|
||||
.. _Static Pages_g:
|
||||
|
||||
**Static Pages**
|
||||
|
||||
Pages that supplement the courseware for a course. Each static page appears in your course's navigation bar.
|
||||
|
||||
See :ref:`Add Static Pages` for more information.
|
||||
|
||||
|
||||
|
||||
.. _Subsection:
|
||||
|
||||
**Subsection**
|
||||
|
||||
A division that represents a topic in your course, or another organizing principle. Subsections are
|
||||
found inside sections and contain units. Subsections can also be called "lessons."
|
||||
|
||||
See :ref:`Subsections` for more information.
|
||||
|
||||
|
||||
|
||||
.. _Short Course Description:
|
||||
|
||||
**Short Course Description**
|
||||
|
||||
The description of your course that appears on the edX `Course List <https://www.edx.org/course-list>`_ page.
|
||||
|
||||
See :ref:`Describe Your Course` for more information.
|
||||
|
||||
|
||||
.. _T:
|
||||
|
||||
****
|
||||
T
|
||||
****
|
||||
|
||||
.. _Text Input Problem:
|
||||
|
||||
**Text Input Problem**
|
||||
|
||||
A problem that asks the student to enter a line of text, which is then checked against a specified expected answer.
|
||||
|
||||
See :ref:`Text Input` for more information.
|
||||
|
||||
|
||||
.. _Transcript:
|
||||
|
||||
**Transcript**
|
||||
|
||||
A printed version of the content of a video. You can make video transcripts available to students.
|
||||
|
||||
See :ref:`Working with Video Components` for more information.
|
||||
|
||||
|
||||
.. _V:
|
||||
|
||||
****
|
||||
V
|
||||
****
|
||||
|
||||
.. _Video Component:
|
||||
|
||||
**Video Component**
|
||||
|
||||
A component that you can use to add recorded videos to your course.
|
||||
|
||||
See :ref:`Working with Video Components` for more information.
|
||||
|
||||
|
||||
.. _Visual View:
|
||||
|
||||
**Visual View**
|
||||
|
||||
The view in the HTML component editor that allows you format text without using HTML code.
|
||||
|
||||
See :ref:`Work with the Visual and HTML Editors` for more information.
|
||||
|
||||
|
||||
.. _W:
|
||||
|
||||
****
|
||||
W
|
||||
****
|
||||
|
||||
.. _Wiki:
|
||||
|
||||
**Wiki**
|
||||
|
||||
The page in each edX course that allows students as well as course staff to add, modify, or delete content.
|
||||
|
||||
Students can use the wiki to share links, notes, and other helpful information with each other.
|
||||
|
||||
|
||||
.. _X:
|
||||
|
||||
****
|
||||
X
|
||||
****
|
||||
|
||||
.. _XBlock:
|
||||
|
||||
**XBlock**
|
||||
|
||||
EdX’s component architecture for writing courseware components.
|
||||
|
||||
Third parties can create components as web applications that can run within the edX learning management system.
|
||||
|
||||
|
||||
@@ -103,6 +103,8 @@ upload and submit their files. You can let students know what to expect
|
||||
after they submit responses. You can also mention the number of times
|
||||
that a student will be able to submit a response for the problem.
|
||||
|
||||
.. _Rubrics:
|
||||
|
||||
Rubrics
|
||||
~~~~~~~
|
||||
|
||||
|
||||
@@ -20,6 +20,7 @@ unit.
|
||||
- :ref:`Word Cloud` Word cloud problems show a colorful graphic of the
|
||||
words that students enter as responses to a prompt.
|
||||
|
||||
.. _ Add Advanced Component:
|
||||
|
||||
**Add the Advanced Component to Your Course**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user