== README ===============================
Name: new file from template
Desc: creates a new document based on a custom define template file.
Author: Rob Miller 
Email: funky.style@gmail.com
WWW: http://gnome.en9ine.com/gedit/
=======================================

** INSTALLATION *********
copy the contents of the newfromtemplate.tar.gz archive into ~/.gnome2/gedit/plugins then activate the plugin from the preferences->plugins dialog in gedit. 

Alternatively you can install the plugin system wide eg - /opt/gnome/share/gedit-2/plugins/


** WRITING YOUR OWN TEMPLATES *************

very, very easy (for now, may change if i implement the stuff in the TODO file) 

Here are some steps....

1. create a template file called whatever you want. 
	eg - cpp_template
2. write the template, and at any point where you want a user defined variable, substitute it with a $$description of variable$$
	eg - contents of cpp_template


	/** @author $$author of file$$
	 *	@brief	$$brief description of class$$
	 *	@email	$$email address of author$$ */

	class $$the classname$$ 
	{
		// default constructor
		$$the classname$$() 
		{

		}
	
		// default destructor
		~$$the classname$$()
		{

		}

	}

3. In the above example you can see there are 4 distinct variables, when you select file->new from template and select the cpp_template, the plugin will scan the file and extract out each variable and form a gui to enable you to put in your own variable name.
4. Once you confirm this, a new tab will be created with the substituted variables in place. 
5. easy!