Adobe 65030089 User Manual - Page 55

Optimizing Word documents for online output, Heading hierarchies, Inline styles and style overrides

Page 55 highlights

USING ROBOHELP HTML 10 49 Projects 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 56. Inline styles and style overrides You can convert inline styles to CSS styles in RoboHelp. However, converting inline styles to CSS styles can lead to numerous styles that share the same formatting. See "Converting Word styles to RoboHelp styles" on page 53. Header and footer information RoboHelp can convert headers and footers. However, to ensure consistency across your topics, you can define a master page that contains the required header and footer information. By using master 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

49
USING ROBOHELP HTML 10
Projects
Last updated 7/13/2012
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
56.
Inline styles and style overrides
You can convert inline styles to CSS styles in RoboHelp. However, converting inline
styles to CSS styles can lead to numerous styles that share the same formatting. See “
Converting Word styles to
RoboHelp styles
” on page
53.
Header and footer information
RoboHelp can convert headers and footers. However, to ensure consistency across
your topics, you can define a master page that contains the required header and footer information. By using master
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.