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 has two modes of operating. In the Basic mode (shown below), all you need to do is to select a Paratext project, choose the book(s) you want to print, and hit the Print button. Then you can return to tweak any of the basic parameters that you would like to adjust in order to improve the output.

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! In the Advanced mode, 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

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
  • Tooltips available on practically every option with context-specific help

Advanced Typesetting Features

  • Advanced options for handling illustrations – including image quality, precise positioning on page, mirroring and scaling
  • Pictures in peripheral books (INT, BAK, GLO etc.) can be precisely controlled like any other pictures in the text
  • Can overlay image credits on pictures (specifically to comply with David C Cook image use requirements)
  • 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
  • Supports ruby glossing
  • Can produce interlinear word-for-word glossed output using Paratext’s interlinear data
  • 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 and enabled through a graphical interface
  • Fallback font for missing characters in primary font
  • Introductory outline formatting
  • Can mix single and double column layouts for different books in the same publication
  • Marginal verses
  • Automatic Index/Thumb Tabs
  • Support for pre-processing USFM data using external scripts
  • Colophon included with appropriate Illustration Credits generated automatically (even in different languages)
  • DBL scripture text bundles can be downloaded and installed by PTXprint – particularly useful for diglot scriptures
  • Configuration settings can be saved and shared with other users via Paratext’s Send/Recv
  • Produces output compliant with PDF/X-1a:2003 standard
  • Jobs can be archived (along with all supporting files) in order to be able to reproduce the same output on another system or at a later time

“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) is highly recommended, but is not needed 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 Coding & Diglot Specialist)
  • 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 Downloads

PTXprint 1.6.0.4for Windows EXE | 28.26 MB | 1 Apr 2021
PTXprint 1.6for Windows EXE | 28.26 MB | 19 Mar 2021

 

Linux Downloads

PTXPrint Linux 18.04 1.6.0.4for Linux DEB DEB | 1.51 MB | 1 Apr 2021
PTXPrint Linux 20.04 1.6.0.4for Linux DEB DEB | 1.51 MB | 1 Apr 2021
PTXPrint Linux 20.04 1.6.0for Linux DEB DEB | 1.50 MB | 19 Mar 2021
PTXPrint Linux 18.04 1.6.0for Linux DEB DEB | 1.50 MB | 19 Mar 2021

Or follow 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. Even so, the sky is the limit as to what you can produce yourself with PTXprint. Take a look at the samples here and be inspired to be creative!


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.

User Interface Languages

PTXprint is localizable and has a growing number of languages that its interface can be used in. If you would like to contribute to the development of the User Interface in other languages, then join the effort at Crowdin.