|
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.
GoalProvide a way for several different clusters of groups ("fields") to share a common code base and local customisations. SolutionAttach: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. DiscussionThe 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.
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
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. In particular, the displays of EditQuickReference and UploadQuickReference in the edit and upload actions rely on ReadPage. To get around this, the WikiFarm includes copies of these pages in the wikifarm/wikilib.d/ directory. So it all just works.
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 AlsoDevelopment.WikiFarm History8 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 & BugsUltimateZip 2.7.1(approve links) users be warned:
changed '->' to 'to.' which should fix this problem -- jr
Leave this field for future bugs or comments for your script Contributors
CopyrightIf necessary, put your copyright information for the script here. pmwiki-2.2.0-beta68 -- Last modified by {{BenWilson}}
|