FrameMaker 11: INI reference documentation now available – maker.ini and ditafm-output.ini


FrameMaker INI reference documentation is now available.

Using the INI documentation, you can:

  1. Create professional looking PDFs from DITA content – ditafm-output.ini
  2. Modify FrameMaker’s default behaviour  – maker.ini

1. Professional looking PDFs from DITA content

Creating clean, good looking PDFs from structured content is either difficult, expensive, or both.

  • XSL-FO is free but complex and offers limited options
  • Paid tools do a better job than XSL-FO, but …
  • The easiest and best PDF are created by saving/printing a FrameMaker book.  (But, if only we could create a book from a ditamap and then create a PDF from it, we would have the PDFs that are nice to look at as well as easy to create.)

FrameMaker 11 allows you to create a book from a ditamap. Then you can save/print this book to a professional looking PDF. You do not need to install or buy a plug in and you need not master XSL-FO. FrameMaker 11 includes an ini file using which you can configure the components, look-and-feel, footnotes, and templates of the book you create from a ditamap.  You can then save the book to a PDF, just like an unstructured book.

The ditafm-output.ini gives you the control of all the aspects of a book. With ease, you can use notepad or another editor to set the various options in the ini file and create a FrameMaker book. Using the ini file, you can configure:

• How a DITAMAP is converted to a book

• Whether to generate files such as ToC, Index, and Table of References or not.

• What should be the order of the files in a book

• Which templates are to be used for creating various files of the book

• Contents of these files

• Page numbering

• Footnotes and table footnotes

• Table titles

• And more

 

A  minimal use case: steps

For a quick demo of this feature:

1. Open the ditafm-output.ini file (at %appdata%\Adobe\FrameMaker\11\) and set the following options:

Option

When set to 0

When set to 1

GenerateTOC

ToC is NOT generated in the output book

ToC IS generated in the output book

GenerateIndex

Index is NOT generated in the output book

Index IS generated in the output book

GenerateBookTitlePage

Book title page is NOT generated in the output book

Book title page IS generated in the output book

 

Option

Detail

OutputFilesOrder

 

Specify the order of the files in the output. Use the following values delimited with pipelines to specify the order: BookTitle|TOC|Files|ListofFigures|ListofTables|Index.

For a detail of all the flags, see documentation.

2. Save a ditamap as “Book 11.0 with fm components.” FrameMaker creates a book.

 3. Review the book and make any required changes in the ini file. Regenerate the book.

Like the test drive? Check out the documentation to know all the options.

2. Initialization settings in maker.ini file

Adobe FrameMaker uses an ini (initialization file) to set many application and user preferences. By changing it, you can modify FrameMaker’s default behavior according to your needs.  Maker.ini is an important initialization file and it controls many aspects of FrameMaker including:

  • Pasting from clipboard
  • Preferences (spelling, interface etc)
  • API Clients
  • Structured Authoring preferences
  • CMS preferences
  • Handing unavailable fonts in documents

And more. Once you edit the maker.ini file, changes take place the next time you launch FrameMaker.

Information about a lot of important flags that help you do the above and more are available in the INI Reference documentation. Maker.ini documentation is being worked on and information on rest of the flags will be made available soon.