Macro Language Reference > Macros > Text (Frame Level) > tmark
  
tmark
Description
Inserts a bookmark destination command at the text cursor position.
This macro is enhanced from release 10, to allow the generation of external bookmarks whilst formatting without having to resort to executing tpmkset macros.
 
Example 287. Generate an inline external bookmark using tmark
tmark "link1","","*http://www.ptc.com"
This macro will insert the PI <?"link1",13,"","*http://www.ptc.com"> to the document. This is turn will create the URI bookmark called “link1”.
Syntax
tmark bookmark name:t ',' description:t ',' remote file:t (',' remote name:t (',' fit mode:n (',' no outline:n (',' level:n (',' pagenum:n )? )? )? )? )?
tmark
[no parameter]
Invoke the Insert Automatic Bookmark dialog box.
bookmark name
The name of bookmark stream to create for the bookmark.
Must be declared in double quotes
description
A description of the bookmark: up to 127 characters. The description will be used as the name of the link in PDF output. If no description is defined the value of bookmark name will be used.
Must be declared in double quotes
remote file
The filename to be used when pointing a bookmark to another document or a URI if the * prefix operator is used.
Must be declared in double quotes
If pointing to a URI the next parameters are not required.
remote name
The bookmark name to be used when pointing a bookmark to another document.
Must be declared in double quotes
fit mode
0
All
1
Width-Top
2
Width-Center
3
Width-Bottom
4
Height-Left
5
Height-Center
6
Height-Right
7
Does not fit (does move)
no outline
Determines whether this bookmark should be excluded from the PDF bookmark list.
0
Include
1
Do not include
level
The level at which a bookmark should be placed in the bookmark list.
* 
If the hierarchy is incomplete, i.e. a level is missing, the bookmark level will be decreased to compensate for the missing level(s).
pagenum
The page on which the bookmark will appear within the bookmark list. If not specified, the current page will be used.
Additional Information
Bookmarks can be generated using show strings. The show string code <?show $60#?"Chapter$11a",13,"$5,1w",1,0,0$62#> could, for instance, be copied into the end of a chapter heading style which used the $a text counter. The bookmark name would be Chapter1 etc., and the description would be generated automatically from any text tagged with the chapter heading.
 
As with any case of showing to a reference, care should be taken not to overwrite any existing tag names.
Related Links