Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{panel}
*Training info:*
* [LibGuides training outline, February 2009|^LibGuides training February 2009.doc]
* [LibGuides training handout, February 2009|^LibGuides handout rev2 09.doc]

* [LibGuides training outline, Summer 2008|https://wikis.mit.edu/confluence/display/LIBTALKS/LibGuides+staff+training]
* [What's changing about Vera, Summer 2008|http://libstaff.mit.edu/vera/2008/] \- how databases by subject are now integrated into LibGuides
 
{panel}

h3. *Basic guidelines for creating LibGuides pages:*

* Follow the web style & writing guidelines already in practice:
** [Web Guidelines|http://libstaff.mit.edu/web/guidelines/]
** [Writing for the Web|http://libstaff.mit.edu/web/writing/]

* Keep it simple\!

|| Guideline || Example ||
| *General:* | |
| Follow existing web guidelines whenever possible, including use of color and recommended fonts. \\ | |
| You can use LibGuides to create any sort of research guide: publication types, subject pages, databases cheatsheets, course pages, etc. | [Publication type|http://libguides.mit.edu/sae], [subject page|http://libguides.mit.edu/materials], [course page|http://libguides.mit.edu/mites] \\ |
| | |
| *Setting up your profile:* \\ | |
| Label the profile box (and all boxes\!) wisely: \\
* My Profile
* Ask Us
* Subject Specialist
* Dewey Library (or other library name)
* Questions? | [
Panel

Training info:

Basic guidelines for creating LibGuides pages:

  • Keep it simple!

...

Guideline

...

Example

...

General:

...

 

...

Follow existing web guidelines whenever possible, including use of color and recommended fonts.

...

 

...

You can use LibGuides to create any sort of research guide: publication types, subject pages, databases cheatsheets, course pages, etc.

...

Publication type, subject page, course page

...

 

...

 

...

Setting up your profile:

...

 

...

Label the profile box (and all boxes!) wisely:

  • My Profile
  • Ask Us
  • Subject Specialist
  • Dewey Library (or other library name)
  • Questions?
http://libguides.mit.edu/21W-732-01

...

Use your Kerberos ID for your profile shortcut.

] \\ |
| Use your Kerberos ID for your profile shortcut. \\ | [http://libguides.mit.edu/profile/darcy

...

Only include your name in the "Display Name" field.

...

We strongly encourage you to add your photo to your profile. Usability tests showed they made it VERY easy to see the contact info and made the profiles stand out. Staff photo use guidelines should be followed.  No avatars!  Hide the photo box on each guide, if you don't use a picture. 

] |
| Only include your name in the "Display Name" field. \\ | \\ |
| We strongly encourage you to add your photo to your profile. Usability tests  showed they made it VERY easy to see the contact info and made the profiles  stand out. Staff photo use guidelines should be followed.  No avatars\!  Hide the  photo box on each guide, if you don't use a picture.  \\ | [http://libguides.mit.edu/compsci

...

] |
| Use "friendly" URLs (shortcut URLs) for all pages.

...

 

...

Adding chat contact info is optional.  People are welcome to embed Meebo boxes, but color should match with our color scheme (black, meebo, mac, meebome).

 \\ | |
| Adding chat contact info is optional.  People are welcome to embed [Meebo|http://libstaff.mit.edu/web/guidelines/meebo.html] boxes, but color should match with our color scheme (black, meebo, mac, meebome). \\ | [http://libguides.mit.edu/theater

...

Contact information should always display in top right.  You can delete the default profile box, as long as you add a new box with contact info. 

] \\ |
| Contact information should always display in top right.  You can delete the default profile box, as long as you add a new box with contact info.  \\ | [http://libguides.mit.edu/companies

...

 

...

Page layout:

...

The fewer boxes, the better!  Keep it simple.  No set limit to number of boxes allowed on page, but if it looks cluttered or if scrolling is excessive, consider reorganizing or using Dreamweaver.

...

1, 2, and 3 column layouts are all ok to use use.  

] \\ |
| \\ | |
| *Page layout:* | \\ |
| The fewer boxes, the better\!  Keep it simple.  No set limit to number of boxes allowed on page, but if it looks cluttered or if scrolling is excessive, consider reorganizing or using Dreamweaver. | \\ |
| 1, 2, and 3 column layouts are all ok to use use.   | [http://libguides.mit.edu/humgeneral] (2 column)

...

 \\
[http://libguides.mit.edu/materials] (3 column)

...

Set a maximum of 5 or 6 tabs per page.  Subtabs may be used as a last resort, but should be kept as simple as possible and labeled wisely.  Make sure the tab name and the page name match.  Don't link tabs to URLs outside of your guide, since the tabs are meant for navigating within your guide. 

 \\ |
| Set a maximum of 5 or 6 tabs per page.  Subtabs may be used as a last resort, but should be kept as simple as possible and labeled wisely.  Make sure the tab name and the page name match.  Don't link tabs to URLs outside of your guide, since the tabs are meant for navigating within your guide.  \\ | [http://libguides.mit.edu/circ

...

] |
| If you use tabs, make sure to link to the tabs somewhere on the main page.

...

  Users don't always see tabs, so providing alternate navigation helps.

...

  Note: When you link to the tab, don't just copy the link to the tab in edit or preview mode.

...

  You can either copy the tab's URL on a live page, or you can copy tab's URL in edit mode, and delete the "ae" from the URL.

...

  \\
Example:

...

 \\
link for a tab you'd see in live mode: [http://libguides.mit.edu/content.php?pid=18306&sid=126406

...

] \\
link for a tab you'd see in edit mode: [http://libguides.mit.edu/aecontent.php?pid=18306&sid=126406

...

] \\
(You'd want to delete the "ae" before the "content.php" in the link, so that the URL is correct.)

...

 \\ | [http://libguides.mit.edu/circ

...

] \\ |
| When given an option, have links open in a new tab/window.

...

 | \\ |
| Choose to "link to" or "copy" wisely.

...

  Any time the content should be maintained by one person, use link to (ex., search box on [tools page

...

|http://libguides.mit.edu/tools]).  \\ | [http://libguides.mit.edu/tools

...

You can also copy or link to database information.  If you want to change any info on the database pages, e-mail Marion.

  • Pros of linking to the list:
    • Always up to date
  • Pros of copying it: 
    • Can customize it
    • Can add the descriptions to the page
] |
| You can also copy or link to [database information|http://libguides.mit.edu/databases].  If you want to change any info on the database pages, e-mail Marion. \\
* Pros of linking to the list:
** Always up to date
* Pros of copying it: 
** Can customize it
** Can add the descriptions to the page \\ | [http://libguides.mit.edu/databases

...

] |
| To add an "info link" to your list of databases:

...


* If you link to the list of databases, ask Marion to do it for you.

...


* If you maintain your own database list, copy and paste the code for your link from this list of [Info URLs for Vera databases|https://wikis.mit.edu/confluence/display/LIBVERAMETALIB/Info+URLs+for+Vera+databases].

...

  Don't see your resource listed?

...

  Ask Marion to add

...

 

...

 

...

Content:

...

 

...

Less is more!  Usability tests show that users get overwhelmed with a lot of content, so keep text to a minimum.  Organize your content so that you can have fewer boxes and columns.

...

 

...

  • biology: BIOSIS
  • chemistry: SciFinder
  • computer science, electrical engineering, physics: Inspec
  • engineering: Compendex
  • math: MathSciNet
  • medicine: PubMed
  • science: Web of Science

...

 

...

Put databases in order by importance, not in alphabetical order.  Users tend to choose the first databases in the list, not the most relevant.  

 it.
* <!--  /* Font Definitions */  @font-face 	{font-family:Wingdings; 	panose-1:5 0 0 0 0 0 0 0 0 0; 	mso-font-charset:2; 	mso-generic-font-family:auto; 	mso-font-pitch:variable; 	mso-font-signature:0 268435456 0 0 -2147483648 0;}  /* Style Definitions */  p.MsoNormal, li.MsoNormal, div.MsoNormal 	{mso-style-parent:""; 	margin:0in; 	margin-bottom:.0001pt; 	mso-pagination:widow-orphan; 	font-size:12.0pt; 	font-family:"Times New Roman"; 	mso-fareast-font-family:"Times New Roman";} span.EmailStyle15 	{mso-style-type:personal; 	mso-style-noshow:yes; 	mso-ansi-font-size:10.0pt; 	mso-bidi-font-size:10.0pt; 	font-family:Arial; 	mso-ascii-font-family:Arial; 	mso-hansi-font-family:Arial; 	mso-bidi-font-family:Arial; 	color:purple; 	font-weight:normal; 	font-style:normal; 	text-decoration:none; 	text-underline:none; 	text-decoration:none; 	text-line-through:none;} @page Section1 	{size:8.5in 11.0in; 	margin:1.0in 1.25in 1.0in 1.25in; 	mso-header-margin:.5in; 	mso-footer-margin:.5in; 	mso-paper-source:0;} div.Section1 	{page:Section1;}  /* List Definitions */  @list l0 	{mso-list-id:943727282; 	mso-list-type:hybrid; 	mso-list-template-ids:-1916527176 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} @list l0:level1 	{mso-level-number-format:bullet; 	mso-level-text:; 	mso-level-tab-stop:.75in; 	mso-level-number-position:left; 	margin-left:.75in; 	text-indent:-.25in; 	font-family:Symbol;} @list l0:level2 	{mso-level-number-format:bullet; 	mso-level-text:o; 	mso-level-tab-stop:1.0in; 	mso-level-number-position:left; 	text-indent:-.25in; 	font-family:"Courier New";} @list l0:level3 	{mso-level-number-format:bullet; 	mso-level-text:; 	mso-level-tab-stop:1.5in; 	mso-level-number-position:left; 	text-indent:-.25in; 	font-family:Wingdings;} ol 	{margin-bottom:0in;} ul 	{margin-bottom:0in;} -->Find the database title in the list, and copy everything after the title, including the dash.
* Go to your LibGuides page, and click "edit text" in the box where you want to add the info link.&nbsp; In the edit box, click the link above the formatting options to "switch to the plain text editor."
* Paste the code where you want the info link to appear, and save changes. | \\ |
| | |
| *Content:* | |
| Less is more\!&nbsp; Usability tests show that users get overwhelmed with a lot of content, so keep text to a minimum.&nbsp; Organize your content so that you can have fewer boxes and columns. \\ | |
| Users tend to choose databases based on names - if the name of the database doesn't indicate the content (like Compendex), they don't go there.&nbsp; Use descriptive words in or near the database titles if not clear. \\
\\
Example of a clear way to do this: \\  \\
Find articles related to... \\
* biology: BIOSIS
* chemistry: SciFinder
* computer science, electrical engineering, physics: Inspec
* engineering: Compendex
* math: MathSciNet
* medicine: PubMed
* science: Web of Science | |
| Put databases in order by importance, not in alphabetical order.&nbsp; Users tend to choose the first databases in the list, not the most relevant.&nbsp;&nbsp; | [http://libguides.mit.edu/neuroscience

...

] |
| Users get confused with too much contact information, so make it clear by providing one way to contact us for help.&nbsp; (ex., Don't include links to Ask Us AND ask-dewey.)

...

 

...

 

...

 

...

Other features:

...

 

...

Don't use tags feature.

You can either upload images and images through LibGuides (in edit mode), or store them on the Libraries server, and you can link to them from your LibGuide.  If you need permissions, or if you don't know how to upload, ask libguides@mit.edu to do it for you.  Upload to:

 \\ | |
| | |
| *Other features:* \\ | |
| Don't use tags feature. \\ | \\ |
| You can either upload images and images through LibGuides (in edit mode), or store them on the Libraries server, and you can link to them from your LibGuide.&nbsp; If you need permissions, or if you don't know how to upload, ask libguides@mit.edu to do it for you.&nbsp; Upload to:
* www/guides/libguides/img

...


* www/guides/libguides/files

...

 | [http://libguides.mit.edu/compsci

...

Making pages live:

...

] |
| \\ | \\ |
| *Making pages live:* \\ | \\ |
| Make sure to add a "friendly" shortcut URL for each page.&nbsp; If you're making a test page, end the URL with "-test".

...

&nbsp; LibGuides won't let you use a "dot", so if you're creating a course page in LibGuides, use a *hyphen* in the friendly URL in place of the dot.

...

 | [http://libguides.mit.edu/2-009

...

] |
| If you want to save an old version of a page, change the page title to include the date, or some other identifier that will show that it's an old page (ex., "Product Engineering Processes, 2007").&nbsp;Also, change the shortcut URL to "pagetitle-old" (ex., biology-old), and change the status to "private."

...

&nbsp; If you have more than one old version saved, you could use "pagetitle-old-2007" or something else that would make sense.

...

 

...

Add one or more subject categories per page.

...

 

...

Keep pages public or private.  Don't bother with unpublished.

...

 

...

No need to get approval to post pages.  Tell Marion when it's live so she can update links to it from pages on our site that link to it, including our Site Index.

...

 

...

If you don't want a guide anymore, delete it!  (You can delete the page that Marion made for you originally, too, if you're not using it anymore.)

...

 

...

 | |
| Add one or more subject categories per page. \\ | |
| Keep pages public or private.&nbsp; Don't bother with unpublished. \\ | |
| No need to get approval to post pages.&nbsp; Tell Marion when it's live so she can update links to it from [pages on our site that link to it|http://libraries.mit.edu/research-guides], including our [Site Index|http://libraries.mit.edu/site-index.html]. \\ | |
| If you don't want a guide anymore, delete it\!&nbsp; (You can delete the page that Marion made for you originally, too, if you're not using it anymore.) \\ | |
Need help??&nbsp; Ask [mailto:libguides@mit.edu]