Tips for creating or modifying web pages residing in the ACRL Instruction Section web site

Tips for Web Pages

The purpose of this tip sheet is to provide clear and consistent instructions for the development and updating of IS web pages. Keep in mind that any new publications, projects, logos, or other new content will need to be forwarded through your IS Executive Committee liaison for approval.The IS Publication Policy and Procedure Manual outlines general guidelines for proposals, including when proposals are needed.

Table of Contents:

General Tips

  • Revisions or new content may be submitted as Microsoft Word documents. These documents can be easily converted to web content in ALA’s Drupal Content Management System (CMS).
    • Formatting (bold, underline, etc.) from Word documents will also be converted.
    • One best practice is to use headings within Word to ensure correct structure and formatting, as well as accessibility. The page title should be labeled “Heading 1” with other subheadings as “Heading 2” and lower.
  • For all requests, please be as explicit as possible by including URLs (not just page titles) where changes need to occur, exact wording for text, and copying your co-chair, both co-administrators (if applicable), and any other interested parties (e.g., Exec liaison)
  • If you are creating a site which requires folders and subdirectories, please contact the IS web site administrator(s), who will help you develop the directory structure.
  • Send new web pages and major changes through your IS Executive Committee liaison for approval.
  • Files that need to be in PDF format should be converted prior to sending to the web administrators and named according to the File Naming Protocols.
  • For links that need to be created on multiple pages, provide the filename and the specific wording that should be the hyperlink, as well as URLs for all pages where links need to be placed.
  • Once updates to the website have been completed, the co-administrator(s) will respond via email to confirm the changes made.

Modifying Web Pages

  1. Minor updates:
    • Minor changes are considered to be changes such as adding/deleting a link, correcting typos, or adding/deleting a sentence or two (even a paragraph).
    • E-mail the IS web site administrators specifying the page URL and the exact changes needed.
    • You do not need to send a Word document, .txt or .html file.
  2. Major changes
    • Major changes are considered to be changes that require significant modifications such as a complete revision of one or more pages.
    • Major changes should be sent through your committee liaison to the Executive Committee for approval.
    • E-mail the approved, updated code as a Word document, .txt or .html file to the IS web site administrators. Include any PDF or other files needed as attachments.
    • When a web page is no longer needed, please inform the web administrators which page should be deleted.
      • Committee chairs are responsible for archiving web pages related to that committee's work; for more information consult the Archiving web site.

Creating New Web Pages for a Project or Publication

  1. Create the main content of the page(s) using Microsoft Word, or a plain text editor like Notepad (not Wordpad) or an HTML editor.
  2. You do not need to include the Instruction Section Logo.
  3. You may include a project logo approved by the IS Executive Committee.
    • Please attach this logo to your email request.
  4. Please specify a title for your page.
  5. The introductory text on the page should identify the Instruction Section and the specific committee(s) responsible for the page.
  6. Send accompanying images to the web site administrator(s) for uploading.
  7. Publications and projects will reside in the Publications & Projects directory of the IS web site with links from the authoring committee's page and other appropriate IS web pages.
  8. The published page will be named according to the filenaming protocol established by the IS Executive Committee. The web administrators will rename this page if needed.

Creating a Committee Web Page

  1. Create the main content of the page using Microsoft Word, or a plain text editor like Notepad (not Wordpad) or an HTML editor.
  2. You do not need to include the Instruction Section Logo.
    • Web Site Administrators will insert the logo via the CMS
  3. The published committee home page will be named according to the filenaming protocol established by the IS Executive Committee. The web administrators will rename this page if needed.
  4. Other Headings, Sections, and Links
    • Most committee home pages include the following sections:
      Charge, Annual Planning, Meetings, Committee Minutes, Roster, and Projects/Publications.
    • For committee minutes, please include the sentence: "View minutes from committee meetings, by choosing a conference date and then the committee name." Make "minutes from committee meetings" a link to: /acrl/aboutacrl/directoryofleadership/sections/is/iswebsite/committees/minutes
    • For annual planning documents, please include the sentence: "View planning documents such as annual goals, measuring success reports, or annual reports by selecting the appropriate report from the Planning Documents Archive page." make "Planning Documents Archive" a link to: /acrl/aboutacrl/directoryofleadership/sections/is/iswebsite/about/planning/archive
    • Rosters are generated by ACRL and member names are pulled from the ALA membership database. Roster URLs can be obtained from the ACRL Section Committee Rosters web page.

Guidelines and Standards

To ensure consistent display and access to content, the IS Web Site Administrators reserve the right to modify the HTML code of submitted files. Content will not be modified without approval from the appropriate committee chair(s) and Executive Committee liaison. Web administrators will ensure that html code and filenames follow ALA/ACRL standards & guidelines.

  1. IS logo
    All web pages will have the IS logo at the top of the page.
  2. Left Hand Navigation
    This is generated via the ACRL template. Addition of a menu item needs to approved by the IS Executive Committee.
  3. Filenames
  4. Word document
    • Edits and new page content may be sent as Word documents (.doc or .docx) with the following formatting guidelines:
      • The page title should be formatted as Heading 1
      • All other headings in the document will be formatted as Heading 2 and lower
      • Other formatting, such as bold, underline, italics and spacing, should appear in the Word document as it is desired to appear on the web page
  5. Images
    • Send accompanying images for a web page, including a short description, to the Web Site Administrator(s), who will upload to the CMS
    • Administrators will add ALT attributes (text describing an image for ADA compliance) for all images to the appropriate HTML code
  6. XHTML Tags
    • In general, pages should use only basic tags and elements such as P, TABLE, List (UL; OL), and ALIGN elements
    • All paragraphs must be enclosed within paragraph <P> </P> tags
    • Use heading level (H1 thru H6) tags for section headings only
    • SPAN and STYLE elements or attributes are typically not necessary
    • Do not use heading level tags to control the size of text within a paragraph instead use <FONT SIZE=" "> tags
  7. Metatags
    • IS Web Site Administrators will add metatags using the following protocol
      • Page title: IS | [page title]
      • Page keywords: ACRL, IS, [other keywords as appropriate and recommended by the committee or Executive Committee]
      • Page description: includes a reference to the Instruction Section & ACRL; reflects substance of the page (recommendations from the submitting committee are encouraged); is limited to 255 characters.
  8. Approval
    Each committee's IS Executive Committee liaison approves new pages and forwards them on to Executive for final review and approval.

Instruction Section Home Page

Send us your comments and questions