Scripts moved and linked in documentation

Closes #45

See merge request !171

doc/changelog.rst

@@ -5,7 +5,9 @@ unreleased
 ----------
 
 - **Bug fixes**
-  
+
+    - fix :issue:`45` SLURM scripts embedded in and download link available from documentation :mr:`171`
+ 
 - **Improvements**
 
     - reorganize the Howto section :mr:`169`

doc/howtos.rst

@@ -41,7 +41,14 @@ which will be repeated. XGM data will also be binned similarly to the DSSC
 data.
 
 Since this data reduction step can be quite time consuming for large datasets,
-it is recommended to launch the notebook via a SLURM script:
+it is recommended to launch the notebook via a SLURM script. The script can be
+downloaded from :download:`scripts/bin_dssc_module_job.sh` and reads as:
+
+.. literalinclude:: scripts/bin_dssc_module_job.sh
+   :language: bash
+   :linenos:
+
+It is launched with the following:
 
 .. code:: bash
     
@@ -101,8 +108,14 @@ non-linearity calculation by taking the JSON file as soon as it appears.
 The determination of the non-linearity correction is a lot longer and can take
 some 2 to 8 hours depending on the number of pulses in the
 train. For this reason it is possible to use a script
-``scripts/boz_parameters_job.sh`` in the toolbox to launch the first notebook
-via slurm:
+that can be downloaded from :download:`scripts/boz_parameters_job.sh` and
+reads as:
+
+.. literalinclude:: scripts/boz_parameters_job.sh
+   :language: bash
+   :linenos:
+
+It uses the first notebook and is launched via slurm:
 
 ``sbatch ./boz_parameters_job.sh 615 614 3``