Home | People | News | Undergrad | Graduate | Courses | Knowledge Base Wiki | Research | Projects | Search
UCSB English Dept. Home Page

Development FAQs: How to Work on Dept. Site
(Last rev. July 18, 2003 )

Table of Contents
Note: The information on this page applies only to editing static content on the Web pages of the Dept. site. Dynamic content (content that is input into the Dept. database and then dynamically served to the Web) is edited through Web forms available most conveniently from the Staff Homepage. News items, personnel lists, faculty bios, and course descriptions are dynamic content.

Setting up a working, local copy of the dept. site in Dreamweaver MX

  • For basic instructions on using Dreamweaver and setting up a site, see the Transcriptions "Getting Started with Dreamweaver" page

  • Open the Site > New Site dialogue to set up your Dreamweaver site definition

    • Click to enlargeSet up the "Local Info" part of the site as in the following image (where you set the local folder that will hold your hard-drive or zip-drive copy of the department site). You must previously have created your local folder, naming it whatever you want (e.g., "Alan's Working Copy of Dept. Site")

    • Click to enlargeSet up the "Remote Info" part of the site as in the following image. The FTP information is as follows:

      FTP Host: www.english.ucsb.edu
      Host Directory: /dept-internet/
      Login: ENGL_MAIN/[your userid]
      Password: [your password]
      Save checkbox: [leave unchecked if you are working on a studio or office machine]


  • click to enlargeOpen the Site window. In its double-pane mode, the Site window shows the files in your local copy of a site on the right and the files in the remote site (that is, the real site on the server) on the left. (When you start, the local pane will be empty because you haven't put any files in it; and the remote pane will not yet be connected to the server)

    • "Connect" to the remote site (you'll need to supply your password). You'll presently see the directory structure of the department site as it exists on the server

    • Select the folder or folders of the dept. site that you want a working copy of on your local folder. Important: do not attempt to keep a copy of the entire dept. site on your local folder. (Keeping local copies only of what you need to work on reduces your need for local storage space and also minimizes the chance of damaging the whole site on the server through an unlucky upload. You can always download extra parts of the site as you need them.)

    • click to enlargeClick on the "get" or download arrow (it points down) to fetch the remote files to your local folder. You'll first see a dialogue that asks whether you wish also to download "dependent files." This means: do you want to download not only the files you have selected but also any images, templates, or Dreamweaver "library" objects that are needed by those files even if they are stored elsewhere on the dept. site? Since this is the first time you are doing this, say "yes." (In future, avoid getting dependent files when you download and especially when you upload. Experience shows that manual downloading/uploading prevents unintended errors--for example, uploading old copies of files over everything on the server).

    • You now have a local version of the dept. site.



Creating a New Dept. Page

  • There are two ways to create a new page on the site and be sure that all the scripts, images, relative links, etc. are correct to begin with:

    • click to enlarge(A) Use the File > New menu to open the new file dialogue. Then click on the Templates tab to see a list of the page-templates that have been defined for the dept. site. (Each branch of the site, e.g., the faculty pages, has its own variant template). Click on "create" to create a new page from the template. Templates have "editable regions" where you can work; other areas of the page are off-limits.

    • (B) Copy an existing file:

      • While in Dreamweaver's Site Window, copy an existing file in its existing folder (e.g., "index.html" to "Copy of index.html"
      • Then in the Dreamweaver Site Window (important: not in Explorer) drag the copy to the folder where you want your new file to live. Dreamweaver will offer to update (change) all links, etc. in the file to reflect the new location. Say "yes."
      • Then while still in the Dreameweaver Site window, rename the file to the name that you want. Again, Dreamweaver will offer to update links around the site to reflect the name change of this file. Say "yes."
      • Finally, open the new file and revise its existing content for your purposes.



Design/Editing Tips & Tricks for the Dept. Site

  • Thin-Border Tables:
    Much of the design on the department pages depends on the use of tables (and tables nested within tables) to place content on the page or to set off content in a visible box. In particular, the site makes frequent use of thin-border tables. The present content, for example, is in such a table.

    These thin-border tables are actually a table-within-table configured in such a way that there is a 1-pixel gap between the outer and inner tables (with the gap showing a particular color). The easiest way to create such a table is to copy the following empty table and size it as you wish (by sizing the percentage width of the outer table). If you wish, you can add the code for this table as a "snippet" to Dreamweaver MX's Assets panel (which would make adding such tables more convenient in the future).

    [Empty thin-bordered table constructed of an outer table set at 95% width with1-pixel cell-padding and a background color of #993300. The inner table is set at 100% width and a cell-padding of 8 pixels, though you can customize that to add more space between any content you add and the borders of the table]

     


  • CSS Styles: Use styles for the titles, headings, and similar text. (See Cascading Style Sheets on the Dept. Site)



Cascading Style Sheets (CSS) on the Dept. Site

  • If you open the CSS window in Dreamweaver, you can see the custom "styles" that are defined for the dept. site. These custom styles live in a file called "english.css" in the root of the dept. site. They modify the way that HTML elements are styled by default.

  • Select text in your document, then click on a style in the style window to format your selection with that style. For example, the following text uses the .titleDark 14pt custom style.

  • You can also use the CSS window to add styles to the individual document you are working on (which will take precedence over site-wide stules). Important: never save styles to the site-wide "english.css" file; always save to the individual document only or to a new .css file that you create.

Do's and Dont's for Working on Dept. Site

  • Synch with files on the server: Always download the latest version of a file from the server before editing it. (Always check the dates of files on the server even if you don't think anyone else has been working on them.)

  • Back up files before major revision: Always make a local backup copy of any file that you are about to make major changes to. This is especially important for .asp files with database code.

  • Upload only the minimum files necessary:
    • If you only revised one file in a folder, just upload that one file. Do no upload the whole folder. This will minimize the number of possible mistakes.
    • If Dreamweaver offers to upload "dependent files" when you upload a file or folder, never say "yes." Always upload files manually. The worse that can happen if you upload files manually is that you will discover you are missing a file on the server and will need to upload it individually. By contrast, the worse scenario in the case of automatic uploading of files is considerably more catastrophic (e.g., overwriting many files on the site with old versions).

  • Standardize filenames:
    • Filenames on the dept. site have a .html extension (not .htm). (Alternatively, they have a .asp extension).
    • Unless there is a reason otherwise, use all lower-case for file names
    • Do not use any spaces in filenames.
    • The home page within any folder or branch of the site should be named "index.html" or "index.asp"

  • Follow a "cascade down" principle when deciding where to store images on the site:
    • Only images that are common to the whole site belong in top-level "gfx" directories ("gfx" = graphics effects, such as bullets, logos, icons, etc.) or top-level "images" directories ("images" = substantive images, such as photos of people)
    • Images used only at a lower level of the site (e.g., only on the faculty pages) should be stored in "gfx" or "images" directories at the appropriate lower level.

  • Keep the site tidy: remove temporary files and redundant files on the site when you are done with them.

  • Use "Design Notes" feature in Dreamweaver as appropriate to annotate pages (to remind yourself or other developers of tricky issues or to-do items)

  • Use Alt Tags: Always identify an image on the site with an Alt tag (set in the Dreamweaver Properties bar). This is for the benefit of the visually handicapped and others who have trouble with images.

  • Keep a sense of tone and audience: Write in a tone consistent with that of the Dept. site as a whole—one that is neither too entirely bureaucratic nor too in-your-face friendly. Because it is a web site, the Dept. site will be seen by diverse groups of people, including both our local community of students and faculty and strangers.

  • Do not tamper with the following files without letting Alan know about it in advance:
    • Home page files in the root dept. directory (e.g., index.asp, graduate.asp, undergrad.asp, etc.)
    • Web-form or database-result pages (e.g., /faculty/directory.asp) These pages always have a .asp extension. (The reverse, however, is not true: not all pages with a .asp extension actually have code on them to work with the database)
    • Template or Library files: All pages on the site are associated with Dreamweaver "templates" for the page design, which can be revised in such a was as automatically to revised all pages using the template. In addition, many pages include a navigation bar or other items that are Dreamweaver "library objects," which also can be revised so as to update all affected pages automatically.



Home | People | News | Undergrad | Graduate | Courses | Knowledge Base Wiki | Research | Projects | Search
UCSB English Dept. Home Page
* Disclaimer | Copyright | Credits | About this Site | Login * Site Map | Top | UCSB Home * Webcontact
 
Page Updated: Friday, July 18, 2003 10:39 AM