Commit 43df811c authored by Daniele Casati's avatar Daniele Casati

readme

parent cd4dffac
USAGE
-----
* Wrapper scripts run.sh and print.sh
======================================
=====
Wrapper scripts run.sh and print.sh
-----------------------------------
0) Follow the instructions for installation first (`HOWTO INSTALL`_)
---------------------
^^^^^^^^^^^^^^^^^^^^^
1) Create the tex-files and compile the PDFs
---------------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -28,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
---------------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -44,7 +42,7 @@ 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
---------------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -74,14 +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)
================================================================================
In case the wrapper scripts don't work, you can fallback to the manual procedure described below.
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
---------------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -92,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
--------------------------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -102,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
----------------
^^^^^^^^^^^^^^^^^^^^^
::
......@@ -117,9 +114,9 @@ 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
Go to the ``results`` directory from step 3 and run ``xelatex`` like shown below:
::
......@@ -131,10 +128,10 @@ 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
----------------------
5) Print the pdf-files
^^^^^^^^^^^^^^^^^^^^^
Send *all* the ``pdf`` files to a printer
Send *all* the pdf-files to a printer:
::
......@@ -149,10 +146,10 @@ 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
------------------------------------------------
^^^^^^^^^^^^^^^^^^^^^
::
......
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