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

Updating the website

This section describes how to update the Robotics site.

How do I update workgroup pages using SVN?

This page is about updating the workgroups of the website. To update the main page, see How do I check out my own copy of the main page with SVN?

Getting started quickly

Many of the workgroups have a SVN Repository associated with them.

The idea behind SVN is that SVN copies a version of a source repository on repo.eecs to your local machine. The svn commands are run on your local machine, edits are made, the changes are committed and then the website is update.

To update the workgroup pages, do the following

  1. Request a Version Control (VC) account or access. Note that your login on repo.eecs.berkeley.edu may be different than your login on the website.
    If you have a UCB EECS account, then your login on repo.eecs will be the same as your UCB EECS login. Note that even if you have a UCB EECS account, you will still need to request access to the repository.
    If you do not have a UCB EECS account, then your login on repo.eecs will be your email address.
    If your username on repo is different than your local account, then in the commands below you can use --username yourusername@youremail.com, for example, --username elvis@graceland.com
  2. Install Subversion. If you are using Windows, try TortoiseSVN. See below for detailed instructions.
  3. All the repositories for the CHESS, CPS-FORCES, E3S, Embedded, iCyPhy, Robotics, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.
    The table below lists the websites and the first part of the URL
    Website First part of the Repository URL
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    Robotics https://repo.eecs.berkeley.edu/svn/projects/robotics/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/

     

    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.
  4. If you have a UCB EECS account: To check out the TRUST wise workgroup, the command lines would be
          svn co https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    If you do not have a UCB EECS account: and your email address was elvis@graceland.com
          svn co --username elvis@graceland.com https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    This will create a directory "execboard" with a subdirectory "web" with at least one file, "index.html". After this directory is created, you never need to run svn co ... again.
    Next time you want to edit files for the workgroup, just go to this wise/ directory and type:
       svn update
       
    It will update your local copies of the files.
  5. You can edit the index.html file, or any other file in the directory.
  6. You can add a new file or directory by putting it in the same directory and doing:
       svn add filename.html
       
  7. To commit your changes, do:
        svn commit -m "Added myself" web/index.html
       
  8. Once you have committed the changes, you can make them visible on the website by going to the website and clicking on Update at the bottom of any page.

Detailed instructions about Checking Out a Repository

Subversion (SVN) is a version control system that allows multiple users to edit the same source tree. We use SVN to manage the content of group web pages.

Bear in mind that SVN authoring is generally useful for software projects, in which case we assume that you know the basics of SVN. For information about the repository, see the EECSRepo FAQ.

  1. If you are a group administrator of a website workgroup, check that your group has CVS authoring turned on by going to your group pages and then clicking on the Admin link and then Configure Group link and verifying that CVS Module and CVS Checkin are selected. FIXME: We are still transitioning from CVS to SVN, so the choice is CVS Checkin
    If these two choices are not selected, then select them and hit the Change Group Configuration button at the bottom. This will send email to webmaster, who will then set up your cvs repository and send email back to you. While you are waiting, you can proceed with the steps below.
  2. If you don't yet have a Version Control account on repo.eecs.berkeley.edu, and access get one. You can request a VC account. Even if you already have a UCB EECS account, your account will need to be granted read/write access to the repository.
  3. If Subversion is not yet installed, then install the Subversion.
    For Linux and Mac OS X, try running svn --version from the command line. If that command is not present, then you must install Subversion. For Windows, the command line might work from Cygwin Bash, if Cygwin Bash has been installed. However, most Windows users will install TortoiseSVN.
    • For Unix, to download Subversion, see: https://subversion.apache.org/packages.html
    • For Mac OS X:
      Find a Subversion Mac OS X application such as SvnX. SvnX requires that you install svn by hand, but helpfully includes instructions. If you are using svnX, please see the website-specific instructions.
      OR
      Install from the Subversion site.
      OR
      1. Install Xcode from Apple, which includes gcc and other tools. Xcode is usually free, but can only be installed via the Mac App store, which requires an Apple Store login and a credit card.
      2. Download and installed the Command Line Tools for your version of Mac OS X by going to https://developer.apple.com/downloads/index.action and searching for Command Line Tools.
      3. If the installation is successful, then svn --version will now work in the Terminal window.
    • For Windows, you can use TortoiseSVN or download svn and OpenSSH as part of Cygwin.

Using TortoiseSVN

  • Download and install TortoiseSVN
  • Go to the directory where you want to check out the repository, right click and select SVN Checkout
  • All the repositories for the CHESS, E3S, Embedded, iCyPhy, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.

    Make these changes to the dialog:
    URL of Repository
    Choose according to the Website
    The table below lists the websites and the first part of the URL
    Website URL of Repository
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/
    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.

    Below is a sample screen shot that would be used to check out the TRUST website:

    Screenshot of TortoiseSVN

    When you hit OK, you will be prompted for your password twice.
    If your account on repo.eecs has been set up with access to the repository, then after you type your password and hit ok, then the workgroup files will be downloaded to your machine.

    The website files will appear in the web subdirectory. Edit the files as you see fit. To associate the file with a specific editor, e.g. WordPad, right click on the file and choose Explore from the menu. Right click again on your file and select <Open with...> Wordpad. When you are through editing, then right click and select CVS Commit, enter a log message and select OK.

    To update the website, go to the main site, log in to the website scroll to the bottom of the page and select Update.

    How do I check out my own copy of the main page with SVN?
    The main page is in a Subversion (SVN) repository. To update the main page, you need administrative privileges in the robotics workgroup. To request permission, go to Options and request administrative access in the robotics workgroup.

    Once you have been granted administrative privileges in the robotics workgroup, obtain Version Control access to request creation of your svn account. Once you have your svn account, follow the instructions at How do I update work group pages using SVN?

    The URL for the repository containing the main page of the Robotics website will be:
    svn co https://repo.eecs.berkeley.edu/svn/projects/robotics/roboticswww/trunk/roboticswww

    How do I update site-specific portions of the main page?

    See How do I check out my own copy of the main page

    The source for the Robotics main page is in roboticswww/index.htm.

    The table of contents is in roboticswww/toc.htm.