PmWiki is a wiki-based system for collaborative creation and maintenance of websites.
PmWiki pages look and act like normal web pages, except they have an "Edit" link that makes it easy to modify existing pages and add new pages into the website, using basic editing rules. You do not need to know or use any HTML or CSS. Page editing can be left open to the public or restricted to small groups of authors.
Key PmWiki Features
Custom look-and-feel: A site administrator can quickly change the appearance and functions of a PmWiki site by using different
skins and HTML templates. If you can't find an appropriate skin
already made, you can easily modify one or create your own.
Access control: PmWiki password protection can be applied to an entire site, to groups of pages, or to individual pages. Password protection controls who can read pages, edit pages, and upload attachments. PmWiki's access control system is completely self-contained, but it can also work in conjunction with existing password databases, such as
.htaccess, LDAP servers, and MySQL databases.
Customization and plugin architecture: One principle of the
PmWikiPhilosophy is to only include essential features in the core engine, but make it easy for administrators to customize and add new markup. Hundreds of features are already available by using extensions (called "recipes") that are available from the PmWiki
Cookbook.
PmWiki is written in PHP and distributed under the General Public License. It is designed to be simple to install, customize, and maintain for a variety of applications. This site is running pmwiki-2.2.11.
PmWiki is a registered trademark of Patrick R. Michaud.
PmWiki's home on the web is at pmwiki.org.
administrators (intermediate)
There are many ways to configure PmWiki:WikiFarms, and some of the documentation uses different terminology to describe the same things. This page attempts to explain the terminology.
For terms not related to farms, see Glossary.
Why is this page needed?
- to provide a place to find the preferred terminology with definitions
- to explain where the term "farm" came from
- to list various terms that have been deprecated but still exist in the docs
- to suggest alternate terms for the deprecated ones
The origins of WikiFarms
The term WikiFarm is based on the computing term "server farm", which is a collection of servers that use a common infrastructure. A wiki farm is nothing more than multiple wikis that share the same installation of the PmWiki software.
Some recipe and documentation authors, however, began writing about WikiFarms using agricultural terms such as "field", "farmer", "barn", "crop", and "tractor". In some cases these terms made the documentation more confusing. It is suggested that documentation authors avoid the agricultural terms, as tempting as they may be, and keep in mind that a wiki in a wiki farm is like a server in a server farm.
Wikis and components in a WikiFarm
All of the wikis in a farm are more or less the same, except the "home wiki" is a wiki that is located in the same directory as the PmWiki software. The home wiki needs special consideration because it holds the components that are shared by or affect the operation of all the wikis in the farm. In particular:
- the scripts/ directory
- the cookbook/ directory
- the pub/ directory
- the wikilib.d/ directory
It is possible to move the PmWiki software outside of the web document tree, but the pub/ directory needs to be in a web-servable directory (one that can be accessed by a URL).
Authors writing about complex farm setups often have difficulty describing the components and their locations. However, it is probably not necessary or desirable to coin new terms for the components and their locations.
Suggested terms
- WikiFarm
- An installation where one copy of PmWiki is configured to run multiple wikis. Analogous to the computing phrase "server farm". The wikis in a farm can be configured farm-wide (using the farm's local/farmconfig.php) or individually (using the wiki's local/config.php).
- Wiki
- A site with it's own URL and wiki.d/ directory. All of the wikis in a wiki farm are simply called wikis.
- Home wiki
- A wiki in a farm that's located in the same directory as the PmWiki software and therefore shares the farm's cookbook/ and pub/ directories. If you start with a stand-alone installation and add a wiki, the original wiki becomes a home wiki.
- Farm-wide
- Something available to or affecting all wikis in the farm. Typically this means modifying the farmconfig.php file or the contents of the farm's cookbook/ or pub/ directories.
- Local
- Something available to or affecting a specific wiki. Typically this means modifying the wiki's local/config.php file or the contents of the wiki's cookbook/ or pub/ directories.
- PmWiki
engine - The software that makes PmWiki work, as opposed to the content of the wiki that readers see.
- PmWiki
installation directory - The directory PmWiki is installed to. It contains pmwiki.php and its subdirectory scripts/, which is used by all the wikis in the WikiFarm.
If you do a standard, single install of PmWiki, it goes into this directory.
Ambiguous terms
- Installation directory
- Installation of what? Some authors have used this to mean the directory that contains most of the shared components on a wiki farm. Others use it to mean a directory that has a complete standalone installation of PmWiki that is not part of a farm. Use PmWiki directory instead.
- PmWiki installation
- This is sometimes used to indicate a process, sometimes used to mean a single wiki in a farm, and sometimes refers only to the shared components of a farm.
Deprecated terms that should not be used
These terms still exist in the documentation (pending revisions), and will live forever in the PmWiki-Users list archive.
- farm directory
- The directory in which the home wiki lives or a directory where the shared components are stored. Use PmWiki directory instead.
- field
- Any wiki in a farm which is not the home wiki.
- farm administrator
- An administrator who has access to all of the wikis in a farm, particularly the home wiki. Use administrator instead.
- field administrator
- An administrator who has access to one or more wikis in a farm, but not the home wiki. Use administrator instead.
- barn
- The place where common components are stored. Use PmWiki directory instead.
- crop
- Packaged content and customizations that can be added to a wiki. See Cookbook:ListOfBundles for similar ideas. Use component bundles instead.
- tractor
- The PmWiki engine or pmwiki.php itself. Use PmWiki instead.
Categories: WikiFarms
PmWiki is a wiki-based system for collaborative creation and maintenance of websites.
PmWiki pages look and act like normal web pages, except they have an "Edit" link that makes it easy to modify existing pages and add new pages into the website, using basic editing rules. You do not need to know or use any HTML or CSS. Page editing can be left open to the public or restricted to small groups of authors.
Key PmWiki Features
Custom look-and-feel: A site administrator can quickly change the appearance and functions of a PmWiki site by using different
skins and HTML templates. If you can't find an appropriate skin
already made, you can easily modify one or create your own.
Access control: PmWiki password protection can be applied to an entire site, to groups of pages, or to individual pages. Password protection controls who can read pages, edit pages, and upload attachments. PmWiki's access control system is completely self-contained, but it can also work in conjunction with existing password databases, such as
.htaccess, LDAP servers, and MySQL databases.
Customization and plugin architecture: One principle of the
PmWikiPhilosophy is to only include essential features in the core engine, but make it easy for administrators to customize and add new markup. Hundreds of features are already available by using extensions (called "recipes") that are available from the PmWiki
Cookbook.
PmWiki is written in PHP and distributed under the General Public License. It is designed to be simple to install, customize, and maintain for a variety of applications. This site is running pmwiki-2.2.11.
PmWiki is a registered trademark of Patrick R. Michaud.
PmWiki's home on the web is at pmwiki.org.
