docs: DELPHI CVMFS guide

Extract CVMFS-related documentation as a dedicated guide and fix some
bugs and typos in the DELPHI Getting Started guide.

Author: schwicke

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

@@ -6,7 +6,7 @@ This quick start guide is meant as a guide for the very first steps to get going
 * [Documentation](#documentation)
 * [Examples](#examples)
 
-# <a name="overview"> Overview
+# <a name="overview"> Overview</a>
 
 The DELPHI stack consists of the following modules:
 
@@ -23,44 +23,16 @@ DELPHI data access rules are available [here](/record/417), or from [the DELPHI
 
 Please read these before accessing the DELPHI software and data.
 
-# <a name="access"> Accessing the software stack
+# <a name="access"> Accessing the software stack</a>
 There are two possible ways to access the software stack.
 
 ## Docker
-A docker container is available which ships with all the modules installed. Please take a look [here](docs/delpi-guide-docker)
+A docker container is available which ships with all the modules installed. Please take a look [here](docs/delphi-guide-docker).
 
 ## CVMFS
-Binaries are also available from CVMFS, for a variety of different Linux flavors. There are no native Windows or Apple ports available for the time being.
+Binaries are also available from CVMFS, for a variety of different Linux flavors. Please take a look [here](docs/delphi-guide-cvmfs).
 
-This method is convenient if you are running a desktop or a virtual machine with one of the supported Linux flavors on it.
-
-### Requirements
-You will need to have:
-
-* /cvmfs/delphi.cern.ch mounted. Documentation can be found at https://cvmfs.readthedocs.io/en/stable/
-* /eos/opendata/delphi mounted. Documentation can be found at
-* A list of additional packages installed, see https://gitlab.cern.ch/delphi/deployment for more information:
-    * general: tcsh xfonts-100dpi xfonts-75dpi libxfont2
-    * compilers: cmake gcc g++ gfortran
-    * library packages: libx11 libglu1-mesa xutils libmotif r-base xutils libxbae libxaw7 libssl libglew libdlm
-
-Please check the instructions at https://cvmfs.readthedocs.io/en/stable/cpt-quickstart.html and https://eoscta.docs.cern.ch/install/eos/ and https://eos-web.web.cern.ch/eos-web.
-
-### Initialising the environment
-For C-Shell (csh, tcsh ), do
-```
- source /cvmfs/delphi.cern.ch/setup.csh
-```
-
-For Bourne shell (sh, bash, zsh, ...), type
-```
-. /cvmfs/delphi.cern.ch/setup.sh
-```
-If using the container, please use `/etc/profile.d/delphi.sh` or `/etc/profile.d/delphi.csh` instead.
-
-After sourcing the environment, make sure that the environment variable **DELPHI_DATA_ROOT** points to the tip of the data area. This is specifically important if you copied the data sets you want to use locally. The default is `/eos/experiment/delphi/castor2015`.
-
-# <a name="documentation"> Documentation
+# <a name="documentation"> Documentation</a>
 DELPHI manuals and notes are available from [https://cds.cern.ch/](http://cds.cern.ch/search?c=DELPHI&sc=1)
 
 Here is a selection for getting started:
@@ -79,10 +51,11 @@ The DELPHI stack is mostly written in Fortran, with some bits written in C. Only
 
 The collaboration main contact for data preservation is the mailing list [email protected]. Support can only be given on a best effort basis. Suggestions and feedback is of course welcome!
 
-# <a name="examples"> Examples
+# <a name="examples"> Examples</a>
 Some basic examples of how to run the software stack and perform various tasks can be found in the `/cvmfs/delphi.cern.ch/examples` tree.
 
 In the following, we will
+
 * Create some Monte Carlo events and run simulation, reconstruction and DST production on them
     * First, we will show how to do so interactively
     * Then, how to do this on the batch farm at CERN

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

@@ -0,0 +1,25 @@
+[
+  {
+    "body": {
+      "content": "delphi-guide-cvmfs.md",
+      "format": "md"
+    },
+    "experiment": [
+      "DELPHI"
+    ],
+    "short_description": {
+      "content": "This guide explains you how to run the DELPHI software from CVMFS, if available. Various flavours of the Linux operating systems are supported. This is an alternative to the encapsulated container image which in some cases may be easier and more performant."
+    },
+    "slug": "delphi-guide-cvmfs",
+    "tags": [
+      "Getting Started"
+    ],
+    "title": "Running the DELPHI software stack from CVMFS",
+    "type": {
+      "primary": "Documentation",
+      "secondary": [
+        "Guide"
+      ]
+    }
+  }
+]

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

@@ -0,0 +1,43 @@
+## Introduction
+The DELPHI software is also availabe on CVMFS. Many decent Linux flavors are supported, however, there are no generic binaries available for Windows and MacOS.
+If you run on Windows, you can use the Windows for Linux subsystem, using one of the supported systems, for example Ubuntu 22. It is possible to install both CVMFS
+and EOS, allowing for direct access to the data.
+
+This method is convenient if you are running a desktop or a virtual machine with one of the supported Linux flavors on it.
+
+Running the stack locally from CVMFS has some advantages, in particular if the EOS storage system is available on the same host:
+
+* No need to copy the data locally and expose them to the container.
+* Software development can be done locally, without the risk to loose your work if the container is accidentially destroyed.
+* Easy access to hardware accellerated graphics when running on the local desktop. This is only relevant for the event display though.
+* No need for podman or docker.
+
+## Requirements
+You will need to have:
+
+* /cvmfs/delphi.cern.ch mounted. Documentation can be found at https://cvmfs.readthedocs.io/en/stable/
+* /eos/opendata/delphi mounted. More information about EOS can be found at https://github.com/cern-eos/eos
+* A list of additional packages installed, see https://gitlab.cern.ch/delphi/deployment for more information:
+    * general: tcsh xfonts-100dpi xfonts-75dpi libxfont2
+    * compilers: cmake gcc g++ gfortran
+    * library packages: libx11 libglu1-mesa xutils libmotif r-base xutils libxbae libxaw7 libssl libglew libdlm
+
+Please check the instructions at https://cvmfs.readthedocs.io/en/stable/cpt-quickstart.html and https://eoscta.docs.cern.ch/install/eos/ and https://eos-web.web.cern.ch/eos-web.
+
+## Initialising the environment
+For C-Shell (csh, tcsh ), do
+
+```
+ source /cvmfs/delphi.cern.ch/setup.csh
+```
+
+For Bourne shell (sh, bash, zsh, ...), type
+```
+. /cvmfs/delphi.cern.ch/setup.sh
+```
+If using the container, please use `/etc/profile.d/delphi.sh` or `/etc/profile.d/delphi.csh` instead.
+
+After sourcing the environment, make sure that the environment variable **DELPHI_DATA_ROOT** points to the tip of the data area. This is specifically important if you copied the
+data sets you want to use locally. It should point to `/eos/opendata/delphi`.
+
+