Technical

Using Dreamweaver CS5.5+ with svn+ssh on a Mac

Tuesday, June 24th, 2014

This is a really technical article. If you are not comfortable with using a command line interface, please seek help from someone who is comfortable with it before you begin.

I just got a new computer, switching from Windows 7 to Mac OS 10.9. I’m not new to Mac, but it’s been a few years since I used one regularly. It’s been fun getting it set up and remembering all things cool about OS X and finding new things.

I have a client that has Dreamweaver templates and uses svn+ssh to connect to their web server. This doesn’t seem to be a super common setup. I remember trying to get it set up on my Windows 7 machine and it was a struggle. But once it was set up, I was good. Now, transferring this setup to my new Mac presented a new challenge. I spent about 4 hours getting it to work. I couldn’t do more than piece bits of information together so either we’re the only ones in the world using this particular set up or there isn’t any documentation about it (I’m guessing it’s this one). I’m sharing my experience and steps to hopefully help someone else out there.

The Adobe documentation didn’t help me much and judging by some of the posts I saw on the help forum I’m not alone. I will give credit where credit is due – the point about needing to use the same version of subversion on your computer as in Dreamweaver is VERY correct. That’s part of where I was getting stuck.

Check your version of subversion

First, you want to see what version of subversion you are using. I had 1.7 and Dreamweaver uses 1.6.9. If you have this set up, you will never successfully get your repositories set up.

You will need to use Terminal for a lot of this. If you don’t know where Terminal is, go to Launchpad -> Other and click on Terminal.

Once you have your Terminal window open, type in:

svn help

You should see something like this:

$ svn help
usage: svn  [options] [args]
Subversion command-line client, version 1.7.

If you have 1.6.9 already you don’t need to do this, but if you have 1.7+ and Adobe still hasn’t updated its subversion client, keep reading.

Next up, you may be installing a bunch of stuff.

Install Xcode

If you don’t already have it, you’ll need to download and install Xcode from the Mac App Store (don’t worry, it’s free) or the Apple developer website.

You may need to install the Command Line Developer Tools. These are available from the Apple developer site or in Xcode. I already had them installed.

Once you have both installed, you’ll need to return to Terminal and accept the license agreement:

$ xcodebuild -license

Install MacPorts

If you don’t already have it, you’ll need to download and install MacPorts.

Downgrade subversion

This article on downgrading subversion was very helpful but not entirely correct for what I needed. Here is an updated version:

Check what version you have installed already by typing this into your Terminal window:

$ port installed subversion

I didn’t have my current version of subversion in MacPorts. So when I ran this, I didn’t see 1.7 listed. Before I installed 1.6.9 with MacPorts it said I didn’t have any and then after I installed it only listed 1.6.9. You may very well see that you have none installed now and that’s okay!

You need version 1.6.9 to be compatible with Dreamweaver so type these commands into Terminal:

$ cd /tmp
$ svn co -r 62949 http://svn.macports.org/repository/macports/trunk/dports/devel/subversion
$ sudo port install

You’ll have to enter your password.

And, the install will fail. That’s okay. You’ll get an error message about not being able to find dependency for serf. Let’s fix that.

$ cd subversion
$ vi Portfile

You can use vi, nano, or whatever text editor you want here. I’m old school and still use vi.

Search for the line that says:

depends_lib port:expat port:neon \
 port:apr port:apr-util \
 port:db46 port:sqlite3 \
 port:gettext port:libiconv \
 port:serf port:cyrus-sasl2

Change port:serf to port:serf0

port:serf0 port:cyrus-sasl2

Then run the install command again.

$ sudo port install

And, it should work wonderfully. It will run for a bit, installing all the dependencies, so go get a cup of coffee, tea, or soda and come back in about 5 minutes.

Once it’s done:

$ port installed subversion
The following ports are currently installed:
 subversion @1.6.9_0 (active)

OK, now you have 1.6.9 installed! But we’re not quite ready to go yet.

Close Terminal and open it again. (And I mean close the program, not just the window.)

If you run svn help again, you should see:

$ svn help
usage: svn  [options] [args]
Subversion command-line client, version 1.6.9.

Now our subversion matches Dreamweaver!

Next up, we need to install a helper for ssh.

Install sshpass

If you are using a key pair to connect to your subversion server, you do not need to install sshpass. You should be able to follow the steps in this article to set them up.

In my case, I need to pass a plain text password to the server. I can’t use key pairs, which I know is the ideal configuration. That is how it is set up and until it changes there’s no way I’m going to enter the password manually every time I need to connect to the server – and there is no way to do that with Dreamweaver. Note: I know this method is not best practice. But sometimes you just have to go with how the server is set up. Please do not complain to me about this.

This article was super helpful for installing sshpass. Go through the steps detailed there and come back here.

Now we are ready to configure subversion.

Configure subversion

Back in Terminal, make sure you’re in your home directory:

$ cd

Then go into your subversion directory and edit your config file:

$ cd .subversion
$ vi config

You will want to find the line in [tunnels] that starts:

ssh = $SVN_SSH

Change it to:

ssh = $SVN_SSH /usr/local/bin/sshpass -p "your-password" ssh -o StrictHostKeyChecking=no

Replacing your-password with your actual password. No, this is not best practice. Yes, it makes me cringe. That’s how it is.

Save the config file and open up Dreamweaver.

Configuring Dreamweaver

Finally! We are almost done!

  1. In Dreamweaver, go to Site -> Manage Sites
  2. If you haven’t already created your site, click Add Site.Otherwise, click your site and then the pencil icon to edit it.If not already there, enter the Site Name and Local Site Folder.
  3. Skip Servers (if you have a test server, that’s great, you can set it up)
  4. Go to Version Control.
    For Access, select Subversion.
    For Protocol, select: SVN+SSH
    For Server Address, enter username@servername (where username is the SVN username and servername is the host name or IP address of the server)
    For Repository Path, enter the path to the repository you are setting up.
    Click the Test button.
    Hold your breath.

Hopefully you will see the glorious “Server and project are accessible” message!

Screen Shot 2014-06-24 at 2.30.09 PM

Click Done on Manage Sites.

Now, the real test is to right-click on your Site in the File viewer and click Version Control -> Get Latest Versions. That should download all of your files to your computer. You can exhale now!

If you struggled with this like I did, this is where you make yourself a large alcoholic beverage or buy yourself a cupcake or something. You deserve a treat!

 

 

Weekly Tech Roundup for July 27, 2012

Friday, July 27th, 2012

Weekly Tech Roundup

Estimated reading time in web design

ConvertWord documents to Clean HTML

New High-Quality Free Fonts

The Elements Of The Mobile User Experience

17 Free Icon Sites

Weekly Tech Roundup for February 17, 2012

Friday, February 17th, 2012

Weekly Tech Roundup

It’s back! This week’s Tech Roundup includes web design/dev survey, navigation menus, WPCandy Quarterly, and creating your own WordPress widgets.

The Web Design and Development Survey 2012 – If you are a designer or a developer, take a few minutes and complete this survey. Generally speaking, we’re a pretty small group so when we can get informational stats it’s really helpful. The survey closes March 20 so you have some time, but don’t use that as an excuse to forget! :)

Progressive And Responsive Navigation – Coding one site for screen and mobile but not sure what to do with the navigation menu on the mobile version? Check this article out for ideas.

Download a sample article from The WPCandy Quarterly – WordPress designers/developers/power users! Ever wish there was a magazine all about WordPress? I first mentioned this in November and now it’s just about here. You can check out a sample article here and sign up if you like it. I’m looking forward to my first copy!

Define Your Own WordPress Widgets – Speaking of WordPress… this is a detailed, step-by-step tutorial on creating your own widgets in WordPress. Very handy for when you can’t find a plugin widget to do what you want. Sometimes it’s just faster and easier to do it yourself.

Have a great weekend!

Weekly Tech Roundup for January 13, 2012

Friday, January 13th, 2012

Weekly Tech Roundup

This week’s Tech Roundup includes WordPress security update, W3 Total Cache write-up, free fonts, and Send to Kindle app.

How to Turn Off Google’s Annoying New Personal Search Results – This is kind of a follow-up to the Google+ integration in Google Search articles I just posted about in this week’s Small Business Roundup. This article tells you how to hide these new search results by default. It doesn’t really turn them off and you can easily turn them back on, but if you find them annoying or unhelpful, this will help you out.

WordPress 3.3.1 Security and Maintenance Release – WordPress released an important security update. This update shouldn’t cause any trouble for your theme or plugins and you should apply it now if you haven’t already.

Speed Up WordPress with W3 Total Cache – I’ve used this plugin on a couple of sites now and it really seems to work. This is a good write-up covering all the features.

New High-Quality Free Fonts – You know me, I love fonts! Especially when they’re free. There are some really slick ones here. Great to add to your collection.

Amazon’s Send to Kindle App Makes Sending Documents to Your Kindle as Easy as Right-Clicking – As a relatively new Kindle owner, I’m super excited to try this out. If you’re on Windows and have a Kindle, definitely check this out.

Have a great weekend!

Weekly Tech Roundup for January 6, 2012

Friday, January 6th, 2012

Weekly Tech Roundup

This week’s Tech Roundup includes Google getting into trouble with Google, New Year’s resolutions for designers, and HTML5 and CSS3 cheat sheets.

Google’s Jaw-Dropping Sponsored Post Campaign For Chrome – I don’t know that it’s “jaw-dropping”… maybe “eyebrow-raising”; certainly interesting. If you know anything about how Google search operates, paid links are a big, bad no-no. And now they have their own sponsored links. It’s not okay unless they do it? There are two follow-up articles at the end that continue the story.

Google+ Is Going To Mess Up The Internet – I think this is somewhat related to the previous post. Apparently Google is ranking shared links on Google+ higher in search results than the original article. This is obviously a rant but it’s still an interesting read because even though the author is noticeably angry, he has a very good point.

10 New Year’s resolutions for designers – I love this article! And not just because of these two: “stop stealing crap” and “learn to write,” but also “Stop being your own obstacle,” which is one of my all-time favorites, and “Stop Using Your Mom as an Example of a Stupid Person.” There’s a lot of good advice here and I hope people read it and embrace it. Oh, and these aren’t just for designers…

Test on Real Mobile Devices without Breaking the Bank – Interesting article and a good resource if you’re looking to expand your mobile testbed on the cheap. I don’t know that you really need to own all of these devices. There are enough emulators (yes, I know they don’t do everything – I ran into an excellent example of that this week) out there to get by on and I’m sure you have friends you can hit up to check things out for you occasionally.

Seven things still missing from CSS – The author of this article named some of my favorite pet peeves about CSS. Great stuff!

The Best HTML5 and CSS3 Cheat Sheets of 2011 – Quite a few cheat sheets here. Great if you are still learning HTML5 or CSS3 or to use for quick reference when you’re working on a project.

Have a great weekend!

Weekly Tech Roundup for December 30, 2011

Friday, December 30th, 2011

Weekly Tech Roundup

This week’s Tech Roundup includes mobile web best practices, a site-wide validator, font identification, and Waterfox.

Mobile Web Best Practices – An entire site dedicated to the best practices of mobile web. If you’re a mobile web designer or developer, you need to check out this resource.

W3Clove – Site-wide markup validation! This is going to be very handy.

Identifont – This seems a bit more detailed than What the Font!, which is another great font identification tool. You can find fonts based on appearance, name, similarity, picture, and designer/publisher.

Waterfox is a Faster, 64-Bit Optimized Version of Firefox for Windows PCs – Use Firefox on 64-bit Windows but want it to go a little faster? Take a look at Waterfox. I’m intrigued but I don’t know if I can handle another browser. :)

Have a great weekend! Happy New Year!