Examples of well-formatted front matter

I would love to see some well-formatted examples of front matter that users are successfully using with PTXPrint.

1 Like

@John_Nystrom In the absence of any replies, I’ll do my best to answer your question - albeit with my limited experience.

The USFM specification for the FRT book uses a \periph marker to indicate the different elements (usually on different pages) that make up the front matter of a publication. For PTXprint to mimic that behaviour, I’d suggest adding a rule to your PrintDraftChanges.txt file (accessed through the Advanced tab in PTXprint) to add a page break at each \periph marker:

# Force a new page each time the \periph marker is found
"\\periph " > "\\pb\r\n\\rem "

The other issue is getting adequate spacing before the title on the 1st page, and then between the various elements on the verso page. I also tried adding multiple \b (blank line) markers above the \mt but found that they don’t do anything - not until you have a marker above them. So I inserted a bank \mt at the top, followed by several \b markers to bring the title down. Similarly, \b between the various \pc elements on the verso page allowed me to spread things out as needed.

Note that I have used the magic code to generate the illustration credits information (as can be done with a colophon):

\pc \zimagecopyrights

The end result looked like the sample shown below (click to enlarge). Note that the table of contents in this sample was NOT auto-generated, but that certainly is another option if helpful using the PTXprint settings on the Body tab.

Here’s an extract showing what the USFM in FRT looks like:

And if you wish to copy-and-paste the example for your FRT book then use the plain-text version below:

\id FRT XYZ Language Name (C) 2010-2018 Copyright Notice
\periph Title Page
\mt pavitra vacan
\mt2 gōṇḍi bāsata pūna niyam
\periph Publication Data
\imt pavitra vacan
\imt2 gōṇḍi bāsata pūna niyam
\pc The Holy Word
\pc (New Testament)
\pc Language: Langname
\pc Script: Scriptname
\pc NNX NNNN/2018/2M PL
\pc © 2018, The Bible Society of Vwxyz
\pc Written permission must be obtained from the Bible Society of//Vwxyz as copyright holder, prior to the reproduction of any part//of this publication in any form or by any means, electronic//or mechanical, including photocopying, recording,//or any information storage and retrieval system.
\pc \zimagecopyrights
\pc \it Published by:
\pc The Bible Society of Vwxyz
\pc NNN Somename Road
\pc City - Postcode
\pc Brilliant Printers Pvt. Ltd., City - Code
\periph Table of Contents
\imt batal baga manta
\io1 mattayi: sīta vāgdan barpur āyval \ior NNN\ior*
\io1 mārk: kiristuna carna piyle baven suṭi kiya lāgar \ior NNN\ior*
\io1 lūka: pārtana ani kivul vāyval gunte pisval \ior NNN\ior*
\io1 yōhan: vēḍcitaga pisval \ior NNN\ior*
\rem etc...
\io1 yūda: gaṭ nilval \ior NNN\ior*
\io1 ujagiri arusval: kaṭoḍalira rāj \ior NNN\ior*
\periph Special Marks
\imt id grantun vāḍakam kiyval tarika:
\m id grantun vāci kīneke iv gosṭiṅg hētu irana:
\li 1. pūnaṅg ani kaṭin manvalik bavte gosṭin (namunat: \w bāptisma\w*, \w sunagōg\w*, \w parisaya\w*) būḍ cukaṅg mandantaṅgo, aven bārete, id grantna ākrita bāgamnaga mandanta.
\li 2. uṇḍe gir padamna seleke, pūro gosṭita artamun samje māyle bagane āyi (*) ītal sukumna nisani matteke, pējitaga būḍ iden bārete mandanta.
\li 3. ani (†) ītal talvarta nisani matteke, av gosṭiṅg dusrok-dusrok pustaknaga gir mantaṅg inval tohanta.
\li 4. kahi jāganaga modoḍa bāsate lihi kītaṅg pustaknaga bagate iv gosṭiṅg seleṅgo, ani kahitaṅg pustaknaga vacank cuksi mantaṅgo, aven tohle *[ ... ] ītaṅg cavkoṭ manvalik gītoṅg dostom ani aven bārete pējitaga būḍ lihi kīsi manta.

I hope this helps as you try to make things work for your project.

1 Like

I am having trouble getting the magic codes (\zimagecopyrights, \zimagecopyrights) to be left aligned?

In the example above, the code prior to \zimagecopyrights is \pc = Centered Paragraph. Have you tried using \p (normal indented paragraph) or \m (margin paragraph with no 1st line indentation) in place of \pc ?

Yes I tried both of those, no change.

Yes, you are right @MikeB. I can see why that is happening. We’ll work on fixing that for 1.9.1 - along with a few other bugs you’ve raised in the last week or so.

1 Like

Fixed, and will be available in 1.9.1. It was a tricky one; good catch! Here’s a rather hypothetical sample output showing that it now works like it is supposed to:

Interestingly, if you need a work around for the current version 1.9 which you’re using, then just as ‘en’ to the end of \zimagecopyrights i.e. \zimagecopyrightsen and it will behave itself,

1 Like

Thanks for the great work on PTXprint! Always look forward to the next update. Gets better and better. And this fix will be helpful too.

But I have found it better for us to have front matter formatted at a smaller font size than main translation text. If you feel the same, then maybe using the \pc style is less than ideal.

Unfortunately, there is no suggested SF markers to use for front matter like this. Might I propose we create a new standard style like say \ipc (introduction centered paragraph) or maybe \fmpc (front matter centered paragraph), as a better way to handle these? I.e. Could we get a set of “front matter” styles that can be used and tweaked, without having any effect on the main body of the document?

(I know Paratext does maintain a separate style sheet for front and back matter from the main style sheet for scripture text. But this is outside of PTXprint and opaque to most users. Also, would it not be better to have the style labeled \pc always act the same regardless of where it is found?)

I’d be interested in the community’s thoughts on this.

What I would do in this case is to create the PDF for the front matter separate from the main text. This would allow you to change the \pc style for the front matter.

Yes, that is how I currently handle this.

But a separate PDF leaves out the automatic copyright information for illustrations PTXprint brings. And it can mean the working copy of the front matter is kept in a Word document to generate the PDF, and so is not archived with the Paratext project. That can allow the front matter to become stale or lost.

The ideal solution is for all things relevant to scripture development, checking, revising, tracking, formatting, and publishing (especially for trial runs of scripture portions)–which includes relevant front and back matter too, to be handled within the Paratext context. And our tools then work to extract that information in usable ways.

Product design emphasizes that markers should have specific tasks, and not be used generically. So it seems safer to not have something which applies to scripture text also apply to anything in the front or back part of a book, because then tweaking something for one place can have unexpected consequences elsewhere.

But I realize adding new markers carries its own set of pain and suffering!
So, i’m just thinking out loud here, to see how translation could become easier, and more seamless, and sustainable into the future.

1 Like

@mjpenny Thank you so much for taking the time to put this together! I agree with David Coward re. making it seamless to do all of this within Paratext so all we need is our data, Paratext, and PTXPrint to get good quality trial copies.

1 Like

I agree, if the goal is to make this easy to use for all users (not just typesetters), then having the ability to do it all within Paratext and PtxPrint is important.

I like the idea of using the area in PtxPrint set aside for future FRT creation. That could be even simpler than using the FRT in Paratext, and would allow the FRT in Paratext to be used for official typesetting.

I wonder if it’s possible to create content in FRT that would apply to any scripture portion we want to print.

We want to be able to quickly produce printouts of various books and combinations of books. PTXPrint makes that easy on the basic tab. E.g. I can print 1-3 John and Jude one minute and the Five T’s a minute later. But if I want to print front matter with them, I have to change the contents of \mt and \mt2 in the FRT book in Paratext each time I change what I want to print. That’s probably no big deal once I and our team are proficient at using PTXPrint and have a good set of saved configurations. We don’t need front matter when we’re doing an informal printing anyway, just when we are actually publishing. But when we are working on typesetting several books, I anticipate completing some and then going back to do them again after I discover I want to change something because of what I learned in typesetting the next set of books. We are not publishing the entire backlog as one publication but as several. Because we have a large backlog of books to typeset and probably won’t print any until we print them all, I’m likely to encounter this problem many times: If I want to produce a new PDF of something I have already done, I have to go back and change those title fields again, then change them back.

I wonder if there is a way PTXPrint could auto-generate the contents of those markers based on which scripture books I am printing. And maybe some of you have another suggestion for making this easier.

We face the same issue. And ours has a “Preface” (in 3 languages), which makes reference to the book’s title as well, so that is a tricky bit, unless these book names can use places-holders made into special fields (for the various languages), like the special copyright field does.

Our title page has to have the vernacular book name, but also have everything in the national language as well. Same with the copyright page. And those preface blurbs I mentioned from the translation team. All of this can be kept in the FRT “book” and manually tweaked as needed.

But we also have “letters of introduction” (or like sponsor letters) from the the main church and local organization that sponsors the translation. Those are a bit tricky, with logos in the letterhead and signatures with seals too. So these two pages would be better served as kept in two PDF files and loaded in where needed, if there was a way to put in a PDF link in the FRT book.

Anyway, Mark’s idea for page breaks in front matter was very helpful! Very glad to see progress in this part of the product. (Our Back Matter materials also needs work, like the maps have never worked right through PTXprint, etc. etc.) What PTXprint does now is pretty amazing, so we tweak the rest as needed. One step at a time.