# timOhjeet

Tämä on ohjeen yhden sivun versio, jossa kaikki ohjeet ovat samalla sivulla. Ohjeen usean sivun versiossa jokainen luku on jaettu omalle sivulleen. Voit valita usean sivun version yläreunassa olevasta navigointipalkista.

Muista, että tässä versiossa voit hakea ohjeesta ctrl + f avulla.

1. About TIM

The chapter teaches

  • how to log in to TIM
  • how to register to TIM
  • basic operations of the home page
  • basic operations of the document.

The basic structure of TIM

The basic concepts of TIM are:

  • document
    • a document can be for example a book, a lecture note, a weekly assignment page, a registration page, a questionnaire, an agenda. So basically anything with text.
    • a document consists of blocks
  • block
    • a block can be one or more pieces of text, which can also contain images
    • the text can use mathematical () notations
    • a block can be written in MarkDown (md), -, HTML etc. languages
    • a block can be a plugin
  • plugin
    • a plugin can be for example a video, table, multiple choice, text area, etc.
    • usually a plugin is something interactive, hence the name The Interactive Material
    • plugins are described in YAML or JSON
  • folder
    • basically a TIM consists of documents. To structure the documents a document can be given one or more directories where the document can be found
    • for example a course can be thought of as a set of documents in the same directory (or subdirectories)
  • ** ** a user
    • one TIM user who can be logged in or anonymous
    • logged in users can be assigned different permissions based on their username or groups, to which they belong
  • group
    • a group of users who can be granted rights or treated as a single group
  • preamble
    • special document, whose contents are appended to the beginning of all documents in the same directory structure

    • preamble may contain, for example, a menu, which in this way appears at the beginning of each page

    • preamble may contain macros, which allows certain strings to be replaced by others in all documents

  • macro
    • a string that is replaced by another string when the document is displayed
    • for example, a macro vuosi: 2023 can be made and then written in the document Tämä on vuoden %%vuosi%% materiaali so that the text would appear Tämä on vuoden 2023 materiaali.
    • macros allow frequently repeated queues to be easily maintained from a single location. Or even if the queue itself is not a one-time occurrence, the deadlines for different locations, such as scheduling , can be maintained from a single location.
  • area
    • a set of blocks can be defined as an area, which can be visible, hidden or shrinkable
  • copy by reference
    • a block or area of a document can be copied to the same or another document
    • copying can also be done by quoting, in which case the quoted area/block of the target document changes whenever it is changed in the source document

1.1 Functions on the homepage

Log in at

  • Log in to TIM with your Haka ID or TIM account.
  • After logging in, you will be taken to the TIM welcome page.

To register

  • If you do not have the necessary credentials, please register as a TIM user.
    • Click Register.
    • Fill in your e-mail address in the form that appears.
    • You will receive a temporary password in the e-mail you have sent.
    • Create a new password.
Valitaan etusivulta Rekisteröidy.
Register for TIM
Kirjoita sähköposti tai käyttäjätunnus.
To order a temporary password
Kirjoita väliaikainen salasana.
Temporary password
Luo uusi salasana, jossa on vähintään 10 merkkiä.
Create a new password

After logging in, you will be taken to the TIM welcome page.

Basic functions

  • By clicking on the arrow to the right of your name, you can select:
    • Omat dokumentit / My documents
    • Add a user to this session (login to TIM)
    • Log out / Log out.
  • You can select the language (Finnish/English) under Kieli / Language:
    • In TIM, some functions are always in English.
TIM:n aloitussivu.
TIM homepage

The functions in the top left corner:

  • Click on the bookmark to get a list of bookmarks and add a new bookmark.
  • Click on the wheel to find different functions depending on the page you are on and the rights you have in TIM.
  • The TIM logo Figure 2 appears on all TIM pages and clicking on it takes you back to the TIM home page.
  • Under the Image button you will find the search menu.

Under My courses / My courses you can see your current courses, by clicking on the pen you can remove a course from the view or edit the "bookmark".

Get started here / Get started:

  • My documents / My documents: you will find the documents in your personal folder

  • All documents / All documents: you will find all the documents in TIM, to which you have rights

  • Current courses / Availabe courses: you will find the courses currently running on TIM

  • Create a new document: you can create a new document directly in your own folder tim.jyu.fi/view/users/surname-surname/own-document.

You will find links at the bottom of the front page:

  • Introduction to the Tim system
  • User manual
  • Examples of how to use TIM and how to use it in different subjects.

1.2 Functions in the document

TIM document

A TIM document consists of blocks. A block can contain one or more pieces of text or one interactive component (plugin). A block is the smallest unit that can be edited and is associated with the possibility of commenting and marking as read.

In addition to the wheel and the bookmark in the documents, clicking on the three dots ... you will find the book Image.

  • Clicking on Image will display the table of contents for that page.

  • Under the image you will find the bookmarks as on the front page.

Kirjanmerkit.
Bookmarks
Sisällysluettelo.
Table of contents

By clicking on the wheel, you will find different functions depending on the page you are on and the rights you have on TIM. Once you are in the document, the wheel will open the functions related to the document.

Ratas.
The wheel

1.2.1 Main menu

When you are in a document, you will see the tabs in the main menu. Each tab has different functions for editing and using the document.

Välilehdet: Hallitse, Opettaja, Vastaukset, Luento, Velpit ja Kalvot.
Tabs

1.2.2 Edit menu

Clicking on a text or image brings up the pencil Image on the right-hand side of the block, from where opens the edit menu.

By clicking on

  • View source to display the source code for that block

  • Comment/note opens the commenting for the block you are in

  • Add paragraph above you add a new block above

  • Edit opens the editor

  • Copy you copy the block in question

  • Add question above you add a question above

  • Close menu you close the editing menu

  • Move menu to left/right you move the edit menu opening to the left/right margin

  • Image open the edit menu for advanced users.

Muokkausvalikko avattuna.
Edit menu
  • If you have moved the editing menu to the left side of the screen, you can open it by dragging your mouse to the left side of the block and clicking on the bar.
Edit menu on the left
Edit menu on the left

1.2.3 Editors

The editor is used to create content using the Markdown markup language.

Markdown

Markdown is a markup language that relies on simple text syntax to format a document and can be used to edit documents without the need for complex software such as word processors. Markdown uses easily recognisable markup code to indicate highlighting and document structure.

You can read about the syntax of the Markdown markup language e.g.: https://www.markdownguide.org

TIM makes use of the so-called Pandoc shortcut for Markdown, which you can read more about at: https://pandoc.org/MANUAL.html#pandocs-markdown

  • You can open the editor either from the edit menu () or by clicking on the button at the end of the document Add paragraph.

  • You can add content using the Navigation, Style, Insert, Characters, TeX, Plugins, Fields and Upload tabs, under which you can find various functions, or by typing directly with Markdown.

  • The Wrap button allows you to specify how many characters to write in the editor before automatic line wrapping. Wrapping does not affect the formatting of the text in the document, it just makes it easier to edit the text in the editor.

  • From Preview - Preview you can see how the content you have created will look when you add it to the page.

  • By clicking on

    • Save to save your changes and close the editor

    • Cancel to cancel your changes and close the editor

    • Delete to delete the entire block.

Editorin perusnäkymä.
Editor

1.2.4 Marking blocks as read

  • By clicking on the orange/yellow bar on the right side of the document blocks, you can mark as read.
    • The yellow bar indicates that changes have been made to that block since you last marked it as read.
  • Clicking on Image will mark as read up to the previous header level of the document blocks.
  • To disable the orange bars completely, click on the wheel -> Mark all as read.

More guidance

2. Creating a document

Learn how to use the TIM system to

  • create a new document
  • copy a document
  • copy a directory.

2.1 TIM document

A TIM document is a page in the TIM system that can be edited using the TIM system.

A TIM document consists of blocks. A block can contain one or more pieces of text or one interactive component (plugin). A block is the smallest unit that can be edited, with the possibility of commenting and marking as read.

There are two ways to create a document and you must be logged in to the TIM system. The location and name of the document can be changed afterwards.

  1. Create a new document using My documents/My documents:
  • To create a new personal document, click on your name at the top of the page and select My documents/My documents.

  • You can create folders and documents.

Luodaan harjoituksena uusi dokumentti klikkaamalla
Create a new document
  • You can create a new document by typing

    • You can create a document by creating aTitle, which defines the title of the document

    • Theshort name of the document path is determined by this.

  • The Create document button will now create a new document at the location

/view/users/mikkihiiri/harjoitus
Uuden dokumentin luonti TIM-järjestelmässä
New document
  1. New document in the browser address bar
  • Create a new document by typing the address in the address bar of your browser, and TIM will create the document and folder path directly.

  • You must have the necessary permissions if you create a document somewhere other than your own page.

  • The link below will take you to the exercise document created in the exercise above, if you have not yet created a document you will be offered the option to do so. users/Anonymous/exercise

# dokumentin-kopiointi

2.2 Copying a document

On the Manage/Manage tab, the Copy this document block can be used to copy an existing document.

  • To copy a document, as well as to create a new document , enter the Title and Short name of the document and specify the location of the new copied document.

  • The Create document button now creates a new document at the location

/view/users/mikkihiiri/harjoituskopio
Dokumentin kopiointi TIM-järjestelmässä
Copying a document

2.3 Copying multiple documents

You can copy documents from an entire directory using the Copy contents section on the Manage/Manage tab of the directory:

  • Destination: enter the new folder path of the documents to be copied.

  • Exclude documents/folders that match: enter what you do not want to copy in regular expression format.

  • Copy preview... button once to see a preview of what will be copied. If you click a second time, the copy will be made to a folder:

/view/users/mikkihiiri/
Usean dokumentin kopiointi TIM-järjestelmässä
Copying multiple documents

3. Creating a course

The chapter teaches

  • copy the template course and edit
    • home pages
    • lecture pages
    • material pages
    • demo pages.

The instructions below show how to create (copy) a template course with multiple documents. You can choose to copy the course from the reduced version, which has a menu for the homepage, material, lectures and demos. The full version also has a menu with a place for exercises and a discussion area.

3.1 Creating a course by copying a simple template course

Before creating a course

  • You need to know the target directory of your course.
  • You can also create a course under your own names. For examples, see: https://tim.jyu.fi/view/kurssit.
  • If you cannot find a suitable organisation, ask the administrator () to create one, please think of a suitable name.
  • After finding out the target directory of the course, you will need the identifier of the future course. It can be for example your course code.

In the future we will assume that

  • organisation: history
  • course: HISP001

Let's start creating a course by copying the base of the model course:

  • Go to :

https://tim.jyu.fi/manage/kurssit/tie/proj/2022/timo/tim-ohje/mallikurssi-yksinkertainen.

  • In the Copy contents block, type Destination under: courses/history/HISP001.
  • Press Copy preview.
  • Check again that you have entered the correct directory in Destination.
  • Press Copy if everything looks good.
  • You can access your new course by clicking on the link after the copy.

The video below shows how to copy a course following the instructions above.

Copying a new course

Mallikurssin kopioinnista syntyneet kansiot
Folders and pages from copying
# kansiomerkitys

3.2 The importance of folders and pages

  • Under the folder Material is the page Course Material
    • Under the folder there is also the folder templates which contains two documents that define the default permissions for folders and pages.
  • templates contains two documents that define the default permissions for folders and pages.
    • Thetemplates folder also contains a preambles folder with a document preamble called preamblepreamble
  • Theyear_term folder contains documents that may change from year to year, such as demos, homepage and lecture topics.

Assuming that the course is held several times, the course will have documents that remain the same from year to year (or change, but the same content is used each year) and documents that are different from year to year. A typical document that changes from year to year is the home page of the course, which in the example became the document:

kurssit/historia/HISP001/vuosi_lukukausi/kotisivu

In Sisu, the home page of the course for the year in question is then set to

https://tim.jyu.fi/view/kurssit/historia/HISP001/2022k/kotisivu

So the content of the course will now appear in the directories:

kurssit/historia/HISP001/ - kurssin pysyvä osuus
kurssit/historia/HISP001/2022k - vuoden 2022 kevään dokumentit

The copied folder "year_term" should be changed after copying to match the course of that year and semester. The above example uses spring 2022.

3.3 Editing the general settings of the preamble document (preamble)

Video on editing the preamble document below. Below the video you will also find textual instructions for editing the preamble.

Editing the introductory document

For detailed instructions on how to create an introductory document, click here: introductory documentintroductory document

Go to the document "preamble" located at:

kurssit/historia/HISP001/templates/preambles/preamble

Click on the cog -> Edit settings. An editor will open with contents that look something like the following:

macros:
 kausi: "kevät"             #Laita tähän "kevät" TAI "syksy" 
 vuosik: "2018k"       
 vuosip: "2018"
 ajankohta: "kevät 2018"
 homepath: ""               #Laita tähän kurssin kansion osoite 
 yearpath: ""               #Laita tähän kurssin kansion osoite/vuosi_lukukausi
 coursecode: KURSSIKOODI
 coursename: KURSSIN NIMI
 coursecredits: 3 op
 #Voit kirjoittaa omia makroja tähän itse.

Change these to match your course.

The example course introductory document would look like the following:

macros:
 kausi: "kevät"             #Laita tähän "kevät" TAI "syksy" 
 vuosik: "2022k"       
 vuosip: "2022"
 ajankohta: "kevät 2022"
 homepath: "/view/kurssit/historia/HISP001/"        #Laita tähän kurssin kansion osoite 
 yearpath: "/view/kurssit/historia/HISP001/2022k"   #Laita tähän kurssin kansion osoite/vuosi_lukukausi
 coursecode: HISP001
 coursename: Historia 1
 coursecredits: 3 op
 #Voit kirjoittaa omia makroja tähän itse.

Instructions for macros can be found here: Introductory course - MacrosIntroductory course - Macros

# kotisivunmuokkaus

3.4 Editing the course homepage

Edit page

kurssit/historia/HISP001/vuosi_lukukausi/Kotisivu

according to the needs of the course.

The macros in the introductory document above can be used as follows:

Vuoden %%vuosip%% kurssilla opiskellaan...

to get the result, for example:

Vuoden 2018 kurssilla opiskellaan...

3.5 Editing course material

Edit document

kurssit/historia/HISP001/materiaali/kurssimateriaali

as needed.

3.6 Editing course demos

Edit a document

kurssit/historia/HISP001/vuosi_lukukausi/demotyleinen

to describe what is commonly said about the weekly tasks.

Retrieved from

kurssit/historia/HISP001/vuosi_lukukausi/demot

is used to create a list of possible weekly assignments to be held in the course.

3.7 Editing course lecture pages

Edit document

kurssit/historia/HISP001/vuosi_lukukausi/luentojen-aiheet

to describe the course lectures.

# johdantodokumentti

4. Introductory document

The chapter teaches

  • create an introductory document
  • use an introductory document when you want to give the same settings to all pages of a course or add similar content
  • change the look and feel of a course using an introductory document.

What is an introductory document?

  • A document in which changes made affect all documents in the folder.
  • A preamble document is also known as a preamble document.

A preamble document can be used, for example, if you want to have a specific menu on all course pages or if you want to display a specific image or text at the top of each page. The preamble document can also be used to customise the look and feel of all the pages of the course.

4.1 Creating an introductory document

You can watch the video below for instructions on how to create an introductory document. The video is followed by the same instruction in text format.

Creating an introductory document

Suppose we have a course folder for a template course. Let's create an introductory document that affects all documents in this folder.

  • Create a new folder in the course folder called templates (the name must be exactly this).
  • Create a new folder in the templates folder called preambles (the name must be exactly this).
  • Create a document in the preambles folder called preamble (the name must be exactly this).

Now you have created an introductory document with the path

.../mallikurssi/templates/preambles/preamble
Mallikurssin sisälle on luotu kansio templates, jonka sisällä on kansio preambles. Preambles-kansion sisällä on johdantodokumentti, jonka nimi on preamble
Creating a preamble document

4.2 Editing the layout

You can watch the video below for instructions on how to edit the course layout. The video is followed by the same instruction in text format.

Editing the course layout

The layout of documents can be changed by editing the CSS. Changes made to the introductory document will affect all documents in the same folder.

  • Open the introductory document preamble.

  • Open the settings in the top left corner of the page by clicking on the wheel and selecting Edit settings.

Avataan asetukset
Edit page settings
  • The CSS settings are written between the lines css: |!! and !!.
Asetuksiin on lisätty rivit css: |!!` ja !!. Näiden rivien väliin on  kirjoitettu css-tyyli, joka muuttaa sivuston fonttia. Koodi on body {font-family: Arial, Helvetica, sans-serif;}
Changing the font using CSS style
# makrot

4.3 Macro

You can watch the video below for instructions on how to create macros. The video is followed by the same instruction in text format.

Macro

Macros are useful, for example, when documents often contain text that may need to be changed in the future. For example, the name of the course and the year of the course. By using macros, changes need only be made to a single location.

  • Add the line macros: to the settings of the introductory document and enter the desired macros under it.
  • Macros can be named using lower case letters, upper case letters, exclamation marks, special characters and numbers. You cannot use spaces when naming .
Makroihin on lisätty coursename: 'kurssi X' ja year: '2022'
Adding macros to settings

The macros defined in the introductory document are used on all pages of the course. So you can refer to the course name with the macro coursename and the course year with the macro year. Macros are referred to by typing them between the percent signs.

Otsikko on kirjoitettu # , , vapaa keskustelu.  Näkyville tulee otsikko Kurssi X, 2022, vapaa keskustelu
Using macros

4.4 Adding content to all pages of the course

You can watch the video below for instructions on how to add content to an introductory document. The video is followed by the same instruction in text format.

Adding content to an introductory document

Content added to the introductory document preamble will automatically appear on on all pages of the course. You can add any content to the document (image, text, menu...).

  • For example, you can add an image to the introductory document.
Johdantodokumenttiin on lisätty kuva
Adding content to the introductory document
  • The image now appears on all pages of the course.
Johdantodokumenttiin lisätty kuva näkyy myös kurssin keskustelusivulla
The image is now displayed on other pages of the course

More guidance

4.5 Creating a menu

The introductory document is also used to create the course menu. See Course navigationCourse navigation for more detailed instructions.

5. Template bases

The chapter teaches

  • create a template base to speed up the creation of similar documents.

What is a model base?

In TIM, it is possible to use templates as a basis for new documents if you often need to create similar documents. A template base is a document whose content can be copied into the content of a new document.

This tutorial assumes a situation in a course where you want to create similar documents with a common base. This could be, for example, different reports.

Watch the video to see how to create and use model bases.

Template bases

Raporttipohja, jossa on väliotsikot johdanto, kirjallisuuskatsaus, menetelmät, tulokset, johtopäätökset ja pohdinta.
Example of a report template

5.1 Creating a model base

  • Create a folder called templates in the folder or top folders of your new documents.
  • Create the documents you want to use as a base in the templates folder.
Raporttipohja on sijoitettu templates-kansioon.
The report base in the templates folder can be used when creating new documents

5.2 Using the template

  • Create a new document in the template folder.
Uuden dokumentin luominen mallikurssi-kansioon.
Creating a template report
  • Now, after creating the document, you can select the report template created above from Valitse mallipohja.
Raporttipohjan lataaminen.
Selecting a template base

More guidance

6. Creating and managing a group (including a student group)

The chapter teaches:

  • creating a group in TIM
  • importing a student group from Sisu
  • managing a group
  • linking a group to a course page
  • evaluating a student group and exporting the evaluation to Sisu.
# ryhman-luonti

6.1 Managing and creating a group in TIM

To create a group, you need group creation rights, which you can obtain by sending a request to TIM development .

  • click on in the wheel and select Create a new group.
  • In the form that appears, fill in
    • Name: name of the group, the name must not contain capital letters and must contain at least one number. For example (tiep111k23opet).
    • Folder: select the appropriate location for your group. For example, course ID / year (e.g. tiep111/2023k).
Ryhmän luonti kurssin kotisivulla.
Creating a group

Usethe Add group members field to add new group members. Enter the information you want in the field and finally press Add.

Please note that you can only add a user after they have logged in to at least once.

Kurssin tiedot ja nimen vaihto.
Adding group members

The list allows you to search for group members either by name, username or email by entering the desired information in the column at the top of the table. Once you have found and selected the group of people you want, you can click:

  • Create a report with a list of your selected students' data on the new tab

  • Remove selected students from the group to remove selected students from the course

  • User list a new form where you can display a list of names, usernames or email addresses of your choice

  • Send an email to opens a new form where you can send an email to selected students.

Kurssin tiedot ja nimen vaihto.
Participant list

6.1.1 Linking a student group created in TIM to the course homepage

Add a group to the course home page:

  • Go to the document from which you want to make the course home page.
  • Click on the wheel -> Set as a course/Setas a course.
  • Add the course details to the form:
    • Course code: course code
    • Subject: subject (if you can't find your own, please contact )
    • Expiration date: the date when the course will be removed from the main TIM page
    • Student group: the name of the group created in the previous step. Dokumentin asettaminen kurssiksi.

Once you have added a group to the course home page, you can find the course by clicking on Current Courses/Availablecourses.

Nykyiset kurssit pääsivulla.
Current courses

Students can find a course and add it to their course list My courses

  • by clicking on Current Courses
  • on the TIM home page and entering either the course ID or name in the search box
  • by clicking on Add to My courses.
Kurssin lisääminen pääsivulle.
Adding a course to the homepage of
# avoinryhma

6.1.2 Converting a group created in TIM into an open group

Students can independently join or leave open groups.

Allow independent joining or leaving:

  • Click on the wheel and select Browse existing groups

  • Find and open the student group you want to change to open

  • In the document that opens, click on and select Edit settings

  • In the settings editor that opens, add the following settings:

    groupSelfJoin:
      canJoin: true   # Saako ryhmään liittyä vapaasti?
      canLeave: false # Saako ryhmästä poistua vapaasti?
      course: false   # Onko kyseessä kurssiryhmä? Jos on true, TIM lisää kurssisivun käyttäjän kirjanmerkkeihin.
Allow independent joining
Allow independent joining
  • Customize the join settings to your liking
    • canJoinIf true, anyone can join the group. Please note that joining a group does not automatically give you the right to see members of other groups.
    • canLeave: If true, any member can leave the group.

Add a button on the join page or course homepage that allows group members/students to join or leave the group:

  • Go to the course homepage

  • Add a new block and open the block editing editor

  • Select the Plugins tab-> Others -> Group self-join Add a Join a Course component

  • Replace groupname with the name of the group

  • Edit the other settings and texts to your liking

    • join: If true, a button allows you to join the group

    • leave: If true, you can also use the same button to leave the group. So you can either make separate join/leave buttons or keep everything in one button. Editing the functions of the join button

# opiskelijat-sisusta

6.2 Bringing and managing a group of students from Sisu to TIM

Log in to Sisu and select the user role of teacher. In the top bar, select My Teaching -> select the desired course -> Implementation details.

Sisun opettajanäkymä.
Sisu teacher view

Select Classification factors and click on EDIT.

Luokittelutekijöiden muokkaus.
Edit classification factors

In the LEARNING ENVIRONMENTS AND TOOLS field, click on + More.

Oppimisympäristön lisäys.

Select TIM from the options and click SAVE to see the selected learning environments and tools used for teaching at .

TIM:n valinta oppimisympäristöksi.

TIM:n valinta kurssin ympäristöksi.
The choice of TIM as the course environment
TIM valittuna sisussa.
TIM selected

You will receive an email informing you about the copying of the Sisu group to TIM. Follow the link in the email to the document with instructions on how to use the group in TIM.

Kurssin TIM linkki sähköpostissa.
TIM link

The table at the end of the document shows the groups imported from Sisusta into TIM. Select the group "All students" from . In the TIM name column, you can change the name of your course to a more descriptive . Copy this TIM name to paste the course on the course homepage. Finally, click on Confirm groups at the bottom of the table to create the group in TIM.

Sisusta TIM:iin tuodut ryhmät.

Kurssin tiedot ja nimen vaihto.
Course information

The URL column will contain a link to a page where you can manage the group.

URL.
URL

The list allows you to search for a student, either by name, username or email by typing in the blank columns in the top row of the table. Once you have found and selected the set of students you want, click:

  • Create a report with a list of the students you have selected on the new tab

  • Remove selected students from the group to remove selected students from the course

  • User list a new form where you can display a list of people's names, usernames or emails of your choice

  • Send an email to opens a new form where you can send an email to selected students.

Kurssin tiedot ja nimen vaihto. Use the Add group members section under the table to add new group members to the table. Add the information you want in the field and finally click Add. Opiskelijoiden lisäys.

# tervetuloviesti

6.2.1 Tervetuloviestin asettaminen opiskelijaryhmälle

Voit asettaa ryhmälle viestin, joka lähetetään opiskelijalle heti, kun opiskelija liittyy tai lisätään ryhmään.

Viestin asettaminen tapahtuu opiskelijaryhmän hallintasivulta, joka on luotu luvussa 6.2.

Viestin muokkausta varten löydät tekstilaatikon kohdasta Muita asetuksia, aikaisemmin mainitun Lisää ryhmän jäseniä -toiminnon alapuolelta.

Tervetuloviestin asettaminen
Tervetuloviestin asettaminen

Määrittele sähköpostiviestin otsikoksi tuleva teksti avainsanalla Subject: kuten esimerkkikuvassa yllä. Kirjoita viestin leipäteksti sen alle.

Alla on yksinkertainen pohja tervetuloviestille:

Subject: Tervetuloa opintojaksolle [opintojakson nimi]

Hei!

Tervetuloa opiskelemaan opintojaksolle [opintojakson nimi].

Kurssi toteutetaan TIM-ympäristössä.

Tarkemmat ohjeet opiskeluun ja kurssimateriaalit löydät jakson TIM-sivuilta: 

[Kurssin TIM linkki]

Jos sinulla on ongelmia kirjautua sisään, ota yhteyttä TIM tukeen: tim@jyu.fi

Oppimisen iloa!

Tallenna viesti sitten tekstialueen alapuolelta löytyvällä Tallenna-painikkeella.

Huomaathan, että tällä hetkellä viesti lähetetään vain uusille ryhmän jäsenille, eli sellaisille käyttäjille, jotka lisättiin ryhmään viestin tallentamisen jälkeen.

# sisukoti

6.2.2 Adding a student group imported from Sisu to the course homepage

Please note that course homepages are usually located at:

 https://tim.jyu.fi/view/kurssit/ORGANISAATIO/KURSSIKOODI/KAUSI/koti

for example:

 https://tim.jyu.fi/view/kurssit/historia/HISP001/2022k/kotisivu

Add a group to the course homepage:

  • Go to the document from which you want to make the course home page.

  • Click on -> Set as a course/Set as a course. Dokumentin asettaminen kurssiksi.

Please add the course details to the form:

  • Course code: course code
  • Subject: subject
  • Expiration date: the date the course will close to students
  • Student group: the TIM name of the group copied from the previous step
  • Click Set.
Kurssin tietojen muokkaus.
Edit course information
  • a link to the course home page is created on the group administration page.
  • group can be found by selecting All documents -> groups from the main menu.
URL teksti.
URL

Once you have added a group to the course homepage

  • students enrolled in a group in Sisu will automatically see the coursein Mycourses/Mycourses list on the TIM home page and
  • as a teacher you can find the course by clicking on Current courses/Availablecourses.
Nykyiset kurssit pääsivulla.
TIM home page
Nykyiset kurssit/Available courses.
List of courses currently offered by the teacher

6.2.3 Evaluation of a group of students imported from Sisu and export of coursework to Sisu

Create a folder where the course is

  • a new document for group management
  • select the Manage tab from the main menu
  • copy the code below in full into the Edit the full document field
  • finally click Save.
``` {settings="" id="4JnLiL380HUA"}
auto_number_headings: 0
form_mode: true
group: mallikurssinryhma1
lazy: false
macros: 
  courseSisuCode: jy-CUR-4668
  group: mallikurssinryhma1
  n: 11
urlmacros:
  group: mallikurssinryhma1

#- {visible="True" id="EFWgSPaG5Fwv"} Tämä on opiskelijan minimaalinen näkymä. Tietoja voit opettajan syöttää kun klikkaat yläpalkista Teacher.

7. Mallikurssi, vain arvosana

showname: 1

#- {defaultplugin="textfield" readonly="view" .fieldCell id="BAILqZlbs8KR"} {#grade stem: 'Arvos', cols: 3#}

#- {visible="False" id="RMSH1qcMgNVk"}
Klikkaa kahdesti solua johon haluat syöttää.

groups: 
 - 
fields:
 - grade
table: true
report: true
maxRows: 40em   # max height for the table before scrollbar 
realnames: true # Show full name in 2nd column, true or false
buttonText:     # Name your save table button here
autosave: true  # autosave, true or false
separator: ";"  # Define your report value separator here, ";" by default
cbColumn: true    # show checkboxes
nrColumn: true    # show numbers
filterRow: true   # show filters 
singleLine: true  #
reportButton: "Raportti"
emailUsersButtonText: "Lähetä sähköpostia valituille" # jos halutaan lähettää sähköpostia 
toolbarTemplates:
 - cell: '1'
 - cell: '2'
 - cell: '3'
 - cell: '4'
 - cell: '5'
 - cell: 'HYV'

#- {visible="False" .gray id="sOwgk5kGQM0v"}

buttonText: "Lähetä arvioinnit Sisuun"
destCourse: 
showInView: false
group: 

#- {id="UDcKWFRNxI4v"}
```

Edit the code:

  • group: the TIM name of your course
  • courseSisuCode: the sequence of numbers in the Sisu name of your course
  • group: the TIM name of your course.
Omat tiedot dokumenttiin.
Document details
Tarvittavat tiedot dokumentin asetuksiin.
Information needed to configure the document

You can get the assessment done and sent to Sisu:

  • by clicking on the main menu Teacher/Teacher
  • by setting the grades in the table using the editor
  • by clicking on Preview the assessments
  • by setting the date when the grades will be exported to Sisu and
  • by clicking on Send the selected ones to Sisu
  • finally go to Sisu to confirm the grades. Opiskelijoiden arviointi.
Arvostelujen vienti Sisuun.
Exporting ratings to Sisu

7. Rights to documents

The chapter teaches

  • adding rights to a document
  • adding rights to a group in a document
  • setting default rights for new documents and folders
  • assigning a specific right to only one block in the TIM system
  • mass changing rights.
# dokumenttien-oikeudet

7.1 Rights to documents

When a new document is created, the default permissions are assigned to the document and are displayed when a new document is created and can be edited as desired.

The permissions can be edited from the Manage tab of the document.

Hallitse välilehti
Manage tab

The default permissions set the document as the author's property.

Dokumentin oletusoikeudet
Default permissions for the document

Clicking on any permission will open a menu that allows you to set permissions for users or groups.

  • Name:Enter user names or groups separated by a semicolon ; .

  • Right:select the right you want to grant from the drop-down menu.

  • Add: add the selected right to the specified usernames or groups.

  • Add logged in-users: add rights for all logged in users.

  • Add anonymous users: add rights for all guests. Use with caution, especially when editing permissions.

  • Add jyu.fi users: add permissions for all users of the jyu.fi organization . From the pull-down menu on the left of the button, you can select other organisations.

Oikeuksien lisääminen
Add rights

7.1.1 Available rights levels

  • view: the right to view the document and perform tasks on if you are logged in. If the tasks are given the right to do without logging in, even non-logged in users can do the tasks, but the results are not saved anywhere. In addition, there is the right to view the markdown of non-plugin blocks via View source.

  • copy: the holder of this permission can view the markdown of the document also for plugins (View source) and copy the document (via the manage view) to himself. In this case, any answer or scoring criteria in the plugin will be shown with it, so this permission should not be granted if the answers are to be encrypted.

  • edit: right to edit the document. Does not include the rights that the teacher permission allows. This should be given to the group that develops the document. For general-purpose (wiki) documents, jyu.fi users may also be a useful alternative to . Why not even Logged-in users.

  • see answers: the right to view (but not modify) the answers of others. The names of respondents are displayed anonymously. This right should usually only be given to the group to which the tasks belong, once the deadline for the tasks has passed. For example ohj2k16.

  • teacher:

    • no right to edit the document, so edit permission must be given separately
    • right to create lectures related to the document and to add lecture questions
    • right to view all answers to the document
    • right to change the scores of the answers
    • right to give feedback to the student on the answersThis right should be given carefully, because then you will see the names and usernames of the users. Note: the teacher permission does not automatically grant the edit permission.
  • manage: the right to change the permissions of the document except for the owner. Includes of course all previous permissions including edit and teacher.

  • owner: the highest level of rights, which includes all rights.

If no rights are assigned to a document, the document will be displayed with the text UNPUBLISHED in the background. If you are disturbed by the text and do not want to assign rights to anyone yet, you can assign the view right to the document to yourself, after which the background text will be removed.

7.1.2 Rights preferably for groups

While rights can be granted to individuals, it is preferable to grant rights to groups.

Ready-made larger groups include:

  • jyu.fi users. These are users who are reliably logged in to and these accounts cannot be easily created by just anyone. These users can often be given more rights, because in case of abuse it is easier to put their account on the banned list or to contact them.

  • logged-in users: people who are logged in. This category includes also those who have created an account for themselves from Sign in using . These persons have at least a working e-mail account, because have been assigned a TIM account. These people can also be denied access in case of abuse, but they can always create a new account with another email address, so they are not as reliable as the Raven logged in.

  • anonymous users: users who are not logged in at all. This group can often be given read access, but care must be taken with edit access.

TIM's ideology would be that if possible, anonymous should be given read access, so should be made as public as possible. If there are tasks in the document, they are not stored for the unlogged, so then the recommendation is logged-in users.

In the TIM system it is also possible to create new-groupsnew-groups and give them descriptive names. For example, a group could be students in a particular course or teachers.

For example, for the teachers and instructors of the Programming 1 course, a group ohj1 is created for the teachers and instructors of the course manage or owner. By assigning access to the course document or to that group, then by changing the members of the group each year, it is possible to control at once who can edit what. Either the same or a different group can be given teacher access, which for example entitles them to give feedback on students' answers.

If there is more than one administrator , it is advisable to create a group of potential document administrators at once. Even if there is only one person, you should make a group if there is even a small chance that there will be more administrators.

If the owner of a read-only account is not one of the general Logged in, Anonymous or one of the Haka groups, then it is also worth making a group of the owners of the read-only account.

The group can be created from Luo uusi ryhmä behind the wheel. The groups needed for courses can be obtained from via-insuvia-insu.

Creating your own groups requires a permission, which can be requested from the administrator at by sending an email to: tim@jyu.fi For groups automatically generated from Sisu, teachers already have sufficient rights to create them.

Another advantage of a group is that it can be created email listemail list.

7.2 Setting default permissions for new documents and folders

Useita dokumentteja luotaessa oikeuksien asettaminen kullekin erikseen on aikaa vievää, ja se voi myös unohtua helposti. Siksi on mahdollista asettaa kansiokohtaisesti oletusoikeudet uusille dokumenteille ja kansioille.

Jos esimerkiksi haluat, että kansioon harjoitustyot luotuihin dokumentteihin tulee automaattisesti katseluoikeus ryhmälle jyu.fi users, etene seuraavasti:

  • Mene kansion harjoitustyot hallintasivulle (Manage).
  • Klikkaa välilehteä Default rights for new documents.
  • Lisää view-kohtaan oikeus ryhmälle jyu.fi users.

Vastaavalla tavalla voit asettaa oletusoikeuksia uusille kansioille (välilehdeltä Default rights for new folders).

Huomaa, että ylempiin kansioihin asetetut oletusoikeudet periytyvät myös alempiin kansioihin.

7.2.1 Granting a specific right to only one block

If necessary, a right may also be granted for only one block. Often the permission is restrictive, e.g. the right to edit a document is granted to a large number of people, but only people with manage permission can edit a particular block. In this case, a block can be started

#- {edit="manage"}

7.3 Mass migration of rights

When there are many folders/documents whose permissions need to be changed, the Manage/Manage tab for a single item is a slow solution. Then to change , you should go to the top folder of the set to be changed, (directory), and its Manage/Home tab. There, select Rights of subitems:

Rights of subitems.
Rights of subitems

Here you can use the Title box of the table to filter the desired rows and then select the required or all those displayed and add/remove the desired rights. Adding and removing rights is done as described in the document-rightsdocument-rights header.

Lisää oikeuksia.
Add rights

8. Email list and discussion page

The chapter teaches

  • create an email list
  • copy the course discussion page to your own course
  • give students permission to edit the discussion page
  • subscribe to emails about changes to the discussion page
  • add topics, messages and comments to the discussion page.

8.1 Email list

To create an email list, you need the right to create groups. To get the rights please contact TIM Development . To start creating an email list, click on on the wheel and select Create a new mailing list.

In the form that appears, fill in

    • length between 5 and 36 letters
    • can contain lower case letters a-z, numbers 0-9, dashes -, dots . and underscores _
    • must start with a lower case letter
    • cannot contain several dots in a row and cannot end with a dot
    • must contain at least one number
    • if the list is to represent, for example, the course group ohj1s22, then this is a good name for the list
  • archiving type
  • click create.
Sähköpostilista rattaasta.
Email list

Fill in the list settings, which are valid for the whole mailing list and for all channels. The tab also lists general information such as the list name and email address.

  • List name
  • The email address of the list to which messages going to the mailing list will be sent
  • Short description to inform users of the purpose of the mailing list
  • Long description to specify the target group, purpose or use of the list
  • General settings.

Click Save settings.

Sähköpostilistan asetukset.
Email list settings

Adding members to the mailing list

  • A TIM user is added to the mailing list by entering his/her username in the Lisää jäsenet field. The user will be granted the rights that are selected in the checkboxes below the text field at the time of the addition. The rights can be changed afterwards.
  • A TIM group is added in the same way as a TIM user, i.e. by entering the name of the group.
  • An external member is added by entering the details in the Lisää jäsenet field. For the details of an external member, the e-mail address is mandatory, but not the name. You can enter the information in two different ways:
  • You can add several members at the same time by entering the information in the text field and by separating them with a line break.

Finally, click Add new members.

Jäsenien lisääminen sähköpostilistaan.
Adding members to the mailing list
  • Members added to the list are displayed in the Nykyiset jäsenet field.
  • Members can be edited, removed from the list or reinstated.

Deleting a member

  • Select the member to be deleted from the checkbox in the Poistettu listalta column.
  • Save by clicking Save members.
  • The deleted member will not disappear from the members table, but the time of the deletion will appear in the Jäsenyys päättyi column . You can return a deleted member to the list by selecting the member again in the Poistettu listalta checkbox and saving the change by clicking Save members.

An email list can be deleted by clicking Delete list, which means the email list is disabled and will not accept messages from members of the list. This way the mailing list will not be accidentally deleted.

Jäsenen poistaminen sähköpostilistalta.
Removing a member from the mailing list

8.2 Course discussion page

On TIM, any document can be commented on and thus the discussion can be carried out on , for example in lecture material. However, courses often want to create a separate discussion area . The following are instructions on how to create and use a separate discussion page.

8.2.1 Copying a chat page

Copy the bottom of the document to your own folder from

view/courses/tie/proj/2022/timo/tim-guide/course-discussion-base

Watch the video to see how to copy the discussion page.

Copying a chat page

After creating the page, the students must be given editing rights to the discussion page. This is done from the Manage/Manage tab of the main menu under Document rights. Students are given editing rights by adding them to the edit section.

Muokkausoikeuden antaminen kurssilaisille.
Adding rights to discussants

Watch the video to see how to add students to the chat page.

Adding students to the chat page

It is always a good idea for the course teacher to order the changes to the page by e-mail. This is done via the box at the top of the discussion page .

Keskustelusivulla on laatikko,josta ilmoitukset tilataan.
the box on the chat page where notifications are subscribed to

Options for email notifications

Document modifications: the user receives an email when a document is modified.

New comments: the user receives an email when a new comment is added to the document.

Edited comments: the user receives an email when an existing comment is edited.

New answers to tasks: the user receives an email when new answers to tasks are added.

Notifications of changes can also be subscribed to at from the Manage/Manage tab under Notifications.

Muutokset tilataan Notifications-välilehdeltä
To subscribe to changes by emailing

8.2.2 Use of the chat page

You can watch the video below for instructions on how to use the chat page. The video is followed by the same instructions in text format.

Use of the chat page

  • You can add a message to a specific discussion by clicking on Add message.
  • To add a new topic, click on at the bottom of the page and add a new topic to .
Uuden keskustelun lisääminen.
Adding messages and discussion topics
  • You can comment on a particular message by clicking on the message and then selecting from the edit menu Comment/note.
Viestin kommentointi muokkausvalikon avulla.
Commenting on messages

More guidance

# kurssin-navigointi

9. Course navigation

The chapter teaches

  • add a menu to a course page
  • edit the content and layout of the menu
  • edit the functionality of the menu.

What is the menu?

In TIM, a menu is a navigation bar anchored at the top of the page . The menu is used to navigate between the different pages of the course.

Menupalkki, jossa on navigointi materiaaleihin, tehtäviin ja kotisivulle.
Example of a menu

The menu can be created with the timMenu plugin. In the template courses, the menu is pre-built and you only need to modify the menu to suit your course.

A course website usually consists of several pages and you want the menu to be the same for all pages of the course . This is done by adding the menu to a preamble document created in the course directory templates/preambles. This way the menu will automatically appear on all pages of the course. If you are building a course based on a template course, the menu is edited by editing the preamble document.

kuva preamble-dokumentista, joka on sijoitettu templates/preambles-kansioon
preamble document

Watch the video to see how to add a menu to multiple course pages using a preamble document.

Adding a menu to the course pages

9.1 Adding a new menu

  • From the Insert tab, click the Menu button and select timMenu.
Insert-välilehden ja menun valinta editorissa.
To add a timMenu

9.2 Editing the menu

You can watch the video below for instructions on how to edit the menu. The video is followed by the same instruction in text format.

Editing the menu

TimMenu comes with a variety of predefined submenus and formatting that you can use to build your own menu.

What is a menu slide?

A menu item is a single element displayed in a menu. In the menu below, menu items are the menu headings "Materials" and "Tasks" and the link "Home".

Menupalkki, jossa on navigointi materiaaleihin, tehtäviin ja kotisivulle.
Example of a menu

Expenditure debits are marked with (-).

Menualkiot on merkitty - merkillä.
Expenditure is indicated by a hyphen

Placing a menu drawer in a submenu is done by nesting.

Alavalikon menualkiot on sisennetty editorissa.
Inclusion

To make drop-down menus, type the menu title in normal text.

Alavalikoiden tekstit on kirjoitettu editorissa normaalina tekstinä
Creating submenus

If you want to make a link to another page in the menu, enter the text as a link.

[linkkiteksti](linkki)
Menualkiot voivat olla myös linkkejä.
Adding links to a menu

If you want to make a menu text that is neither a link nor a new submenu, type between the (**) characters.

Valikkoon on lisätty teksti ** merkkien väliin.
Adding text to a menu

9.3 Menu settings

Menu attributes allow you to customise the layout and some functionality. Menu attributes are written in the plugin right at the beginning, before the actual menu content.

What are attributes?

In TIM, plugin settings are controlled by attributes. An attribute has a name and a value. The name tries to describe what kind of setting is controlled by the attribute. The value depends on the attribute in question. The attribute name and value are separated by a colon. In plugins, attributes are placed at the beginning of the code.

nimi: arvo

Example of attribute usage

In the timMenu plugin, if you set the topMenu attribute to true, the menu will appear at the top of the current view when the page is scrolled up. This is a very handy feature if the page is long.

topMenu: true

Watch the video to see how to customize the menu using the attributes.

Menu settings

Menu attributes:

  openingSymbol : symboli joka näytetään avautuvissa valikoissa
      separator : merkki joka erottaa valikon otsikot toisistaan
backgroundColor : taustaväri
      textColor : tekstin väri
       fontSize : fonttikoko
        topMenu : kertoo ilmestyykö valikko sivun yläreunaan, kun sivua selataan ylöspäin
    basicColors : kertoo käyttääkö valikko TIMin perustyyliä
 keepLinkColors : kertoo näytetäänkö linkit sinisellä värillä
      hoverOpen : kertoo avautuuko valikko ilman klikkaamista
Attribuutit on sijoitettu menu-pluginin alkuun
Menu settings are adjusted by changing the values of the attributes

10. Text formatting

10.1 Headlines

The chapter teaches

  • how to create different levels of headings.
  • In the editor, select the Style tab.
  • On the Style tab you will find headline buttons from largest to smallest H1-H5.
  • You can create headlines
    • by first selecting the desired headline size and then typing the headline or
    • by using #, for example a H3 level headline would be typed ### Headline or
    • by pressing Ctrl-1(H1), Ctrl-2(H2) etc.
  • To enable automatic numbering of document titles, from the top left corner of the page, click on the wheel image -> Edit settings -> change auto_number_headings to 1.
  • Automatic numbering of titles only works for levels H1-H3.
Otsikot editorilla.
Headlines
# erityyli

Excercise

Edit the text with the main heading H1 and its subheadings H2, and H3

# Pääotsikko H1 {.nonumber}
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Integer in accumsan nunc, id egestas augue. Phasellus
imperdiet orci orci, sit amet tristique justo porta et.

Alaotsikko H2
Suspendisse suscipit iaculis erat, et pulvinar mi posuere
sed. Vestibulum rhoncus, lectus nec interdum fringilla,
risus turpis varius tortor, at consequat ex purus at erat.
Suspendisse hendrerit elementum diam, sed consectetur sapien

Alaotsikko H3
ullamcorper a. Donec consectetur purus at eros sodales, quis
ornare sem convallis. Aenean fringilla lectus nibh, ac
efficitur est dictum at.t, ac maximus elit feugiat et.
Praesent bibendum sem eget pulvinar tincidunt.

 

10.2 Text styles

The chapter teaches about text styles

  • italics
  • bold
  • text colour and background colour
  • note
  • underline underline
  • strikethrough.

You can highlight text or parts of text by specifying highlighting marks around the part of the text you want to highlight

  • by typing them in manually, or
  • by specifying a highlight in the Style tab of the Editor, or
  • by using the buttons that appear when you hover over a highlight in the Style tab .

If any text or text part is selected, clicking on the highlight button will place highlight marks around the selected area. If you click the button a second time, the highlights disappear. If no area is selected, the highlighters will appear around the blank and the cursor will remain between them.

If you want to use a particular style for the whole block, specify the style at the beginning of the block on the #- line, and the style will continue to the end of the block.

10.2.1 Course

You can italicise text

  • by selecting italics from the Style tab or
  • by selecting the key combination ctrl + I italics after the desired word/selected text part or
  • by adding * characters around the text part to be italicized.
Kursivointi editorilla.
Italic


10.2.2 Bold

You can bold text

  • by selecting bold from the Style tab or
  • by selecting the key combination ctrl + B with bold after the desired word/text or
  • by adding ** characters around the word as shown in the image below.
Lihavointi editorilla.
Bold

10.2.3 Text colour

  • You can change the colour of the text in the Style tab by clicking Color.
  • You can also put the text you want between [ ] and type the colour you want in curly brackets in English, for example[Tekstiä]{.red}.
  • You can change the background colour of the text by adding bg (backgroud) in front of the colour.
Tekstin väri editorilla.
Text colour

10.2.4 Note

To highlight a text or part of a text, type the part of the text to be annotated in square brackets and add the annotation style [Tekstiä]{.huomautus} after the square brackets. If you want to specify an annotation style for the whole block, add {.huomautus} to the line #- that starts the block.

Huomautus editorilla.
Note

Do all the exercises. Read the instructions carefully! Check again that you have returned all the exercises.

If you specify a style at the beginning of a block on the #- line, the style will continue until the end of the block.

The next block starts...

10.2.5 Underline

  • You can underline text by selecting underline from the Style tab.
  • You can also underline text by placing at the beginning of the text to be underlined. <u> and at the end </u>.
Alleviivaus editorilla.
Underline

10.2.6 Overwrite

  • You can cross out text by selecting the cross out option from the Style tab.
  • You can also cross out text by placing the part of the text to be crossed out at the beginning of <s> and end </s>.
alt-tekstiä.
Strikethrough

10.2.7 Mission

# erityyli1

Try out different text styles

Edit your text with italics, bold, colour, underline, strikeout and annotation.

Kursivoi sana kissa

Lihavoi sana koira

Muuta sana jänis vihreäksi

Muuta tämän lauseen tausta keltaiseksi.

Alleviivaa sana orava

Yliviivaa sana hevonen

Korosta tämä lause huomautus -tyylillä.

 

10.3 Inclusion

The chapter teaches about text formatting

  • indentation
  • specific types of lists
  • line and spacing
  • paragraph
  • You can indent:
    • using the arrow buttonson the Style tab, as shown below, or
    • by pressing and pressing the key.
Sarkainnäppäimet Style-välilehdeltä.
Indenting

10.3.1 List of

When you start making a list, separate the list from the rest of the text with at least one blank line .

You can createa bullet list:

  • by selecting Insert -> List or
  • from the navigation bar by typing a hyphen (-) at the beginning of the line.

To get aninserted list

  • by indenting the sub-list by clicking once on with a column and List or
  • by clicking on with a column and inserting a hyphen or
  • by indenting the sub-list with at least four spaces.
Esimerkki sisennetystä bullet-listasta.
Lists

Numbered and alphabetical lists

  • A numbered list is created when you start creating a list with a number, the numbering starts from the given number. Similarly, a letter list starts with the given letter.

  • In a list, the number/letter is followed by either . (dot) or ) (close bracket).

  • An indented list is obtained by indenting a line with a column or by adding at least four spaces at the beginning of the line.

  • Remember to separate the list from the text with at least one blank line.

Esimerkki numeroidusta ja kirjainlistasta.
Numbered list and alphabetical list

Numbered shopping list:

  1. Milk
  2. Bread
  3. Cheese
    1. Oltermann
    2. Polar
  4. Fruit

Shop list in lower case:

  1. milk
  2. bread
  3. cheese
    1. oltermann
    2. polaria
  4. fruit

Shopping list in capital letters:

  1. milk
  2. bread
  3. cheese
    1. oltermannia
    2. polaria
  4. fruit

Numbering of nested lists

For numbering of nested lists, add the attached CSS tab to the document settings. To enable numbering in a block, add the class
#-{.sub-numbering} to the beginning of the block.

``` {settings=""}
css: |!!
.sub-numbering {
  ol { counter-reset: item; }
  li {
    display: block;
    
    &:before {
      content: counters(item, ".") ". ";
      counter-increment: item;
    }
  }
}

```

Sisennettyjen listojen numerointi editorilla.
Numbering of nested lists
# erityyli2

Exercise

Try creating different types of lists. Separate fruit, vegetables and dairy products into their own sections.

Ostoslista
- hedelmiä
  - omenoita
  - päärynöitä
- vihanneksia
  - paprika
  - tomaatteja
  - kurkku
- maitotuotteita
  - voi
  - maito
  - viili

 

10.3.2 Row spacing and line spacing

When writing text, you don't have to worry about line spacing, it's taken care of by the device you're using to read the text. However, to make it easier to read the text, it is recommended to change the line break after about 70 characters, which makes it easier to read the text in the editing editor .

You can get a forced line break when

  • you put \ as the last character of the line or
  • you select Breaks from the Insert tab End line or
  • you click Ctrl + Enter.

If there is a single blank line in the source text of the list, the entire list is made with a sparse line spacing.

Esimerkki rivityksestä.
Row spacing and line spacing

10.3.3 Clips from

  • The idea of TIM is to create easily editable and commentable paragraphs.
  • You can always create a new paragraph by clicking Add paragraph at the bottom of page.
  • Alternatively, you can break up the finished paragraph
    • by selecting Insert -> Breaks -> Paragraph break from the navigation bar or
    • by adding #- as shown below.
Kappaleen lisäys editorilla.
Paragraphs

11. Links

The chapter teaches

  • add links to pages
  • create in-page links, also known as jump anchors.

You can watch the video below for instructions on how to add links. The video is followed by the same instruction in text format.

Adding links

# omalinkkiteksti

A normal link without a separate title, can be written between the <> signs.

http://fi.wikipedia.org/wiki/Koira

<http://fi.wikipedia.org/wiki/Koira> 
# Hyppylinkit

If you want a separate title for the link, you can type the title between the [] characters and the link () between the characters.

See wikipedia

[Katso wikipediasta](http://fi.wikipedia.org/wiki/Koira)

You can also insert a link in the editor from the Insert tab by clicking Link.

Linkin lisääminen Insert-välilehdeltä.
Adding a link in the editor

11.1 Internal links on the page

You can watch the video below for instructions on the links within the page. The video is followed by the same instruction in text format.

Internal links on the page

You can use on-page links, known as "jump anchors", when you want a link that takes you to another point on the same page.

  • A jump anchor at the beginning of a block is added by typing:
#- {#omalinkkiteksti}
Hyppyankkuri on lisätty lohkon alkuun.
Adding a jump anchor to the beginning of a block
  • A jump anchor can be referred to by writing:
[linkki lohkoon](#omalinkkiteksti)

You will see link to the block

  • You can also add a jumping anchor to the title by typing after the title:
{#omaotsikkolinkki}
Hyppyankkuri on lisätty otsikon perään.
Adding a jump anchor to a headline

You can refer to the jump anchor you created by typing:

[linkki otsikkoon](#omaotsikkolinkki)

This will display with a link to the title

NOTE: You can define the name of the jump anchor yourself, which best describes the link.

# linkit

Tehtävä: Muokkaa linkkejä

Kokeile muokata alla olevia erilaisia linkkejä

[kissa Wikipediassa](http://fi.wikipedia.org/wiki/Kissa)

<http://fi.wikipedia.org/wiki/Koira>

 

11.2 Links to TIM documents

In document links, avoid using the initial part https://tim.jyu.fi or https://tim.education/ , so that the links do not depend on the TIM address. For example, a link to this page can be created by typing the address without the initial part as a semi-absolute reference:

[linkki tähän dokumenttiin](/view/tim/ohjeita/ohjeet/en-US)

This will display link to this documentlink to this document.

More guidance

# kuvat

12. Photos from

The chapter teaches

  • how to add an image.

You can watch the video below for instructions on how to add an image. The video is followed by the same instruction in text format.

Adding an image to TIM

To add an image, add it to the editor

  • ![Kuvateksti](Kuvaosoite) or
  • Insert -> Image.
Kuvan lisääminen TIM-editorissa
Insert image


If you want, you can add a picture from your own device

  • by pasting an image from your clipboard directly into the editor, or
  • by dragging an image or file from your device's file system into the text editor.

You can also upload a file from the Upload tab in the editor.

  • Select the Upload tab and click the Browse/Save button.

    • Select an image from your device's file system or in the case of a phone/tablet you can also take an image.
  • You can also drag and drop an image file onto the Browse/Save button.


Three ways to add a picture (paste, drag, upload tab)


Try adding an image:

# kuva1

Tehtävä

Kokeile vaihtaa kuvan osoitetta sekä kuvatekstiä

![Kuva 1: Volkkari](/images/24/dsc_0014.jpg)

 

More guidance

13. Videos from

The chapter teaches how to add

  • videos in different styles
  • videos from different sources (computer, YouTube, multimedia).

13.1 Styles for embedding videos

TIM offers a few different ways to embed videos. From the instructions below a YouTube video has been added using the "small video" style and a Multimessage video has been added using the "big video" style. You can use the style you prefer to add videos regardless of where they are stored.

Big video

In the big video style, a large play icon is displayed on the page, which can be clicked to open the video.

Big-video ikoni

List video

In List video style, videos appear in a list, from which they can be opened by clicking on them. If you wish, you can link to related material by following the video at .

Where to get parameters for subroutines Lecture 3 – 39m0s (40m15s) 6. Aliohjelmat

Small video

Also in Small video style, videos open by clicking on the text.

13.2 Videos from YouTube

You can watch the video below to see the instruction video on YouTube. The video is followed by the same instruction in text format.

Videos from YouTube

  • Select the Plugins tab.
  • Select Video from the Small video button (you can use any style you like).
Small-videon valitseminen tekstieditorista
Add video - Small video

Now the video plug-in is displayed in the editor and its settings are modified as follows:

     stem:  teksti joka näytetään ennen videolinkkiä
videoname:  videolinkin teksti
  doctext:  videoon linkitetyn materiaalin otsikko
  doclink:  videoon linkitetyn materiaalin osoite 
    start:  videon aloituskohta
      end:  videon lopetuskohta
    width:  videon leveys
   height:  videon korkeus
     file:  videon osoite
Videon asetusten muokkaaminen
Add video - settings

If you don't need all the settings, you can leave out the extra ones.

Asetuksia voidaan jättää pois,  jos niitä ei tarvita
Adding a video - simple settings

Watch the video at

  • can be opened by clicking on the text Videos from YouTube
  • can be hidden by clicking on Hide file
  • can be resized using the +/- buttons.
Videosoitin, jossa näkyy YouTubesta lisätty video
To add a video from YouTube

13.3 Videos from Multicommunicator

From you can import videos with and without subtitles. Let's first go through to import videos without subtitles.

13.3.1 Videos without subtitles

You can watch the video below for an instructional video on Multicommunicator without subtitles. The video is followed by the same instruction in text format.

Videos from a multimedia device without subtitles

  • Select the Plugins tab.
  • Select Video from the Big video button (you can use any style you like).
Big-videon lisääminen tekstieditorilla.
Add video - Big video

Now the video plug-in is displayed in the editor and its settings are modified as follows:

   footer:  teksti, joka näytetään videon alapuolella
   iframe:  asetus joka otetaan käyttöön, jos tuodaan osoite upotuskoodista. 
            Tätä tarvitaan tekstitetyn videon yhteydessä.
    width:  videon leveys
   height:  videon korkeus
     file:  videon osoite
Video-pluginin asetukset
Add video

The link to the video can be found in the Downloads tab of Multicast. Select the link for the best resolution (1080p) and add it to file in the editor.

Moniviestimen lataukset-välilehdeltä valitaan 1080p-laatu
Copied from the best resolution multimedia link

Watch the video at

  • can be started by clicking on the icon
  • can be hidden by clicking on Hide file
  • can be resized by using the +/- buttons
  • can be resized by using the +/- buttons in the Speed section
  • can be changed by clicking onthe Adv button to display a menu that allows the user to jump around in the video, for example.
Video-soiti, jossa näkyy Adv-painike,  Hide-file painike, sekä painikkeet nopeuden ja koon muuttamiseksi
Import videos from Multicast

13.3.2 Videos with subtitles

You can watch the video below to see how-to subtitled videos from Multicommunicator. The video is followed by the same instruction in text format.

Subtitled videos from multimedia

If you have subtitled your videos in Multimessage, you can see them in TIM when you.

  • adding the video in the style you want and
  • copying the link to the video from the Upload tab in Multicast, which can be found in the code under src.
iframe-koodista kopioidaan linkki, joka on attribuutin src arvona (src=https://moniviestin.jyu.fi/embed?uid=f91a8ca5d7584033bcee27cf32b89dc5)
The video link found in the embed code is copied from the multimedia device
  • Add the link to the file section of the plugin.

  • Make sure that the plugin's settings are set.

iframe: true
Moniviestimen linkki  kopioitu editorissa file-kohtaan. Videon asetuksiin asetettu iframe:true. Poista #-merkki alusta tarvittaessa.
Import a subtitled video from Multicast

Now there is a button in the video player to enable the subtitles created in Multicast.

Video-soittimessa on painike, josta tekstitykset saadaan päälle.
Using multimedia subtitles

13.4 Videos from your computer

You can watch the video below for instructions on how to watch videos from your computer. The video is followed by the same instruction in text format.

Videos from your computer

You can also add a video directly from your computer.

  • From the Plugins tab, select the video style you want.
  • Select the Upload tab and add the video to file: by clicking Choose Files.

Note: You can also drag and drop the video file onto the Choose Files button.

Choose files löytyy editorista upload-välilehdeltä
To add a video from your computer
  • Once the video has been uploaded, the file address will automatically appear in the editor.
Videon latautuminen on valmis
Downloading a video from your computer

14. Tables

The chapter teaches

  • adding a timTable table
  • editing a table.

TIM includes many ways to add tables. The simplest and most expressive way is to use a so-called timTable.

In the video below, you will learn how to use timTable.

Tables

14.1 Adding a table

Select the Insert tab and Table button timTable2x2.

Taulukon lisääminen editorissa
Adding a table

14.2 Editing with a text editor

You can add individual cells by typing in the editor

`- cell: 'sisältö'`
Taulukkoon on lisätty kaksi solua cell-määritteen avulla.
Adding a cell

Add a new row

  • To add rows, type - row: and list the new cells below.
  • Note that the rows in the cell must be nested at the same level in the editor. The indentation of cells is 2 spaces. The
  • cell attribute does not need to be entered if the appearance of the cells is not to be edited.
Taulukkoon on lisätty uusi rivi.
Add a new row

14.3 Editing with a table editor

You can also use a table editor to edit the table.

You can watch the video below for instructions on how to use the table editor. The video is followed by the same instruction in text format.

Using the table editor

NOTE! If you cannot access the features of the table editor, please refresh the page.

  • Open the table editor from the edit menu at Edit table.
Taulukkoeditorin avaaminen
Opening the table editor

Now you can edit the table directly on the main page.

  • Use the mouse to select the cell you want to edit and enter new text.
  • You can also move around the table using the arrow keys while holding down ctrl.
  • Tab to move to the next cell.
Taulukko jota muokataan taulukkoeditorilla.
Editing a cell with the editor
  • You can add/remove rows and columns using the +/- buttons.
Rivien ja sarakkaiden lisääminen +/- painikkeista.
Adding rows and columns with editor
  • To close the editor, select Close table editor from the edit menu.
Taulukkoeditorin sulkeminen muokkausvalikosta.
Closing the table editor

14.4 Editing the cell style

cell-The style of cells written with the attribute can be modified by adding style attributes below.

See more details on the style definitions here:

Taulukon solun tyyliä on muokattu.
Editing the cell style

14.5 Example table used in the guidance

Open plugin

More guidance

Example exercises for other types of tables:

15. Tasks

The chapter teaches the following types of tasks

  • true/false
  • multiple choice
  • Likert scale
  • text question
  • arrangement task
  • gap task.

TIM allows you to create many types of tasks and questions and check them . You can create tasks and questions

  1. by selecting the question editor Add question above from the menu.


Kysymysken lisääminen muokkausvalikosta.
Menu
  1. By selecting Plugins -> Questions, from the editor you can edit the question in text format.
Kysymys editorilla.
Editor
  1. By writing the task/question directly as text, but initially it may be easier to add questions using an editor. As you edit the questions, you will also learn to write them in text format.

15.1 Questions and tasks in the editing menu

Watch the video to see how to create questions and tasks using the edit menu ().

Questions and tasks in the editing menu

From the edit menu (), select Add question above, which opens the Create a question form, where you can fill in the question details. The editing menus allow you to create the following question types: true/false, multiple choice, Likert scale and text response.

  • Question text: enter the name of the question.

  • Question title: enter the abbreviation of the question that will be used to store the question in the database and will be displayed as a lecture question title for the teacher.

  • Question type: select the type of question you want.

  • Default points for answer: add here the number of points that will automatically be assigned to those answer options for which you have not specified a value (pts) in the answer options.

  • Randomize rows: shuffle the answer choices.

    • If you wish, you can lock the position of the answer(s), e.g. in polls the option "I don't know" is usually last.
  • Enter the answer options, you can remove (-) or add (+) the options.

    • You can specify the score for the answer in the field after the option, if you are limiting the number of answers, Answer limit, you can also write an explanation for the answer, which will appear when the number of answers is reached.
  • The question can be changed in your lecture question by clicking "Document question" off, you can also specify the answer time for the question if you wish. You can ask the completed question as a lecture question on by clicking on the question mark .

  • In the preview you can see what the question will look like.

  • Save the question data -> Save.

  • You can edit the finished question by selecting Edit question from the edit menu ().


Esimerkkikysymys muokkausvalikolla.
Create a question-lomake

The image above shows a column where you could have entered feedback for each option, which will be displayed when the number of times the question has been answered is reached. The location of the feedback will be displayed when you move the cursor to the right of the option line . You can then enter feedback there.


Try the multiple-choice activity

# Jyvskylnperustaminen2

Open plugin

15.2 Questions and tasks from the navigation bar

Watch the video to see how to edit a question on a form in the editor.

Opening a question from a form in the editor

15.2.1 Text question

Watch the video to see how to make a text question in the editor.

Text question

In the editor, select Plugins -> Questions -> Text question

Tekstikysymys editorilla.
Text question


Customise the task by changing the finished base

  • PLUGINNAMEHERE: the abbreviation of the question, with which the question is also stored in the database and is displayed as the lecture question title for the teacher (cf. Question title).
  • placeholder: you can write here e.g. "Write your answer here." or leave blank.
  • stem: question text.


Tekstikysymys editorilla, koodista korostettu muokattavat osuudet PLUGINNAMEHERE, placeholder ja stem.
Text question code

You can copy the code of the text question here


Try how text input works

# Teksti1

Respondent's name (last name first name):

 

15.2.2 Organizational function

Watch the video to see how to do the organising.

Organizational function

In the editor, select Plugins -> Questions -> Arrangement.

Editorista valittu järjestely.
Organizational function

Modify the task by changing the finished base:

  • PLUGINNAMEHERE: the abbreviation of the question, with which the question will also be stored in the database and displayed as a lecture question title for the teacher (cf. Question title).
  • header: you can write here e.g. "Write your answer here." or leave it blank.
  • stem: question text.
  • In place of Pieni, Keskikokoinen, Suuri, Jättimäinen, type the texts you want in the correct order.
Järjestelytehtävä editorilla, koodista korostettu muokattavat kohdat PLUGINNAMEHERE,header, stem ja järjestettevät sanat.
Code for the organisational task

You can copy here the code for the arrangement task



Try how the organising task works

# Plugin1

16.0.1 Gap task

Watch the video to see how to do the gap task.

Gap task

  • in the editor, select Fields -> Check/Radio/Drop -> Block with one dropdown-plugin (one slot) or Block with two dropdown-plugin (two slots).
Editorista valittuna Block with one dropdown-plugin.
Gap task


  • create your own assignment by editing the prepared text base (outer red box) and the answer options (inner red box).
Edittorissa ohjekoodi aukkotehtävään.
Code for the gap task


You can copy the code for the gap task here

Try how the gap task works

The weather

Please to interact with this component.

{}

{}

{}

{}

nice today.

17. From mission to exam

The chapter teaches you how to

  • how to make the task an exam
  • schedule the exam
  • set the duration of the exam
  • collect the exam score.

17.1 Increasing rights

Exercises and questions also work as tests and exams when you set them up with timed permissions.

  • From the main menu, select Manage/Manage.
  • Change the viewing rights - view by clicking Add right....
Oikeuksien lisääminen Hallitse välilehdellä.
Increasing rights

Specify the rights you want to grant to users in the Right field. You can give permissions:

  • For an individual person and for groups in the TIM

    • by entering the username of the individual in the Name field, the name of the group in the group field and
    • by clicking on Add
  • For users logged in to TIM Add logged-in users

  • for anyone with a link to the exam Add anonymous users

  • University of Jyväskylä users Add jyu.fi users.

Oikeuksien lisääminen henkilölle tai ryhmälle.
Rights for a person/group

17.2 Timing of the exam

You can schedule a start and end time for the exam.

  • Click Set start and/or end date.
  • Set the time when the exam opens and closes for students.
Oikeuksien ajastaminen.
Timing of rights

You can schedule a window of time for the exam to be taken and specify the time available to take the exam from the moment it is opened.

  • Click on Set duration....

  • Specify the time available to take the exam.

  • Specify the time window for the exam when you can start taking the exam.

  • Specify the deadline for closing the exam.

  • Require confirmation means that the authorization has been completed, but the instructor must confirm from the Manage/Manage tab under Documents rights when the person arrives for the exam. It is not necessary to use this function.

  • Add permissions for the person/group of your choice according to the Adding permissions guide .

Oikeuksien keston määrittäminen.
Determining the duration of the exam

Review document permissions in the view section of the document permissions window:

  • You can see the permissions you have selected and the duration of the exam.
  • You can edit/remove the permissions and duration of the exam.
  • You can see who is currently taking the exam.
Katseluoikeudet lisättynä kirjautuneille käyttäjille.
Viewing rights

17.3 Points obtained from tasks

You can see the points accumulated from the assignments for the student when you

  • click on the wheel, Edit settings and

  • adding the text below to the document settings.

show_task_summary: true

To view the results of the exam, select Answers/Answers from the main menu, and a summary of the students who have taken the exam will appear on the right-hand side of the page.

  • Tasks: the number of tasks completed.
  • Points: the total score obtained on the exam.

TIM records the answers/scores of the registered students per task when the task is saved.

Tent results
Tent results

Syntax error in macro template: Expected an expression, got 'end of print statement'

  • At the end of the document, add the code below in a new block.
## Tentin lopettaminen {allowangular="true"}

Lopeta tentti painamalla **Remove your rights** -painiketta

<tim-self-expire
    button-text="'Lopeta tentti'"
    item-id="$ctrl.item.id"
    confirm="'Haluatko varmasti lopettaa tentin? Et voi enää palata siihen sen jälkeen!'"
></tim-self-expire>
Tentin lopetus.
Termination of the Tent

More guidance

18. Lecture and lecture question

The chapter teaches

  • how to display lecture slides
  • how to create a lecture
  • how to create a lecture question.

18.1 Showing lecture slides

  • Select the document you want to show in a lecture.
  • To open a document in lecture mode, select Slides/Slide from the main menu.
  • By default, TIM makes slide breaks for titles.
  • If you think there is too much content on one slide, you can make a forced slide break to the desired point in the original document
    • by selecting Insert -> Slide -> Subslide Break from the editor or
    • by typing in the text editor:#- --- #-
Luentodian pakotettu dianvaihto.
Forced slide replacement of a lecture slide

18.2 Creating a lecture

Lecture questions allow you to make lectures more interactive and engage students during lectures. In order to ask a lecture question, you must have a lecture running. However, you can create lecture questions in advance without having a lecture running or already created.

Watch the video to see how to create a new creation.

Creating a lecture

From the main menu, select the Lecture tab and press Show lecture info.

Luentovälilehden valinta.
Lecture tab

Click the + button to create a new lecture.

Uuden luennon tekeminen.
New lecture

Creating a new lecture

  • Give the class a name.
  • Set the access code for the class if you wish.
  • Choose the maximum number of students.
  • Set the start time of the class.
  • Choose whether students can join the class 15min before it starts.
  • Choose either the end time or the duration of the class.
  • Copy the link below to the clipboard.
  • Finally, press Create.
Luentoeditori.
Create a lecture

You can inform students of the link you have copied or you can shorten the link and/or make it a qr code at r.jyu.fi.

Linkin lyhentäjä.
Link shortening

When you click on the button Shorten address you will see the shortened link. Press download to open the QR code in a new tab. Copy the image for the lecture wall.

Valmis lyhyt linkki ja QR-koodi.
Short link address and QR code
  • From the lecture wall, select Add paragraph.

  • In the editor, select the Upload tab.

  • Copy the address of the image into the Upload image/file field:

  • Put the short address of the link as the caption.

Lyhyt osoite kuvatekstinä editorissa.
Add the link shortcut and QR code to the lecture wall

Ready link abbreviation and QR code:

https://r.jyu.fi/Eny
https://r.jyu.fi/Eny

18.3 Lecture question

InLecture/Lecture mode, you can create lecture questions either before or after creating a lecture at .

Watch the video to see how to ask a lecture question.

Creating a lecture question

Start creating a question by selecting Add lecture question above from the edit menu ().

Add lecture questions above muokkausvalikosta.
Adding a lecture question

Fill in the details of the question in the form that appears.

  • Question text: enter the name of the question.

  • Question title: enter the abbreviation of the question that will be used to store the question in the database and be displayed as a lecture question title for the teacher.

  • Question type: select the type of question you want to use.

  • Default points for answer: enter here the number of points that will automatically be assigned to the answer options for which you have not specified a value (pts) in the answer options.

  • Randomize rows: shuffle the answer choices if you wish.

    • You can lock the position of the answer(s) if you wish, e.g. in polls the option "don't know" is usually last.
  • Enter the answer options, you can remove (-) or add (+) the options.

  • Duration: select the appropriate display time for the question.

Esimerkkikysymys kysymyseditorilla.
Creating a lecture question
  • The question appears in the document as a small question mark block.
  • You can edit a question in
    • by clicking on the question mark or in
    • in the text editor by selecting Edit from the edit menu ().

18.3.1 Asking a lecture question and the answers to the questions

Watch the video to see how to ask the lecture question.

Asking a lecture question

  • While the lecture is in progress, the question is asked by clicking on the question mark , and the question will appear for the logged in students and the time set for the question will start.
Opiskelijoille näkyvä valmis kysymys tentin haastavuudesta, vastausvaihtoehtoina liian vaikea, vaikea, haastava, sopiva ja helppo.
Lecture question
  • To see the distribution of answers, click on Show answers.

  • By clicking on Show points you can send students to see the scores and comments received.

  • You can ask the same question again by clicking Reask, and the answers will be cumulated or ask the question as a new question Ask as new.

  • To change the scoring of a question, go to Edit points.

Opettajan näkymä kysyksen kysymisen jälkeen.
Lecture question - answers

19. Programming

The chapter teaches

  • add programming blocks that can be run directly in the document.

csPlugin is a tool that also allows you to perform programming-related tasks in TIM. The advantage of TIM over many other systems is that programs can be run directly in the document. Thus, programming tasks can be easily embedded in various materials, and a separate programming development environment is not necessarily needed at all. TIM also allows for automatic checking of tasks and feedback.

19.1 Adding a programming block

You can see the textual instructions below for adding programming blocks. After the text, the same instruction is in video format.

On the Plugins tab of Programs, select the programming language you want to use.

Ohjelmointilohko lisätään Plugins-välilehdeltä Programs-painikkeesta.
Adding a programming block

If the desired programming language is not displayed in the menu, select from the list, for example Java. You can then change the programming language by entering a new value in type.

Ohjelmointikieltä muutetaan editorissa antamalla type-attribuutille uusi arvo
Choice of programming language
# kielet

Programming languages and environments and corresponding values ofthe attribute type

Python     : py
Java       : java
C          : c
C++        : c++
C#         : cs
F#         : fs
JavaScript : js
TypeScript : ts
SQL        : sql
Go         : go
Rust       : rust
Swift      : swift
Kotlin     : kotlin
HTML       : html
CSS        : css
Pascal     : pascal
Elixir     : elixir
Lisp       : clisp
Scala      : scala
Fortran    : fortran
NodeJS     : nodejs
WeScheme   : wescheme
Processing : processing
GlowScript : vpython

You can test the different languages with the task at the end of the chapter.

19.2 Programming block settings

Enter a unique name for the programming block to replace the text PLUGINNAMEHERE.

Naming a programming block
Naming a programming block

By default, a programming block does not have a task or a title. They can be added to the block afterwards. The mission statement is added to the beginning of the block using the stem attribute.

Pluginin alkuun on lisätty attribuutti stem: Tee ohjelma, joka tulostaa Hello World!
The mission statement is added with the stem attribute

The title is added to the beginning of the block using the header attribute.

Lohkoon alkuun on lisätty attribuutti header: Tehtävä 1
The header is added with the header attribute

The actual program code is written between the line fullprogram: |!! and the line !!.

ohjelmakoodi kirjoitetaan fullprogram: |!!` ja rivin ` !!` väliin
Writing the program code

The comments BYCODEBEGIN and BYCODEEND are used to mark an area in the program code that can be edited by the block user .

BYCODEBEGIN ja BYCODEEND väliin jäävää koodia voidaan muokata
The block can be used to edit the code that falls between the comments BYCODEBEGIN and BYCODEEND
Jos koodi jätetään BYCODEBEGININ ulkopuolelle, sitä ei voi muokata lohkossa.
BYCODEBEGIN and code outside BYCODEEND cannot be edited in the block

19.3 Using the programming block

The Highlight/Table button displays/hides the line numbers. Highlight also highlights the code with colours.

Highlight-painike tuo editorissa näkyville rivinumerot
Line numbers in the editor

The Start button returns the task to the way it was at the beginning.

Alusta-painike palauttaa tehtävän sen alkuperäiseen muotoon.
Starting a task from the beginning

The Show full code button displays the full program code for the block in question .

Ohjelmakoodi näytetään kokonaisuudessaan, kun klikataan Näytä koko koodi.
To display the full program code

Watch the video to see how to add a programming block and what settings are involved.

TIM and programming

19.4 Grading of exercises

Automatic grading of tasks can be built, for example using JavaScript. You can learn more about automatic checking via the link below.

19.5 All TIM languages

# all1

Test different languages. Check the abbreviations for programming languages at the beginning of this chapter, if necessary.

Select a language from the list. Type in the program code and run. Also try the button Normal/Highlight.

 

19.6 Examples of programming blocks

19.6.1 Java

# test

Excercise 1

Make a Java program that prints the text "Hello World!"

    // Koodi tähän

 

19.6.2 C

# test2

Exercise 2

Make a C# program that prints the text "Hello World!"

public class HelloWorld
{
    public static void Main()
    {
        System.Console.WriteLine();
    }
}

 

19.6.3 Python

# test3

Exercise 3

Make a Python program that prints the text "Hello World!".

 

These are the current permissions for this document; please modify if needed. You can always modify these permissions from the manage page.