Proposed changes to a couple of OpenXML options

[Chase Tingley]

Hi all,

In the current snapshot, Denis added the translatePowerpointGraphicMetadata option to control extraction of image metadata in PPTX.  There was already a corresponding option for DOCX called bPreferenceTranslateWordExcludeGraphicMetaData, although the semantics for that are inverted (true means that it excludes the metadata).

We have recently had the need to distinguish between "name" and "description" metadata on these images in some of our translations -- similar to a title vs alt text on an HTML img tag, name and description can be set independently and are used in slightly different cases.

So, Denis and I are planning the following:

1. Remove bPreferenceTranslateWordExcludeGraphicMetaData option
2. Remove translatePowerpointGraphicMetadata option  
3. Add translateWordGraphicName option (true by default)  <--- This preserves the current default behavior
4. Add translateWordGraphicDescription option (true by default)  <--- This preserves the current default behavior
5. Add translatePowerpointGraphicName option (true by default)   <--- This inverts the current default behavior
6. Add translatePowerpointGraphicDescription option (true by default)  <-- This inverts the current default behavior

Basically, we are removing the existing options and replacing each with two new options.  The default behavior for the word option is preserved (although the semantics of the option is inverted -- we will now extract if this option is true).

The default behavior for the powerpoint option will change to extract metadata by default, aligning it with the legacy behavior for word.  This is something we don't normally do, but since this option was added during this same snapshot window, I think it's ok here.

The parameters implementation will be responsible for picking up the legacy bPreferenceTranslateWordExcludeGraphicMetaData value and propagating the desired behavior to the new settings as needed.

Please let me know if you see issues with this plan.

ct

[Jim Hargrave]

I don't see any issues we will treat 1.48.0 as a breaking release like we always do. Better docs on these options would be appreciated in the wiki. 

--
You received this message because you are subscribed to the Google Groups "okapi-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email to okapi-devel...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/okapi-devel/CAGRYq4jkiz_cDKrWQFOZnBu5dy1FJyy5nS-BetAjFQavJRZGRQ%40mail.gmail.com.

[yves.s...@gmail.com]

+1 as well.

It’s more consistent and clearer, and like you said : within the same snapshot it should be OK to change the behavior.

 

-yves

To view this discussion visit https://groups.google.com/d/msgid/okapi-devel/4f1770e6-8b44-40a8-9222-860022d48fb0%40gmail.com.