Screencast: Installing Umbraco

Monday, February 01, 2010 by Sebastiaan Janssen

Rather than making a long post with a lot of images, I decided to do something new for this post: a nice little 6 minute screencast!

It's just a quick run through of how I create a new Umbraco installs on my dev machines. It's easy!

I noticed after the recording that I didn't change the path for the database files. During the creation of the new database, you can easily change the path of where the database files are stored here (buttons marked yellow):

 

newdatabase

 

I tend to mumble a little, I'll work on that for future screencasts (also, I didn't shave, sorry). ;-)

Hopefully this will help some people setting up their Umbraco install manually.

Version control in Git - Part 2 (set-up and usage)

Monday, October 05, 2009 by Sebastiaan Janssen

So you're ready to start using Git? Here's how to start:

First of all, go and download and install the Git extensions for Windows. The featured (full) release is recommended.

In Visual Studio, you'll now see a few new buttons (in Windows Explorer, there's also some new context items that will show up when you right-click a folder).

2009-10-05_193837

As you can see it's a tiny toolbar, click the last icon (settings), you have to set a name and e-mail address, they will be attached to any commit you do.

2009-10-05_194927

I've noticed that in order for the toolbar buttons to work, I have to open a file in the solution. So just open one of the files and make sure the cursor is in the file somewhere.

Hit "Ok" and click on the folder icon ("Browse repository"). You'll be presented with a screen with three options, one of which is "Initialize repository".

2009-10-06_111854

Initialize the repository in the root directory of your solution, this is typically where your .sln file is. The content in this folder and everything in the subfolders will be under source control. This is also your personal repository, there is not even a central repository yet.

The repository is simply one .git folder in the solution folder.

2009-10-06_111310

Almost done!

2009-10-06_111022

You're ready to commit your project to the repository. First, make sure you ignore the appropriate files, hit the "edit .gitignore" button and add the default ignores. For me personally, this is all that I need, you might want to tweak it.

Ready. Now you can do your first commit! You can skip the "Add files" button, this will just stage all the files for a commit, you can also do this in the commit screen.

2009-10-06_113925

Select all of the files and click "Stage selected files", type a commit message and click "Commit".

This creates the first branche, called master. You're good to go code and make changes. When you're ready to commit again, just use the tiny toolbar button instead of the repository browser.

2009-10-05_193837

In the next part of this series, I'll show how to commit the changes to a remote repository using Unfuddle.com.

Presenting: The CleanHome package

Sunday, June 14, 2009 by Sebastiaan Janssen

Every time you start a new Umbraco project, there is one thing that you will do first: Set-up a home page.
As this takes a few minutes, I've created a simple package that will help you out by installing the home page.

CleanHome will give you a ContentPage document type linked to a master page that sets you up with an XHTML 1.0 strict document type.

The document type includes these new fields:

  • body (richtext editor)
  • meta keywords
  • meta description
  • alternate title (to use in <title> tag for example)
  • alternate navigation title
  • hide in navigation checkbox (alias: umbracoNaviHide, to use with default XSLT templates)

There's also a stylesheet reference and a favicon reference in the master page.

The stylesheet contains Eric Meyer's reset-styles to start you off with the cleanest possible page.

Your new "home page" validates as XHTML strict and the CSS file is also completely valid.

Warning: This will create a document type and Master/Childpage with the name "ContentPage", a content item named "Home" and a CSS files called styles.css. If any of these already exist in your site, you WILL get errors.

This package is specifically meant for new, empty websites. You can view it as a bare-bones version of the Runway package.

Download CleanHome here.