num() rounded ties to even only at 17 significant digits. IDML takes the decimal nearest to the exact value at the shortest length, with ties to even, at any length, and writes numbers below 1e-4 with an exponent (1e-05). The rule gives the IDML text for all but 67 of the 1,090,937 distinct numeric texts of the reference IDMLs (those 67 are text values). diff_outputs.py: 2,672 outputs differ, no change in failures or warnings. compare.py --exclude own/: - trustworthy 97.72% (+77 values): PDF GraphicBounds 849 -> 913 of 913, EPS 323 -> 329, SVG 140 -> 146 - all pairs +99 values: PDF, EPS and SVG GraphicBounds all equal - extra values unchanged
30 KiB
Values written from IDML observation
Some values the converter writes do not come from the INDD file. They are values that every IDML exported by InDesign in the corpus has, on the root styles and in the preferences. They are facts about InDesign's IDML output, not about the INDD format, and the evidence is the corpus IDML files alone.
Why they are written: IDML consumers apply their own defaults to
attributes that are missing. When those defaults differ from InDesign's,
the layout differs. For example, a consumer that defaults to keeping all
lines of a paragraph together breaks pages differently from a document
whose root style says KeepAllLinesTogether="false".
Root style values
The root styles are [No paragraph style], [No character style], the
object style [None], the cell style [None] and the table style
[No table style]. Every corpus IDML has all five.
tools/root_values.py reads Resources/Styles.xml of every corpus IDML
and collects each attribute of the root styles, each Properties child,
and each attribute of their child elements (for example
TextFramePreference in the object style). It keeps a value when:
- every IDML from some DOM version on has it, with the same value, and
- the converter does not read it from the INDD.
The kept values are in src/idml/root_values.xml, generated by that
tool. The converter writes them on its root styles. A value the
converter reads from the INDD takes precedence: for the paragraph and
character root styles, attributes in the text attribute table
(attributes.md) are left out of the file, and any attribute the INDD
supplies is written from the INDD.
The files were generated from the 240 INDD files with an IDML that the
corpus had then (SOURCE in the tool), which are 88 distinct IDML
files. Their DOM versions are 7 (1 file), 12 (7 files) and 15 to 20 (80
files). Values that first appear after DOM 7 are written only for
documents of that InDesign version or later (MinimumVersion in the
file). The corpus has grown since; the later pairs are evidence for the
values of other elements (below). Regenerating these files from all pairs
would drop some values that the larger corpus shows to vary between
documents, such as table style stroke weights. With the 828 distinct
IDML files of the corpus in 2026-10, 19 values of [No paragraph style], 41 of the object style [None] and 19 of [No table style]
vary, and DOM 7 files differ from later ones in many values. The files
also predate most of the text attributes the converter now reads from
the INDD; the tool leaves those out, so regenerating them would also
remove values that the INDD supplies only for some styles. Regenerating
them is a change of its own, with its own measurement.
| Root style | Values | Same in | Written for version |
|---|---|---|---|
[No paragraph style] |
180 | 88 of 88 files | all |
| 14 | 87 of 87 files with DOM 12 or later | 12 and later | |
| 30 | 80 of 80 files with DOM 15 or later | 15 and later | |
[No character style] |
1 | 88 of 88 | all |
| 2 | 87 of 87 (DOM 12 or later) | 12 and later | |
| 2 | 80 of 80 (DOM 15 or later) | 15 and later | |
Object style [None] |
75 | 88 of 88 | all |
| 43 | 87 of 87 (DOM 12 or later) | 12 and later | |
| 16 | 80 of 80 (DOM 15 or later) | 15 and later | |
Cell style [None] |
1 | 88 of 88 | all |
Table style [No table style] |
105 | 88 of 88 | all |
| 10 | 87 of 87 (DOM 12 or later) | 12 and later |
Among them are the keep settings of [No paragraph style]:
KeepAllLinesTogether="false", KeepFirstLines="2", KeepLastLines="2",
KeepWithNext="0" and KeepWithPrevious="false", in 88 of 88 files.
Left out because they vary between files:
[No paragraph style]:DiacriticPosition,KinsokuSet,Mojikumi,StyleUniqueId,TreatIdeographicSpaceAsSpace, and the eight corner radii of paragraph borders and shading (12 or 1).[No character style]:StyleUniqueId.- Object style
[None]:FrameFittingOption/FittingAlignment,StoryPreference/StoryDirection,TextFramePreference/ColumnRuleStrokeColorandTextFramePreference/ColumnRuleStrokeWidth.
Left out because the converter reads them from the INDD: 85
attributes of [No paragraph style], listed in attributes.md. Some of
these are also the same in every IDML; the INDD value is written. In
every compared pair the converted root styles have all of them.
The object, cell and table root styles get only observed values: the
converter reads no attributes of these styles from the INDD yet. The cell
and table root styles are written as new elements in
RootCellStyleGroup and RootTableStyleGroup.
Document attributes
AccurateLABSpots="false" is on the Document element of all 654
corpus pairs' IDML files. The converter writes it. The colour settings
next to it are read from the INDD (preferences.md).
Name (the package's file name) is on the Document element from DOM
13 only: 321 of 321 trustworthy references from DOM 13, 0 of 168 before.
Default numbering list
The root paragraph style refers to NumberingList/$ID/[Default]. Every
corpus IDML file has this element in designmap.xml, with the same
attributes: Name="$ID/[Default]",
ContinueNumbersAcrossStories="false" and
ContinueNumbersAcrossDocuments="false". The converter reads the
numbering lists from the INDD (objects.md, numbering lists) and writes
them after idPkg:Styles, where the IDML schema puts them. It writes
this default list with these values only for a file whose lists it
cannot read.
Built-in stroke styles
All 240 corpus IDML files list the same 18 StrokeStyle elements in
Resources/Graphic.xml, in the same order, each with only Self and
Name (StrokeStyle/$ID/Solid, $ID/Solid, and so on). The converter
writes the same list, so every StrokeType it writes refers to an
element in the package.
Story values
tools/element_values.py collects the values of Story, XmlStory
and their StoryPreference and InCopyExportOption children from the
827 corpus IDML files (element_values.xml); the converter writes them
where the INDD gives no value:
| Element | Values kept | Versions |
|---|---|---|
Story |
TrackChanges="false" |
7 on |
Story, XmlStory |
UserText="true" where written |
11 on; IDML has it from version 11.2 (none of the 3,184 stories of DOM 10.0 to 11.0, every story from 11.2), and the converter writes it from INDD version 11.2 |
InCopyExportOption of stories |
IncludeGraphicProxies="true", IncludeAllResources="false" |
7 on |
The other story values are read from the INDD: StoryTitle,
StoryDirection and the optical margin from story chunks, with the
value of every story without the chunk when it is absent (objects.md,
story settings); IsEndnoteStory from the story class (footnotes.md);
AppliedTOCStyle from chunk 0x8C40.
StoryPreference FrameType and StoryOrientation are read from
story chunk 0x2EE (objects.md, story settings).
Left out because it varies: Story AppliedNamedGrid (106 of 27,816
stories name a grid, all in DOM 12 files). Before the corpus had
samples typeset in Japanese, every IDML had n.
Graphic settings without an INDD field
element_values.xml holds the ClippingPathSettings values of every
Image, PDF and EPS element with ClippingType="None" in the 827
corpus IDML files:
ClippingType="None", InvertPath="false", IncludeInsideEdges="false",
RestrictToFrame="false" and AppliedPathName="$ID/" (and for PDF and
EPS also the values the converter reads for images). The converter writes
the element only for clipping type 0 in chunk 0x2C1A, which IDML writes
as None (objects.md), so tools/element_values.py collects only those
elements (WRITTEN_FOR). The 8 images with another ClippingType (7
with AppliedPathName set, 1 with InvertPath and RestrictToFrame
true) are the only elements with other values; all 7,698 elements with
None have the values above. EPS graphics occur
only up to DOM 20, so a DOM 21 EPS gets only the values read from the
INDD. Every ImageIOPreference has AllowAutoEmbedding="true". The
converter writes the values read from the INDD first (objects.md,
clipping path settings).
Over the 5,131 graphics of the trustworthy pairs, every graphic has
LocalDisplaySetting="Default"; every image (3,607)
ImageRenderingIntent="UseColorSettings"; every PDF and EPS (1,339)
GrayVectorPolicy="IgnoreAll"; every SVG (146) UseSVGAs="EmbedCode".
From DOM 21 every image, PDF and SVG has FlexItemWidthMode="FlexFixed"
and FlexItemHeightMode="FlexFixed" (81 of 81), and SVG graphics from
21.2 have IsMathMLObject="false" (4 of 4). The constant values of
graphic layers are in objects.md (graphic layers). The converter
writes all of these.
Links
These Link values are the same in all 4,699 links of the trustworthy
pairs, and the converter writes them on every link: AssetURL="$ID/",
AssetID="$ID/", LinkClassID="35906" (0x8C42, the class of links),
LinkClientID="257" (the u32 at offset 4 of chunk 0x8C9B is 0x101 in
every link), LinkObjectModified="false", CanEmbed="true",
CanUnembed="true", CanPackage="true", ImportPolicy="NoAutoImport"
and ExportPolicy="NoAutoExport". RenditionData="Actual" is on every
link from DOM 13 on (3,043 of 3,043) and on none before (1,656 of
1,656); the converter writes it from version 13.
Object styles other than the root
tools/root_values.py also collects the object styles other than
[None]: 295 styles in the 88 distinct IDML files, every file having at
least one. A value is kept when every such style of every IDML from some
DOM version on has it, with the same value, and at least 10 files show
it. The kept values are in src/idml/object_style_values.xml. The
converter writes them on every object style other than [None], and
writes the values it reads from the INDD (objects.md, object style
settings) in their place.
| Values | Same in | Written for version |
|---|---|---|
| 80 | 88 of 88 files | all |
| 40 | 87 of 87 files with DOM 12 or later | 12 and later |
| 14 | 80 of 80 files with DOM 15 or later | 15 and later |
| 1 | 74 of 74 files with DOM 18 or later | 18 and later |
Among them are the nine Enable… effect flags other than
EnableTransparency in the four ObjectStyle…EffectsCategorySettings
elements (all true), all of BaselineFrameGridOption,
ObjectExportOption and TransformAttributeOption, and
ApplyNextParagraphStyle="false" and EnableParagraphStyle="false".
Left out because they vary or are not in every style (59): the
fill, stroke and corner values, most Enable… attributes,
AnchoredObjectSetting PinPosition, AnchorPoint and
VerticalAlignment, the frame fitting values, the story frame type,
orientation and direction, the text wrap mode and contour type, the
column, inset, footnote and column rule values of
TextFramePreference, and EnableTransparency. The converter reads
many of these from the INDD. Values that only the 2 files with DOM 20
have (18) are left out as for the preferences.
The TextFramePreference values that the file lists from DOM 12
(UseFlexibleColumnWidth="false", TextColumnMaxWidth="0",
UseNoLineBreaksForAutoSizing="false" and the auto-sizing values) are
on every object style from DOM 8: 607 of 607 styles of DOM 8 to 11 in
the trustworthy pairs, [None] included, and none of the 28 of DOM 7
(the file's source had no DOM 8 to 11 files). The converter writes them
from DOM 8; the auto-sizing values it reads from the INDD take
precedence.
TextFramePreference FootnotesEnableOverrides="false" is on every
object style, [None] included, from InDesign 13.1 (INDD header
version): 1,392 of 1,392 styles of the trustworthy pairs, none before.
The value file has it only from DOM 15, since it is generated per major
version; the converter writes it from 13.1.
Composite font entries
The converter writes only the built-in composite font [No composite font]. All 5,231 of its CompositeFontEntry elements in the corpus
IDML files have Locked="true", RelativeSize="100",
BaselineShift="0", HorizontalScale="100" and VerticalScale="100".
No INDD field for Locked is identified; the converter writes it on
every entry, and the other four where the entry's stored numbers are
those of every entry (fonts.md). Entries of other composite fonts
have other values.
Inks
Every Ink element of the 827 corpus IDML files has InkType="Normal"
and PrintInk="true" (element_values.xml); the converter writes them
on every ink. ConvertToProcess is read from the INDD (objects.md,
inks).
Values of other elements
tools/element_values.py collects the values of other elements the
converter writes from every distinct IDML of the corpus (827 files
exported by InDesign; one more IDML in the corpus lacks the product of
InDesign's aid processing instruction and was written by a script, so
it is left out). A value is kept for a range of DOM versions when every
element of that kind in every file of those versions has it with the
same value, and it is left out entirely when some version shows two
values or elements without it. The values may differ between versions;
each range needs 10 files. The kept values are in
src/idml/element_values.xml, in blocks with MinimumVersion and
MaximumVersion. The converter writes them after the values it reads
from the INDD and only where the element lacks the attribute.
Files per DOM version: 7: 9, 8: 67, 9: 8, 10: 52, 11: 48, 12: 106, 13: 116, 14: 74, 15: 66, 16: 42, 17: 17, 18: 88, 19: 70, 20: 31, 21: 33.
Page items
| Element | Elements | Values kept |
|---|---|---|
TextFrame |
33,580 | LocalDisplaySetting="Default", GradientStrokeAngle, GradientStrokeHiliteLength, GradientStrokeHiliteAngle (0) from DOM 7; FlexItemWidthMode and FlexItemHeightMode (FlexFixed) from 21 |
Rectangle |
24,737 | LocalDisplaySetting, StoryTitle="$ID/" from 7 |
Oval |
3,393 | LocalDisplaySetting, StoryTitle and the gradient highlights from 8 |
Polygon |
52,863 | LocalDisplaySetting, StoryTitle and the gradient highlights from 7 |
GraphicLine |
4,413 | LocalDisplaySetting, LockState="None" and the gradient highlights from 7 |
Group |
9,063 | LocalDisplaySetting, GradientStrokeAngle and the gradient highlights from 7 |
Each kind also has FlexItemWidthMode and FlexItemHeightMode from
DOM 21, and values that the converter reads from the INDD
(objects.md, page item settings), which take precedence. Values such
as Name, Visible, Locked, the gradient angles and the layout
constraints are not kept: they differ in some elements, and those
values come from the INDD.
Spreads, pages and layers
| Element | Elements | Values kept |
|---|---|---|
Spread |
7,725 | PageTransitionType="None", PageTransitionDirection="NotApplicable", PageTransitionDuration="Medium", ShowMasterItems="true", FlattenerOverride="Default" from DOM 7; SpreadHidden="false" from 19 |
FlattenerPreference of spreads |
7,725 | ClipComplexRegions, ConvertAllStrokesToOutlines, ConvertAllTextToOutlines (false) and RasterVectorBalance 50 from DOM 7 |
MasterSpread |
1,585 | OverriddenPageItemProps="" from DOM 7 |
Page |
13,733 | AppliedTrapPreset="TrapPreset/$ID/kDefaultTrapStyleName" from DOM 7; SnapshotBlendingMode="IgnoreLayoutSnapshots", OptionalPage="false" from 8 |
Layer |
1,755 | ShowGuides and Expendable (true) from DOM 7 |
Page GridStartingPoint is left out: 28 pages of DOM 18 files have
another value than TopOutside.
Every spread has one FlattenerPreference, so the converter writes the
element on every spread. For a spread without the flattener chunk
(objects.md, flattener settings) it also writes
LineArtAndTextResolution and GradientAndMeshResolution: 300 and
150, or 400 and 400 after a session of a Japanese or Chinese edition,
by the language code of the save history (objects.md, flattener
settings). The other attributes of these elements come
from the INDD (objects.md).
Document settings in designmap.xml
These elements are children of Document without Self. The tool keeps
an element when every IDML from some version on has it, with the values
all of them have; the converter writes it in the order of the IDML files.
| Element | From DOM | Values kept | Left out (vary) |
|---|---|---|---|
ConditionalTextPreference |
7 | both | |
EndnoteOption |
13 | 9 | EndnoteTitle, EndnoteSeparatorText, the marker and text styles, EndnoteMarkerPositioning |
TextFrameFootnoteOptionsObject |
12 | all 4 | |
LinkedStoryOption |
8 | all 4 | |
LinkedPageItemOption |
8 | all 7 | |
WatermarkPreference |
7 | 11 | the font family, style and colour |
TaggedPDFPreference |
8 | StructureOrder |
|
AdjustLayoutPreference |
14 | 4 | EnableAdjustLayout, EnableAutoAdjustMargins, AllowFontSizeAndLeadingAdjustment |
HTMLFXLExportPreference |
11 | both | |
PublishExportPreference |
11 | 11 | ImageExportResolution, PublishPdf |
Assignment (827 elements, one per file): UserName="$ID/",
ExportOptions="AssignedSpreads", IncludeLinksWhenPackage="true",
FilePath="$ID/" and FrameColor Nothing, from DOM 7.
Language quotes
The quotes of a language are not in its INDD object (objects.md,
languages). For each language name the tool keeps SingleQuotes and
DoubleQuotes when every IDML Language element with that name has the
same value, in at least 3 files (a Keyed block of the values file):
63 languages. Romanian and Japanese have two variants each and are left
out.
Pasted smooth shades are keyed the same way by ContentsType: every
ConstantShade (and every AxialShade) has ContentsVersion="0",
SpotColorList="", ContentsEncoding="Ascii64Encoding",
ColorEditable and ColorRemovable true, Visible="false" and
SwatchCreatorID="7937"; constant shades also
ContentsMatrix="1 0 0 1 0 0".
Paragraph and character styles
The styles other than the root styles (5,505 paragraph and 2,284 character styles in the IDML files):
| Values kept | Styles | Versions |
|---|---|---|
PreviewColor Nothing |
paragraph and character | 7 on |
EpubAriaRole="" |
paragraph and character | 21 on |
IncludeClass="true" |
character | 13 on |
ExtendedKeyboardShortcut="0 0 0" |
character | 15 on |
EmitCss="true" where written |
paragraph and character | 10 on |
SplitDocument="false" where written |
character | 10 on |
TOC styles (851 in the IDML files) all have RunIn="false" and
IncludeHidden="false". SetStoryDirection is left out: 3 styles have
Vertical.
The paragraph styles' SplitDocument and IncludeClass are left out:
a few styles have other values, whose INDD field was not found. Keyboard
shortcuts are read from the INDD (objects.md, styles).
Table and cell styles other than the root styles (731 and 84 in the IDML
files) all have KeyboardShortcut="0 0" (cell styles from DOM 8, with
27 files) and ExtendedKeyboardShortcut="0 0 0" from DOM 15; the
converter writes them. Imported and StyleUniqueId come from the INDD
(objects.md, styles).
Swatches
| Element | Values kept |
|---|---|
Tint |
ColorOverride="Normal", AlternateSpace="NoAlternateColor", AlternateColorValue="", ColorEditable, ColorRemovable, Visible (true) and SwatchCreatorID="7937" from DOM 8 (37 tints in 26 files); ConvertToHsb="false" from 18 |
Gradient |
SwatchCreatorID="7937" (and the flags, which the converter reads) from DOM 7 |
Swatch (None) |
SwatchCreatorID="7937" from DOM 7 |
Colours have their creator and alternate colour in the INDD
(objects.md, colours).
Trap presets
All 827 IDML files list the same two TrapPreset elements at the end of
Resources/Styles.xml, with the same attributes: $ID/k[No Trap Preset] and $ID/kDefaultTrapStyleName, which every page applies. The
converter writes the list (a List block of the values file). One DOM
12 file has a third preset, named by the user, after these two. Its INDD
object is not decoded, so the tool leaves presets with such names out of
the list.
Values written where the converter writes the attribute
Some attributes are only on some elements; IDML writes them where a
frame's value differs from its object style, or from some version on.
For these the tool keeps a value when every element that has the
attribute has the same value (WhenWritten blocks). The converter
writes them on every text frame of those versions:
TextFramePreference values |
Versions |
|---|---|
VerticalThreshold="0" |
7 on |
UseFlexibleColumnWidth="false" |
8 on |
FootnotesEnableOverrides, FootnotesSpanAcrossColumns (false) |
13 on |
ColumnRuleOffset, ColumnRuleTopInset, ColumnRuleBottomInset (0), ColumnRuleInsetChainOverride="true", ColumnRuleStrokeTint="100", ColumnRuleStrokeType="StrokeStyle/$ID/Solid", ColumnRuleOverprintOverride="false" |
15 on |
The first version of the column rule and footnote values is also where
the converter starts writing the column rule and footnote values it
reads from the INDD (objects.md, text frame preferences).
Export options of page items
ObjectExportOption of page items has different attributes in different
INDD versions, major and minor. Over the 92,409 page items of the
trustworthy pairs there is no exception inside a version:
| INDD version | Attributes in addition to the common set |
|---|---|
| 7 | no ObjectExportOption |
| 8.0–9.1 | CustomImageConversion="false", CustomImageSizeOption="SizeRelativeToPageWidth" |
| 9.2 | also UseOriginalImage="false" |
| 10.0 | EpubType="$ID/", UseExistingImage="false", CustomHeightType="DefaultHeight", CustomHeight="$ID/", CustomWidthType="DefaultWidth", CustomWidth="$ID/", CustomImageConversion="false", UseOriginalImage="false" |
| 10.1 on | EpubType="$ID/", SizeType="DefaultSize", CustomSize="$ID/", PreserveAppearanceFromLayout="PreserveAppearanceDefault" |
| 21.0 on | also EpubAriaRole="$ID/" |
| 21.1 on | also EpubAriaLabel="$ID/", EpubAriaLabelSourceType="AutomaticARIALabel" |
| 21.4 on | also AIGeneratedAltText="false", AltTextGenerationError="false", AltTextCropSyncRect="" |
The common set, on every page item from version 8 on: the alternative
text and tagging values (AltTextSourceType, ActualTextSourceType,
CustomAltText, CustomActualText, ApplyTagType, read from chunk
0x1E206, objects.md), ImageConversionType="JPEG",
ImageExportResolution="Ppi300", GIFOptionsPalette="AdaptivePalette",
GIFOptionsInterlaced="true", JPEGOptionsQuality="High",
JPEGOptionsFormat="BaselineEncoding", ImageAlignment="AlignLeft",
ImageSpaceBefore="0", ImageSpaceAfter="0",
UseImagePageBreak="false", ImagePageBreak="PageBreakBefore",
CustomImageAlignment="false", SpaceUnit="CssPixel",
CustomLayout="false", CustomLayoutType="AlignmentAndSpacing", and
the Properties children AltMetadataProperty and
ActualMetadataProperty (their values also from chunk 0x1E206). These
are constant in all 93,701 elements except ImageAlignment (3
AlignCenter) and SizeType (3 RelativeToTextFlow), all in the same 3
items of one document; their INDD field is not identified.
Object styles, [None] included, have ObjectExportOption from version
9 on (all 1,882 styles of those versions), with the common set (all
values constant) and the same version-dependent attributes, except that
21.4 on adds only AltTextCropSyncRect="".
The converter writes these values by the version of the INDD file. It
leaves out CustomImageSizeOption: the IDML schema the output is
checked against does not allow that value. The ObjectExportOption
blocks of element_values.xml, root_values.xml and
object_style_values.xml are not used, because those files are keyed
by major version only.
Every InCopyExportOption of a rectangle, oval or polygon in the 827
corpus IDML files has IncludeGraphicProxies="true" and
IncludeAllResources="false" (element_values.xml; ovals from DOM 8,
as no DOM 7 file has one). The converter writes the element with these
values on those items.
Column direction of pages
The ColumnDirection of pages is read from the INDD (objects.md,
page settings). The MarginPreference and DocumentPreference of the
preferences keep the observed Horizontal of preference_values.xml;
8 of the 489 trustworthy pairs have Vertical there, and no field was
found for it (chunk 0x555 does not separate them, and 4 of the 8 lack
it).
Font platform name
PlatformName is $ID/ in every Font element of the corpus IDML
files except the fonts of missing-font records, where it is read from
the record (fonts.md, missing fonts). The converter writes $ID/ on
every other font.
Number format
IDML writes a number as the shortest decimal that reads back as the same
64-bit value. When two decimals of that length read back as the value,
IDML takes the one nearest to the exact binary value, and of two equally
near (the value lies exactly halfway, common for values that came from
32-bit floats) the one with the even last digit. For example the value
150.235992431640625 is written 150.23599243164062, not …063.
Numbers below 1e-4 are written with an exponent of at least two digits
(5.684341886080802e-14, 1.8897456811828306e-05); all others are
written in plain notation.
Evidence: of the 1,090,937 distinct numeric texts in the attributes of
the 654 reference IDMLs of the corpus before 2026-10, the rule gives the
same text for all but 67, which are text values rather than numbers
(DOMVersion="17.0", 2.000, 0.80). Rust's shortest form differs on
7,674 of them: ties written with the odd digit, and small numbers
written without an exponent. The INDD values of GraphicBounds (chunk
0x1633), written this way, equal the IDML text in all 1,774 PDF, 407 EPS
and 233 SVG graphics of the 803 pairs (compare.py compares
Properties children as text). The converter writes every number this
way.
Preferences
Resources/Preferences.xml of every corpus IDML has the same 41
top-level elements (TextDefault, TextPreference,
TextFramePreference, PageItemDefault, StoryPreference,
FootnoteOption, TransparencyDefaultContainerObject and others; the
DOM 7 file lacks EPubFixedLayoutExportPreference). tools/root_values.py
collects each attribute, Properties child and child element attribute
of these elements with the same rule as for the root styles, and writes
the kept values to src/idml/preference_values.xml. The converter writes
those elements in the order the IDML files list them.
| Values | Same in | Written for version |
|---|---|---|
| 1,041 | 88 of 88 files | all |
| 66 | 87 of 87 files with DOM 12 or later | 12 and later |
| 46 | 80 of 80 files with DOM 15 or later | 15 and later |
For example TextDefault keeps 264 of its 317 values,
TransparencyDefaultContainerObject all 352 and TextFramePreference
32 of 34.
Left out:
- 230 values that vary between files, for example the page size,
margins and grid settings, 53 values of
TextDefault(among them the font and point size) and 12 ofTextPreference. - The document setup the converter reads from the INDD (
objects.md):PageHeight,PageWidth,FacingPages,Intent,PageBindingand the four bleed offsets ofDocumentPreference. The converter writes its own values for these and adds the observed values for the rest of the element.ViewPreferencegetsRulerOrigin="SpreadOrigin", as before. - 3 values that name a style other than a root style, which the package
need not contain:
AppliedTextObjectStyleandAppliedGridObjectStyleofPageItemDefault,FootnoteTextStyleofFootnoteOption. - 20 values that only the 2 files with DOM 20 have. A value first seen in a later version is kept only when at least 10 files show it.
tools/element_values.py also collects the preference elements from all
827 IDML files of the larger corpus (paths Preferences/<tag> in
src/idml/element_values.xml), with its rule for other elements (per
range of DOM versions, at least 10 files). The converter adds these
values where preference_values.xml has none. They add, for example,
the auto-sizing values of TextFramePreference for DOM 8 to 11 and the
values of EPubExportPreference and HTMLExportPreference that all
files from DOM 8 on have. PageItemDefault values that name an object
style are written only when the package has that style.
Values kept despite unpaired files. XMLImportPreference
AllowTransform="false", ImportCALSTables="true",
ImportTextIntoTables="true", ImportToSelected="true",
RemoveUnmatchedExisting="false", RepeatTextElements="true" and
DictionaryPreference MergeUserDictionary="false" are the same in all
803 pairs. Two IDML files of the 827 differ: one in the six
XMLImportPreference values, one in MergeUserDictionary. Both were
exported by an earlier version than their INDD was last saved with, so
they are not pairs, and the INDD cannot show which field holds the
value. The values are probably stored in the INDD; with no pair that
varies, the field cannot be found. element_values.py keeps these
values from the other files (LATER_INDD_EXCEPTIONS).
DOM 7. The 7 DOM 7 references of the trustworthy pairs have no
EPubExportPreference and no HTMLExportPreference (7 of 7), though
preference_values.xml lists them for all versions (its source had one
DOM 7 file). The converter leaves both out before DOM 8.
Some of these values are probably stored in the INDD and may differ in a
document outside the corpus; none of them is read from the INDD yet. A
sample typeset vertically shows this: two 2-byte fields of the
preferences object (chunks 0xCD14 and 0xCD1C) are 1 there and 0 in all
250 distinct little-endian public files, and the values most likely to
depend on vertical layout (StoryPreference StoryOrientation,
DocumentPreference and MarginPreference ColumnDirection) are
written as observed. The print PDF cannot show which preference each
field holds, so they are not mapped.