[Main topics] [Navigation]

Navigate in document

Deutsche fassung

This ExtendScript allows you to navigate in a document with a tree view of the header paragraphs in a palette.
Bjørn Smalbro (FrameMaker.dk) made a video for this script (and the famous Archive script by Rick Quatro).

The script adapts its UI language to the FM-UI-language (de, en, fr).
L'interface utilisateur française a été créée avec le service web DeppL (https://www.deepl.com/translator).

Note: This function will be integrated into ETB14up

Tree view of headings in document

The tree view in the palette provides hypertext jumps to heading paragraphs of up to 4 levels.

In unstructured FrameMaker it is allowed to violate the rules of a homogeneous structure. You may start with a sub- level title and place a top title amidst the document. To be able to set up a tree view for this 'structure' it may be necessary to inset dummy entries in the list of titles. In the picture to the left you see these highlighted.

Working with the tree

  • Initially You see the full tree expanded. You may wish to resize the window.
  • Collapse to the top level items with button Collapse.
  • Expand the full tree with button Expand.
  • Branches can be expanded by clicking on the + symbol and collapsed by clicking the - symbol.
  • Jump to the document location by clicking (not double clicking) on a line (which is not indicating a pseudo level) .
  • Go back to the previous target with button << (Back). Thus you can walk back the chain of visited document locations.

Determination of level

Button Define opens a dialogue to change the settings for the level definitions. It shows the current settings:

Dialogue Define heading levels

The levels are determined by means of a tabular definition which is kept in the file ETBextras.cfg in the Script directory, normally %appdata%\Adobe\FrameMaker\vv\StartUp\ETBextras\.

Multiple paragraph formats can be defined for a particular level. The initial table specifies heading levels for the standard FrameMaker templates (en, de, fr) and for the D+DD templates.

Separate the format names in a line by a semicolon immediately before the next name.

Misconfiguration of this table may lead to en empty tree which is reported by an error message.

Further functions

Refresh button: You need to use this button if you have changed heading paragraphs (e.g. inserted or deleted a heading, changed a heading text).
You must also refresh the tree after changing the document.

See the heading tags: If you want to see the heading tag names rather than the heading texts, check the box at the bottom and use Refresh.

Clicking on the tree item does nothing: This may happen, if you have used the Jump Back button form the ETB tool bar rather than the << button on the panel. Just select any other target in the tree and then the desired one.

Initial size and placement

The palette is initially placed to the right side of the FM window. This placement can be overridden by settings in ETBextras.cfg:

[ETBdocNav]
; --- Initial width and height of tree display (see documentation)
Tree_width = 250
Tree_height= 100
; --- Initial position of the palette from top and left of screen ... (see documentation)
DocNav_top = 10
DocNav_left= + 0

DocNav_left can indicate 3 locations:

xxx The palette is positioned xxx pixels from the left of the screen (absolute placement).
+xxx The palette is positioned xxx pixels to the right of the FM window.
-xxx The palette is positioned to the left of the FrameMaker window with a gap of xxx pixels.

Tree_height defines the height of the tree view - this is only part of the palette height. A value < 250 leads to a palette hight the same as the FrameMaker window heigh.

[To top/bottom of page] Downloading and installing the script ETBdocNav

Note: All software from D+DD is Donationware - if you find it helpful for your work, think about supporting also my work.

  1. Close FrameMaker if necessary.
  2. Download the script file
  3. Date FM version Installation file(s) Latest changes
    2020-03-02 10 and later ETBdocNav.zip First issue of ETBdocNav stand alone version
    2020-03-07
    • Removed: defintion of levels by regular expresssion
    • Added: dialogue for defintion of levels by tabular data
  4. UnZip the file to a directory of your liking.
  5. Move the script ETBdocNav.jsx and the file ETBextras.cfg to %appdata%\Adobe\FrameMaker\vv\Startup\ (vv being 10 … 15).
  6. Start FameMaker. You will see a new menu item at the bottom of the View menu.
  7. In a German or French FrameMaker installations the menu and all messages are in the corresponding language.

[To top/bottom of page] Navigation im dokument

Mit diesem ExtendScript kann aus einer palette mit baumansicht direkt ins dokument gesprungen werden.

Das skript stellt sich auf die FrameMaker benutzher-sprache ein. (de, en, fr).

Hinweis: Diese funtkon wird in ETB14up integriert werden.

Tree view of headings in document

Die baum-ansicht in der palette enthält hypertext links zu den überschriften im dokument. Es werden bis zu 4 ebenen unterstützt.

Im unstrukturierten FrameMaker ist es zulässig, die regeln einer homogenen struktur zu brechen. Es darf zb mit einem untertitel begonnen werden.
Um einen baum für eine solche 'struktur' erstellen zu können, müssen hilfs-ebenen eingebrachte werden. Diese sind links gelb hervorgehoben.

Arbeit im baum

  • Zu beginn ist der baum voll entfaltet. Das fenster kann in in grösse und position verändert werden.
  • Reduzieren zeigt nur die höchsten überschriften an.
  • Erweitern zeigt den vollständigen baum an.
  • Zweige werden mit klick auf das + geöffnet. Klick auf das - zeichen reduziert den zweig.
  • Sprung ins dokument erfolgt durch klick (nicht doppelklick) auf eine überschrift (keine pseudo-ebene).
  • Zur vorhereigen zielstelle wird mit << (Zurück) gesprungen. So kann die gesamte sprungfolge zurück gegangen werden.

Bestimmung der ebenen

Schaltfläche Definieren öffnet den folgenden dialog zur inspektion oder modifikation der ebenen-definitionen:

Dialog zum definieren der überschriften-ebenen

Die ebenen werden mit einer tabelle in der datei ETBextras.cfg im skript-verzeichnis definiert. (meist in %appdata%\Adobe\FrameMaker\vv\StartUp\ETBextras\).

Es können mehrere absatz-formate für eine bestimmte ebene angegeben werden. Die ausgelieferte tabelle definiert formate für die FrameMaker standard vorlagen und die D+DD vorlagen.

Weitere format-namen auf einer zeile folgen unmittelbar nach einem semikolon.

Eine fehlkonfiguration der tabelle kann zu einem leeren baum und entsprechender fahlermeldung führen.

Weitere funktionen

Schaltfläche Aktualisieren: Diese wird gebraucht, um nach änderungen von überschriften im dokument den baum zu aktualisieren.
Der baum muss auch neu aufgebaut werden, wenn das dokument gewechselt wird.

Stilnamen anzeigen: Um die stilnamen anstelle der überschriften-texte zu sehen, das kästchen aktivieren und dann Aktualisieren antippen.

Klick in den baum bewirkt nichts: Das kann nach der benutzung von Sprung zurück (in der ETB werkzeugleiste) vorkommen. In diesem fall ein anderes ziel anspringen und dann das gewünschte.

Platzierung und grösse

Die palette wird zunächst rechts des FM fensters platziert. Diese platzierung und die grösse des baumes kann in der datei ETBextras.cfg überschrieben werden:

[ETBdocNav]
; --- Initial width and height of tree display (see documentation)
Tree_width = 250
Tree_height= 100
; --- Initial position of the palette from top and left of screen ... (see documentation)
DocNav_top = 10
DocNav_left= + 0

DocNav_left kann drei verschiedene orte angeben:

xxx Die palette wird vom linken bildschirm-rand her auf position xxx pixels gesetzt.
+xxx Die palette wird bezogen auf den rechten rand des FrameMaker fensters xxx pixel gesetzt.
-xxx Die platte wird bezogen auf den linken rand des FrameMaker fensters mit xxx pixel zwischenraum abgesetzt..


Tree_height definiert die höhe des baumes - dies ist nur ein teil der höhe der palette. Ein wert <250 führt dazu, dass die palette so hoch gemacht wird wie das FrameMaker fenster.

[To top/bottom of page] Download und installatin des skriptes ETBdocNav

Hinweis: Alle D+DD software ist Donationware - Wenn meine arbeit hilfreich für Deine arbeit ist, denke daran, meine arbeit zu unterstürzen

  1. FrameMaker schleissen, falls erforderlich
  2. Skrip datei herunter laden:
  3. Date FM version Installation file(s) Latest changes
    2020-03-02 10 und später ETBdocNav.zip Erste ausgabe der einzel-version von ETBdocNav
    2020-03-07
    • Entfernt: definition der ebenen durch regulären ausdruck
    • Neu: dialog für die definition der ebenen via tabelle
  4. Herunter geladene datei an einen beliebigen ort expandieren (zb auf den Desktop)
  5. Skript ETBdocNav.jsx datei ETBextras.cfg nach %appdata%\Adobe\FrameMaker\vv\Startup\ (vv ist die FM version 10 … 15) verschieben.
  6. Nach dem start von FrameMaker erscheint ein zusätzlicher menupunkt am ende des Anzeige menus.
  7. In a German or French FrameMaker installations the menu and all messages are in the corresponding language. To bottom of page To top of page
[Main topics] [Navigation]
 URL:  Created: 2020-03-02  Updated:
© Docu+Design Daube, Zürich    
  Business of Docu + Design Daube Documentation issues Sharing information Klaus Daube's personal opinions Guests on this site Home of Docu + Design Daube To main page in this category To first page in series To previous page in series To next page in series To bottom of page To top of page Search this site Site map Mail to webmaster To bottom of page To top of page