]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/tips/nearlyfreespeech.mdwn
Process .md like .mdwn, but disallow web creation.
[git.ikiwiki.info.git] / doc / tips / nearlyfreespeech.mdwn
index 3a389ca3a081a09dd29dbe9541144d7c4d68a8a6..f9da223ac071f9d0452abc17d146b885101be7fc 100644 (file)
@@ -1,3 +1,5 @@
+[[!meta date="2008-05-05 14:51:26 -0400"]]
+
 [NearlyFreeSpeech.net](http://NearlyFreeSpeech.net) is a shared hosting
 provider with very cheap pay as you go pricing. Here's how to install ikiwiki
 there if you don't have a dedicated server.
@@ -14,7 +16,8 @@ After you [get an account](https://www.nearlyfreespeech.net/about/start.php),
 create a site using their web interface. 
 
 Mine is named `ikiwiki-test` and I used their DNS instead of getting my
-own, resulting in <http://ikiwiki-test.nfshost.com/>
+own, resulting in <http://ikiwiki-test.nfshost.com/>. (Not being kept up
+anymore.)
 
 They gave me 2 cents free funding for signing up, which is enough to pay
 for 10 megabytes of bandwidth, or about a thousand typical page views, at
@@ -42,7 +45,12 @@ Use `wget` to [[download]] the ikiwiki tarball. Then unpack it:
 
 ## Install perl modules
 
-Use CPAN to install the perl modules it uses into your home directory:
+As an optional step, you can use CPAN to install the perl modules ikiwiki
+uses into your home directory. This should not be necessary, mostly,
+because the system has most modules installed already.
+
+So, you might want to skip this step and come back to it later if ikiwiki
+doesn't work.
 
        PERL5LIB=`pwd`/ikiwiki:`pwd`/ikiwiki/cpan:`pwd`/lib/perl5 PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")'
        
@@ -71,19 +79,19 @@ Here is an example of how I set up a wiki:
 
        mkdir ~/wiki
        cd ~/wiki
-       cp ~/ikiwiki/doc/ikiwiki.setup .
        cp -r ~/ikiwiki/doc/examples/blog/* .
+       ikiwiki --dumpsetup ikiwiki.setup
        nano ikiwiki.setup
        # Set destdir to /home/htdocs
        # Set srcdir to /home/private/wiki
-       # Set url to http://yoursite.nfshost.com/ , set cgiurl likewise
-       # Uncomment the `rcs => "git"` line, and the cgi and git
-       # post-update wrapper blocks.
-       # Set the cgi wrapper path to /home/htdocs/ikiwiki.cgi
-       # Set the git wrapper path to /home/private/wiki.git/hooks/post-update
+       # Set url to http://yoursite.nfshost.com/
+       # Set cgiurl to http://yoursite.nfshost.com/ikiwiki.cgi
+       # Uncomment the `rcs => "git"` line.
+       # Set the cgi_wrapper path to /home/htdocs/ikiwiki.cgi
+       # Set the git_wrapper path to /home/private/wiki.git/hooks/post-update
        # Configure the rest to your liking and save the file.
        ikiwiki-makerepo git . ../wiki.git
-       ikiwiki -setup ikiwiki.setup
+       ikiwiki --setup ikiwiki.setup
 
 ## Clean up
 
@@ -94,7 +102,7 @@ dollars.
 
 rm -rf ~/ikiwiki*.tar.gz ~/.cpan ~/ikiwiki ~/man ~/lib/perl5/5.8.8
 
-That should cut things down to less than 4 megabytes. If you want to save
+That should cut things down to less than 2 megabytes. If you want to save
 even more space, delete unused perl modules from ~/lib/perl5
 
 ## Enjoy!