Enhanced Tool Bar (ETB) for FrameMaker 14 and 15

Note: The official (marketing-) product name for FM version 14 is FM Edition 2017, that for version 15 is FM Edition 2019. However, program-internal 14 and 15 are used.

See also: Deutsche version; English version für FM 7.2/8.0; version for FM 9 to 11, FM 12, FM 13

Caveat

According to the licensing terms of Adobe, the modification of dlls may invalidate your licence.
Hence all installation programs which exchange a dll by a modified one request your confirmation.

What is it all about?

With FM-14 Adobe fell back into to the November look with grey icons. For FM-15 it was hard work to convince Adobe to provide coloured tool bar icons. Nevertheless ETB provides a full set of coloured tool bars for both versions, including addidional functions.

• Reasonable menu items and tool bars are added with all forms of icons (grey/coloured, regular/large)
• An enhanced version of the vertical tool bar is back. It fits nicely on facing pages thus reducing mouse miles.
• The Equation Palette has been enlarged for better legibility on high resolution screens..
• The ETB is active only in WYSIWYG View, both in unstructured and structured mode..
• "Standard" in this text refers to the original FrameMaker installation.
• Special ETB functions (such as special documentation) are found in menu Help > Enhanced Tool Bar
• You may wish to read the documentation

What's about FM updates?
Tool Bars
   Vertival Tool Bar
Workspaces
Special enhancements to FM:
   Context menu "Insert special symbols"
   Coloured cursors and tab indicators
   Utility TextHelper
   Documents
Download and installation
Uninstallation

What's about FM updates?

The Enhanced Tool Bar was developed for FM 14.0.1.406 resp 15.0.0.333. An update of FM may require an updated version of ETB. Look at Download and installation for an update of ETB.

1. Uninstall ETB before you update FM (use button Remove ETB of the installation program) – FM updating processes may not work with installed ETB.
2. When updating or re-installing FM, keep the preferences.
3. Update FM.
4. Install ETB again.

Tool Bars

FM-14: ETB replaces the grey icons of all sizes (regular, medium, large) in the tool bars.

FM-15: ETB supports all variants of the icon appearance: regular/medium/large. With ETB tool bars however, you always have coloured icons, whether you specify colour or grey icons.

Additional tool bars in ETB group buttons for paragraphs, characters and tables somewhat different than in the standard arrangement. This is to cope with additional functions:

ETB quick access ws	Save (icon is grey as long as document is 'clean'), save to an older version, import file, import formats, lock/unlock document, delete page, undo, redo, repeat, history. Buttons for help, open, print, copy are left out, because the keyboard short cuts for these are so common among applications that nobody will use buttons for these functions.
ETB paragraph bar	Paragraph catalogue, copy ¶ format , repeat last ¶ command, paragraph format drop down list, text alignment menu, tabulation menu, paragraph actions.
ETB character bar	Character catalogue, copy ƒ format, repeat last ƒ command, character format drop down list, convert text to lower case, mixed case, upper case; Insert special characters
ETB tables bar	Standard table commands + Added at left: insert table; table catalog Added at right: copy column width
ETB object properties	Standard object properties commands + Added Pick up Object properties
ETB object align	Standard tool bar got at left "information on moving objects".
ETB display	Display body pages, master pages, reference pages display in edting view, printing view jump back, jump next, scroll to previous screen, scroll to next screen.
ETB extra	Find/replace, find next Spell checking Equations palette, unwrap equation/frame, shrink wrap equation/frame Insert anchored frame, insert footnote Copy conditional text settings, show/hide condition indicators. Invoke vertical toolbar, start test script.
ETB Direction ETB TrackTextEdit

Tool tips for all Tool Bars show keyboard shortcuts where applicable.

Vertical Tool Bar

With ETB the vertical Tool Bar is back. It is very convenient to be placed on the margin area of a document thus saving mouse miles.
The upper part of the tool bar now show more useful buttons than those of the traditional vertical tool bar. Since no tool tips are available on this standard FM palette, you may need to look at the documentation or the image below:

Workspace

An additional work ETB space is defined:

You know that work spaces can be configured by the user - do so also with the ETB work spaces (add/remove tool bars, add/remove pods, iconise pods...). Save your modified workspace with a new name, to preserve the original ETB workspace.

Context menu "Insert special symbols"

The standard button for inserting special symbols has been replaced by a script to be able to insert also Unicode characters. You get the benefit to be able to modify the symbol table in this script.

Coloured cursors and tab indicators

Optionally coloured (magenta) cursors and TAB indicators can be installed to make them better visible.

Utilility TextHelper

After copying or cutting text to the clipboards this utility may help to get rid of unwanted features. Except for the two last functions it works for all Windows applications.

Icon	Hotkey	Function
This is in system tray	Windows+v	Paste the clipboard contents without formatting information, that is, just plain text (including line breaks). This functions is handy to copy from other applications, including web pages, but also within FrameMaker.
	Windows+space	Remove sequences of spaces to one before pasting the text (without formatting information).
	Windows+u	Change \ to / before pasting the text (without formatting information)Very useful to convert Windows paths to URL notation.
	Windows+y	Scroll both doc windows 1 page DOWN
	Windows+x	Scroll both doc windows 1 page Up

The latter two commands work only correct, if there are only two documents windows open (probably arranged side by side). No book window must exist either.

Documents

ETB provide PDF documents, which are not available in FM (FM help may be online only). For curious people even some still valid documents are provided.

Title in menu	Description (partly form the document)
Local User guide	PDF with the same content as the online Help system. The CHM file is accessed automatically, if no Internet connection is available for the online help. With ETB you can open it at any time. It is however often out of sync (older version) than the online help.
FrameMaker commands	This is a complete list of the commands available in FrameMaker. It has been generated with a script from itl. It lists the commands with their name, menu label, short cut and hexadecimal function code.
Templates, Samples & Clipart	Read-only FM file with hyperlinks to the various sample files and clip art files Clip art for diagrams (scales, grids) are added.
MIF Reference	MIF (Maker Interchange Format) is a group of ASCII statements that create an easily parsed, readable text file of all the text, graphics, formatting, and layout constructs that FrameMaker understands. Because MIF is an alternative representation of a FrameMaker document, it allows FrameMaker and other applications to exchange information while preserving graphics, document content, and format.
MML Reference	FrameMaker includes support for a markup language called MML (Maker Markup Language). You can use any standard text editor to create an MML file. Later, you can open the MML file as a FrameMaker document or import it into a FrameMaker template. In a department where different people are responsible for writing and formatting documents, writers can use MML statements to mark up manuals in progress; at the same time, graphic designers can create the formatting specifications in FrameMaker templates.
Customizing FrameMaker 14/15	This manual describes how to customize FrameMaker by changing settings in initialization files and creating custom menu configurations and tool bars. Based on the FM-7 manual from Adobe and various other sources.

Download and installation

1. You may wish to read the documentation before you decide about the installation.
2. Close FrameMaker. if necessary.
3. If you have ETB already installed and want to update with a newer version:
   • Run the installation program from the shortcut in the Start Menu
   • Use Remove ETB to de-install it from FrameMaker
4. Download the appropriate ETB installation file
   Note: the full FM-version is only relevant for the installation of the opional GUI enhancements (replacement of DLLs)
   

Full FM version	ETB version	ETB Installation file	Date	Latest changes
14.0.2.425 14.0.3.500 14.0.4.511	7.1	Inst-FM14-ETB-en.zip	2017-06-26	The provisional version for FM 14.0.0.361 and 14.0.1.406 is no more supported. For FM-14 with correct icon handling. Script Saving As Old Version now warns the user about the fact that after Saving As Old Version the next ordinary save will save to the same location - not to original document location!
			2017-07-12	Correction of some bugs (mainly to parallel the German version).
	7.2		2017-10-31	Installation part was not able to handle various builds.
	7.3		2017-11-28	Adaptation to FM-build 500 (dll modification).
	7.4			Not published.
	7.5		2018-03-05	Installation corrected for x64 systems. New name for installtion file (…ETB… rather than …toolbars…).
	7.6		2018-09-11	Workspace ETB corrected (caused FM crash with double click on text inset to get Text Inset Properties)
15.0.0.393 15.0.1.430 15.0.2.503	7.5	Inst-FM-15-ETB-en.zip	2018-08-27	First issue of ETB for FM-15.
	7.6		2018-09-11	Workspace ETB corrected (caused FM crash with double click on text inset to get Text Inset Properties)

Note: FM-help (PDF, chm) and additional documentation may not be available from Adobe for the first issue - hence document content may be for the previous FM version. ETB will be updated as soon as the documents are available.

5. Expand the downloaded ZIP to the Desktop. You should get only 2 items: file PrepInstall-etb-en.exe and directory InstallETB
6. Execute PrepInstall-etb-en.exe . The Picture shows the installation programs for ETB-13
   

   	To release some Windows burden from the user, a first step collects necessary information. And to avoid too much trouble with the User Access Control the installation files are put into the User Area/D+DD. Then Continue Installation.
   	File structure set up in %appdata%\D+DD\FM14-toolbars-en\ ETB etb_icons etb_scripts toolbars WorkSpaces config.ini FM-puzzle.ico Install-FM-etb.exe

7. Check the box if you want to also install coloured cursors and tab icons together with the Enahnced Tool Bars
8. Use Install ETB to install the ETB functionality.
9. After a short time a message box indicates successfull installation (see first note below).

Notes

• There are cases – especially in companies where only an admin may install programs – where files can not be copied to the user area. In this case only manual installation according to the method mentioned in the documentation will help: see heading Possible installation problems..
• All software from D+DD is Donationware - if you find it helpful for your work, think about supporting my work.

What is installed on your computer ?

• For FM-15 the procedure is analogous.
• A shortcut (De)Installation FM14-tool bars en is placed in the Start Menu folder All Users\Programs. You may move the shortcut to any sub folder.
• The following files are copied to the required locations:
  • Workspaces and tool bars to %APPDATA%\Adobe\FrameMaker\14\WorkSpaces (both Structured and UnStructured, Wysiwyg view)
  • Additional icons to %APPDATA%\Adobe\FrameMaker\14
  • The customisation file, documents, vertical tool bar and utility TextHelper to $HOME\fminit\configui
  • The to $HOME\fminit
  • The enlarged Equations editor to $HOME
  • The modified fmcustom.dll and fmres.dll to $HOME\fminit
  • The additional clip art to $HOME\clipart

%APPDATA% is the symbolic name for the User area. The real path name depends on the OS.
$HOME is the installation directory of FrameMaker.

Uninstallation

If you want to get rid of the enhancement and go back to the original FM installation:

1. Start the installation with the shortcut in the Start Menu and click Remove ETB .
2. All files of this installation will be removed (tool bars, work spaces, icons, config files, clip art, added. documentation).
3. FrameMaker 14 will copy the original tool bars into the user area at its next start.
4. Since this is not a Windows un-installation, you must delete the installation directory and the short cut manually to get rid of all items. On the other hand this allows to install the Enhanced Tool Bar again later.