PmWiki
This page is for notes to help get people started with a new pmwiki site. There is not much here yet. If you have experience running pmwiki, let us know what we should put here.
the directory layout
You will start out with a directory structure like this:
.../username
wiki.php
wiki.d/
local/
config.php
webalizer/
- wiki.php: just a stub which is used to call the actual wiki code.
- wiki.d: a directory to hold all the wiki pages. this directory doesn't exist until you make your first edit.
- local: a directory to hold local pmwiki source files
- local/config.php: your pmwiki configuration file.
- webalizer: a directory which holds traffic graphs
getting started
The first thing you want to do is edit config.php.
Here is an example config.php configuration file:
<?php
if (!defined("PmWiki")) exit();
$ScriptUrl = "";
$WikiTitle = "My Site";
$PageLogoUrl = "/mylogo.png";
$Skin = "pmwiki";
$DefaultPasswords["admin"] = "";
$DefaultPasswords["edit"] = "";
$DefaultPasswords["read"] = "";
$DefaultPasswords["upload"] = "";
return;
?>
To set a password, you would do something like this:
$DefaultPasswords["admin"] = crypt('my very secret password');
In order to edit this file, you will need to login using ssh or
sftp. If using sftp, you can download the config.php file, edit it, then upload it again. If using ssh, then you can use the text editor 'nano' to edit the file.
for more information, see
www.pmwiki.org/wiki/PmWiki/InitialSetupTasks
users and groups
If you require more access control than a simple password, it is possible to create users and groups by using the special AuthUser page. For more information, see
www.pmwiki.org/wiki/Site/AuthUser.
available skins
In PmWiki, the appearance you choose for the website is called a "skin". We have pre-installed a number of skins for you to use. In order select a skin, edit the config.php file like so:
$PageLogoUrl = "/path/to/mylogo.png";
$Skin = "name of skin";
Where "name of skin" is equal to one of the skin names below, and /path/to/mylogo.png is the name of a image you have uploaded. You can upload the image using
sftp, or you can attach the image to a wiki page (in which case the image will likely have a path like "/uploads/PageName/mylogo.png"). See the web page for the individual skin for a preview and for information on configuring the skin.
- FlexiSkin: this is a flexible css skin which you can edit entirely from within pmwiki. the different sections are specially named pages, so that if you want to edit the left side bar, you would edit the page FlexiRight.
In config.php: $Skin = "flexi";
- WikiLoveSkin: a simple and sleek skin, with a dark grey background.
In config.php: $Skin = "wikilove";
- LeanSkin: a plain yet useful skin, designed with function in mind.
In config.php: $Skin = "lean";
- BeeblebroxGila: an all css skin with an attractive look.
In config.php: $Skin = 'beeblebrox';
- SimpleSkin: a nice looking skin, without a sidebar or other wiki clutter. You several color combinations to choose from.
In config.php:
$Skin = "simple";
added recipes
There are a whole bunch of
cookbook recipes. So far, we have installed one:
- comments: comments are installed. you access it with ?action=comments