Difference between revisions of "Directory Hierarchy"

From GeeklogWiki
Jump to: navigation, search
Line 1: Line 1:
 +
By [[User:Amckay|Alan McKay]]
 +
 
These are currently just notes but soon i'll be organising them into a general discussion on the way i manage my geeklog installations.  While I do not yet have a (mostly) fully-automated means of administering may Geeklog sites, I have finally put together an organisational mechanism which will eventually allow me to write a collection of automated PHP scripts to do the rest for me.
 
These are currently just notes but soon i'll be organising them into a general discussion on the way i manage my geeklog installations.  While I do not yet have a (mostly) fully-automated means of administering may Geeklog sites, I have finally put together an organisational mechanism which will eventually allow me to write a collection of automated PHP scripts to do the rest for me.
  
%TOC%
+
== Path To Geeklog ==
 
 
---+ Path To Geeklog
 
  
 
   * have a look at all of the variables in config.php which are based on /path/to/geeklog, and realise that any of these should be movable anywhere, and Geeklog will still work fine.  Plugin writers should note this as well - most of my own plugins do not adhere to this standard, and break.  Though my latest "books" plugin should work fine.
 
   * have a look at all of the variables in config.php which are based on /path/to/geeklog, and realise that any of these should be movable anywhere, and Geeklog will still work fine.  Plugin writers should note this as well - most of my own plugins do not adhere to this standard, and break.  Though my latest "books" plugin should work fine.
  
---+ Multi-Domain Directory Structure
+
== Multi-Domain Directory Structure ==
  
 
On my server all domains live at /home/username/domains/hostname.example.com/, and geeklog is always at /home/username/domains/hostname.example.com/htdocs/geeklog-x.ysrz.  I also maintain under that a /home/username/domains/hostname.example.com/vdirs/ into which all virtual directories go.  So plugins should ideally go into /home/username/domains/hostname.example.com/vdirs/gl-plugins/pluginname/public_html, the latter of which maps to http://www.example.com/pluginname/.  You have to use similar webserver tricks to map in any admin, layout or other parts of the plugin which may be included (depends on the plugin).  Always ask the plugin author if unsure whether it will work like this.  But any good plugin should adhere to those GL base system variables.
 
On my server all domains live at /home/username/domains/hostname.example.com/, and geeklog is always at /home/username/domains/hostname.example.com/htdocs/geeklog-x.ysrz.  I also maintain under that a /home/username/domains/hostname.example.com/vdirs/ into which all virtual directories go.  So plugins should ideally go into /home/username/domains/hostname.example.com/vdirs/gl-plugins/pluginname/public_html, the latter of which maps to http://www.example.com/pluginname/.  You have to use similar webserver tricks to map in any admin, layout or other parts of the plugin which may be included (depends on the plugin).  Always ask the plugin author if unsure whether it will work like this.  But any good plugin should adhere to those GL base system variables.
  
---+ Websever Tricks
+
== Websever Tricks ==
  
---++ Apache 2.x
+
=== Apache 2.x ===
  
 
Use the webserver's virtual-directory capabilities to map all plugin files into the main geeklog directory.  That means that when you are logged into the =bash= prompt, your files will be at the well-known /path/to/geeklog, which cooresponds to http://www.example.com/ in the web space.   
 
Use the webserver's virtual-directory capabilities to map all plugin files into the main geeklog directory.  That means that when you are logged into the =bash= prompt, your files will be at the well-known /path/to/geeklog, which cooresponds to http://www.example.com/ in the web space.   

Revision as of 22:54, 14 September 2006

By Alan McKay

These are currently just notes but soon i'll be organising them into a general discussion on the way i manage my geeklog installations. While I do not yet have a (mostly) fully-automated means of administering may Geeklog sites, I have finally put together an organisational mechanism which will eventually allow me to write a collection of automated PHP scripts to do the rest for me.

Path To Geeklog

  * have a look at all of the variables in config.php which are based on /path/to/geeklog, and realise that any of these should be movable anywhere, and Geeklog will still work fine.  Plugin writers should note this as well - most of my own plugins do not adhere to this standard, and break.  Though my latest "books" plugin should work fine.

Multi-Domain Directory Structure

On my server all domains live at /home/username/domains/hostname.example.com/, and geeklog is always at /home/username/domains/hostname.example.com/htdocs/geeklog-x.ysrz. I also maintain under that a /home/username/domains/hostname.example.com/vdirs/ into which all virtual directories go. So plugins should ideally go into /home/username/domains/hostname.example.com/vdirs/gl-plugins/pluginname/public_html, the latter of which maps to http://www.example.com/pluginname/. You have to use similar webserver tricks to map in any admin, layout or other parts of the plugin which may be included (depends on the plugin). Always ask the plugin author if unsure whether it will work like this. But any good plugin should adhere to those GL base system variables.

Websever Tricks

Apache 2.x

Use the webserver's virtual-directory capabilities to map all plugin files into the main geeklog directory. That means that when you are logged into the =bash= prompt, your files will be at the well-known /path/to/geeklog, which cooresponds to http://www.example.com/ in the web space.

The following entry is from /etc/httpd.conf on my main brewing webside http://www.bodensatz.com/

        Alias /filemgmt_data/ "/home/bodensatz/vdirs/filemgmt_data/"

more to come ... 2006.09.14

p.s. it seems this is not the same markup as Twiki. If anyone knows both wikis and wants to translate this spage before i get time to do so, it would be appreciated.