...Processing...
error
big error
• Course

# A step by step guide to creating your first TutnIQ course.

• Welcome to TutnIQ! In this tutorial we will show you how to create your first TutnIQ course!

• ### Overview: Creating a course

In this section we will see a brief demonstration of the course creation process. The video works best in HD, at full screen size.

• ### Getting started: Inititial course setup

In this section we will learn how to set up a new TutnIQ course or tutorial.

• ## Creating a course

1. Click the "Create a new course!" link at the top of the page, or on the left side of the screen in the course manager.

2. If you are not signed-in, you will be prompted to sign into TutnIQ.

3. Complete the new course form (you can change the information later if you want to): Course title (i.e. name) and category are required. Please select the correct course category so that visitors to the site can find your course.

4. Optionally provide an introduction (will appear at the top of the course) and tags (will make it easier for users to discover your course).

5. Once the course has been set up, the course builder will open. In the course builder you can:

• Activate an unpublished course (i.e. make the course public);
• Deactivate a published course; and
• Change the sequence of course items (via drag and drop). Sequence changes are saved automatically every few changes, or after a few minutes. You can also manually save sequencing changes.

The course creation process is demonstrated in the following embedded slideshow:

• ### TutnIQ course setup

This presentation was created with Greenshot and LibreOffice, and uploaded as a pdf file to Speaker Deck.

In this section we will learn how to divide our course into sections, and how to add text blocks to our course.

• Once you have set up your course or tutorial you can start adding content.

## Section headers and section breaks

You can divide your course or tutorial into sections to organize content and activities. Each section will appear as a separate page. Sections are created by adding a section header or section break to each section. A section header can have a title (for example: "Step 1: Dig the hole"), and an introduction. The section header and introduction are used to create the course table of contents.

To add a section header or section break in the course builder:

3. All information is optional. The title and introduction will appear at the beginning of the section if provided.
4. The section header / break will appear at the end of the course and can be dragged and dropped into the correct position.

### Jump codes

• You can set a jump code for any section.
• The jump code should be unique in the context of the course.
• Jump codes are similar to short URLS. At TutnIQ jump codes allow us to link to a specific section of the course without having to worry about sequencing changes.
• The jump code for this section is "intro" which when written as an url is http://www.tutniq.com/jump/80/intro (i.e. http://www.tutniq.com/jump/{course_id}/{jump code} ).
• When using Markdown at TutnIQ, you can use the 'jump' short code to refer to a jump code: [jump course='80' section='intro']Some text goes here[/jump].

## Text blocks

The bulk of your course or tutorial is likely to be in the form of text. To add a text block in the course builder:

3. Add your text. If the textarea is too small, double-click it to open a larger editing window.
4. Text blocks can be formatted using Markdown syntax. We have a detailed tutorial explaining how Markdown works at TutnIQ.
5. Text blocks can be enhanced with shortcodes. See our tutorial explaining how shortcodes work at TutnIQ.
6. The text block will appear at the end of the course and can be dragged and dropped into the correct position.

In this section we will learn hour to embed and link to web content in our TutnIQ course or tutorial.

• ## Embedding web content

One of the most important TutnIQ features is the ability to embed content from other websites. For example, the following tweet:

• TutnIQ supports embedding from a number of popular websites:

To embed content in the course builder:

2. Select the "Embed web content" option from the drop-down menu.
3. Provide the required information - only the URL of the content is compulsory.
4. Optionally, provide a title and a description.
5. The embedded content will appear at the end of the course and can be dragged and dropped into the correct position.

### Note:

• Embed functionality is experimental and dependent on outside providers.
• Please comply with the terms and conditions of the various embed provider sites!
• Embedded content must also comply with TutnIQ terms and conditions, particularly our prohibited content policy.

#### Finding the URL to embed when using Google Docs

When using Google Docs it is sometimes difficult to find the URL to embed. The following steps should help:

1. Open the content (doc, slide, sheet, etc)
2. Click "file" in the Google Docs interface for the content.
3. Click "Publish to the web".
4. Click "Start publishing" (if the document is not yet published).
5. Copy the "Document link" (in the "Get a link to the published document" section of the form)- this is what you will embed in TutnIQ.

Please note that support for Google Docs is highly experimental - if something looks broken please pop us a message and we will look into it!

A web resource is simply a link to a another website.

To add a link to a web resource in the course builder:

2. Select the "Link to web resource" option from the drop-down menu.
3. Provide the required information - only the resource URL of the content is compulsory.
4. Optionally, provide a title and a note to the viewer.
5. The link will appear at the end of the course and can be dragged and dropped into the correct position.
6. Consecutively sequenced links will be automatically grouped together.

When someone views your course, and clicks on the link, they will be taken to an interstitial page where your notes will be visible. The user will also be advised that the link is on an external website and outside the control of TutnIQ. If you would like to avoid the interstitial, you can create links in a text block using Markdown.

The link will appear as follows:

• ### Getting technical: Code snippets and mathematical equations

In this section we will learn how to add mathematical equations and code snippets to our courses or tutorials.

• ## Code snippets

You can include snippets of computer programming code in your courses and tutorials. When added via the course builder, code snippets will automatically get:

• Line numbers;
• Alternating line colors; and
• Syntax highlighting.

To add a code snippet in the course builder:

3. Add your code snippet. If the textarea is too small, double-click it to open a larger editing window.
4. Optionally, you can provide a title and specify the programming language (only necessary for the more exotic programming languages).
5. The code snippet will appear at the end of the course and can be dragged and dropped into the correct position.

Code snippets can also be embedded in text blocks using Markdown syntax or created inline, for example, print "hello cruel world";.

Example of code snippet embedded using the course builder:

• <?php
echo "Hello world!";
?>
• ## Mathematical equations and formulae

TutnIQ supports the use of LaTeX math macros for creating equations and formulae. MathML should also work, but is not officially supported.

To add a math formula in the course builder:

3. Paste your equation. If the textarea is too small, double-click it to open a larger editing window.
4. Make sure that that you do not forget to enclose your equations with the LaTeX math delimiters: $...$. We do NOT use the dollar sign delimiters often used by LaTeX users.
5. Optionally, you can provide a title.
6. The mathematical equation will appear at the end of the course and can be dragged and dropped into the correct position.

Mathematical equations can also be embedded in text blocks using Markdown syntax. For example, an inline equation: $$\sqrt{3x-1}+(1+x)^2$$.

Example of equation added a via the course builder (Maxwell's equation):

• \begin{aligned} \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\ \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\ \nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \\ \nabla \cdot \vec{\mathbf{B}} & = 0 \end{aligned}

• Equation building software can be used to simplify the process of creating an equation in LaTeX format: