How do I install PmWiki?
Please visit How do I set up a wiki? to learn about other supported options before proceeding.
To install PmWiki:
- Visit the CGI Request Form if CGI has not yet been enabled for the account installing PmWiki.
- Once CGI is enabled, connect to the account on Eniac via the command line.
- Note: If you already have a
wikidirectory in your
htmldirectory, rename or delete it before installing PmWiki.
- Run the following command to install PmWiki:
- The script will prompt you to create a PmWiki admin password.
- The first time you access your wiki in a browser, the
index.phpfile will automatically create a
wiki.ddirectory in your
wikidirectory to store new content.
If you have CGI activated on
If you have CGI activated on
usernameis the SEAS account name where you are installing PmWiki.)
How to Change the Passwords
Change the Admin and/or Edit passwords by modifying these lines in
$DefaultPasswords['admin'] = crypt('newadmin-password');
$DefaultPasswords['edit'] = crypt('newedit-password');
Change the Title of Your Wiki
Change the wiki title by modifying these lines in
## Title of this wiki
$WikiTitle = 'New Wiki Site Title';
wiki/local/config.php to change the logo image, create
different user controls and permissions, themes, etc. For more information on
custom configuration options, please see the pmwiki.org documentation. When creating
custom configurations, please check to make sure your permissions are set
Creating Multiple Instances of PmWiki
You can create as many instances as you want of PmWiki by creating
subdirectories within your wiki directory. For example, copy the contents of
your wiki directory into the
~/html/wiki/wiki1/ subdirectory. Then
do the same thing again for
~/html/wiki/wiki2/. Repeat as many
times as desired.
How to Include HTML Markup
For security reasons, PmWiki does not support HTML markup in wiki pages by default. Follow the instructions on this page to enable HTML. There are a few items not fully explained in the article that you will need to know:
- You will need to create a directory called "local" in your wiki directory (you may have already done this if you followed the instructions above). Make sure it is only read/write/executable by the owner (chmod 700).
- Within the "local" directory, create a directory called "cookbook" with the same permissions as "local". Put your "enablehtml.php" file (as described in the article) in this directory.
- Create a "config.php" file within your local directory (you may have already done this if you followed the instructions above). Make sure this file is not world readable.
- Add these lines to your "config.php" file:
This enables most basic html tags. You may want to add or remove tags from the lists above depending on what you want your users to be able to do.
Warning: Be aware what types of tags you allow. Certain tags, like <script> and <meta>, can give users dangerous amounts of control over your pages.