~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/man/tour.rst

  • Committer: William Grant
  • Date: 2010-02-24 09:51:04 UTC
  • Revision ID: grantw@unimelb.edu.au-20100224095104-nl3ndy0cysz2ioad
Add support for "really deep" (more than two segment) views.

Show diffs side-by-side

added added

removed removed

Lines of Context:
93
93
any submitted project from the subject page.
94
94
 
95
95
If you go into the *Intermediate IVLE ‣ group1* directory, you will be able
96
 
to make a group submission to Phase 2 (which is a group project). Also note
97
 
that the file here (``phase2.html``) was edited by studenta and
 
96
to make a group submission to Phase 2 (which is a group project). Note that
 
97
the Phase 3 submission has already closed.
 
98
Also note that the file here (``phase2.html``) was edited by studenta and
98
99
studentb collaboratively, as you can see in the project's revision log.
99
100
 
100
 
Note that the Phase 3 submission has already closed. You can still make a
101
 
"late submission" to a project that has closed, but there is an extra
102
 
confirmation step. Lecturers are given details on late submissions and may
103
 
deduct marks accordingly.
104
 
 
105
 
 
106
101
Worksheets
107
102
----------
108
103
 
170
165
clicking on *Add a new project* within that box. The fields should be fairly
171
166
self-explanatory.
172
167
 
 
168
.. warning::
 
169
   You can't currently edit or delete a project after it has been created.
 
170
 
173
171
Group projects are complicated by what we call "project sets". A "project set"
174
172
is a set of group projects where the student groups are the same throughout.
175
173
For instance, you will see Phase 2 and Phase 3 inside the same project set
185
183
for all projects in a set, but if you create a new set, the students will have
186
184
to start using a new repository.
187
185
 
188
 
.. warning::
189
 
   You can't delete a project set after it has been created (this could cause
190
 
   problems for groups and their repositories).
191
 
 
192
186
Usually, the hassle of getting into new groups and creating new repositories
193
187
means that you will want to create just two project sets for a subject: one
194
188
for solo projects, and another for group projects.
205
199
This takes you to a page which lists the latest submissions from every student
206
200
(presumably you will just see the submission made by ``studenta`` earlier in
207
201
this tour). Next to each submission is a command line, beginning with
208
 
``svn export``. For instance, you might see the line::
 
202
``svn co``. For instance, you might see the line::
209
203
 
210
 
 svn export --username lecturer -r7 'http://svn.ivle.localhost/users/studenta/ivle-102/phase1.html' studenta.html
 
204
 svn co --username lecturer -r7 http://svn.ivle.localhost/users/studenta/ivle-102/phase1.html
211
205
 
212
206
Paste this line into a command-line (or, if you use a GUI Subversion client,
213
207
use the username, revision and URL given). Subversion will likely prompt for a
214
208
password. For the sample data, this password is ``password``, but in general, it
215
209
will **not** be your normal IVLE password. You can learn your Subversion
216
 
password by going to your user settings page (it is hidden by default, for
217
 
security reasons).
218
 
 
219
 
This will download the student's work into the current directory, to inspect.
220
 
 
221
 
.. note::
222
 
   This page shows late submissions in red, with a "*", and the number of
223
 
   days late, rounded upwards. Therefore, a submission which is 1 second late
224
 
   is shown with a "(1)", while a submission that is 24 hours and 1 second
225
 
   late is shown with a "(2)".
 
210
password by opening a Console in IVLE and typing::
 
211
 
 
212
 import ivle.config
 
213
 ivle.config.Config()['user_info']['svn_pass']
 
214
 
 
215
This will check out the student's work into the current directory, to inspect.
226
216
 
227
217
You can also try to check out the group submission from Phase 2.
228
218
 
 
219
.. warning::
 
220
   It is currently not possible to check out a single file (not a directory)
 
221
   submission using the instructions given. Instead, run ``svn cat``, and
 
222
   redirect the output into a file.
 
223
 
229
224
Managing worksheets and exercises
230
225
---------------------------------
231
226
 
263
258
If you are game enough, create a new worksheet from scratch. If you are
264
259
*really* game, create a new exercise for your worksheet.
265
260
 
266
 
Viewing worksheet marks
267
 
-----------------------
268
 
 
269
 
You will probably have already noticed that the lecturer's worksheet view is
270
 
not quite like the student's. It has a table at the top which shows some
271
 
statistics about how students in this subject are going with each exercise.
272
 
(Depending on settings, tutors may also be able to access these stats.)
273
 
 
274
 
Lecturers (not tutors) can also get more specific feedback on individual
275
 
students by selecting "View worksheet marks" at the bottom of the subject
276
 
page. This shows the marks in each worksheet, and in the subject overall, for
277
 
each student, and can be used to calculate each student's final grade.
278
 
 
279
 
.. note::
280
 
   The marks are calculated from the current time, by default. However,
281
 
   normally, there is a cutoff time after which students cannot gain any
282
 
   additional marks for worksheets. You can set this cutoff in the offering
283
 
   edit page. Once set, the marks will be calculated based on submissions up
284
 
   until that date, and students will be notified of the cutoff time.
285
 
 
286
 
The "Download as CSV file" link provides these same statistics in CSV format,
287
 
which can be easily parsed.
288
 
 
289
261
An administrator's view
290
262
=======================
291
263
 
299
271
-------------------
300
272
 
301
273
Firstly, pull down the IVLE menu (top-left). There is an additional item for
302
 
admins -- the *Users* page. This lists all users with an account in IVLE, and
303
 
lets you create new ones. Clicking on a username takes you to the user's
304
 
profile page. Try it with the user ``lecturer``.
 
274
admins -- the *Users* page. This lists all users with an account in IVLE.
 
275
Clicking on a username takes you to the user's profile page. Try it with the
 
276
user ``lecturer``.
305
277
 
306
278
The profile page is exactly the same as the user himself would see it, but
307
279
with a few more buttons on the side. *Change password* is the same as the