Commit fab51969 authored by Daniele Casati's avatar Daniele Casati

readme

parent 43df811c
......@@ -4,11 +4,11 @@ USAGE
Wrapper scripts run.sh and print.sh
-----------------------------------
0) Follow the instructions for installation first (`HOWTO INSTALL`_)
^^^^^^^^^^^^^^^^^^^^^
0) Follow the instructions for installation first: `HOW TO INSTALL`_
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1) Create the tex-files and compile the PDFs
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -26,7 +26,7 @@ Hint: You can run the stages for creation of the tex-files and compilation separ
see. ``./run.sh --help``.
2a) Concatenate the PDFs into one PDF with two sides per page
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -41,8 +41,8 @@ and blank pages are added so that the exam of each students starts with an odd p
Additionally, pdf-files ending with ``-nup.pdf``
are created at ``/path/to/results``.
2b) Alternatively to the latest step, send all the individual PDFs to a printer
^^^^^^^^^^^^^^^^^^^^^
2b) Alternatively, send all the individual PDFs to a printer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -72,13 +72,13 @@ Note: For an exam with 200 students, creating the LaTeX and PDF files may take u
one of the ada servers (work in ``/userdata``).
Manual procedure (workaround if wrapper scripts run.sh / print.sh don't work)
-----------------------------------------------------------------------------
Manual procedure: workaround if wrapper scripts ``run.sh`` / ``print.sh`` don't work
------------------------------------------------------------------------------------
In case the wrapper scripts don't work, you can fallback to the manual procedure described here.
1) Compute the hashes
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -89,7 +89,7 @@ The directory ``resources`` should be identical to the ``resources`` directory
initially distributed to the students computers. Adapt the path to your own setting.
2) Adapt the header as necessary
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -99,7 +99,7 @@ Adapt the lecture title in ``\author{LECTURETITLE}`` on line 63.
Do *not* change the line ``\title{IDENTIFIER \\ IPADDRESS }`` above.
3) Run this tool
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
......@@ -114,7 +114,7 @@ directories.
Note: This tool is not (yet) Python 3 compliant.
4) Run XeLaTeX
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Go to the ``results`` directory from step 3 and run ``xelatex`` like shown below:
......@@ -129,7 +129,7 @@ The ``pdf`` files will appear in the ``results`` directory (from here we ran ``x
Note: The ``tex`` files will *not* compile with just ``latex`` or ``pdflatex`` due to the use of more modern features.
5) Print the pdf-files
^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Send *all* the pdf-files to a printer:
......@@ -148,8 +148,7 @@ Warning: Printing may take a very long time. You may want to print in batches or
HOW TO INSTALL
==============
1) Open a shell and clone the ``git`` repository
^^^^^^^^^^^^^^^^^^^^^
Open a shell and clone the ``git`` repository:
::
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment