The default values for these parameters should be sufficient
for most people, but there are reasons that you may want to change
the default behavior. The following settings must be changed manually
in the ditafmx.ini file.
- INIOnly section
LastReferencedElement - Record of the last element
tag selected in the Reference Manager to allow access to last referenced
elements.
ForceTablesWide - If set to 1, tables are forced to
fill the text column (or page if the pgwide attribute is set to
1). This overcomes a limitation where under certain circumstances
tables are not rendered full width in Book builds. If your EDD already
handles “pgwide” tables, you may need to disable this functionality
by setting ForceTablesWide to 0.
StructappsFile - If set, this file is used as the
structapps definition file. In order for this to function properly
you must also have set the Directories/StructureDir parameter in
the maker.ini file.
XrefElements - A vertical-bar delimited list of element
names that defines the elements that are valid as xref or link targets.
For example, setting XrefElements to the following string limits
the xref targets to the elements specified:
- XrefElements=topic|concept|task|reference|section|dt
DitaFMxGuide - Specifies the name of the DITA-FMx
User Guide Help file (relative to the DITA-FMx folder).
DitaHelpKeys - Specifies the shortcut keystrokes to
launch context-help for DITA authoring (this runs the “DitaReference”
Help file).
DitaReference - Specifies the name of the DITA Reference
Help file (relative to the DITA-FMx folder).
DitaRefTargetType - Specifies the file extension of
target topics in the “DitaReference” Help file for context sensitive
Help.
MapFromOutlineTemplate -
Specifies the “Map from Outline” template file used as the template
for the New ‘Map from Outline’ Template command.
The default value for this parameter is “$STRUCTDIR\xml\DITA-FMx\map-from-outline_template.fm”.
- INIOnly section (for use with
the Set Attributes command)
SetAttrIgnore - Specifies the
attributes to ignore (and not display) in the dialog. This is a
vertical bar delimited string. By default this is set to the following
values, you can change these values as needed.
xtrc|xtrf|xmlns|class|xmlns:ditaarch|ditaarch:DITAArchVersion|domains
SetAttrStrings - Specifies an
INI file that defines additional “default” values for the indicated
“Strings” attributes (the default value of this parameter is FilterGroups.ini).
These default values are organized into named groups which can be
associated with a specific file system path. All topic files that
fall within the specified root path are mapped to that group. Each
group lists one or more attributes and a vertical bar delimited
list of default values for that attribute. This lets you provide
alternate filtering options for different projects that use the
same structure application without modifying the EDD.
Unless
the value of the SetAttrStrings parameter specifies an absolute
path and file name, it is relative to the FrameMaker\DITA-FMx folder.
If you use a SetAttrStrings file, no default values need be set
in the EDD at all. This adds flexibility to the EDD not otherwise
obtainable. For more information and details, see Set Attributes.
SetAttrStringsDefault - Specifies
the “default” value that is ignored when displaying the list of
defaults.
Note: This INI parameter is for very specialized
and atypical use. Unless you are doing special FDK processing using
attributes of type “Strings” you can safely ignore the following
information.
When you specify default values to a Strings
attribute in the EDD, the first default may be used as the actual
default for certain types of processing. If you want to specify
a special value as the first default so that your processing can
match on it and ignore the value, enter that string as the value
for the SetAttrStringsDefault parameter. A likely value is the dot (“.”)
character, but you can specify any value that makes sense for your processing.
If you specify this value, it will be ignored and excluded from the
options displayed in the Set Attribute dialog.
If you do not
have processing that cares about the initial default value of a Strings
attribute, you can ignore this parameter.
- GeneralImport section
IndextermProcessing - If set to 1, enables conversion
of indexterm elements to proper format required by FrameMaker.
TableProcessing - If set to 1, enables the counting
of table columns for proper import of simpletable and other table
types into FrameMaker.
UseLanguageTemplate - If set to 1, enables the use of language-specific template
files. When opening a DITA XML file, if the “topic”/@xml:lang attribute
specifies a value, the plugin checks for a language template in
the same folder as the default template. The language template must
be named “<templatename>.<langval>.fm” (the “.fm” extension
is optional, but if the default template includes the extension,
the language template must also. For example, if your default template
is topic.template.fm, a Japanese language template
would be named topic.template.ja-jp.fm (assuming
that “ja-jp” was the value in the xml:lang attribute).
- GeneralExport section
IndextermProcessing - If set to 1, enables conversion
of indexterm elements from the format required by FrameMaker back
to one required by DITA.
XrefProcessing - If set to 1, enables processing and
conversion of xrefs and links.
CrossRefToXref - If set to 1, enables the conversion
of FM-based cross-references to DITA-based xrefs and links.
DitaXrefElem - Defines the element name to use when
mapping FM-based cross-refs to DITA xrefs on file export (only used
if GeneralExport/CrossRefToXref is enabled).
DitaLinkElem - Defines the element name to use when
mapping FM-based cross-refs to DITA links on file export (only used
if GeneralExport/CrossRefToXref is enabled).
IgnoreElemPrefix - If you use elements in FrameMaker
that do not exist in the DITA DTDs, you should make sure they all
have the same prefix (“fm-” for example). This INI setting specifies
that prefix. This is required for proper generation of conrefs on
export, and should be used in conjunction with any read/write rules
that may be needed.
- TableImport section
SetColumnsProp - If set to 1, enables the automatic
assignment of the “columns” property.
SetColumnWidthsProp - If set to 1, enables the automatic
assignment of the “column width” property.
CustomTableCount and N - Specifies the
number of instances of simpletable elements that have been specialized
that need to be automatically analyzed for their column number.
The Count value should match the number of N values.
Each N value should have the following format: “<table-element>|<row-element>|<cell-element>”.
- BuildFile section
AntCommand - Specifies the command or path/command
used to run Ant. The default is “ant”, but if you need to specify
another executable or if you need to include the path, change this
value. This value is used for both Generate Output options, Current
File and Selected Target.
EnvironmentSetup - Specifies a batch file to run before
the Ant script in order to set up any needed environment variables.
AntScript - Specifies the filename of the Ant script
that is run for the Generate Output: Current File option. The default
is “ditafmx-ant.xml”, but if you need to specify another filename,
change this value. This filename is assumed to be relative to the
path specified by the DitaDir parameter.
Count and N - Specifies the number of
build options available in the AntScript file (and thus displayed
in the Generate Output: Current File output option). If you modify
the targets in that script, be sure to update the Count value
and add/remove the related N value.
- AntBuild section
Count and N - Specifies the number of
“ANT:” sections which define the available build options displayed
in the Generate Output: Selected Target output option. For each
“ANT:” section added, you must update the Count value and
add/remove the related N value. The value of each N parameter
must exactly match the text following the “ANT:” section name.
- ANT:build name section
BuildFile - Specifies path and filename of the associated
Ant script (use double backslashes as the directory delimiter).
EnvironmentSetup - Specifies a batch file to run before
the Ant script in order to set up any needed environment variables.
Target - Specifies target within the BuildFile.
OutputDir - Specifies the path to the output directory
(use double backslashes as the directory delimiter).
Logfile - Specifies the path and filename to the log
file (use double backslashes as the directory delimiter).
- DitavalFiles section
Each parameter and value in this section define a “friendly
name” and path/filename for a ditaval file. These ditaval files
must be created manually and added manually to the INI file in order
to be recognized by the Generate Output command and the Apply Ditaval
as Conditions command.