blosxom :: the zen of blogging

about

  • home/about
  • features
  • colophon
  • news
  • mailing list
  • donate


    • documentation for users

  • overview
  • install
  • configure
  • blog
  • view
  • flavour
  • syndicate
  • plugins
  • plugin registry
  • static
  • faq
  • use cases*
    •

    documentation for developers

  • overview
  • plugins
    •

    downloads

  • mac
  • windows*
  • everyone

  • license
  • contributed*

    • powered by

    *coming soon

    home :: documentation :: users :: install :: dynamic :: windows.txt

    Amazon Honor System Click Here to Pay Learn More

    Install Blosxom on Windows by Hand

    Blosxom is a simple CGI script that requires not much more than being put somewhere Web-accessible, told where it is, optionally configured a little, blessed with permission to run, and let loose on an unsuspecting public.

    1. Before you can get down to the nitty gritties, you'll need a fresh copy of Blosxom in hand. Download it here.

    2. Extract the blosxom.cgi script from the ZIP archive using WinZIP or the like. Either extract it directly to the C:\Inetpub\wwwroot directory or extract it and drag it there by hand.

    3. All of Blosxom's blog entries live in a special folder. As good a place as any to keep these posts is in a blosxom folder within IIS's Web page repository, C:\Inetpub\wwwroot\blosxom. Go ahead and create that folder as you would normally.

      You'll be telling Blosxom where to find this folder when you configure in just a moment.

    4. There are a couple-three IIS configuration steps in order to a) tell the Web server to run rather than simply display the contents of the blosxom.cgi script and b) fix a bug in IIS so that it properly handles PATH_INFO (never mind if you don't know what the heck that means).

      Thankfully, the PerlMonks site offers a short fixit script, "Fix ActiveState Script Maps (IIS)" which makes use of the IIS "ScriptMaps" property.

      1. Copy the script (all the beautifully hideous Perl code in the yellow box) right from your Web browser. Click the Windows Start button, select Run..., type command, and click the OK button. At the command-line, type: 
        C:\>edit fixiis.pl
        This will launch the simple edit text editor.

      2. Paste in code (Edit > Paste), save (File > Save), and exit (File > Exit).

      3. Run the newly-created script like so: 
        C:\>c:\perl\bin\perl fixiis.pl
        and then delete it: 
        C:\>del fixiis.pl

      4. Close the Command window.

    That's about all there is to Blosxom installation. Next step is configuration. But before you move on, a couple of notes...

    • While Windows uses backslashes between components of a path, Perl uses forward-slashes, so you'll be using C:/Inetpub/wwwroot/blosxom as your data directory

    • While you're welcome to use any text editor you wish to edit the blosxom.cgi script, I find edit on the command-line by far the easiest.

    click here to configure blosxom...