[pmwiki-users] Documentation of Recipes

Patrick R. Michaud pmichaud at pobox.com
Thu Jan 22 09:38:08 CST 2009


On Wed, Jan 21, 2009 at 11:37:01AM +0100, Petko Yotov wrote:
> On Wednesday 21 January 2009 09:50:23 Christian Ridderström wrote:
> > On Wed, 21 Jan 2009, Petko Yotov wrote:
> > > I dislike multiple wikilib.d/ directories added by recipes, for these
> > > reasons:
> > > [...]
> >
> > I prefer having a separate wikilib.d/ because it allows me to better use a
> > version control system (VCS). It's typically possible to have several
> > subdirectories belonging to different repositories, but it doesn't work
> > having files from diffrerent repositories in a single wikilib.d/.
> 
> It should not be hard for the script which creates the YourRecipe.zip 
> archive, to copy the pages from your different directories in the 
> single wikilib.d, 

I'd prefer that we not require skin and recipe creators to go through
this extra step.  In particular, the instructions for skins are to
unpack them from the pub/skins/ directory -- so getting their
documentation pages into wikilib.d might be problematic.

> > > * PmWiki runs slightly faster (considerably faster if 12 recipes add 12
> > > custom wikilib directories).
> >
> > As for PmWiki running slightly faster without many wikilib.d/, have you
> > done any benchmarking?  And if there is a significant difference
> 
> In principle, opening+scanning+closing is faster with one directory than with 
> many. In practice, the "scanning" part is variable, and in directories with 
> few files it is fast. So there may not be a huge difference, but knowing I 
> don't do it the optimal way is painful to me. :-)

I'm not too worried about the speed here.  Of greater importance to
me is that I'd like admins to have the ability to exclude documentation
pages from the site entirely, and that's far more easily handled if
documentation is kept in separate directors than if they're all in
a single directory.

I completely grant that we need better interfaces for manipulating
$WikiLibDirs.

Pm



More information about the pmwiki-users mailing list