Inline Gallery quick start

	This thing is based on AutoGallery by Kyrre Baker (http://www.kyrres.net). Allthough all that's left of it is
some ideas, it was a starting point, so it's worth mentioning. The TinyMCE plugin was developed starting from the wordpress one.

Features:
	* plug and play, just like any other Wordpress plug-in
	* easy to configure
	* does no processing on the images (except for getting the image metadata), so it's fast
	* you can have multiple galleries per post
	* integrated with Wordpress' wysiwyg editor (the way QuickTags is implemented doesn't allow easy placing of 
	  buttons in the toolbar, but that's not a big problem, since you are editing code, anyway)
	* (since 0.2) output can be customized using Smarty-like templates

Requirements:
	* Wordpress 2.0 (it's easy to adjust to 1.5, though)
	* mod_rewrite and permalinks enabled

To install: 
	* unzip and copy inline-gallery.php and the inline_gallery folder into wp-content/plugins
	* activate the plugin
	* go to Options -> Inline Gallery to set it up
		* the root folder is the path relative to your site URL, so if you access your wordpress is
		  "http://example.com/blog/" and the images are under "http://example.com/blog/wp-content/galleries",
		  you should set the gallery root to "wp-content/galleries"
		* the image types list is simply a comma separated list of file extensions
		* if you do not want to use full urls, uncheck it
	* go to Options -> Permalinks to update the permalink structure
	* done

Usage:

	The galleries are file folders that contain images, a text file called "desc.txt" and a subfolder called "thumbs". 
Galleries can be nested (one level for the moment, will expand if needed), and can contain any number of images. A sample 
gallery is included.
	The text file "desc.txt" consists of pairs like:

[keyword]
line of text

	There are only 2 keywords in use: "tag", followed by a one-line description of the gallery, and "dir" followed by a folder 
name (nested gallery). Everything else appearing between square brackets is treated as a file name followed by the alt text (note 
that file existence is verified, so stray text won't cause much trouble). So, a desc.txt file could look like this:

[tag]
This is a short description of the gallery

[dir]
somedir

[dir]
someotherdir

[image1.jpg]
this is an alt text

...

	It's easy to generate a listing of the image files in a folder, especially if you are using Linux ;). It took me about 
10 minutes to produce a desc.txt file for about 70 photos, so it's fast enough, all you need is a text editor.
	The "thumbs" subfolder holds the image thumbnails; their dimensions are your choice. The thumbnails can be easily generated 
using Photoshop's batch mode or ImageMagick's convert in a shell one-liner. A sample gallery set up script is included.

	The galleries live under the gallery root folder you have configured. The main gallery for a post/page must have the same name
as the post or page slug, i.e. if the post URL is "http://columbus.com/blog/1492/10/12/just-found-america" the main gallery should be 
called "just-found-america".

	To insert a gallery in a post:
	* in code edit mode:
		* enter "<!--gallery-->" where you want your main gallery to appear, or
		* enter "<!--gallery[/subfolder/]-->" if you want to insert a nested gallery
	* in visual editing mode, click the "insert gallery" button, and enter "/subfolder/" in the input box for a nested gallery, leave
	  it blank or press cancel for the main gallery

	Note that the main gallery doesn't need to contain images, it can be just a place to store sub-galleries (desc.txt is needed, though).
	Since version 0.2, the output is customizable with templates, see the sample gallery to get an idea of this.

	I think that's about it... use it and enjoy! Comments, ideas and praises are welcome.