Sublime Subversion

We’re still a ways away from the release of Sublime 1.3 but I thought it would be a good idea to provide a sneak peak into what we have in the works.

Apache Support

Although Sublime currently supports Active Directory authentication with Apache it requires you to install and configure Apache manually.  Starting in Sublime 1.3 we will manage the installation and configuration process automatically.  No more mucking around in configuration files – Sublime 1.3 will provide the same easy-to-use management interface that we do for the rest of Sublime’s features.

Hook Script Management

Sublime 1.3 will support hook script management for repositories.  Administrators will be able to make certain hook scripts available and even enforce that all repositories use certain scripts.  This is useful for enforcing policies or integrating with other systems such as bug trackers.  Once these scripts are available repository owners will be able to easily enable or disable them for their repositories.

Minor Features and Updates

Sublime 1.3 will also include the following minor updates:

• Delete a Repository – administrators and (optionally) repository owners will now be able to delete a repository directly within Sublime
• Require Commit Messages – owners will be able to enforce commit messages per-repository
• Bug Fixes and other minor features we can sneak into the development schedule

As always, please leave us feedback on our feedback forum.  This is one of the primary methods we use when planning features for Sublime.

Sublime’s powerful Repository Template feature allows you to create templates that users can select when creating new repositories.  These templates can include folder structures and files that should be created for each new repository.  Creating a basic template is as easy as creating the folders and files, and then editing a few lines in a text file.  However, one of the more powerful features of Sublime is to create templates customized to each new repository.  This, can take a bit more work.

A customized template is one where repository details (name, description or owner) are used when the new repository is populated from the template.  Typically this is used to simply rename files or folders to match the name of the new repository.  But what if you wanted to go farther?  In this post I’ll show you how to create a template containing full Visual Studio solution including multiple projects, all of which will be customized to each new repository.

1. Create a new Visual Studio Solution

Start up Visual Studio and create a solution to be used as your template.  You can create multiple projects, default classes, etc.

New Visual Studio project

2. Rename Files and Folders

Next, close Visual Studio and navigate to the folder containing your solution.  Rename your files and folders using the placeholders below so that they will be renamed when your new repository is created.

• %name% – name of the new repository
• %name-formatted% – name of the new repository formatted for a file system (removed spaces and special characters)
• %description% – description of the new repository
• %description-formatted% – description, formatted for a file system
• %owner% – owner of the new repository
• %owner-formatted% – owner, formatted for a file system
• %guid[0]% – %guid[100]% – unique guids which will be generated when the new repository is generated

Be sure to remove any unwanted files and folders such as bin, obj, or .suo and .user files.

Renamed files and folders

3. Modify Solution Files

The next step is a bit tricky.  Open your Solution File (.sln) in a text editor such as Notepad.  Locate the project names and again, use the placeholders above to rename the names and paths.

Modify project names and paths

Next you must replace the solution GUID and project GUIDs with placeholders so that new GUIDs will be generated for each new repository.  Start with the solution GUID used for each project and replace it with %guid[0]% (leave the GUID braces).

Replaced solution GUIDs

Next you must replace the GUIDs for each project.  Assign numbers to each project starting with 1 and keep a note of which project has been assigned what number.  In my case I chose to use alphabetical order.  Now, select the GUID for the first project, and using Find and Replace, replace it with %guid[1]% (again, leaving the braces).  Do the same for each project, each time using a new guid.

Project GUIDs replaced

Save and close the modified solution file.

4. Modify Project Files

Next, open each project file (.csproj, .vbproj, etc) in a text editor such as Notepad.

First, replace the GUID in the <ProjectGuid> tag with the guid that you assigned in the last step (i.e. %guid[1]%).  If you set up project dependencies when you created your solution, you may need to update those as well.

Next, update the <AssemblyName> and <RootNamespace> tags to use the placeholder names for your new repository.

Modified project file

5. Modify Code Files

Next you may need to modify your source code files to replace namespaces with placeholders.  For example, in this example we replaced the namespaces within the Global.asax and Global.asax.cs files.

Renamed Namespace in Global.asax.cs

6. Finalize Repository Template

Next build out the rest of your repository template structure.  Remember that the files and folders you create will populate the entire repository, so you must create the “tags”, “branches” and “trunk” folders as well.

Complete repository template structure

7. Register the new Template on your Sublime Server

Finally, copy the entire template structure to the Templates folder on your Sublime server (typically C:\Program Files\Sublime\Templates).

New Template copied to Templates folder on Sublime server

Then open the “templates.txt” file and add the details for your new repository template.  See the administrator guide for details on modifying the “templates.txt” file.  Be sure to include the “replaceTokens = true” line for this new template.  Otherwise the placeholders you created will not be replaced with actual values.

Add the new template to templates.txt

Save “templates.txt” and perform an IISRESET.

8. Test the Template

Finally, create a new repository using the new template to ensure it is working properly.  It is a good idea to create a repository, check it out, and open the solution in Visual Studio to ensure that the project builds and that all names are being replaced properly.  If you missed any files or namespaces you can simply edit the template on the server and try again.

Create a repository from the new template

Download the Sample

You can download the sample repository template created for this walkthrough from the link below.

Download the sample Template

Many organizations use SharePoint for team and project collaboration.  SharePoint is an ideal location to store project documents, issues lists, and other project artifacts.  However, without a view into the actual development progress for your project you won’t have a complete picture.  With Sublime 1.2 it is very easy to view your repository commit history directly within your SharePoint team sites or even your My Site.

Viewing Project Progress in a SharePoint Team Site

Having a SharePoint site per project is a very common model for organizations who rely on SharePoint for collaboration.  With Sublime’s RSS feeds it is possible to display the commit history for a single repository right within your SharePoint project sites.

1. First, navigate to your project site.
2. Next, under the “Site Actions” menu, choose “Edit Page”
3. Once the page is in edit mode, choose a web part zone and click “Add Web Part”
4. In the Add Web Parts dialog, choose the “RSS Viewer” web part and click “Add”
5. Once the web part is added, click the “Open the tool pane” link to edit the web part properties
6. Next, open a new browser window and navigate to Sublime
7. Click on the Browse Repositories tab, locate the repository for your project, and click the repository to view repository details.
8. In the “History” section at the bottom of the repository details page, locate the orange RSS feed icon.  Right-click on this icon and choose “Copy Shortcut”.
9. Switch back to your My Site and in the RSS Feed URL textbox for the RSS Feed web part, paste the shortcut you copied in step 7.*
10. Click “OK” to save your settings.  You should now see the activity feed for your repository on the project team site.
    

    Subversion history on a SharePoint project site

View your Activity Stream in your My Site

One of the best features in Sublime 1.2 is the personalized activity stream.  This activity stream shows you all activity on any repository you are a member of so you can easily stay up to date with all your projects.  And because this view is personalized it is an ideal candidate for your SharePoint My Site.

1. First, navigate to your My Site.
2. Next, under the “Site Actions” menu, choose “Edit Page”
3. Once the page is in edit mode, choose a web part zone and click “Add Web Part”
4. In the Add Web Parts dialog, choose the “RSS Viewer” web part and click “Add”
5. Once the web part is added, click the “Open the tool pane” link to edit the web part properties
6. Next, open a new browser window and navigate to the Sublime home page
7. On the right-hand side, next to the activity stream there should be an orange RSS feed icon.  Right-click on this icon and choose “Copy Shortcut”
8. Switch back to your My Site and in the RSS Feed URL textbox for the RSS Feed web part, paste the shortcut you copied in step 7.*
9. Click Okay to save your settings.  You should now see your activity stream on your My Site home page.
   

* RSS Feed Permissions

Depending on how you have configured your Sublime security settings, you may need to modify the RSS Feed URLs slightly.

• If you have turned off RSS Authentication in Sublime (available from the Administrative Security page) then you don’t need to make any changes.
• If you require RSS Authentication then you must specify a username and password in the query string for the RSS feed.  The username and password are added to the end of the feed URL as follows:

http://myserver/Feed.aspx?f=repo&r=/path&username=myusername&password=myurlencodedpassword

We just released a minor update for Sublime.  This is mostly a bug-fix release but it does include one new feature.  You can install 1.2.2 right over your existing 1.2 or 1.1 release so upgrading should be a snap.  See the release notes below for full details:

New Features:

• End-users can Create Folders
  In 1.2 we allowed administrators to create folders for organizing their repositories directly within the Sublime UI. In 1.2.2 we have made it possible for administrators to grant this ability to end users.

Bug Fixes:

• Fixed error when assigning permissions or editing repository details for repositories not created within Sublime.
• Fixed error on some non-english operating systems when configuring Sublime for the first time.
• Fixed URL in RSS feeds to always contain the full URL to Sublime
• Fixed broken images in repository browser when Sublime is installed as a sub-web

Head over to the downloads page to grab Sublime 1.2.2.

Right now I feel like one of those “I must be crazy my prices are so low” guys on local TV.  But that’s because in celebration of the release of Sublime 1.2 we are cutting our prices by 50%!  Starting today until the end of Summer (September 21st to be exact) all Sublime licenses are 50% off if you enter the promo code “SUMMER” during checkout.

If you’ve been trying an evaluation version Sublime then now is a great time to buy!  Or if you are planning for additions to your team in the future, go ahead and grab some extra licenses now while the price is so low.

Go check out the details in our online store.

We just pushed the final bits live and you can download Sublime 1.2 now!  Version 1.2 can be installed right over top of your existing Sublime 1.1 installation so upgrading is a snap!

We are super excited about Sublime 1.2 and feel that it’s the best version of Sublime yet.  Version 1.2 introduces a slew of new features and enhancements.  Check out the release notes for the complete list of new features and bug fixes included.  Below are the highlights:

• Path-based permissions. It is now possible to manage path-based permissions within your repositories.
• Personalized Dashboard. Each user gets their own personalized dashboard showing them their active repositories and activity stream.
• Activity Stream RSS Feed. Keep track of all of your repositories from a single, dynamic RSS feed.
• Active Directory Groups when using LDAP Authentication. Use existing Active Directory groups when managing repository permissions.
• Advanced Repository Templates. Repository templates can contain files and content which will be personalized to the details of your new repository.  Included are two new templates for Visual Studio projects.  Each template will pre-populate the new repository with a Visual Studio solution file based on the name of the repository.

I LOVE this new feature.  I find it to be incredibly useful on a daily basis.  And building tools that you yourself find useful and productive is one of the most rewarding aspects of this business.

Sublime 1.2 ships with a new default home page which is personalized for each user.  It shows a list of active repositories that you have access to, and an activity stream for those repositories.  This makes it very easy to quickly access the repositories you care about, and see exactly who is committing to those repositories – all in one, streamlined view.

New personalized dashboard shows your repositories and latest activity

On the left side of the dashboard is a list of any repository that you have access to, which has been committed to in the last 15 days.  This makes it very easy to quickly access repositories that you have access to and it automatically filters out old or unused repositories.

On the right side of the screen is a list of the most recent commits to these active repositories.  This single, unified view lets you easily see which users are committing to the repositories you care about.

In addition, this activity stream is exposed as an RSS feed.  This lets users subscribe to a single RSS feed for all of their repositories without having to subscribe to each individual repository.

All in all we feel that this is a great feature for developers.  It helps everyone easily stay up to date with the activities of their team.

We’re a bit behind releasing 1.2.  We had hoped to release in July and we may still, but if we don’t make it before the end of this week we’ll definitely have it ready to go by August 6th.  In the meantime, here’s another preview into the new features in 1.2.

Those of you using LDAP / Active Directory for authentication will be pleased to know that with 1.2 it will be possible to use AD groups for permission management.  This is accomplished by creating an “LDAP Group” and entering the name of the group in your LDAP directory.  For example, if you wanted to add “Domain Users”, you would simply create a new LDAP group in Sublime named “Domain Users”.  The group membership will be automatically populated based on the users in the Domain Users active directory group.  Sublime will then keep this membership up to date automatically.  So whenever you add new users to the group in active directory, those additions will be automatically picked up by Sublime.

Sublime is also smart enough to only give access to users who you want using Sublime in the first place.  For example, if you have configured Sublime to exclude all users except those in a given OU, Sublime will respect those rules when pulling in users from your AD groups.  So even if a user exists in that group, if they aren’t in the OU you specified they won’t be granted access to Sublime or Subversion.

That’s it for this post.  Next time we’ll talk about the new user dashboard and user RSS feeds – promise!

This is the first post in a series on what’s new in Sublime 1.2. Version 1.2 will be released next month but we’re so excited about the new features that we wanted to get the word out now.

First up: Path-based permissions.

This feature has been requested for some time and is finally making its way into Sublime. In 1.2 a repository owner will be able define unique permissions at different paths within a repository. A common scenario may be to allow all developers read/write access to the trunk, but then lock down the branches or tags folders to lead developers or release managers.

Below, we can see the updated Permission Management interface in Sublime 1.2. On the left we see the repository structure and the red icon overlay indicates that a folder has unique permissions applied. Clicking on that folder we can see, and then manage permissions for that level in the repository.

Assigning path-based permissions in Sublime

If you make a mistake and would like to remove all unique permissions you can simply click the “Remove these permissions” link in the highlighted area to the right.

Well that’s it for this update. For our next Sublime 1.2 Preview article we will discuss the new personalized Dashboard.

We’ve been working away here on Sublime 1.2 and have a few interesting features to share with you.

First, we’re going to be offering better support for managing your repository organization from within the Sublime web interface. For example, admins will be able to create folders directly within the web interface instead of having to create them from the server.

Second, we’re expanding our RSS support by creating a “My Repositories” feed. This feed will include commit messages to any repository that the subscriber is a committer for making it easy to subscribe to a single feed and automatically stay up to date across all of your projects. We’ll also be allowing RSS feeds to be accessed anonymously (admin configurable) so that they can be accessed easier from external RSS readers or readers that don’t support authentication.

Lastly, we’re expanding the Repository Template functionality to scan your templates for certain tokens and replace them with repository-specific information. For example, if your template includes a visual studio .sln file, you can name this file %name%.sln and it will automatically be renamed with the name of the repository. This works within the contents of your files as well allowing you to set up complete boilerplate project structures.

We always felt that while very useful, templates always came up a little short in truly jump-starting a project because they couldn’t customize the template to the project at hand. We feel that this update will close this gap and provide a significant productivity improvement for Sublime users.

We’ll be posting more on this feature in the future including a full tutorial on how to create repository templates that leverage this functionality.

Stay tuned for more updates on 1.2. We’ve got plenty of other features and improvements we’re adding including:

• My Repositories view
• Significant performance improvements
• Filtered views for the repository browser
• Active Directory Security Group support
• and more…