Web Guidelines: MIT Libraries

Wikis

Overview and guidelines | Applying for a new wiki | Setting up your wiki

Overview and guidelines:

Any member of the MIT community can request a Confluence wiki space for use by their group or project.

• Enter through the Wiki dashboard:
  http://wiki.mit.edu
  which includes a list and links to all the MIT Confluence wikis.
• Click on "request a wiki space" or "guidelines" in the top paragraph for more information.

Applying for new wiki :

To go directly to the wiki-creation form, visit https://wikis.mit.edu/request/wiki/#fragment-2

Form answers:

• Space Title: Start with "Libraries" (e.g. "Libraries Instruction Toolkit")
• Preferred space key: The key, a version of your title,
  • must be unique to this space
  • can't contain spaces or dashes
  • should be short
  • ALLCAPS
  • should start with LIB (e.g. "LIBINSTRUCT")
• Membership options: "Groups available to you" in the drop-down menu (includes only groups to which you already belong)
  • Choose a group, hit "add group," and its name will appear in the box "selected groups."
    
    • About groups in Moira * | Exception **
  • You don't have to choose any groups now - you can add permissions to groups and individuals after the wiki is published.
• Please provide your MIT email address: This will usually be automatically filled in with your complete address@mit.edu
• Notes: Briefly describe what your wiki will be used for.
• Please indicate whether this wiki space is associated with one of the following MIT units: Choose Libraries.
• Hit "submit this request."
• An email will arrive from MIT IS&T: Athena User Accounts
  http://web.mit.edu/accounts/www/
  Phone: 617-253-1325
  usually by the next day, containing your wiki's URL and other information.

Setting up your wiki

• When you receive your approval email, click on the URL link to surf to your home page.
  • Choose "edit" (at top left of page), and you can
    - change the name of your first wiki page from "Home" to the actual name, minus the word "Libraries" - e.g., "Instruction Toolkit."
    - add a search box, if you'd like, by including this code:

  {search-box:label=Search this wiki}

  • Help for maintaining your wiki is available from every page by clicking on in the upper right of the page.

  Set permissions:

  • Choose "Browse Space" (at right top)
  • Choose "Space Admin"
  • Choose "Security > Permissions" on the left side of the Space Admin. page.
  • Chose "edit permissions" in any category.
    • Individuals: Entering an individual's MIT Kerberos name will cause their full name to appear on the list of individuals.
    • Group: Remember that you can only grant permissions to a group to which you already belong.
      - About groups in Moira *
    • Anonymous Access: use this only if you want the whole world to be able to read or edit your wiki
  • Remember always to save your work before exiting the page, or it will revert to the previous state.
  • More permissions information: Controlling access to your Wiki space

  Set "Look and Feel"

  • Choose "Browse Space"
  • Choose "Space Admin"
  • Choose "Look and Feel"
    • Themes - most people like the Default Theme

  To replace the generic MIT logo with the Libraries logo

  • Download the image to your hard disk
  • Choose "Space Admin > Look and Feel > Change Space Logo."
  • Use the box to browse to the image on your HD.
  • Chose "Upload Logo" - and the logo for your site will change.
  • Remember always to save your work before exiting the page, or it will revert to the previous state.

   

   

   

   

   

   

  ---

   

  * About groups in Moira

  A mailing list is not always a group.

  When you create a new mailing list, you have the option of also turning it into a group. If you will want your list members to have permissions on your wiki, be sure to make it a group. If the group to which you want to give permissions is not on the drop-down groups menu, ask a member of that group to add you.

  We are all members of all-lib, which is both a list and a group: Choosing "display list characteristics" for all-lib in the athena list management page tells us, in part:

  List: all-lib
  Description: Libraries staff list - all staff
  This list is a mailing list.
  This list is a Group and its ID is: 28676

  Case in point: dsg-lib was created as a list, but not a group - so when we first tried to give dsg-lib permissions in the DOME Selection Group wiki, we failed.

  The IS&T wiki administrators are able to turn lists into groups, after which, permissions can be applied. Ask the wiki administrators for help.

  ** Exception: because of the evolution of this service, several groups, including "all-lib," are named "confluence-groupname." If you can't find your group in the alphabet, look under "c.

  If you don't see the group (not the same as a list!) that you want, ask a member of the group to add you to the group through Moira.

   

   

   

  last edited mlcar 4/4/08