Adobe 65030089 User Guide - Page 98

Tips for creating HTML projects with HPJ files, Adding projects to version control

Page 98 highlights

USING ROBOHELP HTML 9 92 Projects 2 Click the Import tab. 3 Select WinHelp Project. Click OK. 4 Click the browse button, and select the HPJ file to import. Click Next. 5 Specify the output folder and filename. 6 Under Choose Source Document(s), select the Word documents you want to import. 7 Click Finish or click Next to step through the remaining steps in the wizard. Tips for creating HTML projects with HPJ files • To ensure that the HTML project suits your preferences, review the steps before you start. • All files referenced by the WinHelp project (HPJ) must be in the locations you specify before you generate the project files. • You can create a single style sheet and apply it to all topics or use different style sheets for different topics. • WinHelp topics can use a combination of defined styles and manual character and paragraph formatting. If so, create style sheets that use the same styles from the WinHelp topics to retain the special formats. • You can select an existing style sheet that you use with other HTML projects. Make the style names in the WinHelp topics identical to the style names in the style sheet. Also, format the paragraphs in the WinHelp topics to use these styles. Otherwise, you'll have to apply styles from the style sheet to paragraphs in the HTML topics after the project is generated. • You do not have to use a style sheet at all. The HTML topics include the formatting from the DOC files (as inline styles which are individually formatted paragraphs and characters). You can always create styles and apply them to topics after the HTML project is created. (If your project is large, do use style sheets to create the HTML topics. When you revise the styles, the topics are automatically updated.) • Run a small test project to become familiar with the options. Experiment with different options until you get the HTML output you want. • If you are generating a large project, decide how you want to organize it beforehand. In HTML, you have one HTML topic file for each WinHelp topic. You have several options for organizing these files. You can save them at the root of the project folder or in a subfolder. You can create subfolders based on the DOC filenames and save the corresponding topics in them. Finally, you can save topics based on their use as pages in the table of contents. (Folders are created for each book and subfolders are created for sub-books in your CNT file.) • Often a project is used in combination with several other WinHelp projects (for example, as a master project). If so, create HTML projects with each HPJ file separately so that all the links work. • After the project is generated, you often want to make a few changes to the style sheet. By default, it uses a gray background. You can change it to white by changing the document properties for the style sheet. Adding projects to version control Note: Authors must use the "Add to Version Control" command from within the RoboHelp authoring client app itself when adding a new project to version control. Do not add the folders and files within the RoboSource Control Explorer interface, as this might cause file corruption. 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

92
USING ROBOHELP HTML 9
Projects
Last updated 12/14/2011
2
Click the Import tab.
3
Select WinHelp Project. Click OK.
4
Click the browse button, and select the HPJ file to import. Click Next.
5
Specify the output folder and filename.
6
Under Choose Source Document(s), select the Word documents you want to import.
7
Click Finish or click Next to step through the remaining steps in the wizard.
Tips for creating HTML projects with HPJ files
To ensure that the HTML project suits your preferences, review the steps before you start.
All files referenced by the WinHelp project (HPJ) must be in the locations you specify before you generate the
project files.
You can create a single style sheet and apply it to all topics or use different style sheets for different topics.
WinHelp topics can use a combination of defined styles and manual character and paragraph formatting. If so,
create style sheets that use the same styles from the WinHelp topics to retain the special formats.
You can select an existing style sheet that you use with other HTML projects. Make the style names in the WinHelp
topics identical to the style names in the style sheet. Also, format the paragraphs in the WinHelp topics to use these
styles. Otherwise, you'll have to apply styles from the style sheet to paragraphs in the HTML topics after the project
is generated.
You do not have to use a style sheet at all. The HTML topics include the formatting from the DOC files (as inline
styles which are individually formatted paragraphs and characters). You can always create styles and apply them to
topics after the HTML project is created. (If your project is large, do use style sheets to create the HTML topics.
When you revise the styles, the topics are automatically updated.)
Run a small test project to become familiar with the options. Experiment with different options until you get the
HTML output you want.
If you are generating a large project, decide how you want to organize it beforehand. In HTML, you have one
HTML topic file for each WinHelp topic. You have several options for organizing these files. You can save them at
the root of the project folder or in a subfolder. You can create subfolders based on the DOC filenames and save the
corresponding topics in them. Finally, you can save topics based on their use as pages in the table of contents.
(Folders are created for each book and subfolders are created for sub-books in your CNT file.)
Often a project is used in combination with several other WinHelp projects (for example, as a master project). If
so, create HTML projects with each HPJ file separately so that all the links work.
After the project is generated, you often want to make a few changes to the style sheet. By default, it uses a gray
background. You can change it to white by changing the document properties for the style sheet.
Adding projects to version control
Note:
Authors must use the "Add to Version Control" command from within the RoboHelp authoring client app itself
when adding a new project to version control. Do not add the folders and files within the RoboSource Control Explorer
interface, as this might cause file corruption.