Skip Navigation

HowTos

Apache 2.2 mod_cache

Server Tuning

Petal i18n and I18NFool

HowTo Compile Apache 1.3 for MKDoc

Integrate Soupermail

Creating new document components

Translate MKDoc Templates

Checkout MKDoc via anon CVS

Configuring MKDoc::Apache_Cache

MySQL commands to make a user account an editor account

Using news headlines

Customisation with CSS

Hiding documents and creating private areas

Upgrade from 1.4 to 1.6

Discussion Board Moderation

Text Component Formatting

Site Administration

Email newsletters

Edit Templates in a Subversion Repository

Update the Metadata for all Documents

Import MS Word files into MKDoc

Sign up

If you sign up for an account on this web site you can customise elements of this site and subscribe to an email newsletter.

If you have an account on this web site you may login.

If you have an account on this site but have forgotten your user name and / or your password then you can request an account reminder email.

Edit Templates in a Subversion Repository

Using a versioning system, such as Subversion, allows multiple people to edit files at the same time and for conflicts between versions to be resolved and history to be rolled back.

Install a Subversion client

The first thing you need to do is install a Subversion client. There is a list of client software on the Subversion site, this HOWTO is based on the use of TortoiseSVN, so you first thing you need to do is to download TortoiseSVN.

Checkout a working copy

Once you have installed TortoiseSVN you can decide where you want to checkout the templates (you probably want to create a new folder for this). Then in Windows Explorer you just right click and select Checkout.

Right click and select Checkout.

In the above screenshot a folder called MKDoc was created in My Documents and a Subversion checkout was started after the URL of the repository was entered, as the following screenshot illustrates.

Enter the ULR of the repository and click OK.

After you click OK you will see a listing of files as they are being checked followed by an OK button when this is complete.

Listing of all the files being checked out.

Editing files

Once you have checked out the repository you can start editing files. Since the template file probably have UNIX carrige returns rather than DOS ones so a text editor such as Cream will be required (the editor also need to support editing UTF-8 if languages other than english are to be used).

Checking in edited files

Files that have been changed are marked with a exclaimation mark as the following screenshot illustrates.

An amended file which is marked to show it has been changed.

To commit the changes you have made to the Subversion repository simply right click and select Commit.

Right click and select Commit to upload your changes.

You will then be prompted to add an option message explaining what changes you have made, write a brief note about the changes and click OK.

Enter log message and click OK.

You will then be prompted for your username and password and your changes will be uploaded.

Finished!

Updating the templates on the web server

To update the templates on the server you will need to ssh to the server using a ssh client such as Putty.

Enter the hostname or IP address of the server you need to connect to and select SSH as the protocol, as illustrated in the following screenshot.

Enter a host and protocol.

Then enter your username and password.

Username and password.

You then need to change to the directory where the file is that you have updated and then type svn up to update to the latest version.

svn up

Now the server is using the latest version of the templates and you should be able to see the changes you have made.

<< | Up | >>

This document was last modified by Chris Croome on 2004-09-08 14:37:11
MKDoc Ltd., 31 Psalter Lane, Sheffield, S11 8YL, UK.
Copyright © 2001-2005 MKDoc Ltd.