Thursday, November 19, 2009

How to join my Google code project

In case you want to fully use the data on the administrative entities I collected in XML, or the programming I did around that, you can download the whole thing to your computer and compile it yourself - and if you like even work in either the code or the data and then commit your changes into the global repository, so I can use them as well. The easiest way to join is to do exactly like I work, though especially if you just want to work on the XML there are other options as well. And if you just want to edit in the XML files, you don't need to be a programmer, and that can even be done with a plain text editor or on computer without Microsoft Windows. If you want to take a look first, you can do that online as well - the most interesting parts are the Royal Gazette announcements roughly sorted by topic and the data on the administrative entities, one file per province.

So to have this on your computer, first you need to download two programs - Microsoft's Visual Studio Express C# Edition which is both a quite good XML editor, as well as obviously the compiler for the program code I created. The second one is TortoiseSVN, the software which handles the download of the code from the repository and optionally the upload of your changes.

Once you installed both, you need to download the data first. Open the Explorer, go to the folder My Documents\Visual Studio 2008\Projects and do a right click on the mouse. In the popup menu select "SVN Checkout"

To download the project anonymously, you have to use the URL
You will then get all the files into the folder you just selected.

If you plan to submit changes into the repository as well, you'll need to download the project with the URL
(note the https instead of the http), and then when prompted enter your Google user name and the password you find at this Google code page.

However to really submit changes you made, you also need to email me and give me your Google account name, as I have to manually add you to the list of project members.

To update your local files with those in the repository, open the popup menu on the project folder and choose "SVN update". If you have done any changes in the local files which you want to share, then you can choose "SVN Commit", choose the files you want to submit, enter a good comment on what you changes, and provided you have write access it will then be available to everyone.

No comments: