Clip Manager 101: Share your Clips Part II

CM101_SVN1
In our previous blog post, we showed you how you can share your clips via a shared folder on your local network. But maybe you want to share your clips with your fellow FileMaker buddies over the Internet. Shared folders can be an option but it requires that you are online all the time and can rely on a fast network. In the next couple of articles we will explore several alternative ways of sharing your clips.

SVN
One of the options is using an SVN server. SVN stands for Subversion. Subversion is an open source version control system.

Working with SVN requires two pieces of software: an SVN server and an SVN Client.

For the server you can opt to install your own SVN server (http://subversion.tigris.org/) or make use of one of the online services:

Now you need an SVN Client. If you are on (Snow) Leopard, you can use the built-in SVN functionality via Terminal but it's probably easier to use a commercial SVN client. We prefer Versions, which is very well documented.

Other alternatives:

On Windows we can recommend TortoiseSVN.

Setting up the SVN client
In this example we will use Versions, but the steps for other clients are very similar.
We will use Matt Petrowski's Custom Functions repository: http://code.google.com/p/filemakerfunctions/
In my folder on the repository I stored some custom functions as a Clip Manager clip.

1. Open Versions and click the button "Repository"
CM101_SVN2

2. Give the repository a name and fill in the location. Click create.
http://filemakerfunctions.googlecode.com/svn/trunk/vanhulle/
Note: This repository will be read only.
CM101_SVN3

3. Now you can connect and see the files on the SVN server, but you cannot use them in Clip Manager, yet. First you need a “working copy” on your local disk. Create a new folder “Custom Functions Matt” in your Clip Manager clips folder.
CM101_SVN4

4. To create a working copy on your local disk, select the top folder in your repository in Versions and click on Checkout.
Select the folder you have created in the Clip Manager folder.
CM101_SVN5

You will now have a local copy.

Adding, editing and deleting Clips
Note: The example URL is read only, but you can also test this with your own repository.

I have opened an existing clip and noticed that the clip is stored in an old Clip Manager format. I will save the clip in the current file format. If we save the file, the file is saved locally but not yet on the SVN server, we need to submit the changes to the server.

1. Open Versions

2. Notice that the new clips have a question mark. This means that these files are unknown for SVN and need to be added to the working copy. Select the files with a question mark. Right-click and choose the option “Add”.

CM101_SVN7

3. Notice that the question marks are replaced with an “add” symbol.

CM101_SVN8

4. Now we want to remove the old xml files from the repository. Never delete a file from an SVN working copy in the Finder or in Clip Manager. Select the files and right-click. Choose the option “Delete”.
CM101_SVN9


5. Notice that there appears a new “delete” symbol near the files.

CM101_SVN10

6. Now we need to submit the changes to the SVN server. Select the top folder and click on the “Commit” button.

CM101_SVN11

7. Describe what has changed.

CM101_SVN12

Every time you edit or change a clip you need to commit your changes.

To retrieve updates from your buddies, you click the update button.



Leave a Reply

You must be logged in to post a comment.