docs: DELPHI event display guide

Reshuffle the DELPHI guide on using Docker to extract event display
documentation into a separate guide.

Author: schwicke

cernopendata/modules/fixtures/data/docs/delphi-getting-started/delphi-getting-started.md

@@ -213,10 +213,14 @@ Note: Running the event server requires access to the DELPHI raw data sets.
 
 ## <a name="delgra">Event visualisation</a>
 After setting up the DELPHI environment you can start the DELPHI event display with
+
 ```
+cd
 rungra
 ```
-Note that the event display can read only reconstructed data, not raw data. Both full and short DST work.
+
+For convenience, copy the files you want to scan to ~/graexe/data.
+Please take a look at the [DELGRA guide](delphi-guide-delgra) on how to proceed.
 
 ## <a name="more">More examples</a>
 More examples can be found at https://gitlab.cern.ch/delphi/examples.

cernopendata/modules/fixtures/data/docs/delphi-guide-delgra/delphi-guide-delgra.json

@@ -0,0 +1,25 @@
+[
+  {
+    "body": {
+      "content": "delphi-guide-delgra.md",
+      "format": "md"
+    },
+    "experiment": [
+      "DELPHI"
+    ],
+    "short_description": {
+      "content": "This guide explains you how to start up the DELPHI event display, called DELGRA. For further information on the usage, please refer to the manual."
+    },
+    "slug": "delphi-guide-delgra",
+    "tags": [
+      "Getting Started"
+    ],
+    "title": "Running the DELPHI event display",
+    "type": {
+      "primary": "Documentation",
+      "secondary": [
+        "Guide"
+      ]
+    }
+  }
+]

cernopendata/modules/fixtures/data/docs/delphi-guide-delgra/delphi-guide-delgra.md

@@ -0,0 +1,51 @@
+## Introduction
+The DELPHI event display, also known as 'DELGRA', is used to visualise reconstructed events. This document gives a brief introduction
+on how to start up the display.
+
+Important note: The event display only works on reconstructed data, not on raw data.
+
+## Directory structure
+DELGRA expects to see a folder called graexe in your home directory, with 4 subfolders in it. These are called `data`, `hcopy`, `macro`, `run`.
+In case it does not find the graexe folder, it will try to create them. They have the following meaning
+
+* graexe/data:  Default folder for reconstructed date files which are to be scanned.
+* graexe/hcopy: DELGRA allows to print the current view into a file. This is where the output of these screenshots will go.
+* graexe/macro: Folder for macros.
+* graexe/run:   This folder contains log files from running the program. Consult it in case the program does not work correctly or crashed.
+
+## Starting the event display
+
+Start the event display from a shell from your home directory:
+
+```
+cd
+rungra
+```
+
+It should start up showing an hour glass, and a welcome box, like this:
+
+<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_1.png" width="60%"></center></p>
+
+After pressing on OK in the welcome box, the program will bring up the file dialog where you can select the folder and the file to be read in:
+
+<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_2.png" width="60%"></center></p>
+
+Change into the ~/graexe/data folder and select a suitable file.
+In the screenshot here, there is a file called `simana.sdst`. This is a short DST file of simulated data, so can be selected for viewing.
+Select it and press `Ok` in that dialog.
+
+Next, the event display will ask for the `event number` in this `run` to be read:
+
+<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_3.png" width="60%"></center></p>
+
+Just press OK or return to start reading the first event.
+
+You will see the first event, can rotate it, zoom in, and analyze it, or you can skip to the next event, going through them one by one. Here's a screen shot of event number 5, viewed at a slightly different angle:
+
+<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_4.png" width="60%"></center></p>
+
+Note that due to possibly different random number seeds, the sequence may look different for you.
+
+## Event display manual
+
+The event display manual can be found [here](/record/80503)

cernopendata/modules/fixtures/data/docs/delphi-guide-docker/delphi-guide-docker.md

@@ -77,22 +77,4 @@ cd
 rungra
 ```
 
-It should start up showing an hour glass, and a welcome box, like this:
-
-<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_1.png" width="60%"></center></p>
-
-After pressing on OK in the welcome box, the program will bring up the file dialog where you can select the folder and the file to be read in:
-
-<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_2.png" width="60%"></center></p>
-
-Switch to ~/graexe/data and select the simana.sdst file which we just copied there, and press Ok in that dialog. Next, it will ask for the number of event in this run to be read:
-
-<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_3.png" width="60%"></center></p>
-
-Just press OK to start reading the first event from the run, or press return.
-
-You will see the first event, can rotate it, zoom in, and analyze it, or you can skip to the next event, going through them one by one. Here's a screen shot of event number 5, viewed at a slightly different angle:
-
-<p><center><img src="/static/docs/delphi-guide-docker/delgra_startup_4.png" width="60%"></center></p>
-
-Note that due to possibly different random number seeds, the sequence may look different for you.
+Please take a look at the [DELGRA guide](delphi-guide-delgra) on how to proceed.