HyperText Markup Language
[Previous]  [Next]

Before You Write HTML


Basic Design Principles

You should answer the following preliminary questions before starting work on your proposed Web project:

Once you have answered these questions, consult any of these resources available over the Web addressing "style" and design:

What Makes a Great Web Site?
[ http://www.webreference.com/greatsite.html]
Information Quality WWW Virtual Library
[ http://coombs.anu.edu.au/WWWVL-InfoQuality.html]
Elements of Style for Web Design, Christine Quinn
[ http://www.stanford.edu/~cquinn/papers/bostonpaper.html]

In addition, you should consult the Library of Congress World Wide Web Style Guide [http://www.loc.gov/loc/webstyle/] for guidance on placing your information on the Library's Web site.

Usability, User-Centered Design and Accessibility

Usability AND User-Centered Design (UCD) are approaches that attempt to design ease of use into the total user experience. UCD is now considered the key to a successful Web site. UCD involves multidisciplinary teamwork, methods to acquire user input, and converting user input into design. Some useful links are offered below:

Usable Web: 1122 Links About Web Usability
[http://usableweb.com/]
IBM's User-Centered Design Information
[http://www-3.ibm.com/ibm/easy/eou_ext.nsf/Publish/570]
The Alertbox: Current Issues in Web Usability (Jacob Nielson)
[http://www.useit.com/alertbox/]
10 Web Usability Tips (Human Factors International)
[http://www.humanfactors.com/downloads/10tips.asp]

In addition to general usability, the topic of "accessibility" is also critical to making your Web content avaiable to all. Library of Congress pages must be accessible to all users, including those with dissabilities requiring special browsers or equipment to use Web pages. Some accessibility links are offered below:

Web Accessibility Initiative Home Page (World Wide Web Consortium)
[http://www.w3.org/WAI/]
Americans With Disabilities Act Information
[http://www.usdoj.gov/crt/ada/]
Access.Edu
[http://lrs.ed.uiuc.edu/access]

Create a Mock-Up of Your Page

You will need to think things through before you create any HTML files. A good way to start is to create a mock-up of your proposed home page using your favorite wordprocessing program. Compose the mock-up, underlining text you wish to have act as the hypertext link. Indicate where any graphics will be placed as well as alternate file types (i.e., WordPerfect documents, Adobe Portable Documents Files (PDF), etc.). Also, indicate where you intend to link to existing or new HTML files on LC Web or elsewhere on the Internet.

View an example of a Home Page Mock-Up

Collect URLs for Links to Other Documents

After creating a basic mock-up for your page, you will need to determine the URLs needed for each link you plan to make to an existing URL. There are high-tech and low-tech ways to go about doing this. If you are working in a GUI like Windows or OS/2, you can display pages, via your Web browser, on the screen, then block and copy the displayed URL onto a text editor. Under Windows, you can do this easily between Netscape and the Windows Notepad.

When capturing URLs for other Library of Congress Web pages, you should note the following:

** Note: For more information on making direct links to bills, Congressional Record searches, documents, and Index topics, etc. see Direct Links to THOMAS Documents. [http://thomas.loc.gov/home/example.html]

When linking to servers outside of the Library of Congress, ALWAYS retain the port number when given. The above rules only apply to files on Library of Congress servers.

WWW Home Page Proposal Form (Library Services only)

If you are a staff member in Library Services, you must submit an approval form called the World Wide Web Home Page Proposal Form. This form enables you to gain approval for your mock-up from the division level all the way up to the director level, as appropriate. In addition, your proposal will receive a brief technical review to determine the need for assistance from ITS (programming or graphics design work), user accounts, HTML training or assistance from the Automation Planning and Liaison Office (APLO) to install Web software on your PC. Once the form has been approved, a copy is sent back to you and the original stays on file in the Network Development and MARC Standards Office (NDMSO). Copies of the WWW Home Page Proposal Form are available from NDMSO or from the Library Services Home Page [http://www.loc.gov/staff/ls/].

Planning Names for New Files

In advance of writing any HTML, you will also need to devise file names for your new home page and all new sub-pages you will be creating. This preparation will save you time in the long run. You should also plan file names for all graphic images you intend to include on your page or to link to.

Since both Windows 95, NT and Macintosh accept filenames longer than the for DOS limitation of 8 character filenames with a 3 character extension, it is best to keep the filename exactly the same in your local development environment as they will be on the server. Just be aware that UNIX does differentiate between uppercase and lowercase letters. It is advisable to use only lowercase letters in your Web filenames making things simpler for the user.

On the Library of Congress Web servers, all HTML files should use the .html extension.

Library of Congress Documents Governing Web Page Creation

Web pages originating from the loc.gov host need to conform to existing Library of Congress policies and guidelines. There are two documents you should consult in order to familiarize yourself with these policies and guidelines:

Note: the LC WWW Style Guide is currently being revised (October 16, 2000).

Other Documents To Consult


Go to:


Library of Congress
Library of Congress Help Desk ( December 20, 2002 )