A galley is the final, formatted version of an article ready for publication. The term originates from traditional printing, where a 'galley proof' was a typeset version of content used for final review before printing. In digital publishing, a galley represents the final published format of your article. Once an article has been accepted and copyedited, one or more galley formats are produced for publication. These galleys are what readers will download or view when they access the published article. On Janeway, galleys are sometimes also referred to as "typeset files".

You may publish a single galley (for example, PDF only) or multiple galley types for the same article (for example, PDF and XML). Offering multiple formats allows readers to choose how they access the journal content, based on their needs.

The three most common galley types are PDF, JATS-XML and HTML, though Janeway does not restrict which file types can be made available for download — you may also offer DOCX, DOC, TEX, or other formats as downloadable galleys depending on your journal's needs. For displaying content directly on the webpage, Janeway supports HTML and JATS-XML galleys.

PDF galleys provide a fixed-layout, print-optimised version of the article. PDFs preserve the exact appearance of the content, including fonts, images and page formatting, across all devices and platforms. PDFs will either need to be generated by a typesetter or created in-house. Janeway has no built-in PDF generation functionality. Generally, editing a PDF will require returning to the source file (typically Word or InDesign documents) and regenerating the PDF.

XML (Extensible Markup Language) galleys contain the structured, machine-readable version of your article. Janeway uses JATS-XML (Journal Article Tag Suite), which is the standard format for scholarly journal articles. JATS-XML captures all the structural elements of an article; headings, paragraphs, citations, figures, tables, author information, and metadata, in a standardised format.

JATS-XML galleys are typically generated by a typesetter. Janeway generates a HTML representation of the JATS-XML galley which can be displayed to readers. All you need to do is upload the JATS-XML as a galley and Janeway will generate a web page version of your article. (For information on XSLT see the typesetter guide and editor guide.)

HTML (Hypertext Markup Language) galleys are designed for online reading and allow you to display your content as a webpage. In Janeway, HTML can be generated from XML galleys or converted from Word documents (DOCX or DOC) using the Pandoc plugin. You can also create your own HTML galley and upload it to Janeway.

Galleys can be previewed as a part of the typesetting stage. They will be listed under Current galleys and be viewed using the Preview icon. Using this view, you can see the galley content as it would be displayed on your website. The galley preview will not have functional download links, a views and download block, or any other information that is not encoded within the file itself. The link of the galley preview will only be accessible to other users with appropriate permissions.

There are various ways to edit galleys, depending on your workflow and which galley types you are using. If you are working with multiple galley types, you may need to make changes to multiple files to ensure consistency across galleys. If you are editing metadata, you will also need to check if the data within Janeway matches the galley. A mismatch can have impact on the archiving and preservation of content by services such as Portico and/or (C)LOCKSS.

If you wish to make changes to an XML galley, you can either send it (back) to the typesetter or download the file to edit it yourself. The latter is recommended only for minor changes. XML files can be edited with various softwares such as Oxygen XML Editor, Sublime Text or Visual Studio Code.

If you are editing JATS-XML yourself, there are things to be cautious with:

• Delete or modify tag names unless you are certain of the JATS structure.
• Remove paired tags (opening without closing, or vice versa).
• Change the hierarchical structure of elements.
• Edit special characters or entities (like < for < or & for &) unless you understand character encoding.
• Make structural changes (like adding new sections or figures).

It is recommended to consult your typesetter for the following types of changes to an XML file:

• Structural changes; adding or removing sections, figures, or tables.
• Complex formatting issues.
• Changes that affect interconnected elements.
• Changes to mathematical equations or special characters.
• Any edits where you are uncertain about the correct JATS structure/hierarchy.

Whichever way you make changes to a JATS-XML file, it is recommended to check it using the preview function in Janeway to proof the galley to ensure it displays correctly.

For information on editing images within an XML file or upload missing images, see Managing galley images.

HTML galleys can be edited in various ways, you can:

• You can download the HTML galley, edit it manually and reupload it.
• If using the Pandoc plugin, you can edit the original Word document and generate a new HTML file.
• You can use Janeway's built-in HTML editor (you may need to check with your system administrator whether this is installed).