Add \nd markers within captions

Question

Is there a way to use \nd markers within the caption of an illustration? Just editing the caption in the Figure Properties box or as unformatted text doesn't seem to allow it. Or does the character formatting need to be done at the typesetting stage? If so, what is the best way to flag this in the translation data?

Answer 1

Hola.

Effectively you cannot add markers inside the caption text. But, as you mention, you can make modifications on the \fig tag when typesetting or even when using PTxPrint.

In PTxPrint you can search for the \fig tag under the Styles tab and look for the \fig tag.
 

If what you are looking for is to add some character marker for only some words within some \fig but not within all, then I think it might be an idea to add some basic character before and after the words to mark, maybe (( and )) always keeping in mind that they are not the ones used in the markers or the language. And use these characters to recognize during diagramming or PTxPrint.

Saludos,
Pepe.

Answer 2

I don't think USFM structure lets that happen, unfortunately. Thus Paratext should not allow you to enter it, and if you try, PTXprint will not like the result anyway.

BUT... PTXprint has been mentioned in another answer. So here's how to *actually* do it in PTXprint (assuming the figures UI is working properly for you...):

In ptxprint-mods.tex, add your equivalent of this:

\protected\def\ndLord{\cstyle{nd}{Lord}}

Use that definition in the caption editor: "The angel of the \ndLord\ appeared..."

A bit of explanation: you're defining a 'protected' macro (\ndLord) that selects the nd character style and typesets "Lord". The  \protected bit means that various things like parsing the input and debug-logging don't expand it, only when it's actually used in the text.  The "\ " between "\ndLord" and "appeared" tells it that you really do want a real space there, it's not just a space to mark the end of the macro.

Don't try to use \ndLord (or equivalent) in anything paratext touches, as \ndLord isn't  USFM, and also (I tried) ptxprint will refuse to pick-up \fig entries that include USFM - valid or not - in the caption, etc, so you'll just end up with ignored images.

Comments

Actually, having said that USFM doesn't support it, I'm not at all sure from the specifications.
If someone from the USFM standards committee said that fig should behave as if it were a character style (with more than the normal number of required attributes, and some 'interesting' side-effects), then I certainly wouldn't argue. (and I'm having a go at  enabling PTXprint to support that usage, at least if the user will guarantee that no USFM2.x style figures are in the document).

Answer 3

Correcting/updating my earlier answer:
1. I understand that the official syntax of does not allow nesting of character styles within captions.
2. The syntax of \fig being like a character style with attributes, however, does allow nested character styles.
3. PTXprint 2.8.8, once it is released, should allow character styles in captions, however there may still be problems if you start off with the \nd within Paratext, and the last time I checked \fig s that included other markup were silently ignored, and not added to the generated piclist.
I don't know how other tools, e.g. SAB, will respond.
4. Unless your SFM is marked as \usfm 3.1, any tool that treats \fig ... \fig* as a character style will get very confused if you use \nd in the fig, rather than \+nd, as it would treat \nd as ending the \fig. (usfm 3.1 gets rid of \+something format, and requires character styles to have an end-marker).
5. You asked how to mark it... I'd recommend something easily visible on the proof copy and very clear.  How about \fig The *FIXME**ND>*Lord*<ND* called from the burning bush|.....\fig* ? (FIXME giving you a string to search for, and *ND>* text *<ND* marking where the typesetter should apply what mark-up.
As far as I know, ptxprint doesn't have a changes file section that will be applied to figure captions, but searching the jobname.piclist for FIXME is simple enough with a text editor.