Configuring jump lines

Build 1501 on 14/Nov/2017  This topic last edited on: 20/Sep/2016, at 15:26

You need to configure jump lines before using them, either on the system, or on the personal level. This topic describes the jump line items, placeholders #, £, %, @1 and @2 and modifiers ^ and #X and explains how the set them.

System-level jump lines are equal for all the users of the GN4 system, while personal jump lines are per user.

A Fred4 user can select whether to use global or personal jump lines (Edit > Preferences > Extra > Jump lines > Use global jump settings instead of below settings).

If the jump lines are not correctly configured, Fred4 can display various error message and abort insertion of jump lines.

hmtoggle_plus1Jump lines items, placeholders and modifiers

There are four items to configure for each jump line type, e.g. "jump to" and "jump from" jump line. These are: margin, height, head element name and tags.

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

The margin between last frame and the jump line frame.

Leave at 0 if the top spacing is defined with tags within the jump line frame, otherwise, enter a suitable value, e.g. 10pt.

Typically 0, as you normally want the top jump line to be appear over first body frame (pushing the body text down), and be vertically aligned with other body frames.

Height

The jump line frame height, e.g. 30pt.

Define it high enough to accommodate all content, especially if multi-line.

Head element name

The name of the article element from where the jumpline content is taken. This assumes you will a jump head element specified in your schema.

Typically, enter the name of the jumphead element.

You can also prefix it by a #number: in that case, the specified number of words is taken from the specified element name.

 

The name of the article element from where the jumpline content is taken.

It is typically the name of the article head element.

Since v1.4.1515.x you can also use a manual jump line content and section/page number. See placeholders &1 and &2 for that purpose.

Tags

Tags, placeholders, and modifiers, to be used to format and display jumpline content.

Placeholders can appear only in the Tags item. Supported placeholders are:

#placeholder for the page number. When used in tags for the "jump to" jump line, it is the jump page number; when used in tags for the "jump from" jump line, it is the original page number.
£placeholder for the section name. It is always the name of the original page section.
%placeholder for the headline content.  When used in tags for the "jump to" jump line, it is the jump headline; when used in tags for the "jump from" jump line, it is the main headline. When used in a style, use ! for prefix and suffix, eg. !%!
&1placeholder for the jumpline content (manually set, from an article attribute). When used in tags for the "jump to" jump line, it is the content of the article attribute specified in EdConfig.glbJumpLineAttr - by default it is an empty string). If specified together with &2, causes a dialog box to appear, prompting you to manually enter the jumpline content and the section/page. This is available since the version 1.4.1515.x.
&2placeholder for the jumpline section/page (manually set). When used in tags for the "jump to" jump line, it is the string you entered when prompted. This is available since the version 1.4.1515.x.

Modifiers in the Tags item:

^new paragraph

Modifiers in the Head element name item:

#Xnumber of words to take from the jump head element, eg. #1 for the first word.
hmtoggle_plus1Jump lines examples

1. Simple jump line

This example of a simple jump line displays the right aligned text "Continues on page 3" on the starting page, and "Continued from page 1", on the jump page. # stands for the page number:

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

jumphead

head

Tags

>pqr<Continues on page #

Continued from page #

2. Jump line with section name

This example of a jump line displays the right aligned text "Continues on page A3" on the starting page, and "Continued from page A1", on the jump page. # stands for the page number, and £ for the section name. The section name is read from the section to which page is assigned. Both starting and jump page must belong to the same section.

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

jumphead

head

Tags

>pqr<Continues on page £#

Continued from page £#

3. Jump line with entire jumphead and section name

This example of a jump line uses the jumphead (let's assume its content is "Mellow yellow"), and displays the right aligned text "See 'Mellow yellow' on page A3" on the starting page, and "Continued from page A1", on the jump page. This assumes the article contains the jumphead element. # stands for the page number, £ for the section name and % for the content of the jumphead. The section name is read from the section to which page is assigned. Both starting and jump page must belong to the same section.

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

jumphead

head

Tags

>pqr<See '%' on page £#

Continued from page £#

4. Jump line with partial jumphead and section name

This example is similar to the example 3, but the special sign #1 before jumphead instructs Fred4 to take only the first word of the jumphead. Of course, you can also put #2 for first two words and so on.

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

#1jumphead

head

Tags

>pqr<See '%' on page £#

Continued from page £#

5. Jump line with partial jumphead and section name (styles)

This example assumes you have two styles: "cont" style for the "jump to" jump line, and "jump" style, for the "jump from" jump line. The "cont" style requires two parameters: jumphead and section, while the "jump" style requires one parameter: section. Note that in this example, styles also contain some embedded text and page number.

Note: the above requires that in the J library (or in any other library that gets automatically assigned to local texts) there are styles with tag names "cont" ad "jump", otherwise, it won't work. See paragraph "Jump lines and custom styles" for more info.

This jump line uses jumphead (content="Mellow yellow"), and displays right aligned text "See 'Mellow yellow' on page 3A" on the original page, and "Continued from page 1A", on the jump page.

Please notice the use of delimiter "!" to support multi-words in a style parameter.

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

jumphead

head

Tags

>cont !'%'!, !£!<

>jump !£!<

6. Jump line that prompts you for the content and section name

This example of a jump line uses the manually entered content and section and displays right aligned text (assuming you entered "Antispecism" as jump line content and "B" as section, and the article jumps on page 4), See 'Antispecism' on 4B on the original page, and two lines jump line on the jump page with the Antispecism and in new paragraph Continued from 1B".

Field

"Jump to" jump line (bottom)

(on the original page)

"Jump from" jump line (top)

(on the jump page)

Margin

10pt

0pt

Height

20pt

20pt

Head elt.

does not matter

head

Tags

>pqr<See '&2' on #&1

@2^Continued from #&1
hmtoggle_plus1Configuring global and personal jump lines

Configure global jump lines in the <Dict> node of the EditorialConfig (EdAdmin4 > Applications Configuration > search for EditorialConfig).

If global jump lines are not configured, the following defaults are used (defined under EdConfig class of Ted.vb): margins = 0pt, height = 20pt, tags = empty, article jumpline attribute = empty

Notes

•Empty tags values prevent users to use global jump lines unless System Administrator configures them first.

•In case you want to use &1 and &2 placeholders, you need to define first the name of custom article attribute in your GN4.XSD schema and then specify its name in the editorialconfig as:

<Item Name="glbJumpLineAttr" Value="custom_attr_name" />

Have in mind it's potentially dangerous operation that can bring your entire system to a halt. Ensure that you are familiar with modifying the schema before proceeding.

These are the sample steps:

1.Add the attribute to the "articleExtra" section of the GN4.xsd schema

<xs:element name="mdp_jumpline" type="xs:string" minOccurs="0">

  <xs:annotation>

    <xs:documentation>Custom jumpline variable</xs:documentation>

  </xs:annotation>

</xs:element>

2.Run SRV4 DBUPDATE to import the modified schema.

3.Add an entry into the <Dict> section of EditorialConfig

<Item Name="glbJumpLineAttr" Value="mdp_jumpline" />

4.Modify EditorialConfig to insert the correct jump styles for “to” and “from”

5.Use CMD4 to import the changed EditorialConfig.

6.Preform IISRESET on the GN4 server.

7.Restart FRED4 and retry.

Field

"Jump to" jump line (bottom)

(on the original page)

Example of values

"Jump from" jump line (top)

(on the jump page)

Example of values

Margin

F_JumpBotM

0pt or more

F_JumpTopM

0pt or more

Height

F_JumpBotH

5pt or more pt

F_JumpTopH

5pt or more

Head elt.

F_JumpBotC

jumphead

F_JumpTopC

head

Tags

F_JumpBotT

&gt;cont !%!,!£!&lt;

F_JumpTopT

&gt;jump £&lt;

Attribute

glbJumpLineAttr

"custom_attr_name"

n/a

n/a

Important:

•In the F_JumpTopT and F_JumpBotT it is not allowed to enter > and < as GNML tags delimiters. Use &gt; as the replacement for > and &lt; as <. Moreover, you must not enter the & character as is (for &1 and &2 placeholders), but &amp;1 and &amp;2.

•For all content that can be multi-word, when it is a parameter of a GNML style, use ! around placeholders, e.g. !%!. Such delimiters are not required if you are using tags or styles where the content is not a parameter.

An example of the jump lines configuration to use with styles

    <!--jumpline on the original page ("jump to") -->

    <Item Name="F_JumpBotM" Value="10pt" />

    <Item Name="F_JumpBotH" Value="20pt" />

    <Item Name="F_JumpBotC" Value="jumphead" />

    <Item Name="F_JumpBotT" Value="&gt;cont !%!,!£#!&lt;" />

 

    <!--jump line on the jump page ("jump from")-->

    <Item Name="F_JumpTopM" Value="10pt" />

    <Item Name="F_JumpTopH" Value="20pt" />

    <Item Name="F_JumpTopC" Value="" />

    <Item Name="F_JumpTopT" Value="&gt;jump £&lt;" />

 

Note: the above requires that in the J library (or in any other library that gets automatically assigned to local texts) there are styles with tag names "cont" ad "jump", otherwise, it won't work. See paragraph "Jump lines and custom styles" for more info. Moreover, the style "cont" should have two string parameters, one for label, and another for section/page.

An example of the jump lines configuration to use with GNML tags

    <!--jumpline on the original page ("jump to") -->

    <Item Name="F_JumpBotM" Value="10pt" />

    <Item Name="F_JumpBotH" Value="20pt" />

    <Item Name="F_JumpBotC" Value="#1jumphead" />

    <Item Name="F_JumpBotT" Value="&gt;pqr&lt;See %, £#" />

or

    <Item Name="F_JumpBotT" Value="&gt;pqr&lt;See '&amp;1', &amp;2" />

and

    <!--jump line on the jump page ("jump from")-->

    <Item Name="F_JumpTopM" Value="10pt" />

    <Item Name="F_JumpTopH" Value="20pt" />

    <Item Name="F_JumpTopC" Value="" />

    <Item Name="F_JumpTopT" Value="&gt;hld 12pt £&lt;Continued from #" />

Note: as the above does not use any custom tags, it does not require any changes in the style libraries.

Any user can configure personal jump lines. On the Edit menu, click Preferences, and then click Extra tab. Now, click Jump lines and enter values.

For details, see the paragraph "Jump lines items, placeholders and modifiers".

jumplines

Example of tags for the top jumpline (two lines)

>f 451<Continued from >f 463<'%'^>f 451<Page #

Example of tags for the bottom jumpline (two lines)

>f 451<Continues on page >co M<#>co K<^>f 463<See '%'

Example of tags for the bottom jumpline (manual)

>f 451<See '&1' >f 123<on >f 463<&2
hmtoggle_plus1Jump lines and custom styles

If you want to format jump lines content with custom styles, select an appropriate style library where to create such styles.

Have in mind that, by default, when on a page in Fred4 you create a new frame with local text (and jump line frames are actually that), the typographical format that Fred4 assigns to such frame is the format assigned to a master page.

To review which format is assigned to a given master page, open it in Fred4, and then on the Layout menu, select Master format. The format name is displayed in the dialog box.

Therefore, you need to create jump line styles in any library that is linked to that format, unless you decide to change manually, every time, the format of the jump line frame.

The styles required by default are: "cont" style for the "jump to" jump line, and "jump" style, for the "jump from" jump line. The "cont" style requires two parameters: jumphead and section, while the "jump" style requires one parameter: section. Note that in this example, styles also contain some embedded text and page number.

About defaults

By default, the typographical format J gets automatically assigned to all new master pages in editions created from scratch. The J format by default contains only the J style library. Therefore, a good place for the custom jump line styles would be the J library.

Of course, if you are using custom edition templates to create new editions, the master format will be the one you've assigned to master pages in a custom edition template. Having in mind that you can also decide to assign different master format to each master page, the thing becomes complicated: to have working jump lines with custom jump styles, all formats for all master pages need to be linked to the style library that contains jump line custom styles.

As you can link more style libraries to each format, this is not a problem - but you have to be aware of described mechanism.
Click to toggle expandJump lines and variables

Enable global: fr_useglobaljumpline

Top jumpline tags: F_JumpTopT

Top jumpline headline type: F_JumpTopC

Top jumpline height: F_JumpTopH

Top jumpline margin: F_JumpTopM

Bottom jumpline tags: F_JumpBotT

Bottom jumpline content (article element name): F_JumpBotC

Bottom jumpline height: F_JumpBotH

Bottom jumpline margin: F_JumpBotM