Fix: Break line properly into latex when next line starts with `_`

Description

After this MR the slurm profile name was changed from 'slurm_prof_t230419_133346.736582_0' to 'slurm_prof_230419_133346.736582_0' this lead to a pdflatex error while creating the reports for DSSC dark and correct.

After the MR suggestions, the tex_escape and split_len have been swapped around while converting the parameter values.

How Has This Been Tested?

This was tested with DSSC dark and correct reference runs.

Relevant Documents (optional)

Types of changes

• Bug fix (non-breaking change which fixes an issue)

Checklist:

• My code follows the code style of this project.
• I have updated the documentation accordingly.

Reviewers

@kluyvert @schmidtp

src/xfel_calibrate/calibrate.py

@@ -493,10 +493,30 @@ def make_par_table(parms):
     # Add space in long strings without line breakers ` ,-/` to
     # wrap them in latex
     def split_len(seq, length):
+        """
+        Splits a sequence into smaller segments of a specified length,
+        concatenates them, and adds line-breaking characters
+        to ensure proper line breaks in LaTeX.
+
+        Args:
+            seq (str): The sequence to be split.
+            length (int): The desired length of each segment.
+
+        Returns:
+            str: The concatenated line with line-breaking characters.
+
+        Examples:
+            >>> split_len("slurm_prof_230711_095647.832671_0", 10)
+            'slurm\_prof\_230711\\-\_095647.832671\_0\-'
+        """
         lbc = set(' ,-/')
         line = ''
         for i in range(0, len(seq), length):
             sub_line = seq[i:i + length]
+            # Ensure proper line break if the
+            # start of the new line begins with `_`
+            if sub_line[0] == '_' and line[-1] == "-":
+                line += '\\'
             line += sub_line.replace('/', '/\-')
             if not any(c in lbc for c in sub_line):
                 line += '\-'