Adobe 38028779 User Guide - Page 357

Root-relative paths, links automatically.

Page 357 highlights

Root-relative paths Root-relative paths provide the path from the site's root folder to a document. You might want to use these types of paths if you are working on a large Web site that uses several servers, or one server that hosts several different sites. However, if you are not familiar with this type of path, you may want to stick to document-relative paths. A root-relative path begins with a leading forward slash, which stands for the site root folder. For example, /support/tips.html is a root-relative path to a file (tips.html) in the support subfolder of the site's root folder. A root-relative path often provides the best way to specify links in a Web site in which you need to frequently move HTML files from one folder to another. When you move a document that contains root-relative links, you don't need to change the links; for example, if your HTML files use root-relative links for dependent files (such as images), then if you move an HTML file, its dependentfile links are still valid. However, when you move or rename the documents linked to with root-relative links, you do need to update those links, even if the documents' paths relative to each other haven't changed. For example, if you move a folder, all root-relative links to files within that folder must be updated. (If you move or rename files using the Site window, Dreamweaver updates all relevant links automatically.) • To use root-relative paths, first define a local site in Dreamweaver by choosing a local root folder to serve as the equivalent of the document root on a server. (See "Using Dreamweaver to set up a new site" on page 102.) Dreamweaver uses this folder to determine the root-relative paths to files. Note: Root-relative links are interpreted by servers, not by browsers, so if you open a local page that uses root-relative links in your browser (without using Preview in Browser from within Dreamweaver), the links don't work. When you use the Preview in Browser command to preview a document that uses root-relative links, Dreamweaver temporarily converts those links (in the previewed file only) to use absolute file:// paths. However, you can preview only one page at a time that uses root-relative links-if you follow a link from the previewed page, the next page's root-relative links are not converted, and the browser can't follow such links. Previewing pages in framesets that use root-relative links results in similar problems. To preview a set of pages that use root-relative links, do one of the following: • Put the files on a remote server and view them from there. • (Windows only) Choose Edit > Preferences, and in Preview in Browser preferences, select Preview Using Local Server. To use this option, you must be running a Web server on your local computer. Linking and Navigation 357

  • 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
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510
  • 511
  • 512
  • 513
  • 514
  • 515
  • 516
  • 517
  • 518
  • 519
  • 520
  • 521
  • 522
  • 523
  • 524
  • 525
  • 526
  • 527
  • 528
  • 529
  • 530
  • 531
  • 532
  • 533
  • 534
  • 535
  • 536
  • 537
  • 538
  • 539
  • 540
  • 541
  • 542
  • 543
  • 544
  • 545
  • 546
  • 547
  • 548
  • 549
  • 550
  • 551
  • 552
  • 553
  • 554
  • 555
  • 556
  • 557
  • 558
  • 559
  • 560
  • 561
  • 562
  • 563
  • 564
  • 565
  • 566
  • 567
  • 568
  • 569
  • 570
  • 571
  • 572
  • 573
  • 574
  • 575
  • 576
  • 577
  • 578
  • 579
  • 580
  • 581
  • 582

Linking and Navigation
357
Root-relative paths
Root-relative paths
provide the path from the site’s root folder to a document. You
might want to use these types of paths if you are working on a large Web site that uses
several servers, or one server that hosts several different sites. However, if you are not
familiar with this type of path, you may want to stick to document-relative paths.
A root-relative path begins with a leading forward slash, which stands for the site
root folder. For example, /support/tips.html is a root-relative path to a file
(tips.html) in the support subfolder of the site’s root folder.
A root-relative path often provides the best way to specify links in a Web site in
which you need to frequently move HTML files from one folder to another.
When you move a document that contains root-relative links, you don’t need to
change the links; for example, if your HTML files use root-relative links for
dependent files (such as images), then if you move an HTML file, its dependent-
file links are still valid. However, when you move or rename the documents linked
to with root-relative links, you do need to update those links, even if the
documents’ paths relative to each other haven’t changed. For example, if you move
a folder, all root-relative links to files within that folder must be updated. (If you
move or rename files using the Site window, Dreamweaver updates all relevant
links automatically.)
To use root-relative paths, first define a local site in Dreamweaver by choosing a
local root folder to serve as the equivalent of the document root on a server.
(See “Using Dreamweaver to set up a new site” on page 102.)
Dreamweaver uses this folder to determine the root-relative paths to files.
Note:
Root-relative links are interpreted by servers, not by browsers, so if you open a local
page that uses root-relative links in your browser (without using Preview in Browser from
within Dreamweaver), the links don’t work. When you use the Preview in Browser
command to preview a document that uses root-relative links, Dreamweaver temporarily
converts those links (in the previewed file only) to use absolute file:// paths. However, you
can preview only one page at a time that uses root-relative links—if you follow a link from
the previewed page, the next page’s root-relative links are not converted, and the browser
can’t follow such links. Previewing pages in framesets that use root-relative links results in
similar problems.
To preview a set of pages that use root-relative links, do one of the following:
Put the files on a remote server and view them from there.
(Windows only) Choose Edit > Preferences, and in Preview in Browser
preferences, select Preview Using Local Server. To use this option, you must be
running a Web server on your local computer.