Dreamweaver.MX.1002004.The.Missing.Manual [Electronic resources] نسخه متنی

16.5 Communicating with Design Notes

Lots of questions arise when a team works on a Web site: Has this page been proofread?
Who is the author of the page? Where did this graphic come from? Usually, you must
rely on a flurry of emails to ferret out the answers.

But Dreamweaver's Design Notes dialog box (Figure 16-15) eliminates much of that
hassle by letting you attach information, such as a Web page's status or author, to a
file. You can open these notes (from the Files panel or from a currently open document),
edit them, and even share them with others. In this way, it's easy to leave notes
for other peoplesuch as, "Hey Bob, can you make sure that this is the most recent
photo of Ben and J. Lo?" You can even add notes to files other than Web pages including
folders, images, Flash movies, and external Cascading Style Sheetsanything, in
fact, that appears in the Files panel.

If you want the Design Notes window
to open whenever someone opens the
page, turn on Show When File is Opened.
This option makes sure no one misses an
important note attached to a Web page.
When the page is opened in Dreamweaver,
the Design Notes window appears automatically.
(This option has no effect when
adding notes to GIFs, JPEGs, Flash movies,
or anything other than a Web page,
external CSS style sheet, or any type of text
fileXML, for examplethat Dreamweaver
can open and edit.)

16.5.1 Setting Up Design Notes

You can't use Design Notes unless the feature itself is turned on. To find out, open
the Site Definition dialog box by double-clicking the site's name in the Manage Sites
dialog box (choose Manage Sites from the Site menu or the pop-up menu in the
Files panel). In the Category list, click Design Notes; as shown in Figure 16-16, two
checkboxes pertain to the notes feature:

Maintain Design Notes. This checkbox lets you create and read notes using
Dreamweaver's FileDesign Notes command (see Section 16.5.2).

Upload Design Notes for Sharing. If you're using Design Notes as part of a team,
turn on this checkbox, which makes Dreamweaver upload design notes to the
remote site, so that your fellow team members can read them.

NOTE

Design Notes are especially useful for keeping track of pages that are built and maintained by a team
of developers. But if you're a solo operator and still want to use themmaybe you're the type with a hundred
Post-it notes taped to the edges of your monitorthen turn off Upload Design Notes for Sharing. You'll save
time and server space by preventing Dreamweaver from transferring note files to the Web server.

Click OK to close the Site Definition dialog box. You can double-click another site in
the Manage Sites dialog box to turn on its Design Notes feature, or click Done.

The Clean Up button
deletes any notes that were
attached to now-deleted
files. (To avoid stray notes
files in the first place,
always delete pages in
Dreamweaver's Files panel,
instead of at the desktop.)
If you turn off Maintain
Design Notes box, clicking
Clean Up removes all Design
Notes files for the site.

16.5.2 Adding Design Notes to a File

To add a design note to a document you're working on, choose your favorite method:

Choose FileDesign Notes.

Choose Design Notes from the File Status menu in the toolbar (see Figure 16-9).

Right-click (Control-click) a file in the Files panel (or an external object, such as
a graphic or Flash movie, in the document window), and choose Design Notes
from the contextual menu.

In any case, the Design Notes window now opens (Figure 16-15). If you like, you can
use the Status pop-up menu to let your team members know where the file stands.
For example, is it ready to move to the Web server? Is it just a draft version? Or is there
something wrong with it that requires specific attention? Dreamweaver provides eight
different options: draft, revision1, revision2, revision3, alpha, beta, final, and needs
attention. If these categories don't match your workflowfor example, you want a
"needs proofing" flagyou can change them; see the box on the facing page.

The note itself, which you type into the Note box, could be a simple question you
have for the author of the page ("Are you sure `Coldplay: Defining a New Musical
Language for the Modern Age' is an appropriate title for this article?") or more information
about the status of the page ("Still need studio shot of foil-wrapped cigar
hanging from a string.")

Click the calendar icon (circled in Figure 16-16) to pop the date into your notea great way to keep a running tally of notes and the dates they were made.

When you click OK, Dreamweaver creates a file with all note information in it. This
file ends with the extension .mno and begins with the name of the file; for the file
indexl, for example, the note would be called indexl.mno.

Dreamweaver lets you create your own
types of notes in the All Info tab of the
Design Notes window. This lets you add
more information to a page such as its
author or designer. If you want to delete
a note you've added, it's a simple matter
of clicking on the note in the Info box and
clicking the - (minus) button.

STATUS_ITEMS = new Array(","draft","revision1","revision2","revision3",
"alpha","beta","final","needs attention");

Dreamweaver stores notes in a folder called _notes that it keeps in the same folder as
the page or file. For example, if you add notes to the home page, Dreamweaver stores
the notes file in the _notes folder inside the root folder.

16.5.3 Viewing Design Notes

You can view design notes in a number of ways. If the note's author turned on Show
When File Is Opened (see Section 16.5), of course, the Design Notes window opens
automatically when you open that page.

Otherwise, to look at a note, you have any number of options:

Choose FileDesign Notes.

Choose Design Notes from the document window's toolbar (see Figure 16-8).

Double-click the small yellow balloon icon in the Notes column of the Files panel
(see Figure 16-18). (This column is only visible when the Files panel is expanded,
as described in Section 14.1.5.1.)

Right-click (Control-click) an embedded object like a graphic or Flash Movie,
right there in the document window, and choose Design Notes from the contextual
menu.

Right-click (Control-click) a file in the Files panel and choose Design Notes from
the contextual menu.

A yellow speech bubble in the
Notes column of the Files panel
indicates a Design Notes file. You
can even add a note to a folder
(in this case, the images_global
folder).

16.5.4 Organizing the Columns in the Files panel

When the Files panel is fully expanded (see Section 14.1.5.1) columns identify a file's name,
file size, modification date, type, and so on.

This may be more information than you're interested inor it might not be enough.
So remember that Dreamweaver lets you show or hide these various columns, change
their order, or even create new columns with information retrieved from a file's Design
Notes (Section 16.5).

You can adjust the relative widths of these columns by dragging the dividing line between the column names. You can also sort all the pages listed in this window by clicking the relevant column's name. Clicking Modified, for example, sorts the files so that the newest appear first. Click a second time to reverse the sort, placing oldest files first.

When you're setting up a Web site in the Site Definition window (Section 14.1.1), you can
view the column setup by clicking the File View Columns category (Figure 16-19).

If you're working with
others, you'll probably
want to share any columns
you add. Click the Enable
Column Sharing box;
then, you'll be able to see
columns that others on
your team have added,
and they'll be able to see
columns you've added (if
you've turned on Share
with All Users of the Site for
each column, of course).

Once you're looking at the display shown in Figure 16-19, you can perform any of
these stunts:

Reorder columns. Click a column name in the Site Definition window to select it.
Then click the up and down arrow buttons to move the column one spot to the
left or right, respectively, in the Files panel.

Hide columns. You may not care what date a file was last modified or whether it's
a folder or Web page. If that's the case, hide the column by clicking its name in
the Site Definition window and then turning off the Show checkbox (see Figure
16-19). (You can always return to the Site Definition window and turn the column
back on.)

Share a column. If you work with a team of designers, you might want to make
newly added columns (see Section 16.5.5) visible to them, too. (See Figure 16-19
for details.)

Adding Columns. You can add informational columns of your own, as described
next.

Deleting columns. Click the column name, and then click the minus (-) button
to delete the column. (Dreamweaver doesn't let you delete the built-in columns:
Name, Notes, Type, Modified, and so on.)

16.5.5 "All Info" Design Notes in Column Views

Your Files panel offers columns for all the usual information bits: Name, Checked Out,
and so on. But you may someday wish there were a column that showed each page's
status, so that your Files panel could show you which files need proofreading, or who
wrote each article, or which pages are being held until a certain blackout date.

You can indeed add columns of your own design, although the process isn't streamlined
by any means. It involves two broad efforts: First, using an offshoot of the Design
Notes feature described earlier, you set up the new columns you'll want displayed.
Then, using the column-manipulation dialog box shown in Figure 16-19, you make
them visible in the Files panel.

16.5.5.1 Phase 1: Defining the new information types

You create new kinds of informational flagsprimarily for use as new columns in
the Files panelusing the Design Notes dialog box described in Section 16.5.2. Here's
the rundown:

Choose FileDesign Notes.

The Design Notes window appears. (You can summon it in various other ways,
too, as described in Section 16.5.2.)

Click the All Info tab.

This peculiar window shows the programmery underbelly of the Dreamweaver
Notes feature (see Figure 16-17). It turns out that it stores every kind of note as a
name/value pair. If you used the main Notes screen (Figure 16-15) to choose Beta
from the Status pop-up menu, for example, you'll see a notation here that says
"status=beta." (Status is the name of the info nugget; beta is the value.) If you turned
on the option called Show When File is Opened, you'll see "showOnOpen=true."
And if you typed Badly needs updating as the note itself, you'll see "notes=Badly
needs updating" on this screen.

But those are just the built-in info types; you're free to create your own.

Click the + button.

You may wonder why you'd do this; after all, you can type a lot of information in
the Notes box under the Basic Info tab. The primary benefit of creating new types
of notes is that you can display that information in the Files panel.

Type the name of the new note in the Name field.

It might be Author, for example, so that you can note who wrote the text of each
page. Or it could be Artist, if you wish to add a note to each image specifying who
created it. Maybe you need a column called Hold Until, which lets you know when
certain information is OK to publish online.

Press Tab (to jump to the Value field); type the contents of the note.

This might be the actual name of the author or artistJane Stevens, for example
or the actual "Hold Until" date.

Keep the value shortone or two words. Otherwise, the narrow Files panel column will chop off the latter part of it. If you've got enough screen real estate, you can resize the columns by dragging the divider bars between column names.

Repeat steps 3-5 if you want to add more notes to the page or file.

Click OK.

The dialog box closes.

16.5.5.2 Phase 2: Adding the column

Just creating a new note type gets you only halfway home; now you have to tell Dreamweaver
that you want to see that information in the Files panel, like this:

To add a column:

Open the Site Definition window for the particular site and select the File Views
category.

See Section 14.1.3 for a reminder of how to edit a site definition. The File Views dialog
box appears.

Click the + button (Figure 16-19).

A new, untitled column is added to the list, complete with three fields that need
filling in (they now say "untitled").

In the Column Name box, type the column-heading name you want to appear in
the Files panel.

Make it short and descriptive. If possible, it should match the note type (Author,
Artist, Hold Until, or whatever).

Press Tab. Type the name of the Design Note you wish to use for this column.

This is the name part of the name/value pair described in step 4 of the previous
instructions. For example, if you added a note named Author to a file, you would
type Author here. Capitalization matters; so if you named the design note Author,
type it with a capital A.

There's a pop-up menu here, too, but it always lists the same four options: Status,
Assigned, Due, and Priority. If you choose Status, you'll get a column that reflects
your choice from the Status pop-up menu shown in Figure 16-16. The other three
options do nothing unless you created a matching note type in step 4 of the previous
instructions. (It would be nice if this pop-up menu listed all of the note names
you've created, so that you didn't have to remember them. Maybe in Dreamweaver
MX 2004: The Sequel.)

Before you wrap up the column-adding procedure, you can, if you wish, choose
an alignment option for the text in the Site column (left, right, or center). Check
to make sure that the Show checkbox is turned on (otherwise, your new column
won't appear, and you've just defeated the purpose of this whole exercise). Finally,
turn on Share with All Users of the Site, if you like.

The Share feature works like this. The next time you connect to the remote site,
Dreamweaver uploads a file containing your newly defined column information.
The next time another member of the team connects to the remote site, his copy
of Dreamweaver downloads this file, so that his Files panel shows the same columns
yours does.

NOTE

The column-sharing feature is very handy; it lets everyone working on a site share the same note
information. But it works properly only if everyone on the team has the Enable Column Sharing box turned
in (see Figure 16-19).

Click OK.

You should now see the new information column in your Files panel, as shown in
Figure 16-20. (If not, you may need to expand the Files panel view and widen the
window to reveal the additional column.)

The Files panel can show
newly created kinds of status
information, but only if you've
expanded the Files panel view
by clicking the Expand/Collapse
button circled here. Each
piece of information (Author,
Assigned, and so on) is actually
a Design Note you've invented.
To sort the list, click the gray
column heading.