WikiFarm
<< Using RSS Feed | Cookbook-V1 | Trail 2 Menu >>
Note: The recipes here are for PmWiki versions 0.6 and 1.0 only. For PmWiki 2.0 recipes, see Cookbook.
Goal
Provide a way for several different clusters of groups ("fields") to share a common code base and local customisations.
Solution
Attach:wikifarm-0.2.3.tar.gz is a collection of scripts that organises groups into fields within a wiki farm. Existing groups are not affected. This release includes an alternative package for use with PmWiki.WikiFarms.
See also PmWiki.WikiFarms and WhichFarmToUse.
Discussion
The README file describes how to install and test the farm scripts. No changes to the core pmwiki scripts are required; it's a pure local customisation. If you have a heavily-customised wiki, you may wish to test it with a clean install of PmWiki first.
The wikicolony/README describes how to use the scripts with PmWiki.WikiFarms.
It ships with one field set up by default. You define a new field by adding it to the Main.WikiFarm page.
- SoggyBottom:/
By default, the PmWiki and Profiles groups are shared across all fields. You can also share other groups, by adding them to the Main.WikiFarm page, eg
- Glossary.HomePage
A [[$FarmTrail]] variable uses the field list on the Main.WikiFarm to generate links to the next and previous fields, and the farm's home page.
A ReadSharedPage function lets you specify calls to a $ReadPage function to detect whether the requested page is in one of the shared groups. If so, it reads from the common area; otherwise, it reads from the current field. Unfortunately, PmWiki itself doesn't use a $ReadPage function, so this only works with local customisations.
The script includes a slightly-modified pmwiki.tmpl file that is field-aware. The local/config.php file that's included automatically points PmWiki to this.
See Also
Development.WikiFarm
History
8 June -- fix a template bug and include a version that can be used with PmWiki.WikiFarms
24 May -- support fields with the same name as groups in the central wiki
2 May 2004 -- first fully tested release
Comments & Bugs
[(approve links)
edit
diff] users be warned:
paths like: wikifarm-0.2.1\->local\Wikifarm-scripts\
have to be extracted without the option "use folder name".
-pog
Leave this field for future bugs or comments for your script
Contributors
- John Rankin (design and integration)
- Donald Gordon (coding)
Copyright
If necessary, put your copyright information for the script here. pmwiki-2.3.38 -- Last modified by {{BenWilson}}