Adobe 65030089 User Guide - Page 57

Linking versus importing Word documents, Optimizing Word documents for online output

Page 57 highlights

USING ROBOHELP HTML 9 51 Projects 8 Export your conversion settings and reuse it when you link another Word document. See "Export conversion settings" on page 64. Linking versus importing Word documents You have two options for integrating content from Word documents into RoboHelp projects: linking and importing. The following table lists the differences between the two methods: Option Linking Importing Remarks Ability to update generated topics Yes. You can update the generated topics whenever the source document or your RoboHelp project settings change. No. When you import a Word document into a RoboHelp project, RoboHelp copies the contents of the Word document into RoboHelp project. RoboHelp generates topics based on conversion settings. If the source document changes, delete the generated topics and reimport the Word document. Use the link option when the source Word document can change. Typically, if multiple projects share the Word document, you link the Word document. If, however, you are bringing in content as a one-time activity, you can use the import option. Ability to automatically update TOC, index, and glossary changes from the source document Yes. When you link a document, separate TOC, index, and glossary files are created and associated with the linked Word document. When the linked Word document is updated, the linked TOC, index, and glossary files are also updated. No. When you import a Word document, the generated TOC is appended and index and glossary are merged into the selected TOC, index, and glossary file. Use the link option if you want to automatically update the TOC, index, and glossary whenever these components are updated in the Word document. Ability to regenerate deleted topics Yes. You can delete a topic that is generated from an imported Word document, and then regenerate the same topic when you update the Word document. No. Import the source document again to generate the deleted topic. Use the linking option when you share the source document across multiple projects. Ability to preserve changes in generated topics Yes. You can mark topics generated from a linked Word document to ensure that the marked topics are not updated when the linked document is updated. In this way, you can preserve any changes you made in RoboHelp. No. When you re-import a Word document, all topics previously generated from the imported document are recreated, overwriting any changes you made in RoboHelp. Use the link option if you need to retain updates made to both the linked Word document and the generated topics. Ability to change the filenames and topic titles of generated files from Project Manager No. When you link a Word document, you cannot change the filenames or topic titles of generated files from Project Manager. Yes. When you import a Word document, you can change the filenames or topic titles of generated files. Use the import option if you want to customize the filenames andtopic titles from Project Manager. Optimizing Word documents for online output If you are importing Word documents that have been published in printed or online format, consider the following before linking or importing them into RoboHelp projects. Heading hierarchies Determine the best mapping of Word heading styles to RoboHelp styles so that you can achieve automatic pagination (splitting the document into topics) based on heading styles. If your document does not employ hierarchical heading styles, apply them before conversion. For example, you can apply Heading 1 style to standalone articles in your Word document. Then map this style to a similar RoboHelp style and define pagination to create an HTML topic for each Heading 1 style. See "Pagination and topic naming in converted Word files" on page 58. 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

51
USING ROBOHELP HTML 9
Projects
Last updated 12/14/2011
8
Export your conversion settings and reuse it when you link another Word document. See “
Export conversion
settings
” on page
64.
Linking versus importing Word documents
You have two options for integrating content from Word documents into RoboHelp projects: linking and importing.
The following table lists the differences between the two methods:
Optimizing Word documents for online output
If you are importing Word documents that have been published in printed or online format, consider the following
before linking or importing them into RoboHelp projects.
Heading hierarchies
Determine the best mapping of Word heading styles to RoboHelp styles so that you can achieve
automatic pagination (splitting the document into topics) based on heading styles. If your document does not employ
hierarchical heading styles, apply them before conversion. For example, you can apply Heading 1 style to standalone
articles in your Word document. Then map this style to a similar RoboHelp style and define pagination to create an
HTML topic for each Heading 1 style. See “
Pagination and topic naming in converted Word files
” on page
58.
Option
Linking
Importing
Remarks
Ability to update generated
topics
Yes
. You can update the
generated topics whenever the
source document or your
RoboHelp project settings
change.
No
. When you import a Word
document into a RoboHelp
project, RoboHelp copies the
contents of the Word document
into RoboHelp project. RoboHelp
generates topics based on
conversion settings. If the source
document changes, delete the
generated topics and reimport
the Word document.
Use the link option when the
source Word document can
change. Typically, if multiple
projects share the Word
document, you link the Word
document.
If, however, you are bringing in
content as a one-time activity,
you can use the import option.
Ability to automatically update
TOC, index, and glossary changes
from the source document
Yes
. When you link a document,
separate TOC, index, and glossary
files are created and associated
with the linked Word document.
When the linked Word document
is updated, the linked TOC, index,
and glossary files are also
updated.
No.
When you import a Word
document, the generated TOC is
appended and index and glossary
are merged into the selected TOC,
index, and glossary file.
Use the link option if you want to
automatically update the TOC,
index, and glossary whenever
these components are updated in
the Word document.
Ability to regenerate deleted
topics
Yes
. You can delete a topic that is
generated from an imported
Word document, and then
regenerate the same topic when
you update the Word document.
No
. Import the source document
again to generate the deleted
topic.
Use the linking option when you
share the source document across
multiple projects.
Ability to preserve changes in
generated topics
Yes.
You can mark topics
generated from a linked Word
document to ensure that the
marked topics are not updated
when the linked document is
updated. In this way, you can
preserve any changes you made
in RoboHelp.
No.
When you re-import a Word
document, all topics previously
generated from the imported
document are recreated,
overwriting any changes you
made in RoboHelp.
Use the link option if you need to
retain updates made to both the
linked Word document and the
generated topics.
Ability to change the filenames
and topic titles of generated files
from Project Manager
No.
When you link a Word
document, you cannot change
the filenames or topic titles of
generated files from Project
Manager.
Yes.
When you import a Word
document, you can change the
filenames or topic titles of
generated files.
Use the import option if you want
to customize the filenames
andtopic titles from Project
Manager.