UC Berkeley Robotics and Intelligent Machines Lab
FAQ
Previous section  |  This section  |  Next section
Collapse

Editing group pages, and other forms of rocket science

Information on how to set up and edit group home pages, and other advanced features of the site.

How do I control access to my workspace?

Based on How do I control access to my workspace? by John Reekie, 15 Jun 1999

Each section of a workspace (the part of the site devoted to a workgroup, such as its FAQ, forum, and so on), has a set of access control flags associated with it. The administrator of a workgroup can set these flags from the Admin page of that group according to the degree of access/privacy needed by the group.

The access control flags are a two-dimensional grid, where one axis is the region of the workspace, such as the FAQ or forum, and the other is the class of user. User classes are as follows:

  • world. Users who are not logged into the site. As far as the server can tell, this could be anyone in the world.
  • site. Users who are logged into the site as a member of a group, but are neither a guest nor member of your group.
  • guest. Users who are logged into the site and have guest membership in your group.
  • member. Users who are logged into the site and are a member of your group.
  • admin. Users who are logged into the site and are are administrators of your group.

Any given user has the highest class that applies to them (where the order is admin, member, guest, site, world in the above list). As a general rule, higher classes have higher permissions, where the permissions that can be assigned to each class of user are as follows:

The flags are as follows:

  • Read. The user is able to read these pages.
  • Annotate. The user is able to add annotations to these pages. Annotations are no longer used.
  • Write. The user is able to add content to this part of your workspace. For example, a user with write permission can add an article to your forum.
  • Modify. The user is able to modify these pages (where the user interface permits). For example, a user with modify permission can edit an article in the forum. (Note: the author of an article can always edit it, even if they don't have modify permission in that part of the workspace.)
  • Execute. This is only useful in a few rare cases, and allows certain destructive operations that should only be done by an administrator.
When you add a new feature to your workspace, you should check the access permissions carefully. Here are a couple of tips:
  • If the workspace is primarily for work in progress, you may want to make access more restricted, so that confidential results (for example) are not world-readable.
  • If you are a software development group, you may wish to make access more permissive. Allowing anyone to add to and annotate your forum and faq can be a valuable source of feedback from people who are using your software.
We recommend that you err on the side of permissiveness when setting access permissions -- it is generally better in a research environment to have more information flow than less!

Groups with CVS Home Pages

If a group has a CVS home page (Under admin -> Configure Group, "CVS Checkin" is checked), then the home page visibility has the following effects:

home is world readable: Then a non-logged in user will see the contents of the CVS repository.

home is not world readable: Then a non-logged in user will see the contents of the workgroup profile, which is set by admin -> Group Profile.

How do I request a new group?
To request a group, go to options -> Request New Group.

Group names should be one word, lower case.

How do I customize my margins and footers?
The CHESS/CPS-FORCES/E3S/Embedded/iCyPhy/TerraSwarm/TRUST server provides a facility that allows the pages that you author and that appear in your workspace to be customized. To customize your pages, you need to:

  • Turn on the "Fancy HTML" option in your group's configuration options.
  • Create a file called "toc.html" in the root directory of your HTML files. (That is, in the same directory as the index.html file you see when you go to robotics.eecs.berkeley.edu/groupname.)
The toc.html file can contain anything you want. However, the server parses it looking for pairs of HTML comments that look like this:
<!--margin-->
My margin text
<!--/margin-->
If the parser sees a block like this, it extracts the text between the comments and places it in the left-hand margin of the displayed page, instead of the links that it would normally generate.

You can also append text to the existing auto-generated margin text by inserting the "+" sign, as follows:

<!--+margin-->
Text appended to margin
<!--/margin-->
Several fields can be specified in this way:
  • margin: text is inserted or appended to the left hand margin that appears on every page.
  • footer: text is inserted or appended to the footer that appears on every page.
  • header: text is inserted or appended to the header links that appear on every page.

In addition, a block named options can be used to specify additional formatting and display options. the syntax is

<!--options-->
name1=value1
name2=value2
<!--/margin-->
Currently the following options are supported:
  • margincolor: The background color of the left-hand margin.

Once you have a custom setup for your site, you may wish to further customize subdirectories in your site. You can do this simply by placing another "toc.html" in sub-directories that you wish to customize. Note that you will need to duplicate all fields in your top-level file -- for example, if you put a footer in your top-level toc.html, you will have to put one in the sub-directory's toc.html too.

Note also that on all sites except e3s, toc.html is not "inherited." If /diva has a toc.html, and /diva/x has a toc.html, but /diva/x/y does not, then files in /diva/x/y will use the toc.html from /diva, not the one from /diva/x.