formatting

master
Joey Hess 2008-05-05 14:58:21 -04:00
parent b428fb1b14
commit b1b9c2c0d1
1 changed files with 47 additions and 29 deletions

View File

@ -2,39 +2,50 @@
provider with very cheap pay as you go pricing. Here's how to install ikiwiki provider with very cheap pay as you go pricing. Here's how to install ikiwiki
there if you don't have a dedicated server. there if you don't have a dedicated server.
* [Get an account](https://www.nearlyfreespeech.net/about/start.php). ## Register for an account and set up a site.
* Create a site using their web interface. Mine is named `ikiwiki-test` and I
used their DNS instead of getting my own, resulting in After you [get an account](https://www.nearlyfreespeech.net/about/start.php),
<http://ikiwiki-test.nfshost.com/> create a site using their web interface.
* Fund it. (Or don't. They gave me 2 cents free funding for signing up, which
is enough to pay for 10 megabytes of hosting, or about a thousand typical Mine is named `ikiwiki-test` and I used their DNS instead of getting my
page views at their current rates.) own, resulting in <http://ikiwiki-test.nfshost.com/>
* `ssh` into their server using the ssh hostname and username displayed on
They gave me 2 cents free funding for signing up, which is enough to pay
for 10 megabytes of hosting, or about a thousand typical page views at
their current rates. $5 might be a good starting amount of money to put in
your account.
## ssh in and configure the environment
ssh into their server using the ssh hostname and username displayed on
the site's information page. For me this was the site's information page. For me this was
ssh joeyh_ikiwiki-test@ssh.phx.nearlyfreespeech.net ssh joeyh_ikiwiki-test@ssh.phx.nearlyfreespeech.net
cd $HOME
* Set up .profile to use your home directory. Now set up .profile to run programs from ~/bin.
echo "PATH=$PATH:$HOME/bin" > $HOME/.profile echo "PATH=$PATH:$HOME/bin" > .profile
. $HOME/.profile . .profile
* You'll be in the htdocs directory by default, where public web pages are ## Download an unpack ikiwiki
put, so before installing ikiwiki, `cd $HOME`
* Use `wget` to [[download]] the ikiwiki tarball. Use `wget` to [[download]] the ikiwiki tarball. Then unpack it:
* Unpack ikiwiki.
tar zxvf ikiwiki*.tar.gz tar zxvf ikiwiki*.tar.gz
* Use CPAN to install the perl modules it uses into your home directory: ## Install perl modules
(This will take a while. As long as the first command succeeds, ikiwiki will be
usable. The second command adds extra modules that some plugins use, and Use CPAN to install the perl modules it uses into your home directory:
installation of some of them might fail.)
PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")' PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->install("Bundle::IkiWiki")'
PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->force(install => "Bundle::IkiWiki::Extras")' PERL5LIB=ikiwiki:ikiwiki/cpan:. PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::Shell->force(install => "Bundle::IkiWiki::Extras")'
* Now build and install ikiwiki into your home directory. (This will take a while. As long as the first command succeeds, ikiwiki will be
usable. The second command adds extra modules that some plugins use, and
installation of some of them might fail.)
## Build and install ikiwiki
cd ikiwiki cd ikiwiki
export MAKE=gmake export MAKE=gmake
@ -42,10 +53,13 @@ there if you don't have a dedicated server.
$MAKE $MAKE
$MAKE install $MAKE install
* With ikiwiki installed, you can follow the regular [[setup]] tutorial for ## Set up a wiki in the usual way.
With ikiwiki installed, you can follow the regular [[setup]] tutorial for
settng up your wiki. Make sure to set `destdir` to `/home/htdocs/` so that settng up your wiki. Make sure to set `destdir` to `/home/htdocs/` so that
the wiki is published on the web site. I recommend using git for revision the wiki is published on the web site. I recommend using git for revision
control; you can then clone your wiki's git repository as an offsite backup. control; you can then clone your wiki's git repository as an offsite backup.
Here is an example of how I set up a wiki: Here is an example of how I set up a wiki:
mkdir ~/wiki mkdir ~/wiki
@ -64,9 +78,13 @@ there if you don't have a dedicated server.
ikiwiki-makerepo git . ../wiki.git ikiwiki-makerepo git . ../wiki.git
ikiwiki -setup ikiwiki.setup ikiwiki -setup ikiwiki.setup
* Finally, you can save a _lot_ of disk space by cleaning up the ikiwiki ## Clean up
Finally, you can save a _lot_ of disk space by cleaning up the ikiwiki
tarball and .cpan directory. tarball and .cpan directory.
rm -rf ~/ikiwiki*.tar.gz ~/.cpan rm -rf ~/ikiwiki*.tar.gz ~/.cpan
## Enjoy!
Have fun and do good things. --[[Joey]] Have fun and do good things. --[[Joey]]