Interesting

Extending xMonad for Dvorak

You may or may not know about xMonad but if you are a Linux user then I really reccomend looking into it: xMonad is a ‘Tiling Window Manager‘. When you use Gnome the default window manager is Metacity; Metacity is nice for those new users to Linux because it is similar to what they are used to; because they probably came from Windows. However, on linux you do not have to stick with crappy technology and ways of doing things, you can instead change your setup to be more friendly to you. I like xMonad because it allows me to be that little more efficient and use all of the screen space at my disposal.

I also like using Dvorak and Thomas ten Cate has already gone to the effort of making a really nice xmonad.hs config file for everyone to use. I really liked it but over time I found various features that I did not like about it, or thought were missing, and therefore I edited it with the following changes:

  • You can now move a window and switch to the screen that you moved it to at the same time with Win+Alt+FXX.
  • Instead of Alt+Shift+Tab to reverse tile navigation, it is now Alt+Shift+CapsLock. (Warning: I have swapped my Backspace and CapsLock keys around so if you have not too then you will want to edit mine after the patch to use CapsLock instead. I’ll explain more later.)
  • Win+PrintScreen will now take screen shots of the desktop. And you can add a shift to that command if you only want a portion of the screen.
  • The Win+Shift+Q still quits but in what I think is a nicer way. And the Win+Shift+W command now lets you log out or switch user.
  • Win+Shift+I brings up google-chrome browser, but you can change it to the browser of your choice.

All in all I think that these changes are for the better and I would really recommend that you try them out. If you want to get what I have done then just follow the following instructions, assuming that you have already installed, and are using, xmonad then you can get the project from github. Open up a terminal and type:

git clone git@github.com:robertmassaioli/robertmassaioli_xmonad.git
cd robertmassaioli_xmonad
bash install.bash

And then you need to restart xmonad, usually by pressing Mod1+Q and then you will see the new config and all of the instructions. I hope that you enjoy the changes and let me know what you think.

Remember, if you have not mapped the BackSpace and CapsLock keys like I have then you will need to run the following:

cd ~/.xmonad
cat xmonad.hs | sed 's/BackSpace/Caps_Lock/' > temp.hs
mv temp.hs xmonad.hs

And you will need to restart xmonad again with Mod1+Q. That should be everything that there is to it; I will be happy to help solve any problems in the comments.

Interesting

Gitweb and Gitosis: Play Nice

A while back I started using gitosis and found what I call ‘the scientist’ tutorial very good for setting up gitosis on its own. If you have not read it (and setup gitosis that way) then the rest of this little guide will require a little more effort to make work. Please make sure that you have read that first so that the rest makes sense.

Installing Gitweb

Now that you have properly installed gitosis then you can install gitweb:

sudo apt-get install gitweb

For the sake of this tutorial I will be referring to the following version:

$ aptitude show gitweb Package: gitweb State: installed Automatically installed: no Version: 1:1.7.0-1 $

Making the Directory for Gitweb

Firstly you have to make sure that it is referred to correctly with apache. My ‘DocumentRoot’ is set to ‘/var/www/’ and therefore to place git in the correct location I ran the command:

cd /var/www/
sudo ln -s /usr/share/gitweb/ git

That made a link in my websites directory to the gitweb install. If you ‘cd’ into the ‘git’ directory then you will see a ‘index.cgi’ file in that directory and it is the file that actually runs all of gitweb. It is just one big Perl script and it does everything. Kinda neat and klunky at the same time. The other thing that you should notice is that we are making symlinks so you will want to make sure that your Apache config has FollowSymLinks. I would suggest running the following command:

grep export_auth_hook index.cgi

And if you get no output then you have a version of gitweb that does not support what I am about to do. You should upgrade to a later version of gitweb. I am warning you now because this caused a few hours of problems on a server running Hardy Herron.

Configuring Apache

Now you have to setup Apache so that it can put people inside the git folder when they want to go there. When we are done you will be able to access gitweb by adding ‘/git/’ to the end of your usual url.

Important: At this point I am assuming that you know how to setup apache to get a simple website and config happening. If you do not then it is time to take a quick detour and learn. Try this LAMP guide on How to Forge.

The section that I added to my site was:

    Options Indexes FollowSymLinks MultiViews ExecCGI
    AddHandler cgi-script cgi
    AllowOverride All
    Order allow,deny
    Allow from all

Most of those options are important and I would recommend that you understand what they do and why they are needed by reading through the Apache documentation for each. This is just one example of how to setup your apache config so that you can use gitweb. Infact the first time that I installed gitweb I had the luxury to give it it’s own subdomain; as in ‘git.myservername.com’. You can configure it however you like and can use the config above as advice. The really relevant part however is where we give it its own /git/ directory extension, and the part where we set the Options. Make sure that you understand those two by reading the documentation (google it) before going on.

And don’t forget the basics, do a reload before going on:

sudo /etc/init.d/apache2 reload

Setting the /etc/gitweb.conf

I’m sure that there are good and bad ways to make the gitweb.conf work and I don’t know what they are, so I just made it work by opening the ‘/etc/getweb.conf’ file and placing this in it:

# All you need to do is edit the following two lines to point to the right place.
$projectroot = '/path/to/the/repositories';
$gitosis_conf = '/path/to/the/repositories/gitosis-admin.git/gitosis.conf';
$username = $cgi->remote_user;
$export_auth_hook = sub {
  my $projectdir = shift;
  if($projectdir =~ (/(.*?).git/)) {
    my $projectname = basename($1);
    open FILE, $gitosis_conf or die 'Could not open gitosis config file. Please make sure that $gitosis_conf is set properly';
    my $found_repo = 0;
    while() {
      if($_ =~ /^[repo/) {
        if($_ =~ /^[repo $projectname/) { $found_repo = 1; }
        elsif ($found_repo) { $found_repo = 0; }
      }
      if ($found_repo) {
        if($_ =~ /^gitweb = yes *$/) { return 1; }
        if($_ =~ /^gitweb = no *$/) { return 0; }
      }
    }
  }
  return 0;
};

Basically this script uses the export_auth_hook function to decide whether or not to show the required directories. That means that the www-data user will need to be able to get access to those repositories. In order for a repository to show from your gitosis.conf file, the config section must look something like this:

[repo fuppes]
gitweb = yes
description = Free UPnP Entertainment Service
owner = Robert Massaioli

[repo fuppes-website]
gitweb = yes
description = The FUPPES Website
owner = Robert Massaioli

Very important: As you can see, if a repository is missing, or does not have, a ‘gitweb = (yes/no)’ section then it will be discarded and not shown.

Which is an example of a part of the file containing the currently visible repositories.

Reaping the Rewards

With all of that done you should now be able to view the results by browsing to http://thenameofyourserver.com/git/.

And that is now all that there is to it. However, as a last word of warning, if you get errors then it is probably the fact that you have not given www-data the ability to read the required files in repositories/. You need to make sure that it has read access if it is to run successfully.

Leave comments and tell me what you think. I will improve this post based on peoples comments.

P.S. I should note that I was led in the right direction by this post.