IR Web Publishing Guidelines



Information Resources - The University of Texas at Dallas web publishers are responsible for the content of the pages they publish and are expected to abide by the highest standards of quality and responsibility.

These guidelines are intended to assist Web publishers in professionally and consistently representing The University of Texas at Dallas - Information Resources on the Web.

In addition to the publishing guidelines included in this site, all publishers should comply with established UTD Web Publishing Policies and Information Resources policies.

Publishers must commit to keeping their pages up-to-date and with correct information.

It is the policy of Information Resources that all official Information Resources information published on the Information Resources Web site shall be accessible to all users.

The IR Web site was created with standards-compliant XHTML 1.1 applications.

Web publishers and developers are responsible for testing their sites in each of the preferred browsers on the available platforms. We discourage publishers from implementing any browser-specific features which do not break gracefully in Internet Explorer 5.5 or later, Mozilla 1.2 or later, and Safari 1.2 or later.

The IR Web Site contains 5 cascading style sheets and 4 java scripts. The main cascading style sheet defines the body, font family, font sizes, headers, tables, colors, links, menus, superscript, printing, etc. The 4 java scripts define the menus, search links and WebTrend tracking. For a complete list of features please contact the Information Resources Web Designer.

Naming Files, Subdirectories, and Links

The way Web files, subdirectories, and links are named determines how easily users find information and navigate your site. A logical naming system also makes it easier to maintain your site.

Organize files into subdirectories

It may help to think of a subdirectory as being similar to a folder. Organize your HTML files by topic in as many subdirectories as necessary.

Use index.htm or index.php as the name for the first or primary page of your Web site

If the primary page is called index.htm or index.php you do not need to specify it when listing URLs. Both of the links below work, but the shorter one follows standard naming conventions and is easier to remember and type:

When linking from other sites or pages to your main page, don't specify /ir/index.htm in the link. Just point to /ir/. This is helpful in changing the file extension of your main page from index.htm to something else later on, such as index.php. If other pages link to /ir/index.htm they must be changed. If those same pages linked to /ir/, the links will work no matter what type of file extension you use.

Keep file and subdirectory names short and descriptive and in lower case.

Make link text meaningful

Repeat usage of click here does not help readers easily locate the information they need easily. Instead, write your link text to describe the page it links to.

Metadata is data about data. In terms of your Web pages it is additional descriptive information about the page. Typical information might include keywords, a description, author, date of update and other information. Including metadata in Web pages can help in managing them and can help users find them. Every page created must contain keywords and a description highlighting the page content.

The Web templates developed for the 2007 redesign include metadata for keywords and description.

Why should I bother with metadata?

This is like asking why the library should bother with a library catalog. Metadata can help other people find your pages. It can be used to relate pages of similar topics or authors. It can help determine the freshness of your pages. While the tools used to gather and process the metadata are still being refined, take advantage of these tools as they become available.

State of Texas law and Department of Information Resources Web publishing guidelines require Web sites to include a link to the University's Web privacy policy at www.utdallas.edu/privacy.html

As required by the Digital Millennium Copyright Act, the university has a copyright page addressing complaints. Web sites are not required to link to this copyright statement but all publishers should be aware of it.

Campus publishers can include copyright and usage statements on their sites to help answer questions about appropriate use for the resources in the site. Two sample statements are:

 

As part of the 2007 Web redesign, templates were created for Web publishers. These guidelines assist publishers in using the templates and in representing Information Resources at The University of Texas at Dallas on the Web in a consistent, professional manner.

There is one master template. From that template custom templates were created for each department/group/publisher or publishers. All departments / groups will have a custom navigation menu including a Home, About, Staff and Site Map. Every page will also contain Popular Links, and Site Search.

  1. Identify the audiences for your site. Who visits your site regularly? What terms would they use to identify?
  2. Identify users' major tasks. What do your users want to accomplish on your site? What information are they looking for?
  3. Organize information by audience, task or both. Depending on the type and breadth of information presented, select one or two organizational systems for your page and clearly delineate them. Ideally, after one quick look, users will be able to understand how the information is organized. This does not mean that they will have memorized all of the information contained on the page. It just means that they will know how and where to look for what they want to find.
  4. Organize lists of material (lists of links, offices, etc.). Organize the list of materials either alphabetically or by importance to users.
Naming
  1. Use consistent terminology. Be aware that one term can represent different kinds of information. Do not use the same term to refer to different pages. For example, if a section of your site is devoted to policy, select a consistent word and use it on all pages that refer to the policy section of the page.For example avoid calling it "Policy & Procedures" on the index page, but referring to "Policy Information" on subsequent pages.
  2. Ask yourself what kind of information the user expects to find behind a given link. Link labels should match the title of the page where the link leads. For example, when a user clicks on the "e-mail support" link, they should be directed to a page entitled "E-mail Support."
  3. Spell out all acronyms at their first use. Example: The Help Desk is part of Technology Customer Service (TCS). Do not assume that users know what an acronym stands for.
  4. Label items logically and include helpful scope notes throughout. If a term or a name of an office isn't intuitive or explanatory, provide details. A scope note is a brief description which adds depth to the navigational elements. Consider removing repeat instances of "Office of" in front of names
  5. Avoid using icons or graphics as the only source of labeling information. Graphics and icons can be misinterpreted.
Navigating
  1. Include some visual clue when a page requires a NetID.
  2. Make thumbnail pictures clickable links. Users expect thumbnails to be links to the material they represent.
  3. Include the group's name on all pages.

You have a 40 page report with a Table of Contents, Executive Summary, Appendices and have been asked to publish the report on the Web. How is this task accomplished? There are a variety of options, each with their own advantages and disadvantages, including:

  • Creating an Adobe Acrobat PDF file
  • Using Microsoft Word's built-in Save As Web page feature
  • Breaking the report into sections and using links to improve web navigation
  • Creating links to external resources to add value to the report
  • Uploading the Word document "as is" and letting people download the .doc file

These pages outline several possibilities for putting the report on the Web in a reasonable manner.

Use SharePoint.

When adding a graphic make sure to provide a description of the image in the <img src="image.gif" alt="NetID required">. You can use the following types of graphics:

  • GIF
  • JPG
  • PNG

Flash

Web Video

Creating and Maintaining a Campus RSS Feed

Really Simple Syndication (RSS) files, or "feeds", enable Web publishers to provide a summary of their site in a standard XML format. RSS files can be used to syndicate headlines or updates from your site to other sites that subscribe to your RSS feed. RSS feeds are commonly used to announce news or spotlight items, but they can include links to any content at your site or other sites, including audio files for podcasts.

Posting Your RSS File
  1. When finished creating RSS file, save it with .rss as the extension. (for example, name the file helpdesknews.rss)

  2. Upload your RSS file to your Web server as "ASCII" or "text."

  3. If you have an RSS feed for a Web site, you can also include a link to that within your Web page.
Maintaining Your RSS File

Publishers must commit to updating their channels at least once a month. If there news stories or events that occur more frequently, post them as they become available.

PHP

What is PHP?

From the PHP Web site (www.php.net):

"PHP is a server-side, cross-platform, HTML embedded scripting language."

That's a mouthful, but if we break the definition down into smaller pieces, it is easier to understand.

  • server-side: This means that PHP scripts execute on the Web server, not within the browser on your local machine.

  • cross-platform: Cross-platform means that PHP scripts can run on many different operating systems and Web servers. PHP is available for the two most popular Web server configurations (IIS running on Windows NT and Apache running on UNIX).

  • HTML embedded scripting language: This means that PHP statements and commands are actually embedded in your HTML documents. When the Web server sees the PHP statements in the Web page, the server executes the statements and sends the resulting output along with the rest of the HTML. PHP commands are parsed by the server much like Active Server Pages or Cold Fusion tags.
What Can I Do with PHP?

Like most server-side scripting languages, PHP is excellent for creating dynamic Web sites based on database content or different characteristics of browsers. Through the use of external libraries and functions, PHP can:

  • create graphics on the fly
  • serve different content to users based on their browser, IP address, date and time, or numerous other characteristics
  • connect databases like Oracle or MySQL to the Web
  • communicate with external Web sites
  • build discussion forums or Web-based e-mail programs
  • read and process XML

These are just a few of the many things that PHP can do.