PTXprint Collage

About

What does it do? Everything that Paratext’s PrintDraft feature can do, but a whole lot more, a whole lot easier, and much faster!

Designed to be a companion for Paratext, PTXprint is a stand-alone program which allows you to create high quality PDFs for trial publications of scripture. It has a multitude of easily configurable options allowing a whole range of outputs. It is built on the same technology (XeTeX) as PrintDraft, but the macros have been enhanced significantly and the interface has been made user-friendly – thus enabling anyone to produce scripture for testing within their local context.

PTXprint in Basic mode with advanced features hidden
In basic mode you just choose the books to be printed, hit the Print button and wait a few seconds for PTXprint to create a well-formatted PDF.

How can it help me? Use it to try out different layouts, text sizes, verse numbering systems, etc. to find out what the community likes so that the final professionally typeset product will be something that the community loves. After all they are very unlikely to get a second typesetting. Use it for UNS testing printouts. Use it for checking the impact of adding illustrations. Use it to produce diglots with the national language alongside the vernacular.

You have complete control! Just about everything you can think of, from Page Size to Column Settings, Font Sizes to Line Spacing; from Picture Positioning to Paragraph Adjustments; Fancy Intro Outlines to Table of Contents for multi-book PDFs. All these features and dozens more can easily be enabled or disabled as needed, and settings adjusted to meet your specific requirements. The resulting PDF is regenerated within seconds. An entire New Testament takes less than a minute!

Rapidly create scripture PDFs for quality trial publications

Advanced mode Layout tab
Advanced mode allows a vast array of settings to be adjusted according to the needs of each publication.

Main Features

  • Prints scripture from any (non-resource) Paratext project
  • Configurable page sizes, margins, columns
  • Easy to alter Styles/Markers using built-in Style editor
  • On-grid column balancing (back-to-back registration of text)
  • Combines multiple books into a single output PDF
  • Flexible book order, for example to allow NT Books+PSA+PRO+Glossary
  • Left-to-Right, Right-to-Left as well as Top-to-Bottom text flows are supported
  • Numbers and digits in any Unicode-compliant script
  • Complete control over footnotes and cross-references
  • Various glossary markup options
  • Filtered Glossary option (only show glossary entries for books in publication)
  • Glossary entries can be included in the footnote area for assisting with comprehension testing
  • Watermarks can be applied to indicate DRAFT content if needed
  • Tool for helping keep track of the appropriateness of illustrations used in different publications
  • Automatically generated Table of Contents

Advanced Typesetting Features

  • Advanced options for handling illustrations – including image quality, positioning on page, and scaling
  • Advanced options for making page adjustments using Paragraph Adjust Lists
  • Advanced character spacing for better control to shrink and grow paragraphs
  • Introductory Front matter and Back matter (such as Glossary and Index books can be included)
  • Automated chapter-verse aligned Diglots
  • Decorative borders and other textual embellishments
  • Colour in text (which could be used to mark the words of Jesus in red, for example)
  • Complete Graphite Writing System support
  • Font Features are supported
  • Fallback font for missing characters in primary font
  • Fancy introductory outlines
  • Can mix single and double column layouts for different books in the same publication
  • Margin verses
  • Automatic Index Tabs
  • Support for pre-processing USFM data using external scripts
  • Colophon included with appropriate Illustration Credits
  • Configuration settings can be saved and shared with other users via Paratext’s Send/Recv
  • Can produce PDF/X-1a:2003 compliant output

“What you have here is amazing and I’m sure it’s going to be used all over the world”

Attractive verse-aligned diglots are relatively easy to produce with just a few extra clicks:

How does it work? PTXprint generates the .tex template based on your preferences and then calls XeTeX to do the actual page layout. XeTeX is controlled by a set of macros that have been optimized for scripture. The TeX macros shipped with PTXprint have been enhanced to provide additional functionality that the Paratext macros do not provide.

System Requirements

  • Linux (Ubuntu/Wasta is highly recommended)

OR

  • Windows (64-bit mode only)

AND

  • Paratext (version 8 or 9) must be installed in order for PTXprint to work

Use a PDF reader which allows the resulting PDF file to be re-written and automatically refreshed when it is updated. SumatraPDF is highly recommended for Windows users.

License

Open source (MIT X11 license).

Code

The code (Python and TeX) is publicly available via a GitHub repository.

Credits

  • Martin Hosken (Project Lead, System Architect & TeX macros)
  • Mark Penny (UI Developer & Documentation)
  • David Gardner (TeX macro hacks, tweaks & bug fixing)
  • David Coward (User Acceptance Testing)
  • Nicolas Spalinger (Linux Packaging)

PTXprint is built on the solid foundation laid by:

  • Jonathan Kew (author of XeTeX and the original sfm2pdf macros)

Downloads

Windows:

PTXprint 1.5.5for Windows EXE | 17.00 MB | 20 Jan 2021
PTXprint 1.4.9for Windows EXE | 16.98 MB | 16 Dec 2020
PTXprint 1.4for Windows EXE | 16.96 MB | 23 Nov 2020

Linux:

Step by step installation instructions for Linux

Warning

Please note that typesetting for formal publication is far more complex than just producing high quality PDFs using this tool. PTXprint is primarily aimed at field-based translators who need to be able to produce decent printouts for local use and is not intended to replace typesetters who use even more sophisticated tools with greater control over the end product. They have an eye for detail and have to follow strict publication guidelines before texts can be approved for publishing. Typesetting is as much an art as it is a science, and years of experience can’t be replaced by a tool like this.


Support

Is this tool supported by SIL? As PTXprint is distributed at no cost, we are unable to provide a commercial level of personal technical support. We will, however, try to resolve problems that are reported to us.

How can I get support for this tool? We envisage that PTXprint will continue to be a community-driven effort, where people contribute as and when they are able, helping each other solve issues that arise. The best place to receive such support is to use the PTXprint page of the Scripture Software Community.  If you are just starting out, you may want to view the PTXprint Training Videos or to check out the Frequently Asked Questions.

How to provide feedback? We do hope that you will report problems so they can be addressed in future releases. Even if you are not having any specific problems, but have an idea on how this system could be improved, we want to hear your ideas and suggestions. Ideally, you should give feedback through the GitHub issue tracker. However, if security is a concern, or you are not familiar with using GitHub’s issue tracker, then please send an e-mail to <ptxprintunderscoresupport@sil.org>.

Contact

If you are unable to obtain support through the Scripture Software Community, or have a general question about SIL’s software, please contact us.