Adobe 65030089 User Guide - Page 74

Import FrameMaker documents into an existing RoboHelp project

Page 74 highlights

USING ROBOHELP HTML 9 68 Projects If you are importing a FrameMaker document, you can select the components that you want to import from the Import Wizard that appears. You can select the TOC, index, and glossary, and specify the conversion settings. Note: Use the above procedure if you already have a project with some content, and wish to import FrameMaker content. Linking of FrameMaker document is allowed in this case. Import FrameMaker documents into an existing RoboHelp project 1 Select File > Import > FrameMaker document. 2 Select the FrameMaker document type that you want to import. 3 Select the documents and click Open. 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 70. 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 71 and "Import glossary definitions" on page 71. 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 219. Convert equations to images and insert them in the RoboHelp topics after conversion. Markers Cross-references, hypertext, URLs Index and glossary markers Topic name markers 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. Converted to an index and glossary when creating project. See "Import FrameMaker index entries" on page 71 and "Import glossary definitions" on page 71. 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 "Pagination for Help" on page 75. 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

68
USING ROBOHELP HTML 9
Projects
Last updated 12/14/2011
If you are importing a FrameMaker document, you can select the components that you want to import from the
Import Wizard that appears. You can select the TOC, index, and glossary, and specify the conversion settings.
Note:
Use the above procedure if you already have a project with some content, and wish to import FrameMaker content.
Linking of FrameMaker document is allowed in this case.
Import FrameMaker documents into an existing RoboHelp project
1
Select File > Import > FrameMaker document.
2
Select the FrameMaker document type that you want to import.
3
Select the documents and click Open.
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
70.
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
71 and “
Import glossary definitions
” on page
71.
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
219.
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
71 and “
Import glossary definitions
” on page
71.
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 “
Pagination for Help
” on page
75.