Legacy Document

Inside Macintosh: Apple Guide Complete / Part 4 - Scripting Guide Files

Chapter 10 - Guide Script Command Reference / Guide Script Command Descriptions

/ Working With Mixin Guide Files

<Insert Topic Area Topic>

You can use the <Insert Topic Area Topic> command to insert a topic from a Mixin guide file and associate this new topic with an existing topic area in a main guide file.

<Insert Topic Area Topic> topic, seqName, topicArea [, sortOrder]

topic

A text string specifying a new topic.

seqName

A text string specifying the sequence name associated with the new topic.

topicArea

A text string specifying the topic area in a main guide file. Apple Guide associates the new topic with the specified topic area.

sortOrder

A value specifying where the new topic should appear in the list of topics for the specified topic area. You can use the constant FIRST or LAST to sort the topic at the beginning or end of existing topics for the specified topic area. You can also specify in this parameter a text string of the topic that should immediately precede the new topic. This parameter is optional. If you omit it, Apple Guide uses LAST as the default.

DESCRIPTION

When Guide Maker compiles a source file for a Mixin guide file and encounters an <Insert Topic Area Topic> command, it looks for a topic area specified by the topicArea parameter in the main guide file. If it finds the topic area, it associates the new topic with it and inserts the topic into the list of topics, according to the sort order specified by the sortOrder parameter.

To define a header for a new topic, use the <Insert Topic Area Header> command.

SPECIAL CONSIDERATIONS

The <Insert Topic Area Topic> command can be used only in the source file for a Mixin guide file that also includes the <Mixin> command. To use the <Insert Topic Area Topic> command, you must specify a SYM file in the symName parameter of the <Mixin> command.

EXAMPLES

#in a Mixin guide file, specify a new topic for an 
# existing topic area in a main guide file
<Insert Topic Area Topic> "change the default font?", \xAC
                   "How do I change the default font?", \xAC
                   "Setting Options", \xAC
                   "change the standard footer?"

SEE ALSO

For information on the <Mixin> command, see page 10-19. For information on the <Topic Area>, <Header>, and <Topic> commands, see page 10-125, page 10-135, and page 10-137, respectively.