<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>install</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="stylesheet" href="style.css" type="text/css" /> <link rel="stylesheet" href="local.css" type="text/css" /> </head> <body> <div class="page"> <div class="pageheader"> <div class="header"> <span> <span class="parentlinks"> <a href="./index.html">ikiwiki</a>/ </span> <span class="title"> install </span> </span> </div> </div> <div id="pagebody"> <div id="content" role="main"> <p>This page documents how to install ikiwiki if a prepackaged version is not available for your distribution, and you are faced with <a href="./download.html">downloading</a> the source and installing by hand. Ikiwiki should work on most unix-like systems.</p> <h2>Dependencies</h2> <p>Ikiwiki is a perl program, and needs a recent version of perl such as 5.10. (5.8.0 has been reported not to work).</p> <p>It's recommended you have a C compiler, as ikiwiki uses one to build wrappers.</p> <p>Ikiwiki requires the <a href="http://search.cpan.org/search?mode=dist&query=Text%3A%3AMarkdown%3A%3ADiscount">Text::Markdown::Discount</a> (or <a href="http://search.cpan.org/search?mode=dist&query=Text%3A%3AMarkdown">Text::Markdown</a>), <a href="http://search.cpan.org/search?mode=dist&query=URI">URI</a>, <a href="http://search.cpan.org/search?mode=dist&query=HTML%3A%3AParser">HTML::Parser</a>, <a href="http://search.cpan.org/search?mode=dist&query=HTML%3A%3ATemplate">HTML::Template</a>, <a href="http://search.cpan.org/search?mode=dist&query=YAML%3A%3AXS">YAML::XS</a> and <a href="http://search.cpan.org/search?mode=dist&query=HTML%3A%3AScrubber">HTML::Scrubber</a> perl modules be installed. It can also use a lot of other perl modules, if they are available.</p> <p>Various <a href="./plugins.html">plugins</a> use other perl modules and utilities; see their individual documentation for details.</p> <h3>Installing dependencies by hand</h3> <p>If you want to install by hand from the tarball, you should make sure that all the perl modules are installed. This is one way to install them, using CPAN:</p> <pre><code>PERL5LIB=`pwd` PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")' PERL5LIB=`pwd` PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki::Extras")' </code></pre> <h2>Installing ikiwiki by hand</h2> <p>Then to build and install ikiwiki:</p> <pre><code>perl Makefile.PL # PREFIX=/dir to install elsewhere make make test # optional make install </code></pre> <p>If you're using a shared hosting provider, of the sort where you don't have root, you can still install ikiwiki. There are tutorials covering this for a few providers:</p> <ul> <li><a href="./tips/nearlyfreespeech.html">NearlyFreeSpeech</a></li> <li><a href="./tips/DreamHost.html">DreamHost</a></li> </ul> </div> </div> <div id="footer" class="pagefooter" role="contentinfo"> <div id="pageinfo"> <div id="backlinks"> Links: <a href="./download.html">download</a> <a href="./setup.html">setup</a> </div> <div class="pagedate"> Last edited <span class="date">Tue Feb 26 23:01:54 2019</span> <!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> --> </div> </div> <!-- from ikiwiki --> </div> </div> </body> </html>