Installing ScrewTurn Wiki using WebMatrix

ScrewTurn Wiki allows you to create, manage and share wikis. A wiki is a collaboratively-edited, information-centered web site. The most famous of these is WikiPedia. ScrewTurn Wiki is built using ASP.NET, and as such can be installed, run, and edited using WebMatrix.

WebMatrix is a free tool that allows you to create, customize, and publish webpages. It gives a number of different ways that you can create websites. One of the features is providing existing open sources applications such as ScrewTurn wiki, as well as WordPress, Joomla, DotNetNuke or Umbraco. In this tutorial, you will see how quick and easy it is to get your ScrewTurn wiki site up and running!

Using WebMatrix with ScrewTurn Wiki

When you launch WebMatrix you will see several options on how to create a new web site. To create a ScrewTurn wiki site, select ‘App Gallery’.

WMx2ini

 

This will open the Web Gallery, from which you can browse dozens of open source Web Applications. They are subdivided into different types of application such as Blogs, CMS, and of course, Wiki. Select the Wiki tab on the left hand side, and you’ll see that ScrewTurn wiki is an option.

AppGa1l

Select it, and give your site a name (such as MyWiki), and press ‘Next’.

WebMatrix will detect if you need to install any dependencies, such as SQL Server Express, which ScrewTurn Wiki uses to store your pages. If you don’t have SQL Server installed, you’ll see this dialog, which gives you the option to add SQL Server to your development machine, or, if you prefer, to use an existing SQL Server database somewhere else. I’m going to install it locally.

image

If you (like me) choose to install it on your machine, you’ll be asked how you want to sign onto SQL Server. There are two modes

- Windows Integrated Authentication, where whatever you use to sign into your machine is used to sign into SQL Server too

- Mixed Mode Authentication, where either your machine login, or SQL-Server specific authentication, can be used.

I recommend the latter, so that you can set up a SQL Server administrator account ‘sa’, which you’ll use later. Configure a password for ‘sa’, and don’t forget it. You’ll need it later!

image

Press ‘Next’ and you’ll see the EULA’s for the software you’re installing. You’ll have to accept them to continue.

AppGal2

Then it’s time to sit back for a few minutes and let WebMatrix do it’s thing. It’ll download ScrewTurn, SQL Server, and everything else that you might need, and plug them all into each other!

AppGal4

When it’s done, the next dialog will ask you to configure your database connection. You’ll need your SQL Server ‘sa’ password, as the administrator account will be used by WebMatrix to sign into your database and create the tables and data needed to run ScrewTurn wiki. It will also create an account that will be used by ScrewTurn Wiki to edit this data, so you’ll set that up using the Wiki Database Username and password fields in this dialog. The ‘Master Password’ will set the master password for the admin account of the wiki (not the database), which is usually a step that you’d have to do post-installation, but now WebMatrix does it for you.

screwturn3

The installation for ScrewTurn wiki will now complete, and you should see the congratulations screen.

AppGal5

You might see a different list of software here – that just means that you had different dependencies on your machine that I do. Don’t worry, you should still be good to go.

You’ll now be taken to the WebMatrix, and you’ll see that the site workspace is open. WebMatrix integrates the entire stack that you need for web development, so you have a server (IIS Express), database (SQL Server), app framework (ASP.NET), and of course this tool to run them all. You’ll see that your site has been configured to run on a particular localhost URL (localhost is a special name meaning ‘this machine’).

image

The number (or ‘port’) after localhost on your machine may be different. That’s ok. Ports are randomly assigned so that you can have multiple web sites on the same machine. Click the link (http://localhost:whatever) and your browser will open.

image

You’re now ready to wiki!

If you’re worried about what the opening page says about editing the Web.config file, the good news is that WebMatrix already did this for you, so you can safely delete the note from your wiki. This is the Wiki master password that you set up earlier.

In future articles in this series we’ll look at how to use ScrewTurn Wiki with WebMatrix, including how to deploy it to a hosting provider. In the meantime, check out the tutorials and documentation at: http://www.screwturn.eu/Help.MainPage.ashx

You can discuss this article using the adjacent Facebook talkback.

For technical questions please visit our discussion forums, where we have a vibrant community of developers like you, as well as Microsoft engineers who are ready to answer your questions!