Site Style/Editing Guide

General HTML Markup Guidance

When you add new documents to the site, please use responsible/semantic markup, e.g. use <h1></h1> for main headings, <h2></h2> for secondary, etc. as your document dictates. Also, use <cite></cite> when citing book titles, and <strong></strong> when you need to emphasize a passage. Observing these simple guidelines will help structure our documents in a more meaningful way and keep them looking consistent.

URL Renaming

URLs may be edited to created a more "friendly" format by using the "URL path settings" section of any edit screen related to a document. For example, this document has a URL path setting of "administrative/sitestyleguide." Before this change, the URL was "node/280/." URLs should be renamed using a format that reflects their location in the menu hierarchy as shown in the example related to this page.

Please do NOT rename URLs of articles submitted as part of The Medium.

Pictures and Captions

Upload your image (cropped to an appropriate size) and reference it using the following example. The "xxxx.xxx" stands for the name of the picture that you have uploaded. Below the "img" tag, include a caption using the following example. Note that a caret (^) is used before the caption phrase to help point to the picture.

<img src="/files/xxxx.xxx">
<span class="caption">^ Austin Skyline</span>

Updating Annual Meeting Page and Archiving Old Information

The annual meeting base URL is located here:

http://www.arlis-txmx.org/annualmeeting

From this page, a link at the top is provided to a details page related to the current meeting. At the bottom of the page is a link to the past meetings page.

When it is time to add information about a new (and upcoming) meeting, first archive the old annual meeting page by following these steps:

  1. Load the old meeting page and go into edit mode.
  2. Under the "Menu settings" area, change the "Parent item" to "Past Meetings." This operation moves the old meeting page so that it appears under the "Past Meetings" menu item.
  3. Changed the "URL path settings" to "annual-meeting/past-meetings/YYYY" as in annual-meeting/past-meetings/2009
  4. Uncheck "sticky" and "promote to front page" if those are activated.
  5. Save the page.

Now edit this page, adding a link to the archived meeting page that you have just edited at the top following existing examples:

http://www.arlis-txmx.org/annual-meeting/past-meetings

Now you are ready to create a new page for the new meeting:

  1. Click the "Create content" link under your login area and create a new "story."
  2. Give it a title following this format:
    Annual Meeting 2009 | November 6-9 | McAllen, Texas
  3. Assign the page a general topic of "Annual Meeting."
  4. Assign a "Menu link title" using the following example:
    2009 McAllen
  5. The "Parent item" should be set to "Annual Meeting."
  6. Change the "URL path settings" to "annual-meeting/YYYY" as in annual-meeting/2009
  7. Add content, attachments, etc., and save

Now edit this page by providing an introduction and link to the new meeting, using existing content as an example. Delete the old meeting information.

http://www.arlis-txmx.org/annualmeeting