Adobe 65030089 User Manual - Page 72

FrameMaker document components converted to RoboHelp

Page 72 highlights

USING ROBOHELP HTML 10 66 Projects FrameMaker document components converted to RoboHelp RoboHelp converts most of the FrameMaker components when you link or import FrameMaker documents. The following tables list the major FrameMaker document components and show how they are converted in RoboHelp. FrameMaker files Book files TOC Text insets Index and glossary Documents contained within the book are converted (FM, XML, MIF, HTM, and HTML files). XHTML files that are included in the FrameMaker book must be valid XHTML. Validate the XHTML in FrameMaker itself. All other files in the FrameMaker book are ignored. Child books, folders, and groups in FrameMaker 9 books are converted and appear as folders in the RoboHelp projects. See "Hierarchical structure in a FrameMaker 9 book" on page 73. Converted, if selected. See "Convert a FrameMaker TOC" on page 68. Text insets in the FrameMaker documents are considered part of the FrameMaker document itself and are inserted as text in the RoboHelp topic. Once inserted, the content cannot be edited as a text inset in FrameMaker but can only be edited as text within Robohelp. Index and glossary files generated in the FrameMaker book are not converted. Instead, the index markers and glossary markers in the imported FrameMaker documents are converted if selected. See "Import FrameMaker index entries" on page 68 and "Import glossary definitions" on page 69. Variables and conditional text Variables Conditional tags Equations Converted. User-defined variables in FrameMaker are converted as such in RoboHelp and can be redefined. Apply relevant conditional text tags to suppress variables that shouldn't appear in online format. For example, you can suppress the Table Continuation variable in table headers for tables that break across pages in the FrameMaker documents. Converted as RoboHelp conditional build tags. See "Conditional text" on page 230. Convert equations to images and insert them in the RoboHelp topics after conversion. Markers Cross-references, hypertext, URLs Converted to hypertext links. You can map the cross-reference formats in RoboHelp so that you can remove the volume, chapter, and page references that are not relevant in online format. Unresolved cross-references and hypertext entries appear as text in online Help. URLs become live hypertext links in the online Help output. See "Convert FrameMaker cross-reference formats to RoboHelp styles" on page 74. Index and glossary markers Converted to an index and glossary when creating project. See "Import FrameMaker index entries" on page 68 and "Import glossary definitions" on page 69. Topic name markers Converted if you select this option in the project conversion settings. Use topic name markers to create topic titles and topic filenames from the marker text. See "Setting pagination and topic names" on page 75. Context-sensitive Help markers Converted if you select this option in the project conversion settings. Use Context Sensitive Help Makers in FrameMaker to specify text in FrameMaker document for generating Context Sensitive Help. See "Setting pagination and topic names" on page 75. Custom markers Converted. You can use these markers for delineating topics from FrameMaker source, or to pass processing instructions to RoboHelp for images and tables. Formats Paragraph formats Character formats Converted. You can map FrameMaker paragraph formats to RoboHelp styles or import the source formatting. See "Convert FrameMaker paragraph formats to RoboHelp styles" on page 78 Converted. You can map FrameMaker character formats to RoboHelp styles or import the source formatting. See "Convert FrameMaker character formats to RoboHelp styles" on page 78. Last updated 7/13/2012

  • 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
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422

66
USING ROBOHELP HTML 10
Projects
Last updated 7/13/2012
FrameMaker document components converted to RoboHelp
RoboHelp converts most of the FrameMaker components when you link or import FrameMaker documents. The
following tables list the major FrameMaker document components and show how they are converted in RoboHelp.
FrameMaker files
Book files
Documents contained within the book are converted (FM, XML, MIF, HTM, and HTML files). XHTML files that
are included in the FrameMaker book must be valid XHTML. Validate the XHTML in FrameMaker itself. All
other files in the FrameMaker book are ignored. Child books, folders, and groups in FrameMaker 9 books are
converted and appear as folders in the RoboHelp projects. See “
Hierarchical structure in a FrameMaker 9
book
” on page
73.
TOC
Converted, if selected. See “
Convert a FrameMaker TOC
” on page
68.
Text insets
Text insets in the FrameMaker documents are considered part of the FrameMaker document itself and are
inserted as text in the RoboHelp topic. Once inserted, the content cannot be edited as a text inset in
FrameMaker but can only be edited as text within Robohelp.
Index and glossary
Index and glossary files generated in the FrameMaker book are not converted. Instead, the index markers
and glossary markers in the imported FrameMaker documents are converted if selected. See “
Import
FrameMaker index entries
” on page
68 and “
Import glossary definitions
” on page
69.
Variables and conditional
tex
t
Variables
Converted. User-defined variables in FrameMaker are converted as such in RoboHelp and can be redefined.
Apply relevant conditional text tags to suppress variables that shouldn’t appear in online format. For
example, you can suppress the Table Continuation variable in table headers for tables that break across
pages in the FrameMaker documents.
Conditional tags
Converted as RoboHelp conditional build tags. See “
Conditional text
” on page
230.
Equations
Convert equations to images and insert them in the RoboHelp topics after conversion.
Markers
Cross-references, hypertext,
URLs
Converted to hypertext links. You can map the cross-reference formats in RoboHelp so that you can remove
the volume, chapter, and page references that are not relevant in online format. Unresolved cross-references
and hypertext entries appear as text in online Help. URLs become live hypertext links in the online Help
output. See “
Convert FrameMaker cross-reference formats to RoboHelp styles
” on page
74.
Index and glossary markers
Converted to an index and glossary when creating project. See “
Import FrameMaker index entries
” on
page
68 and “
Import glossary definitions
” on page
69.
Topic name markers
Converted if you select this option in the project conversion settings. Use topic name markers to create topic
titles and topic filenames from the marker text. See “
Setting pagination and topic names
” on page
75.
Context-sensitive Help markers
Converted if you select this option in the project conversion settings. Use Context Sensitive Help Makers in
FrameMaker to specify text in FrameMaker document for generating Context Sensitive Help. See “
Setting
pagination and topic names
” on page
75.
Custom markers
Converted. You can use these markers for delineating topics from FrameMaker source, or to pass processing
instructions to RoboHelp for images and tables.
Formats
Paragraph formats
Converted. You can map FrameMaker paragraph formats to RoboHelp styles or import the source
formatting. See “
Convert FrameMaker paragraph formats to RoboHelp styles
” on page
78
Character formats
Converted. You can map FrameMaker character formats to RoboHelp styles or import the source formatting.
See “
Convert FrameMaker character formats to RoboHelp styles
” on page
78.