psdi-data-conversion 0.1.6__py3-none-any.whl → 0.2.0__py3-none-any.whl

psdi_data_conversion/main.py

@@ -18,13 +18,12 @@ from psdi_data_conversion import constants as const
 from psdi_data_conversion.constants import CL_SCRIPT_NAME, CONVERTER_DEFAULT, TERM_WIDTH
 from psdi_data_conversion.converter import (D_CONVERTER_ARGS, L_REGISTERED_CONVERTERS, L_SUPPORTED_CONVERTERS,
                                             converter_is_registered, converter_is_supported,
-                                            get_registered_converter_class, get_supported_converter_class,
-                                            run_converter)
+                                            get_supported_converter_class, run_converter)
 from psdi_data_conversion.converters.base import (FileConverterAbortException, FileConverterException,
                                                   FileConverterInputException)
-from psdi_data_conversion.database import (FormatInfo, get_conversion_quality, get_converter_info, get_format_info,
-                                           get_in_format_args, get_out_format_args, get_possible_conversions,
-                                           get_possible_formats)
+from psdi_data_conversion.database import (FormatInfo, get_conversion_pathway, get_conversion_quality,
+                                           get_converter_info, get_format_info, get_in_format_args,
+                                           get_out_format_args, get_possible_conversions, get_possible_formats)
 from psdi_data_conversion.file_io import split_archive_ext
 from psdi_data_conversion.log_utility import get_log_level_from_str
 from psdi_data_conversion.utils import regularize_name
@@ -554,9 +553,29 @@ def detail_format(format_name: str):
                    "necessary to explicitly specify which you want to use when calling this script, e.g. with "
                    f"'-f {format_name}-0' - see the disambiguated names in the list below:", newline=True)
 
+    first = True
     for format_info in l_format_info:
+
+        # Add linebreak before each after the first
+        if first:
+            first = False
+        else:
+            print()
+
+        # Print the format's basic details
         print_wrap(f"{format_info.id}: {format_info.disambiguated_name} ({format_info.note})")
 
+        # Print whether or not it supports each possible property
+        for attr, label in FormatInfo.D_PROPERTY_ATTRS.items():
+            support_str = label
+            if getattr(format_info, attr):
+                support_str += " supported"
+            elif getattr(format_info, attr) is False:
+                support_str += " not supported"
+            else:
+                support_str += " unknown whether or not to be supported"
+            print_wrap(f"- {support_str}")
+
 
 def detail_formats_and_possible_converters(from_format: str, to_format: str):
     """Prints details on converters that can perform a conversion from one format to another
@@ -589,6 +608,44 @@ def detail_formats_and_possible_converters(from_format: str, to_format: str):
 
     l_possible_conversions = get_possible_conversions(from_format, to_format)
 
+    # Check if no direct conversions are possible, and if formats are specified uniquely, recommend a chained conversion
+    if len(l_possible_conversions) == 0:
+        print()
+        print_wrap(f"No direct conversions are possible from {from_format} to {to_format}")
+        print()
+
+        l_from_formats = get_format_info(from_format, which="all")
+        l_to_formats = get_format_info(to_format, which="all")
+
+        if len(l_from_formats) == 1 and len(l_to_formats) == 1:
+
+            for only in "registered", "supported", "all":
+                pathway = get_conversion_pathway(l_from_formats[0], l_to_formats[0], only=only)
+                if pathway is None:
+                    continue
+
+                if only == "registered" or only == "supported":
+                    converter_type_needed = only
+                else:
+                    converter_type_needed = "unsupported"
+                print_wrap(f"A chained conversion is possible from {from_format} to {to_format} using "
+                           f"{converter_type_needed} converters:")
+
+                for i, step in enumerate(pathway):
+                    print_wrap(f"{i+1}) Convert from {step[1].name} to {step[2].name} with {step[0].pretty_name}")
+
+                print()
+                print_wrap("Chained conversion is not yet supported by this utility, but will be added soon")
+
+                break
+
+            else:
+                print_wrap(f"No chained conversions are possible from {from_format} to {to_format}.")
+
+        else:
+            print_wrap("To see possible chained conversions, specify each format uniquely using the ID or "
+                       "disambiguated name (e.g. \"xxx-0\") listed above)")
+
     # Get a list of all different formats which share the provided name, cutting out duplicates
     l_from_formats = list(set([x[1] for x in l_possible_conversions]))
     l_from_formats.sort(key=lambda x: x.disambiguated_name)
@@ -598,6 +655,7 @@ def detail_formats_and_possible_converters(from_format: str, to_format: str):
     # Loop over all possible combinations of formats
 
     for possible_from_format, possible_to_format in product(l_from_formats, l_to_formats):
+        print()
 
         from_name = possible_from_format.disambiguated_name
         to_name = possible_to_format.disambiguated_name
@@ -605,14 +663,13 @@ def detail_formats_and_possible_converters(from_format: str, to_format: str):
         l_conversions_matching_formats = [x for x in l_possible_conversions
                                           if x[1] == possible_from_format and x[2] == possible_to_format]
 
-        l_possible_registered_converters = [get_registered_converter_class(x[0]).name
+        l_possible_registered_converters = [x[0].pretty_name
                                             for x in l_conversions_matching_formats
-                                            if x[0] in L_REGISTERED_CONVERTERS]
-        l_possible_unregistered_converters = [get_supported_converter_class(x[0]).name
+                                            if x[0].name in L_REGISTERED_CONVERTERS]
+        l_possible_unregistered_converters = [x[0].pretty_name
                                               for x in l_conversions_matching_formats
-                                              if x[0] in L_SUPPORTED_CONVERTERS and x[0] not in L_REGISTERED_CONVERTERS]
-
-        print()
+                                              if x[0].name in L_SUPPORTED_CONVERTERS
+                                              and x[0].name not in L_REGISTERED_CONVERTERS]
 
         if len(l_possible_registered_converters)+len(l_possible_unregistered_converters) == 0:
             print_wrap(f"No converters are available which can perform a conversion from {from_name} to "
@@ -769,8 +826,8 @@ def run_from_args(args: ConvertArgs):
                                               name=args.name,
                                               data=data,
                                               use_envvars=False,
-                                              upload_dir=args.input_dir,
-                                              download_dir=args.output_dir,
+                                              input_dir=args.input_dir,
+                                              output_dir=args.output_dir,
                                               no_check=args.no_check,
                                               strict=args.strict,
                                               log_file=args.log_file,

psdi_data_conversion/static/content/convert.htm

@@ -49,87 +49,118 @@
       </a>
       <br>
       <br>
-      <p>Zero to two option flag select boxes and zero to two sets of option flag check boxes may be displayed,
-        depending on the conversion and the degree of completion of the database. Further information may be displayed
-        underneath the select boxes if available. One or more input or output flags may be selected if required (command
-        click [Mac] or control click [Windows] for multiple select box selections). To undo all selections in a box,
-        click just underneath the final option. Ticking a check box reveals a text box for entry of required
-        information, along with further explanation if available.
-      </p>
-      <h6 id="heading"></h6>
-      <div id="flags">
-        <div id="inFlagList">
+      <h5 id="heading"></h5>
+      <div class="flex-panel-display">
+        <div class="flex-panel instructions-panel">
+          <h6>Select flags and options for the file formats</h6>
           <p>
-            <label for="inFlags" id="in_label">Read (input) option flags
-              (hold CTRL to select multiple, or CTRL+click a selected option to unselect):</label>
-          <div id="in_flag_break"></div>
-          <select id="inFlags" class="large-width" size="4" multiple="multiple"></select>
-          <div id=inFlagInfo></div>
+            One or more input or output flags may be selected if required (command click [Mac] or control click
+            [Windows] for multiple select box selections). To undo all selections in a box, click just underneath the
+            final option. Ticking a check box reveals a text box for entry of required information, along with further
+            explanation if available.
+          </p>
+          <p>Zero to two option flag select boxes and zero to two sets of option flag check boxes may be displayed,
+            depending on the conversion and the degree of completion of the database. Further information may be
+            displayed underneath the select boxes if available.
+          </p>
+        </div>
+        <hr class="small-screen-only">
+        <div class="flex-panel">
+          <div id="flags">
+            <div id="inFlagList">
+              <p>
+                <label for="inFlags" id="in_label">Read (input) option flags
+                  (hold CTRL to select multiple, or CTRL+click a selected option to unselect):</label>
+                <select id="inFlags" class="large-width" size="4" multiple="multiple"></select>
+              <div id=inFlagInfo></div>
+              </p>
+            </div>
+            <div id="outFlagList">
+              <p>
+                <label for="outFlags" id="out_label">Write (output) option flags
+                  (hold CTRL to select multiple, or CTRL+click a selected option to unselect):</label>
+                <select id="outFlags" class="large-width" size="4" multiple="multiple"></select>
+              <div id=outFlagInfo></div>
+              </p>
+            </div>
+          </div>
+          <span id="in_argLabel">Read (input) option flags requiring further information (select all required):</span>
+          <table id="in_argFlags"></table>
+          <div id="flag_break"><br /></div>
+          <span id="out_argLabel">Write (output) option flags requiring further information (select all
+            required):</span>
+          <table id="out_argFlags"></table>
+        </div>
+      </div>
+      <div class="flex-panel-display">
+        <div class="flex-panel instructions-panel">
+          <h6>Select coordinate generation mode</h6>
+          <p>If 2- or 3-dimensional atomic coordinates need to be calculated (e.g., if they do not already exist in the
+            input file), select “2D” or “3D” and a speed/accuracy option (“fastest” is least accurate). Note that this
+            calculation is not appropriate for all file formats, so in these cases selections will be ignored.
+          </p>
+        </div>
+        <hr class="small-screen-only">
+        <div class="flex-panel">
+          <p>
+            <label for="coordinates">Select “2D” or “3D” if an Open Babel calculation of 2- or 3-dimensional atomic
+              coordinates is required. Ensure that this calculation is suitable for your purpose.<br>For more
+              information,
+              visit <a href="https://openbabel.org/docs/3DStructureGen/SingleConformer.html#gen3d" target="_blank">this
+                website.</a></label><br>
+            <input type="radio" name="coordinates" id="coordinates" value="Gen2D"> 2D
+            <input type="radio" name="coordinates" id="coordinates" value="Gen3D"> 3D
+            <input type="radio" name="coordinates" id="coordinates" value="neither" checked="checked">
+            neither
+          </p>
+          <p>
+            <label for="coordOptions"> Calculation options range from 'fastest'
+              (least accurate) to “best” (slowest).</label><br>
+            <input type="radio" name="coordOptions" id="coordOptions" value="fastest" disabled=true> fastest
+            <input type="radio" name="coordOptions" id="coordOptions" value="fast" disabled=true> fast
+            <input type="radio" name="coordOptions" id="coordOptions" value="medium" checked="checked" disabled=true>
+            medium
+            <input type="radio" name="coordOptions" id="coordOptions" value="better" disabled=true> better
+            <input type="radio" name="coordOptions" id="coordOptions" value="best" disabled=true> best
           </p>
         </div>
-        <div id="outFlagList">
+      </div>
+      <div class="flex-panel-display">
+        <div class="flex-panel instructions-panel">
+          <h6>Upload the file and run the conversion</h6>
+          <p>Click on “Choose file” and then select an input file of the correct format (and extension). Clicking on
+            “Convert” uploads and converts the file. The output file is automatically downloaded, along with a log file.
+          </p>
           <p>
-            <label for="outFlags" id="out_label">Write (output) option flags
-              (hold CTRL to select multiple, or CTRL+click a selected option to unselect):</label>
-          <div id="out_flag_break"></div>
-          <select id="outFlags" class="large-width" size="4" multiple="multiple"></select>
-          <div id=outFlagInfo></div>
+            If any issues are encountered (e.g., the output file does not download), please click on “Provide Feedback”
+            in the navigation bar.
+          </p>
+        </div>
+        <hr class="small-screen-only">
+        <div class="flex-panel">
+          <p id="convertFile">
+            <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and
+            files
+            contained in archives) all have the correct extension<br>
+            <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
+            Select file to convert<span class="max-file-size"></span>:
+            <br>
+            <input type="file" name="fileToUpload" id="fileToUpload">
+            <input type="button" class="button no-left-margin" value=" Clear Uploaded File " name="clearUpload"
+              id="clearUpload">
+            <br>
+            If you have sensitive data you might prefer to use
+            <a href="download.htm">one of our downloadable tools or Python library</a> rather than uploading your data
+            to
+            our service.<br>
+            <span class="convert-button-and-spinner">
+              <input type="button" class="button init-disabled no-left-margin" value=" Convert " name="uploadButton"
+                id="uploadButton" disabled=true>
+              <span class="loading-spinner spinner-border"></span>
+            </span>
           </p>
         </div>
       </div>
-      <span id="in_argLabel">Read (input) option flags requiring further information (select all required):</span>
-      <table id="in_argFlags"></table>
-      <div id="flag_break"><br /></div>
-      <span id="out_argLabel">Write (output) option flags requiring further information (select all required):</span>
-      <table id="out_argFlags"></table>
-      <p>If 2- or 3-dimensional atomic coordinates need to be calculated (e.g., if they do not already exist in the
-        input file), select '2D' or '3D' and a speed/accuracy option ('fastest' is least accurate).
-        Note that this calculation is not appropriate for all file formats, so in these cases selections will be
-        ignored.
-        Click on 'Choose file' and then select an input file of the correct format (and extension). Clicking on
-        'Convert'
-        uploads and converts the file. The output file is automatically downloaded, along with a log file. If any issues
-        are encountered (e.g., the output file does not download), please click on 'Provide Feedback' in the navigation
-        bar.
-      </p>
-      <p>
-        <label for="coordinates">Select '2D' or '3D' if an Open Babel calculation of 2- or 3-dimensional atomic
-          coordinates is required. Ensure that this calculation is suitable for your purpose.<br>For more information,
-          visit <a href="https://openbabel.org/docs/3DStructureGen/SingleConformer.html#gen3d" target="_blank">this
-            website.</a></label><br>
-        <input type="radio" name="coordinates" id="coordinates" value="Gen2D"> 2D
-        <input type="radio" name="coordinates" id="coordinates" value="Gen3D"> 3D
-        <input type="radio" name="coordinates" id="coordinates" value="neither" checked="checked">
-        neither
-      </p>
-      <p>
-        <label for="coordOptions"> Calculation options range from 'fastest'
-          (least accurate) to 'best' (slowest).</label><br>
-        <input type="radio" name="coordOptions" id="coordOptions" value="fastest" disabled=true> fastest
-        <input type="radio" name="coordOptions" id="coordOptions" value="fast" disabled=true> fast
-        <input type="radio" name="coordOptions" id="coordOptions" value="medium" checked="checked" disabled=true> medium
-        <input type="radio" name="coordOptions" id="coordOptions" value="better" disabled=true> better
-        <input type="radio" name="coordOptions" id="coordOptions" value="best" disabled=true> best
-      </p>
-      <p id="convertFile">
-        <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and files
-        contained in archives) all have the correct extension<br>
-        <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
-        Select file to convert<span class="max-file-size"></span>:
-        <br>
-        <input type="file" name="fileToUpload" id="fileToUpload">
-        <input type="button" class="button" value=" Clear Uploaded File " name="clearUpload" id="clearUpload">
-        <br>
-        If you have sensitive data you might prefer to use
-        <a href="download.htm">one of our downloadable tools or Python library</a> rather than uploading your data to
-        our service.<br>
-        <span class="convert-button-and-spinner">
-          <input type="button" class="button init-disabled" value=" Convert " name="uploadButton" id="uploadButton"
-            disabled=true>
-          <span class="loading-spinner spinner-border"></span>
-        </span>
-      </p>
-      <div class="medGap"></div>
     </div>
   </form>
 

psdi_data_conversion/static/content/convertato.htm

@@ -50,33 +50,43 @@
         </a>
         <br>
         <br>
-        <p>
-          Click on 'Choose file' and then select an input file of the correct format (and extension). Clicking on
-          'Convert' uploads and converts the file. The output file is automatically downloaded, along with a log file.
-          If any issues are encountered (e.g., the output file does not download), please click on 'Provide Feedback' in
-          the navigation bar.
-        </p>
-        <h6 id="heading"></h6>
-        <p id="convertFile">
-          <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and files
-          contained in archives) all have the correct extension<br>
-          <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
-          Select file to convert<span class="max-file-size"></span>:
-          <br>
-          <input type="file" name="fileToUpload" id="fileToUpload">
-          <input type="button" class="button" value=" Clear Uploaded File " name="clearUpload" id="clearUpload">
-          <br>
-          If you have sensitive data you might prefer to use
-          <a href="download.htm">one of our downloadable tools or Python library</a> rather than uploading your data to
-          our service.<br>
-          <span class="convert-button-and-spinner">
-            <input type="button" class="button init-disabled" value=" Convert " name="uploadButton" id="uploadButton"
-              disabled=true>
-            <span class="loading-spinner spinner-border"></span>
-          </span>
-        </p>
+        <h5 id="heading"></h5>
+        <div class="flex-panel-display">
+          <div class="flex-panel instructions-panel">
+            <h6>Upload the file and run the conversion</h6>
+            <p>Click on “Choose file” and then select an input file of the correct format (and extension). Clicking on
+              “Convert” uploads and converts the file. The output file is automatically downloaded, along with a log
+              file.
+            </p>
+            <p>
+              If any issues are encountered (e.g., the output file does not download), please click on “Provide
+              Feedback”
+              in the navigation bar.
+            </p>
+          </div>
+          <hr class="small-screen-only">
+          <div class="flex-panel">
+            <p id="convertFile">
+              <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and
+              files contained in archives) all have the correct extension<br>
+              <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
+              Select file to convert<span class="max-file-size"></span>:
+              <br>
+              <input type="file" name="fileToUpload" id="fileToUpload">
+              <input type="button" class="button no-left-margin" value=" Clear Uploaded File " name="clearUpload"
+                id="clearUpload">
+              <br>
+              If you have sensitive data you might prefer to use <a href="download.htm">one of our downloadable tools or
+                Python library</a> rather than uploading your data to our service.<br>
+              <span class="convert-button-and-spinner">
+                <input type="button" class="button init-disabled no-left-margin" value=" Convert " name="uploadButton"
+                  id="uploadButton" disabled=true>
+                <span class="loading-spinner spinner-border"></span>
+              </span>
+            </p>
+          </div>
+        </div>
       </div>
-      <div class="largeGap"></div>
     </div>
   </form>
 

psdi_data_conversion/static/content/convertc2x.htm

@@ -51,33 +51,46 @@
         </a>
         <br>
         <br>
-        <p>
-          Click on 'Choose file' and then select an input file of the correct format (and extension). Clicking on
-          'Convert' uploads and converts the file. The output file is automatically downloaded, along with a log file.
-          If any issues are encountered (e.g., the output file does not download), please click on 'Provide Feedback' in
-          the navigation bar.
-        </p>
-        <h6 id="heading"></h6>
-        <p id="convertFile">
-          <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and files
-          contained in archives) all have the correct extension<br>
-          <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
-          Select file to convert<span class="max-file-size"></span>:
-          <br>
-          <input type="file" name="fileToUpload" id="fileToUpload">
-          <input type="button" class="button" value=" Clear Uploaded File " name="clearUpload" id="clearUpload">
-          <br>
-          If you have sensitive data you might prefer to use
-          <a href="download.htm">one of our downloadable tools or Python library</a> rather than uploading your data to
-          our service.<br>
-          <span class="convert-button-and-spinner">
-            <input type="button" class="button init-disabled" value=" Convert " name="uploadButton" id="uploadButton"
-              disabled=true>
-            <span class="loading-spinner spinner-border"></span>
-          </span>
-        </p>
+        <h5 id="heading"></h5>
+        <div class="flex-panel-display">
+          <div class="flex-panel instructions-panel">
+            <h6>Upload the file and run the conversion</h6>
+            <p>Click on “Choose file” and then select an input file of the correct format (and extension). Clicking on
+              “Convert” uploads and converts the file. The output file is automatically downloaded, along with a log
+              file.
+            </p>
+            <p>
+              If any issues are encountered (e.g., the output file does not download), please click on “Provide
+              Feedback”
+              in the navigation bar.
+            </p>
+          </div>
+          <hr class="small-screen-only">
+          <div class="flex-panel">
+            <p id="convertFile">
+              <input type="checkbox" checked id="extCheck"> Enforce file naming checking to ensure uploaded files (and
+              files
+              contained in archives) all have the correct extension<br>
+              <input type="checkbox" id="requestLog"> Also download log file for the conversion<br>
+              Select file to convert<span class="max-file-size"></span>:
+              <br>
+              <input type="file" name="fileToUpload" id="fileToUpload">
+              <input type="button" class="button no-left-margin" value=" Clear Uploaded File " name="clearUpload"
+                id="clearUpload">
+              <br>
+              If you have sensitive data you might prefer to use
+              <a href="download.htm">one of our downloadable tools or Python library</a> rather than uploading your data
+              to
+              our service.<br>
+              <span class="convert-button-and-spinner">
+                <input type="button" class="button init-disabled no-left-margin" value=" Convert " name="uploadButton"
+                  id="uploadButton" disabled=true>
+                <span class="loading-spinner spinner-border"></span>
+              </span>
+            </p>
+          </div>
+        </div>
       </div>
-      <div class="largeGap"></div>
     </div>
   </form>
 

psdi_data_conversion/static/content/download.htm

@@ -52,7 +52,7 @@
       </ul>
 
       <p>
-        The easiest way to install the project is via Python's pip utility. If you do not already have this installed,
+        The easiest way to install the project is via Python’s pip utility. If you do not already have this installed,
         the readme in the link above provides details on installing Python and pip. If you do, you can install the
         package via:
       </p>
@@ -71,14 +71,14 @@
         <li><a href="https://github.com/PSDI-UK/psdi-data-conversion">PSDI Data Conversion Project on GitHub</a></li>
       </ul>
 
-      The project's source code is available on GitHub at the link above. If you wish to install it from source, you
+      The project’s source code is available on GitHub at the link above. If you wish to install it from source, you
       can clone the repository, and then install it via:
 
       <pre><code class="secondary">pip install .[gui-test]</code></pre>
 
       <p>
         The <code class="secondary">[gui-test]</code> portion installs all optional components for running the local
-        webpage and testing all project components. See the project's <code class="secondary">pyproject.toml</code> file
+        webpage and testing all project components. See the project’s <code class="secondary">pyproject.toml</code> file
         for other possible optional dependencies sets that can be installed.
       </p>
 
@@ -95,12 +95,12 @@
         </li>
         <li><strong>Command-Line Application:</strong> Run the script <code class="secondary">psdi-data-convert</code>
           to use the application at the command-line. Append the <code class="secondary">--help</code> option to see
-          arguments for it, and/or find documentation in the project's README.
+          arguments for it, and/or find documentation in the project’s README.
         </li>
         <li><strong>Python Library:</strong> Within a Python script, library, or terminal, the project can be imported
           via <code class="secondary">import psdi_data_conversion</code>, with the most useful function being <code
             class="secondary">psdi_data_conversion.converter.run_converter</code> - see the <code
-            class="secondary">help()</code> of this function and/or find documentation in the project's README.
+            class="secondary">help()</code> of this function and/or find documentation in the project’s README.
         </li>
       </ul>
 

psdi_data_conversion/static/content/feedback.htm

@@ -37,8 +37,8 @@
 
   <form name="gui">
     <div class="max-width-box">
-      <p>To report issues other than missing formats or conversions, please click on the 'Feedback
-        form' link below. The form will open in a new tab.</p>
+      <p>To report issues other than missing formats or conversions, please click on the “Feedback form” link below. The
+        form will open in a new tab.</p>
       <a href="https://forms.office.com/Pages/ResponsePage.aspx?id=-XhTSvQpPk2-iWadA62p2Fa27wFj_AtEgNrXLTdVtPVUQzhCODEyWTRXNlFEVDg5WklURlY2MExLWiQlQCN0PWcu"
         target="_blank">
         Feedback form

psdi_data_conversion/static/content/header-links.html

@@ -1,9 +1,9 @@
 <!-- This file contains the links that will appear in the top-right of the header bar for .html files in this
  directory. -->
 <a href="../../" class="navbar__item navbar__link">Home</a>
-<a href="report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a>
+<a href="../../report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a>
 <a href="feedback.htm" class="navbar__item navbar__link">Provide Feedback</a>
-<a href="documentation.htm" class="navbar__item navbar__link">Documentation</a>
+<a href="../../documentation.htm" class="navbar__item navbar__link">Documentation</a>
 <a href="download.htm" class="navbar__item navbar__link service-only">Download</a>
-<a href="accessibility.htm" class="navbar__item navbar__link">Accessibility</a>
+<a href="../../accessibility.htm" class="navbar__item navbar__link">Accessibility</a>
 <a href="mailto:support@psdi.ac.uk" class="navbar__item navbar__link" id="mail">Contact Us</a>

psdi_data_conversion/static/content/index-versions/header-links.html

@@ -1,9 +1,9 @@
 <!-- This file contains the links that will appear in the top-right of the header bar for .html files in the
  index.htm page. -->
 <a href="./" class="navbar__item navbar__link">Home</a>
-<a href="static/content/report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a>
+<a href="./report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a>
 <a href="static/content/feedback.htm" class="navbar__item navbar__link">Provide Feedback</a>
-<a href="static/content/documentation.htm" class="navbar__item navbar__link">Documentation</a>
+<a href="./documentation.htm" class="navbar__item navbar__link">Documentation</a>
 <a href="static/content/download.htm" class="navbar__item navbar__link service-only">Download</a>
-<a href="static/content/accessibility.htm" class="navbar__item navbar__link">Accessibility</a>
+<a href="./accessibility.htm" class="navbar__item navbar__link">Accessibility</a>
 <a href="mailto: psdi@soton.ac.uk" class="navbar__item navbar__link" id="mail">Contact</a>

psdi_data_conversion/static/content/index-versions/psdi-common-header.html

@@ -16,7 +16,7 @@
     </div>
   </div>
   <div class="navbar__items navbar__items--right">
-    <!-- This file contains the links that will appear in the top-right of the header bar for .html files in the index.htm page. --> <a href="./" class="navbar__item navbar__link">Home</a> <a href="static/content/report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a> <a href="static/content/feedback.htm" class="navbar__item navbar__link">Provide Feedback</a> <a href="static/content/documentation.htm" class="navbar__item navbar__link">Documentation</a> <a href="static/content/download.htm" class="navbar__item navbar__link service-only">Download</a> <a href="static/content/accessibility.htm" class="navbar__item navbar__link">Accessibility</a> <a href="mailto: psdi@soton.ac.uk" class="navbar__item navbar__link" id="mail">Contact</a>
+    <!-- This file contains the links that will appear in the top-right of the header bar for .html files in the index.htm page. --> <a href="./" class="navbar__item navbar__link">Home</a> <a href="./report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a> <a href="static/content/feedback.htm" class="navbar__item navbar__link">Provide Feedback</a> <a href="./documentation.htm" class="navbar__item navbar__link">Documentation</a> <a href="static/content/download.htm" class="navbar__item navbar__link service-only">Download</a> <a href="./accessibility.htm" class="navbar__item navbar__link">Accessibility</a> <a href="mailto: psdi@soton.ac.uk" class="navbar__item navbar__link" id="mail">Contact</a>
     <button class="clean-btn color-mode-toggle" title="Switch between dark and light mode"
       aria-label="Lightmode/darkmode toggle button">
       <img src="static/img/colormode-toggle-lm.svg" alt="Lightmode toggle icon"

psdi_data_conversion/static/content/psdi-common-header.html

@@ -16,7 +16,7 @@
     </div>
   </div>
   <div class="navbar__items navbar__items--right">
-    <!-- This file contains the links that will appear in the top-right of the header bar for .html files in this directory. --> <a href="../../" class="navbar__item navbar__link">Home</a> <a href="report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a> <a href="feedback.htm" class="navbar__item navbar__link">Provide Feedback</a> <a href="documentation.htm" class="navbar__item navbar__link">Documentation</a> <a href="download.htm" class="navbar__item navbar__link service-only">Download</a> <a href="accessibility.htm" class="navbar__item navbar__link">Accessibility</a> <a href="mailto:support@psdi.ac.uk" class="navbar__item navbar__link" id="mail">Contact Us</a>
+    <!-- This file contains the links that will appear in the top-right of the header bar for .html files in this directory. --> <a href="../../" class="navbar__item navbar__link">Home</a> <a href="../../report.htm" class="navbar__item navbar__link">Report Missing Format/Conversion</a> <a href="feedback.htm" class="navbar__item navbar__link">Provide Feedback</a> <a href="../../documentation.htm" class="navbar__item navbar__link">Documentation</a> <a href="download.htm" class="navbar__item navbar__link service-only">Download</a> <a href="../../accessibility.htm" class="navbar__item navbar__link">Accessibility</a> <a href="mailto:support@psdi.ac.uk" class="navbar__item navbar__link" id="mail">Contact Us</a>
     <button class="clean-btn color-mode-toggle" title="Switch between dark and light mode"
       aria-label="Lightmode/darkmode toggle button">
       <img src="../img/colormode-toggle-lm.svg" alt="Lightmode toggle icon"