Adobe 65030089 User Guide - Page 81

Pagination for Help, Topic name pattern

Page 81 highlights

USING ROBOHELP HTML 9 75 Projects • Format conversion settings, image conversion settings, and other settings Export conversion settings 1 Select File > Project Settings. 2 On the Import tab, click Export. 3 Specify a name for the RoboHelp Import Settings file (ISF file) and click Save. Import conversion settings to a project 1 Select File > Project Settings. 2 On the Import tab, click Browse. 3 Select a RoboHelp Import Settings File (ISF file) and click Open. Pagination for Help When you link or import a FrameMaker document, you define how the contents of the FrameMaker file are presented as topics in RoboHelp. For example, if the FrameMaker file contains ten topics, with each topic containing subtopics, tasks, and tables, you can set each topic to appear as separate HTML files. If each of these topic headings is at Heading 1 format, you can set each Heading 1 topic to be created as a separate HTML topic. On the other hand, if you set the pagination at Heading 2, separate HTML files are created for each Heading 2 topic. Even though you can set pagination for any FrameMaker paragraph format, follow these guidelines: Completeness of content in the topic Ensure that the topic generated contains relevant and complete information for the reader. For example, if you set pagination for Heading 3 level paragraph, it is possible that the topic contains only the task information, without the required contextual information that is covered in another Heading 3 level topic. To avoid such disconnected topics, set the pagination at a higher level so that complete information is available in a single Help topic. Drop-down text Ensure that the paragraph format for the drop-down text body is not set for pagination. The paragraphs applied with this format must accompany the drop-down text caption paragraph format. See "Optimizing for online output before conversion" on page 65. Topic name pattern When you set heading styles for pagination, the heading text becomes the default filename for the topic file created in RoboHelp. For example, suppose you define Heading 2 for pagination, and the FrameMaker document has two Heading 2 topics, "Introduction" and "Beyond basics." In this case, RoboHelp creates the topics introduction.htm and beyond_basics.htm. Thus, you get intuitively named HTML files that indicate the topic title. In addition to this default scheme, you can define other naming conventions. If the filenames use sequential numbering, such as helptopic001.html and helptopic002.html, you can define the pattern for such conventions. 1 Select File > Project Settings. 2 In the Import tab of the Project Settings dialog box, click Edit under FrameMaker document. 3 In the Other Settings tab, select one of the following: Topic Name Pattern Topics are named according to the selected pattern. You can select one of the following or create a topic name pattern using the Topic Name Pattern building blocks provided by RoboHelp. In addition, you can add standard static text, such as "HelpTopic," followed by sequential number as the topic name pattern. Last updated 12/14/2011

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380

75
USING ROBOHELP HTML 9
Projects
Last updated 12/14/2011
Format conversion settings, image conversion settings, and other settings
Export conversion settings
1
Select File > Project Settings.
2
On the Import tab, click Export.
3
Specify a name for the RoboHelp Import Settings file (ISF file) and click Save.
Import conversion settings to a project
1
Select File > Project Settings.
2
On the Import tab, click Browse.
3
Select a RoboHelp Import Settings File (ISF file) and click Open.
Pagination for Help
When you link or import a FrameMaker document, you define how the contents of the FrameMaker file are presented
as topics in RoboHelp. For example, if the FrameMaker file contains ten topics, with each topic containing subtopics,
tasks, and tables, you can set each topic to appear as separate HTML files. If each of these topic headings is at Heading
1 format, you can set each Heading 1 topic to be created as a separate HTML topic. On the other hand, if you set the
pagination at Heading 2, separate HTML files are created for each Heading 2 topic.
Even though you can set pagination for any FrameMaker paragraph format, follow these guidelines:
Completeness of content in the topic
Ensure that the topic generated contains relevant and complete information for
the reader. For example, if you set pagination for Heading 3 level paragraph, it is possible that the topic contains only
the task information, without the required contextual information that is covered in another Heading 3 level topic. To
avoid such disconnected topics, set the pagination at a higher level so that complete information is available in a single
Help topic.
Drop-down text
Ensure that the paragraph format for the drop-down text body is not set for pagination. The
paragraphs applied with this format must accompany the drop-down text caption paragraph format. See “
Optimizing
for online output before conversion
” on page
65.
Topic name pattern
When you set heading styles for pagination, the heading text becomes the default filename for the topic file created in
RoboHelp. For example, suppose you define Heading 2 for pagination, and the FrameMaker document has two
Heading 2 topics, “Introduction” and “Beyond basics.” In this case, RoboHelp creates the topics introduction.htm and
beyond_basics.htm. Thus, you get intuitively named HTML files that indicate the topic title. In addition to this default
scheme, you can define other naming conventions. If the filenames use sequential numbering, such as
helptopic001.html and helptopic002.html, you can define the pattern for such conventions.
1
Select File
> Project Settings.
2
In the Import tab of the Project Settings dialog box, click Edit under FrameMaker document.
3
In the Other Settings tab, select one of the following:
Topic Name Pattern
Topics are named according to the selected pattern. You can select one of the following or
create a topic name pattern using the Topic Name Pattern building blocks provided by RoboHelp. In addition, you
can add standard static text, such as “HelpTopic,” followed by sequential number as the topic name pattern.