[Pmwiki-users] Re: Call For Directory Simplicity

[Christian Ridderström]

On Fri, 13 Feb 2004, Andres Yver wrote:

> The local directory is well named.

I agree. The local directory is where you place local customizations and 
configurations -- local stuff. 

> Others had mentioned the typical unix directories for configs, but i'm 
> willing to bet that _most_ future wikians won't come from a strong unix 
> background, so those names might to them be meaningless.

Well, /usr/local isn't exactly unknown to Unix-people...

> The scripts directory also has a non-intuitive name for the layman. 
> What do they know about scripts?

It's difficult to come up with a good name, and it needs to be quite a bit
better than 'scripts/' in order to motivate a change. You suggested
'util/' and other suggestions are 'modules/' and 'extensions/' but none of
them really seem much better to me.

But while we are talking about the directory structure. I started thinking 
about the CSS-files. Right now they're located in pub/CSS, but if (when) I 
fiddle with the CSS-files, I risk losing these changes the next time I 
upgrade pmwiki, or have I missed something?

One possible solution could be to encourage the admin to instead of 
modifying the CSS-files in pub/CSS, he copies them first to another 
directory, e.g. local/CSS and modifies them there. And then pmwiki.php 
uses local/CSS/pmwiki.css instead of pub/CSS/pmwiki.css if the former 
exists. OTOH, maybe anything below local/ should be inaccessible to a 
browser, I don't know.

/Christian

PS. I personally probably won't actually loose anything because I keep all
files under version control using CVS, but you get the idea.

-- 
Christian Ridderstr?m                           http://www.md.kth.se/~chr