wiki_z: InitialOddmuseInstallationNotes

To get the Oddmuse wiki up and running on 25 Dec 2007:

looked at http://www.oddmuse.org/cgi-bin/oddmuse/Setup and http://www.oddmuse.org/cgi-bin/oddmuse/Setup_on_a_Unix_System and http://www.oddmuse.org/cgi-bin/oddmuse/Setup_on_a_Mac_OSX_System — and decided to set up following the UNIX instructions, for maximum compatibility between the home laptop stand-alone wiki on Apple Macintosh OSX and UNIX server on http://zhurnaly.com/
looked at http://www.emacswiki.org/scripts/current
- saw that it was version 1.834 dated 15 Dec 2007
- looked at http://savannah.gnu.org and searched for "oddmuse"
- followed links to "Browse Sources Repository" to "oddmuse" to "wiki.pl" which led to
- http://cvs.savannah.nongnu.org/viewvc/oddmuse/wiki.pl?root=oddmuse&view=log from which downloaded the then-latest version of Oddmuse's wiki.pl (= Revision 1.835 - Sat Dec 22 20:49:38 2007 UTC)
as per directions on http://www.oddmuse.org/cgi-bin/oddmuse/Setup_on_a_Unix_System (as an admin user on the Mac) placed a file named "wiki" in directory /Library/CGI-Executables/ with the following contents:

 #!/usr/bin/perl
 package OddMuse;
 $DataDir = '/Library/WebServer/Oddmuse';
 do 'current';

did a "chmod +x wiki" to make the file "wiki" be executable
created a directory named Oddmuse and made it world-read-writeable:

    mkdir /Library/WebServer/Oddmuse
    chmod 777 //Library/WebServer/Oddmuse

copied the downloaded file "wiki.pl" to /Library/WebServer/CGI-Executables/current and then did "chmod +x current" to make "current" be executable
browsed to http://localhost/cgi-bin/wiki and saw the empty home page
tested system by editing the HomePage, creating a SandBox, commenting on it, etc. — and noted the lack of markup
on http://zhurnaly.com I did the same as above (except for the path to the cgi-bin directory and the path to the data directory to put oddmuse data files into)
as per http://www.oddmuse.org/cgi-bin/oddmuse/Setup_on_a_Unix_System on both home and remote systems created a file "config" in the oddmuse data directory:

 package OddMuse;
 $SiteName  = "ZhurnalyWiki";
 $StyleSheetPage = 'ZhurnalyWikiStyleSheet';
 $LogoUrl = '/images/zh.gif';
 $CommentsPrefix = 'Comments_on_';
 $AdminPass ='****';

set the Admin password to whatever it is now set to (not ''!)
created a "modules" directory in the Oddmuse data directory
downloaded Oddmuse extensions creole.pl (from http://www.oddmuse.org/cgi-bin/oddmuse/Creole_Markup_Extension ) and image.pl (from http://www.oddmuse.org/cgi-bin/oddmuse/Image_Extension ) and put them into the oddmuse data directory
created and placed in "modules" the file module_extensions.pl as per Alex Schröder's suggestion to permit blockquotes (and maybe some day other extensions):

push(@MyRules, \&BlockQuoteRule);

sub BlockQuoteRule {
  # indented text using : with the option of spanning multiple text paragraphs (but not lists etc).
  if (InElement('blockquote') && m/\G(\s*\n)+:[ \t]*/cog) {
    return CloseHtmlEnvironmentUntil('blockquote') . AddHtmlEnvironment('p');
  } elsif ($bol && m/\G(\s*\n)*:[ \t]*/cog) {
    return CloseHtmlEnvironments() . AddHtmlEnvironment('blockquote') . AddHtmlEnvironment('p');
  }
  return undef;
}

created ZhurnalyWikiStyleSheet to hold CSS, based on http://zhurnal.net/wiki/css/zhurnalwiki.css and http://zhurnaly.com/zhurnaly.css and http://www.emacswiki.org/oddmuse/wiki.css
began testing!

TopicProgramming - TopicZhurnal - 2007-12-27

(correlates: Comments on ZhurnalyWikiStyleSheet, Oddmuse Local, Comments on HomePage, ...)