<commit_before>Typesetter Guide
================
When a typesetting task is assigned you will receive an email notification and also be able to see the task on your dashboard under _Production_.

.. figure:: nstatic/production_block.png

    Production block

Clicking on view requests will display three columns

- Awaiting Decision
    - New Assignments.
- In Progress
    - Assignments you have accepted but no completed.
- Completed
    - Assignments you have completed.

.. figure:: nstatic/typesetting_requests.png

    Typesetting requests

Typesetting a Paper
-------------------
Once you have accepted a request you can then use the view button to display the typesetter interface. This allows typesetters to pull files and view the metadata of the paper so they can produce Galley proofs. The interface is broken in 4 sections.

- Files uploaded for production
    - Lists the files that are to be used in generating the galley proofs.
- Current Galleys
    - Lists any galley proofs that already exist.
- Source Files
    - This is an area for you to upload any intermediate source files (indesign etc).
- Notes
    - Displays the request from the editor and a link to view the article's metadata.

.. figure:: nstatic/typeset_article.png

    Typesetter interface

Uploading a Galley
------------------
You can use the Upload a new galley button to upload a new file. There are three upload options.

- XML/HTML
- PDF
- Other (for any other file types)

Janeway processes each differently (or in the case of Other, not at all) so ensure you select the correct upload box.

.. warning::
    Janeway operates with the UTF8 encoding, so you should ensure your plain text galleys (HTML and XML) use this encoding.

Missing Supplements
^^^^^^^^^^^^^^^^^^^
When you upload an XML or HTML galley Janeway will scan it for images and warn you if there you need to upload those images. You can do this by editing the galley file.

.. figure:: nstatic/galleys.png

    Article with galleys, XML galley has two missing images

In the Edit Galley screen you can upload individual image files, select from exising figure files or upload a zip file of images.

.. tip::
    If you have lots of images ensure they have the correct name (eg, whatever they are called in the XML/HTML file) and zip them. You can use the zip uploaded to upload them in one go.

Managing Galleys
----------------
In addition to uploading images alongside galley files you can also:

- Replace the galley if you've made changes to the original file.
- Upload a CSS file to go along with the galley.
- Change the XSLT file used to render the galley.
- View the galley's history or delete it.

Completing Typesetting
----------------------
Once you have uploaded the required galleys and their files you will notice a new Note to Editor box has appeared in the Notes section, you can use this to complete your task.

Once you have marked it as complete the card will move into the Completed column.<commit_msg>[Docs] Typesetting Guide for typesetters<commit_after>Typesetter Guide
================
When a typesetting task is assigned you will receive an email notification and also be able to see the task on your dashboard under _Production_.

.. figure:: nstatic/production_block.png

    Production block

Clicking on view requests will display three columns

- Awaiting Decision
    - New Assignments.
- In Progress
    - Assignments you have accepted but no completed.
- Completed
    - Assignments you have completed.

.. figure:: nstatic/typesetting_requests.png

    Typesetting requests

Typesetting a Paper
-------------------
Once you have accepted a request you can then use the view button to display the typesetter interface. This allows typesetters to pull files and view the metadata of the paper so they can produce Galley proofs. The interface is broken in 4 sections.

- Files uploaded for production
    - Lists the files that are to be used in generating the galley proofs.
- Current Galleys
    - Lists any galley proofs that already exist.
- Source Files
    - This is an area for you to upload any intermediate source files (indesign etc).
- Notes
    - Displays the request from the editor and a link to view the article's metadata.

.. figure:: nstatic/typeset_article.png

    Typesetter interface

Uploading a Galley
------------------
You can use the Upload a new galley button to upload a new file. There are three upload options.

- XML/HTML
- PDF
- Other (for any other file types)

Janeway processes each differently (or in the case of Other, not at all) so ensure you select the correct upload box.

.. warning::
    Janeway operates with the UTF8 encoding, so you should ensure your plain text galleys (HTML and XML) use this encoding.

Missing Supplements
^^^^^^^^^^^^^^^^^^^
When you upload an XML or HTML galley Janeway will scan it for images and warn you if there you need to upload those images. You can do this by editing the galley file.

.. figure:: nstatic/galleys.png

    Article with galleys, XML galley has two missing images

In the Edit Galley screen you can upload individual image files, select from exising figure files or upload a zip file of images.

.. tip::
    If you have lots of images ensure they have the correct name (eg, whatever they are called in the XML/HTML file) and zip them. You can use the zip uploaded to upload them in one go.

Managing Galleys
----------------
In addition to uploading images alongside galley files you can also:

- Replace the galley if you've made changes to the original file.
- Upload a CSS file to go along with the galley.
- Change the XSLT file used to render the galley.
- View the galley's history or delete it.

Completing Typesetting
----------------------
Once you have uploaded the required galleys and their files you will notice a new Note to Editor box has appeared in the Notes section, you can use this to complete your task.

Once you have marked it as complete the card will move into the Completed column.

Typesetting Plugin (New!)
-------------------------
The Typesetting plugin is the new workflow used in Janeway for typesetting.
It is currently deployed as a plugin but we intend to replace the above process with this new system in the near future.

With this new plugin, we aim to simplify the process of working on corrections for the typesetter with a brand new interface that is used both when uploading the initial typesetting files as well as when working on corrections. The summary of improvements includes:

- Unified interface for all typesetting tasks
- Better and more complete display of the article metadata
- Error detection warnings: Incomplete corrections, missing figure files, missing metadata...
- Full display of the proofreading comments and corrections requested
- Single input form for uploading galley files

On your dashboard, there should be a card indicating the number of typesetting tasks that are currently awaiting for you to complete:

.. figure:: nstatic/typesetting/typesettingcard.png

When uploading a new Galley (now referred to as 'Typeset Files'), there is now a single button interface where the typesetter uploads a file and gives it an optional label. Janeway will use the best label for the file provided, but typesetters can edit the label to add a different one if necessary.

.. figure:: nstatic/typesetting/upload_typeset_file.png

   Screenshot of the new file upload box

When uploading an XML or HTML file with image files, Janeway will detect them and prompt the typesetter to upload them.

.. figure:: nstatic/typesetting/images_missing.png

At this point, just hit the edit button and upload each image on the box matching the filename from the XML/HTML file:

.. figure:: nstatic/typesetting/typesetter_images.png

If any intermiadate files have been used for the production of the Files (such as Adobe In Design files), they can be uploaded under the 'Source Files' section

.. figure:: nstatic/typesetting/source_files.png

   Screenshot of the source files form

Before you can complete the task, Janeway will warn you of any potential problems it detects with your files, such as potential missing images on the XML/HTML files or Typeset Files that have not yet been corrected.

.. figure:: nstatic/typesetting/images_missing_warning.png

Once you are done with the typesetting or correction task, you can leave a note for the editor and complete it for the editor to review.
{'fraction_non_alphanumeric': 0.06431707606502908, 'fraction_numerical': 0.00047466476800759466, 'mean_word_length': 3.5093632958801497, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2942921', 'n_tokens_mistral': 2123, 'n_tokens_neox': 2029, 'n_words': 1256}