 ____  _                  _     __  __                         
|  _ \| | __ _ _ __   ___| |_  |  \/  | ___  _ __   __ _  ___  
| |_) | |/ _` | '_ \ / _ \ __| | |\/| |/ _ \| '_ \ / _` |/ _ \ 
|  __/| | (_| | | | |  __/ |_  | |  | | (_) | | | | (_| | (_) |
|_|   |_|\__,_|_| |_|\___|\__| |_|  |_|\___/|_| |_|\__, |\___/ 
         The Transparent Content Manager           |___/v0.04a

This is a quick outline that will explain everything you need to 
know in order to use Planet Mongo effectively.

* Installation
	0. Extract all files to directory on server (it would seem that 
		you already did this).
				You're done! If everything was 
				completed successfully, pointing 
				your browser at index.php should 
				result in a friendly welcome page!
		
		If you are planning on using the web-based content and news 
		editor, then also do the following:
	1. Open up "config/config.php" and change the $main_salt 
		variable to something else. Since, unlike a password, a 
		salt is just used internally, you'll never be asked to 
		remember this. That means you can just mash random keys, 
		and make it as difficult as possible.
	2. You probably also want to set the $editor_enabled variable 
		to equal TRUE.
	3. Open up "config/users.php" and change the password for the 
		administrator account. Just use the two example users 
		listed there as templates for adding your own.
	4. Point your browser at index.php?rqst=__page_editor to 
		start using the web-based content editor.
		
* Planet Mongo might be a little different than what you'd expect
	0. Planet Mongo focuses on the simplest possible use of a 
		content manager: putting a "theme" together with a page 
		of "content".
	1. Although Planet Mongo contains modules for things like 
		a blog, users, and other such features, they are only 
		invoked within "a page" of content using a Planet Mongo 
		command.

* Understanding Planet Mongo commands
	0. Planet Mongo is based on these things called "Planet Mongo" 
		commands.
	1. A Planet Mongo command looks like this:
		<!--[[ comment : main : feedback ]]-->
	2. The first item is the module name. The second item specifies 
		which module function you want to use.
	3. The third item is a (usually) optional argument. In the 
		case of the "comment:main" command, the third item is 
		the name of the database to read comments from and write 
		new comments to.
	4. A file that, when displayed by Planet Mongo, will interpret 
		Planet Mongo commands, is called a "capable" file. By 
		default files in the "content" and in the "theme" 
		directories are capable.
	5. Use the 'capable' and 'uncapable' filename keywords to 
		make a file that is ordinarily (see the filename 
		keywords section).

* Making your own theme
	0. Probably the first thing you wanna do after an installation is 
		make your own theme.
	1. It's uber easy.
	2. You can open up "themes/template.html" as an example.
	3. As you can see, you don't even need to know any PHP to write a 
		theme! The entire theme is contained right there in the HTML 
		file!
	4. Also, as you can see, the theme is simply a series of Planet 
		Mongo commands separated by HTML (see the previous section).
	5. The important Planet Mongo commands for a theme are the 
		following:		
			<!--[[ theme : head ]]-->
				(put this somewhere between <head> and </head>)
			<!--[[ theme : site_title ]]--> 
				(displays the title of your site, as specified by 
				$main_site_title in config.php) ***
			<!--[[ content : page_title ]]-->
				(displays the title of the current page that the 
				user is looking at)
			<!--[[ theme : link_box ]]--> 
				(displays the navigation, as specified by the
				$theme_link_box variable in config.php) ***
			<!--[[ content : main ]]-->
				(displays the page content)
			<!--[[ theme : footer ]]-->			
				(displays the copyright line) ***
	6. You may have noticed the curious *** in the previous list.
		The commands marked with *** are commands that you may 
		prefer not to use and instead just hard-code such things 
		into your theme, since it is likely you want to use your 
		theme only for one website. With Planet Mongo hackability 
		is expected, and respected, and effected, and elected.

* Adding content
	0. Now that you have your theme installed and customized, its 
		time to add content.
	1. All you need to do is put it in the "content" directory.
	2. News articles go in the "news" directory.
	3. When adding pages such as these, you should keep in mind the 
		file-name keywords (explained in next section).

* File-naming
	0. The file name of every file in Planet Mongo tells how to treat 
		it.
	1. These options are set via a series of "keywords" separated by 
		dots, such as "welcome.index.html".
	2. The first keyword is always the title. Unless the title is in 
		mixed case, the title will be automatically formatted into 
		proper case. Thus, "my_page_of_links.html" will become
		"My Page of Links".
	3. A keyword that is entirely a number will be assumed to be a 
		date, in the Unix time-stamp format. This is useful for 
		dating news articles, although it can be used for other files 
		also.
	4. Several file extensions are also recognized by Planet Mongo:
		php: file will be executed as a PHP file
		html: file will be outputted without modification
		bb: file will be interpreted as BBCode and translated into 
			HTML before being outputted
		txt: file will be outputted in a fixed-width font
	5. A few other handy keywords:
		index: serves this file first when your page is visited
		capable: allows a file that is not ordinarily capable of 
			interpreting Planet Mongo commands to interpret 
			Planet Mongo commands
		uncapable: (inverse of above)
		nolist: doesn't list the file when automatically listing 
			files
		error404: use this file as a custom 404 error page, when 
			a non-existent file is requested


There! You're ready to use Planet Mongo! Have fun!


