• View
• Edit
• History
• Attach
• Print
• Backlinks

InstaWiki

Questions answered by this recipe

How can I install PmWiki in seconds using a shell script?

Description

Install PmWiki in seconds using a shell script.

This script

1. Installs PmWiki
2. Creates writable wiki.d/ and uploads/ directories.

At that point the wiki is ready to use. The config.php file is a modified version of sample-config.php with URLs shortened and uploads enabled.

The script downloads PmWiki (if it's not already downloaded), unpacks the archive, renames the directory, then downloads InstaWiki-latest.tar.gzΔ and installs index.php and local/config.php.

Then the script sets 2777 permissions, retrieves the home page (without saving it), and sets 0777 permissions.

The wiki, once installed, is a default configuration with an index.php file and The configuration changes are:

• Automatic semi-clean URLs (with pmwiki.php removed)
• Uploads are enabled by default.
  • Max upload size is set to 1MB.
  • A server-writable uploads/ directory is created automatically.

Installation

Save this as a shell script or download the .txt versionΔ from the command line with
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/InstaWiki.txt

#!/bin/bash
dir="wiki"   # name of the wiki's directory that will be created
ver="2.2.91"   # pmwiki version - see http://www.pmwiki.org/wiki/PmWiki/Download
url="http://localhost/"   # url for the directory where this script is
if [ -e $dir ] ; then
  echo "$dir exists"; exit
fi
if [ ! -f pmwiki-$ver.tgz ] ; then
  wget http://www.pmwiki.org/pub/pmwiki/pmwiki-$ver.tgz
fi
tar -zxvf pmwiki-$ver.tgz
mv pmwiki-$ver $dir
cd $dir/local/
wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/InstaWiki-latest.tar.gz
tar -zxvf InstaWiki-latest.tar.gz -C ../
chmod 2777 ../   # ../ is the wiki's main/ directory
wget -O- $url$dir/ >/dev/null   # retrieve the page
chmod 0775 ../
chmod g-s ../

Configuration

Set the directory name, PmWiki version, and URL.

Usage

1. Download the scriptΔ and rename it to InstaWiki.sh or copy-n-paste the script text into a script.
2. Make sure it's in a directory that matches a URL (see below).
3. Set the settings.
   1. directory name
   2. version of PmWiki
   3. URL that points to the directory where the script is run from, ending in a / because it's a directory.
4. Run the script. (bash ./InstaWiki.sh)

Notes

To disable uploads after the wiki is installed,

1. comment out the line that starts with $HandleAuth['upload'].
2. delete the uploads/ directory.

Change log / Release notes

2016-09-30 - Initial release

See also

Contributors

HaganFox

Comments

See discussion at InstaWiki-Talk?