1
.. IVLE - Informatics Virtual Learning Environment
2
Copyright (C) 2007-2010 The University of Melbourne
4
.. This program is free software; you can redistribute it and/or modify
5
it under the terms of the GNU General Public License as published by
6
the Free Software Foundation; either version 2 of the License, or
7
(at your option) any later version.
9
.. This program is distributed in the hope that it will be useful,
10
but WITHOUT ANY WARRANTY; without even the implied warranty of
11
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
GNU General Public License for more details.
14
.. You should have received a copy of the GNU General Public License
15
along with this program; if not, write to the Free Software
16
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24
This page is designed to give a brief overview of IVLE, from a users point of
25
view (including administrator and lecturer users). Here we assume that you
26
have :ref:`set up a fresh copy of IVLE <ref-install>` and :ref:`installed the
27
sample data <sample-data>`. This page refers to the sample data specifically.
28
If you are just using an existing installation of IVLE, it might still make a
29
bit of sense, but your mileage may vary.
31
We will take the tour in three stages: first as a student, then as a lecturer,
32
and finally as an administrator.
37
Begin by logging into IVLE as a student (username: 'studenta', password:
43
You will see the IVLE home screen, which displays the subjects you are
44
enrolled in, and your files for each subject. Along the top is the blue bar
45
which is always visible in IVLE. Clicking the IVLE logo always returns you to
48
The user "studenta" is enrolled in several subjects, and has several files
49
already in her Subversion repository, but they aren't immediately accessible.
51
First, click all of the "Checkout" buttons, to check out the Subversion
52
repositories. Now you can explore the sample files, for example, in the
55
Go into the "stuff" directory and left-click the file "hello.py". This will
56
open the build-in text editor, which lets you modify the file. Along the top,
57
there is a button marked "Serve". Clicking this will *run* the Python code as
58
a CGI application -- this should open a new window which reads "Hello,
59
world!". You can also click "Run", which will run the program in the built-in
60
Python console (which pops up from the bottom of the screen). This will be
61
much uglier, printing the CGI output.
63
* "Serve" runs Python programs as CGI applications, showing their web output.
64
* "Run" runs Python programs as command-line applications.
66
Note that you can also use the console at the bottom of the screen as a
67
generic Python console, whenever you wish.
69
You can also serve other files, such as HTML files (try "Welcome to
70
IVLE.html"). This will just present them as normal web pages.
72
Files also have full Subversion histories. If you click on a file in the file
73
view (such as "hello.py"), and go to More Actions -> Subversion -> View Log,
74
you will see the history of a file, and be able to "select" then view a "diff"
75
of the file. If you edit a file, you need to commit it (More Actions ->
76
Subversion -> Commit). If you create a new file (More Actions -> Directory
77
actions -> New file), you need to add it (More Actions -> Subversion -> Add),
83
This student has already completed a project, and is ready to submit it. Go
84
into the Intermediate Ivle -> mywork directory. Select "phase1.html" and
85
choose More Actions -> Publishing -> Submit. This takes you to the Submit
88
Choose to submit to Phase 1, and click Submit Project.
90
If you go into the Intermediate Ivle -> group1 directory, you will be able to
91
make a group submission to Phase 2 (which is a group project). Note that the
92
Phase 3 submission has already closed.
93
Also note that the file here ("phase2.html") was edited by studenta and
94
studentb collaboratively, as you can see in the project's revision log.
99
Click on Intermediate Ivle -> Subject Home from the home screen (or, from the
100
IVLE pulldown menu, choose Subjects and select Intermediate Ivle). There is
101
one worksheet, Worksheet Basics. Clicking this takes you to the worksheet,
102
where students are challenged by Python questions.
104
After reading the worksheet, attempt the simple programming question, which is
105
to write a factorial program.
107
A sample solution follows::
119
First, click Submit, and note that the system automatically runs some test
120
cases, all of which fail. Now paste the solution to :func:`fac` (but not
121
:func:`main`). Clicking Submit again shows some test cases pass, but not all.
122
Finally, paste the solution to :func:`main`, and click Submit again. This
123
time, you will pass the test.
125
Note that you can also click "Run", and it will execute your solution in the
126
Python console. This doesn't cost you an "attempt", nor does it run the test
127
cases. It just lets you test it out for yourself before making an official
130
Back on the subject page, you will notice that the exercise appears complete,
131
and you have been awarded some marks.
136
Log into IVLE as a lecturer (username: 'lecturer', password: 'password'). Many
137
of these things are also possible as a tutor (try username: 'tutor', password:
140
Being a lecturer or tutor is a per-subject privilege, so it only applies to
141
certain subjects. All of your special powers are under the subject home for
142
the subjects you are a tutor in. Note that everything a lecturer can do, an
143
admin can also do, for all subjects in the system.
145
Click "Intermediate IVLE - Subject home". From here, you will see largely the
146
same view as a student, but with more buttons. "Change details" allows you to
147
modify the subject properties. "Enrol users" allows you to add existing IVLE
148
users as students or tutors of the subject you are teaching (this is currently
149
an irreversible action).
154
Click "Manage projects" to go to the project management screen. Note that the
155
3 projects are grouped into "Solo projects" (projects submitted by each
156
individual student) and "Group projects". Try adding a new Solo project, by
157
clicking on "Add a new project" within that box. The fields should be fairly
161
You can't currently edit or delete a project after it has been created.
163
Group projects are complicated by what we call "project sets". A "project set"
164
is a set of group projects where the student groups are the same throughout.
165
For instance, you will see Phase 2 and Phase 3 inside the same project set
166
box. This means students will get into groups of 3 to submit Phase 2, and then
167
the same group will submit Phase 3.
169
Clicking "Manage groups" lets you put students into groups for a given project
172
Click "Add a new project set" and enter a group size of 6. Then, create a
173
project in the new set. Each student must get into a new group for each
174
project *set*. Note also that the groups will share a Subversion repository
175
for all projects in a set, but if you create a new set, the students will have
176
to start using a new repository.
178
Usually, the hassle of getting into new groups and creating new repositories
179
means that you will want to create a single project set for a subject, and
180
just partition the projects into solo and group projects.
182
Managing worksheets and exercises
183
---------------------------------
185
Return to the subject home page. Click "Manage worksheets". On this page, you
186
will see all of the worksheets for the subject. Here you can edit worksheets,
187
add new ones, and re-order them. You can also edit any worksheet from its own
190
To get an idea of what a worksheet looks like in edit mode, click the edit
191
action (pencil) next to "Worksheet Basics".
193
* The "URL name" is the name of the worksheet as it appears in URLs.
194
* The "Assessable" checkbox will make the exercises in the worksheet count
195
towards each student's worksheet mark, if checked. Uncheck it for
196
informational worksheets.
197
* The "Format" selection controls the format used to write the worksheet in
198
the box below. Leave it on "reStructuredText" unless you have a reason not
201
Now, you can edit the worksheet content in reStructuredText. The existing text
202
briefly explains this format. See `A ReStruecturedText Primer
203
<http://docutils.sourceforge.net/docs/user/rst/quickstart.html>`_ for a full
204
guide. Note that the exercises themselves are not in the worksheet. They are
205
separate resources, which can be shared across subjects. Exercises can be
206
embedded with a line like this::
208
.. exercise:: factorial
210
Click "Manage exercises" to see the exercises (in the sample data, just
211
"factorial"). An exercise is a very complex thing, due to the fact that it
212
runs automated testing on the student code. The details are outside the scope
213
of this tour. Hopefully, you can figure out how they work by examining the
214
existing "factorial" exercise.
216
If you are game enough, create a new worksheet from scratch. If you are
217
*really* game, create a new exercise for your worksheet.
219
An administrator's view
220
=======================
222
Log into IVLE as an admin (username: 'admin', password: 'password').
224
Administrator users in IVLE have significant privileges. Note, however, that
225
for technical reasons, admins cannot read or write other users' files. This
226
requires root access on the machine IVLE is installed on.
228
Firstly, pull down the IVLE menu (top-left). There is an additional item for
229
admins -- the "Users" page. This lists all users with an account in IVLE.
230
Clicking on a username takes you to the user's profile page. Try it with the
233
The profile page is exactly the same as the user himself would see it, but
234
with a few more buttons on the side. "Change password" is the same as the
235
user's own "Change password" page. However, "Reset password" is a special
236
admin page which lets you change a user's password without knowing the old
237
one. "Administer user" also lets you change administrative settings for the
238
user, such as their full name (more formal than display name, which the user
239
themselves can change) and student ID. You can also add/remove admin status
240
for, or disable/enable (i.e., ban from IVLE) any user (except yourself, of
241
course -- that could be bad).
244
Use this with care. Making a user an admin gives them complete control over
245
the system. They could even revoke *your* admin rights!
247
Admin users also enjoy the same privileges as lecturers, for all subjects on
248
the system. In addition, admins can enrol users in a subject as lecturers
249
(this is the only way to become a lecturer). Go to the subject page for
250
"Advanced IVLE" and enrol the user "lecturer" as a Lecturer in the subject.
255
Unfortunately, there are still a few tasks which admins need to do which
256
haven't been implemented in the UI for the IVLE web application. These tasks
257
are available as command-line scripts which can be run by someone with root
258
access on the machine IVLE is installed on. They are gradually being migrated
259
over to proper UI features in IVLE itself.
261
Details on these scripts can be found in :ref:`ref-admin-scripts`.
added
removed
doc/man/tour.rst
