// The SKY Theme for Textpattern v1.0
// Designed & Developed by Chris Casciano
// Theme Info: http://placenamehere.com/TXP/sky_theme/
// Demo Site: http://sky.placenamehere.com/

This readme.txt file contains the following information to help you install and use the SKY theme for Textpattern:

I. PACKAGE CONTENTS
II. BACKGROUND + GOALS
III. INSTALLATION INSTRUCTIONS
IV. SITE PREFERENCES
V. CREDITS + INFO


I. PACKAGE CONTENTS

./forms/ :: the forms templates that get added to the presentation > forms panel
./pages/ :: the page templates that get added to the presentation > pages panel
./README.txt :: This file.
./SKYTheme.png :: A screen shot of the theme
./static/themes/sky/ :: images and other external files the theme uses*
./styles/ :: the style sheets that get added to the presentation > style panel


* Included in the distribution is the IE7 script library by Dean Edwards to gracefully handle some cross browser issues with CSS and PNG images. Note: This is only included for user download in cases where a user is running IE/Win 6 or less.




II. BACKGROUND + GOALS

In making this theme I looked at is as much as an attempt to solve some technical questions I had about Textpattern as I did about making the prettiest or most universal theme. I don't think I sacrificed quality of the theme as a result, but you may find my approach a bit different then other themes that have been released so I wanted to mention a few technical points that I hit on. (Its OK to skip to the INSTALLATION section if you're not interested in web or textpattern geekery and just want to use the theme).

* Simple, but fun personal blog layout using XHTML + CSS.
* Leave currently installed templates and styles alone so its easy to modify things as needed before going 'live' and its also easy to change back to the old layout if you need to for any reason.
* Try and make the templates and forms as smart as I can without requiring the use of plugins.
* Use the theme as a test implementation for the hatom microformat <http://microformats.org/wiki/hatom>




III. INSTALLATION INSTRUCTIONS

(1) Upload the contents of the static directory to your web host from your computer into the root directory of the web server. If your uploaded the original textpattern files to /username/example.com/textpattern/ then these files should be located in /username/example.com/ and create a directory of files in /username/example.com/themes/sky/ (If you change the location you upload to, make sure to change any references in the templates and styles)

(2) Log in to your Textpattern admin panel. This is where the the rest of the work will be done.

(3) Add the needed Forms. There will be 1 form for each text tile in the forms directory of this package.

* Go to the Presentation tab of the admin interface the go to the tab marked Forms.
* Repeat the following steps for each form:

	# click "Create new form" link in upper right
	# copy the contents of the text file from /forms/ into the main form box
	# enter the name the form in the 'form name' box. Use the same the name of the text file (minus the .txt part)
	# select the proper 'form type' for the form from the list below
	# click the 'save new' button
	# go back to the first step until you are out of forms
	
Forms list

Text File: ./forms/SKYabout_site.txt
Form Name: SKYabout_site
Form Type: misc

Text File: ./forms/SKYcomments.txt
Form Name: SKYcomments
Form Type: comment

Text File: ./forms/SKYcomment_form.txt
Form Name: SKYcomment_form
Form Type: comment

Text File: ./forms/SKYdefault.txt
Form Name: SKYdefault
Form Type: article

Text File: ./forms/SKYlinks.txt
Form Name: SKYlinks
Form Type: link

Text File: ./forms/SKYsearch_results.txt
Form Name: SKYsearch_results
Form Type: article

Text File: ./forms/SKYsticky.txt
Form Name: SKYsticky
Form Type: article


(4) Add the needed Styles and Pages in a similar manner to the Forms in step 3.

* For Styles click 'Create or load new CSS' for the 2 Style sheets that need to be added

Text File: ./styles/SKY.txt
Style Name: SKY

Text File: ./styles/SKYiewin.txt
Style Name: SKYiewin

* For the main template Pages you must first copy an existing Page with the form at the bottom of the screen by entering the new Page name 'SKYdefaut' and clicking "Copy". You finish by editing the newly created Page by copying in the content of the text file.

Text File: ./pages/SKYdefault.txt
Page Name: SKYdefault


* For the error Page, if you decide you don't want the default textpattern one but instead want it to look like the rest of the SKY theme, you will need to edit the existing page 'error_default' instead of creating a new one. This is due to a limitation in current versions of Textpattern. So follow the last step for the following Page.

Text File: ./pages/error_default.txt
Page Name: error_default


(5) Template Customization there are three IMPORTANT changes that you must make to the theme you just installed to get it customized for your site.

* The Form 'SKYabout_site' should be edited to include a blurb about the web site /you're/ running instead of the 'Lorem Ipsum...' text that ships with the template. This is static content that appears at the footer of each page in the site.

* The Page 'SKYdefault' contains 2 links to your feeds in the top of the template

* If you have section navigation beyond that of the basic paging through blog posts you will need to add it into the templates. At the top of the Page 'SKYdefault' there is an example navigation list that you can use that will already be styled for you.

That's it. Nothing else has to be modified to get the theme working for your site. The rest is handled through Textpattern's existing preferences.


(6) Turn it On! go to the 'sections' tab under 'presentation' in the admin panel and for each section of the site (including 'default') change the setting for 'Uses page' to 'SKYdefault' and hit the 'save' button. Now when you view your site you should see the new SKY theme display.

(7) One small final item, you may need to tweak your Textpattern preferences to get things working just right. See next section for SITE PREFERENCES that are important for getting the SKY theme working properly.




IV. SITE PREFERENCES

Please review the following settings that are important for the SKY theme to work properly. These settings for your installation can be seen under the admin > preferences tab:

* Present comments as a numbered list? NO (preferred)
* Comments mode? 'nopopup' (preferred)
* Automatically append comments to articles? NO (MUST - otherwise you'll see comments get duplicated)
* Automatically append comments to articles? NO (MUST - otherwise you'll need to edit the text in form "SKYcomment_form" to make sense)




V. CREDITS + INFO

The SKY Theme v1.0 for Textpattern
Tested with Textpattern v4.0.3
Released 2/23/2006
Designed & Developed by Chris Casciano
Photo by Chris Casciano
chris@placenamehere.com

Code, Design + Photo released under GPL License

Theme Info: http://placenamehere.com/TXP/sky_theme/
Demo Site: http://sky.placenamehere.com/

Included in distribution is the IE7 JavaScript Library by Dean Edwards

Script Info: http://dean.edwards.name/IE7/usage/

See included README.txt file for more details (themes/sky/ie7/README.txt)

This blog posts in the SKY Theme are marked up according to the hatom microformat which is currently in draft status. Follow its progress at http://microformats.org/wiki/hatom