.

MIT Libraries

Web Guidelines: MIT Libraries

Wikis

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

Overview and guidelines:

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

Applying for new wiki :

Visit https://wikis.mit.edu/confluence/display/MITDASHBOARD/Wiki+Requests

Form answers:

  • Space Title: Start with "Libraries" (e.g. "Libraries Instruction Toolkit")
  • Space key: This is a short alphanumeric string which becomes part of the URL for the space (e.g. LIBINSTRUCT): The key should be a shortened version of your title. It:
    • must be unique to this space
    • must be ALLCAPS
    • can't contain spaces or dashes
    • should be short
    • Libraries spaces should start with LIB (e.g. "LIBINSTRUCT")
  • Notes: Briefly describe what your wiki will be used for.
  • Membership options: You can optionally associate a Moira group (or groups) with your wiki space.
    • If you choose not to use groups, you can still manage permissions for your space by designating permissions for individual users.
    • You can also associate a Moira group or groups with the wiki space at a later time.
  • Hit "Submit 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 right 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: choose from the Get Help or Resources menu at the bottom of each page.
    • For more help, email wiki-support@mit.edu

    Set permissions:

    • Choose "Browse" (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: don't use this unless you want the whole world to be able to read and/or edit your wiki!
    • Remember: always 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 Team membership:

    When you log on and arrive at the Wiki Dashboard, you have the option to limit the number of wikis you see under Spaces: "My", "Team", "New" or "All."

    You will only see spaces on which you have some level of permission (even if it's only permission to read - even so, "All" can be a long list.)

    To add your space to the Libraries team:

    • While in your space, choose "Browse" (at right top)
    • Choose "Space Admin"
    • Choose "Space Operations > Edit Space Labels" on the left side of the Space Admin. page.
    • Add Team Label on the right side of this page.

    Set "Look and Feel"

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

    To replace the generic MIT logo MIT with the Libraries logoLibraries 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 save your work before exiting the page, or it will revert to the previous state.

     

     

     

     

     

     


     

    * more about Moira groups

    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 the Confluence Wiki 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.

    More about permissions

    Visit the Libraries Wiki Chat page about permissions to find answers to questions about things like giving permissions on your wiki to someone who's never had permissions on an MIT wiki before.

     

     

     

    last edited mlcar 10/20/09