summaryrefslogtreecommitdiffstats
path: root/STARTERKIT
diff options
context:
space:
mode:
authorJohnAlbin2011-02-20 17:22:25 +0000
committerJohnAlbin2011-02-20 17:22:25 +0000
commit12a168d6da7b8c9ff3898e85fce2a51477e96322 (patch)
tree229b6c0d8b99304e8f1d4a51d1dd302c4510f7a9 /STARTERKIT
parente3e6538a58dea1e14a2a0a71222ae4546b4da830 (diff)
#950206 by n8tron, Mtro and JohnAlbin: Update README in STARTERKIT
Diffstat (limited to 'STARTERKIT')
-rw-r--r--STARTERKIT/README.txt74
1 files changed, 44 insertions, 30 deletions
diff --git a/STARTERKIT/README.txt b/STARTERKIT/README.txt
index fe9d700..24e9200 100644
--- a/STARTERKIT/README.txt
+++ b/STARTERKIT/README.txt
@@ -3,15 +3,15 @@ BUILD YOUR OWN SUB-THEME
*** IMPORTANT ***
-* In Drupal 6, the theme system caches template files and which theme functions
- should be called. What that means is if you add a new theme or preprocess
- function to your template.php file or add a new template (.tpl.php) file to
- your sub-theme, you will need to rebuild the "theme registry." See
- http://drupal.org/node/173880#theme-registry
+* In Drupal 7, the theme system caches which template files and which theme
+ functions should be called. This means that if you add a new theme,
+ preprocess or process function to your template.php file or add a new template
+ (.tpl.php) file to your sub-theme, you will need to rebuild the "theme
+ registry." See http://drupal.org/node/173880#theme-registry
-* Drupal 6 also stores a cache of the data in .info files. If you modify any
- lines in your sub-theme's .info file, you MUST refresh Drupal 6's cache by
- simply visiting the admin/build/themes page.
+* Drupal 7 also stores a cache of the data in .info files. If you modify any
+ lines in your sub-theme's .info file, you MUST refresh Drupal 7's cache by
+ simply visiting the Appearance page at admin/appearance.
The base Zen theme is designed to be easily extended by its sub-themes. You
@@ -24,7 +24,9 @@ installed in sites/all/themes/, but any valid theme directory is acceptable
Why? To learn why you shouldn't modify any of the files in the zen/ folder,
see http://drupal.org/node/245802
- 1. Copy the STARTERKIT folder out of the zen/ folder and rename it to be your
+ 1. Setup the location for your new sub-theme.
+
+ Copy the STARTERKIT folder out of the zen/ folder and rename it to be your
new sub-theme. IMPORTANT: Only lowercase letters and underscores should be
used for the name of your sub-theme.
@@ -32,10 +34,12 @@ installed in sites/all/themes/, but any valid theme directory is acceptable
as sites/all/themes/foo.
Why? Each theme should reside in its own folder. To make it easier to
- upgrade Zen, sub-themes should reside in a folder separate from their base
+ upgrade Zen, sub-themes should reside in a folder separate from the base
theme.
- 2. In your new sub-theme folder, rename the STARTERKIT.info.txt file to include
+ 2. Setup the basic information for your sub-theme.
+
+ In your new sub-theme folder, rename the STARTERKIT.info.txt file to include
the name of your new sub-theme and remove the ".txt" extension. Then edit
the .info file by editing the name and description field.
@@ -45,13 +49,15 @@ installed in sites/all/themes/, but any valid theme directory is acceptable
Why? The .info file describes the basic things about your theme: its
name, description, features, template regions, CSS files, and JavaScript
- files. See the Drupal 6 Theme Guide for more info:
+ files. See the Drupal 7 Theme Guide for more info:
http://drupal.org/node/171205
- Then, visit your site's admin/build/themes to refresh Drupal 6's cache of
- .info file data.
+ Then, visit your site's Appearance page at admin/appearance to refresh
+ Drupal 7's cache of .info file data.
- 3. By default your new sub-theme is using a fixed-width layout. If you want a
+ 3. Choose your preferred page layout method or grid system.
+
+ By default your new sub-theme is using a fixed-width layout. If you want a
liquid layout for your theme, delete the unneeded layout-fixed.css and
layout-fixed-rtl.css files and edit your sub-theme's .info file and replace
the reference to layout-fixed.css with layout-liquid.css.
@@ -65,14 +71,16 @@ installed in sites/all/themes/, but any valid theme directory is acceptable
and path to the CSS file you want to include. The format for these lines
is: stylesheets[MEDIA][] = path/to/file.css
- Then, visit your site's admin/build/themes to refresh Drupal 6's cache of
- .info file data.
+ Then, visit your site's Appearance page at admin/appearance to refresh
+ Drupal 7's cache of .info file data.
Alternatively, if you are more familiar with a different CSS layout method,
such as Blueprint or 960.gs, you can replace the "css/layout-fixed.css" line
in your .info file with a line pointing at your choice of layout CSS file.
- 4. Edit the template.php and theme-settings.php files in your sub-theme's
+ 4. Edit your sub-theme to use the proper function names.
+
+ Edit the template.php and theme-settings.php files in your sub-theme's
folder; replace ALL occurrences of "STARTERKIT" with the name of your
sub-theme.
@@ -82,35 +90,41 @@ installed in sites/all/themes/, but any valid theme directory is acceptable
It is recommended to use a text editing application with search and
"replace all" functionality.
- 5. Log in as an administrator on your Drupal site and go to Administer > Site
- building > Themes (admin/build/themes) and enable your new sub-theme.
+ 5. Set your website's default theme.
+
+ Log in as an administrator on your Drupal site, go to the Appearance page at
+ admin/appearance and click the "Enable and set default" link next to your
+ new sub-theme.
Optional:
- 6. MODIFYING ZEN CORE TEMPLATE FILES:
+ 6. Modify the markup in Zen core's template files.
+
If you decide you want to modify any of the .tpl.php template files in the
zen folder, copy them to your sub-theme's folder before making any changes.
And then rebuild the theme registry.
For example, copy zen/templates/page.tpl.php to foo/templates/page.tpl.php.
- 7. THEMEING DRUPAL'S SEARCH FORM:
- Copy the search-theme-form.tpl.php template file from the modules/search/
- folder and place it in your sub-theme's folder. And then rebuild the theme
- registry.
+ 7. Modify the markup in Drupal's search form.
+
+ Copy the search-block-form.tpl.php template file from the modules/search/
+ folder and place it in your sub-theme's template folder. And then rebuild
+ the theme registry.
You can find a full list of Drupal templates that you can override in the
templates/README.txt file or http://drupal.org/node/190815
- Why? In Drupal 6 theming, if you want to modify a template included by a
+ Why? In Drupal 7 theming, if you want to modify a template included by a
module, you should copy the template file from the module's directory to
- your sub-theme's directory and then rebuild the theme registry. See the
- Drupal 6 Theme Guide for more info: http://drupal.org/node/173880
+ your sub-theme's template directory and then rebuild the theme registry.
+ See the Drupal 7 Theme Guide for more info: http://drupal.org/node/173880
+
+ 8. Further extend your sub-theme.
- 8. FURTHER EXTENSIONS OF YOUR SUB-THEME:
Discover further ways to extend your sub-theme by reading Zen's
documentation online at:
http://drupal.org/node/193318
- and Drupal 6's Theme Guide online at:
+ and Drupal 7's Theme Guide online at:
http://drupal.org/theme-guide