themes/zen/README-FIRST.txt

// $Id: README-FIRST.txt,v 1.1 2009/08/12 06:49:46 johnalbin Exp $

WHERE TO START
--------------

Yay! You opened the correct file first. The first thing that people notice when
they download the Zen theme is that there are A LOT of files -- way more than
other themes.

Don't worry! You don't need to learn everything all at once in order to make a
drupal theme. Zen will do the bits you haven't learned and patiently wait for
you to discover the documentation and inline comments about them.


SUGGESTED READING
-----------------

Installation
  If you don't know how to install a Drupal theme, there is a quick primer later
  in this document.

Building a sub-theme
  See the STARTERKIT/README.txt file for full instructions.

Theme .info file
  Your sub-theme's .info file describes the basic things about your theme: its
  name, description, features, template regions, CSS files, and JavaScript.
  Don't worry about all these lines just yet.

CSS
  Once you have created your sub-theme, look at the README.txt in your
  sub-theme's css folder.

Templates
  Now take a look at the README.txt in your sub-theme's templates folder.


ONLINE READING
--------------

Full documentation on the Zen theme can be found in Drupal's Handbook:
  http://drupal.org/node/193318

Excellent documentation on Drupal theming can be found in the Theme Guide:
  http://drupal.org/theme-guide


INSTALLATION
------------

 1. Download Zen from http://drupal.org/project/zen

 2. Unpack the downloaded file, take the entire zen folder (which includes the
    README.txt file, a STARTERKIT folder, etc.) and place it in your Drupal
    installation under one of the following locations:
      sites/all/themes
        making it available to the default Drupal site and to all Drupal sites
        in a multi-site configuration
      sites/default/themes
        making it available to only the default Drupal site
      sites/example.com/themes
        making it available to only the example.com site if there is a
        sites/example.com/settings.php configuration file

    For more information about acceptable theme installation directories, read
    the sites/default/default.settings.php file in your Drupal installation.

 3. Log in as an administrator on your Drupal site and go to Administer > Site
    building > Themes (admin/build/themes). You will see the Zen theme there
    with links on how to create your own sub-theme. You can optionally make Zen
    the default theme.

 4. Now build your own sub-theme by reading the STARTERKIT/README.txt file.
1	// $Id: README-FIRST.txt,v 1.1 2009/08/12 06:49:46 johnalbin Exp $
2
3	WHERE TO START
4	--------------
5
6	Yay! You opened the correct file first. The first thing that people notice when
7	they download the Zen theme is that there are A LOT of files -- way more than
8	other themes.
9
10	Don't worry! You don't need to learn everything all at once in order to make a
11	drupal theme. Zen will do the bits you haven't learned and patiently wait for
12	you to discover the documentation and inline comments about them.
13
14
15	SUGGESTED READING
16	-----------------
17
18	Installation
19	If you don't know how to install a Drupal theme, there is a quick primer later
20	in this document.
21
22	Building a sub-theme
23	See the STARTERKIT/README.txt file for full instructions.
24
25	Theme .info file
26	Your sub-theme's .info file describes the basic things about your theme: its
27	name, description, features, template regions, CSS files, and JavaScript.
28	Don't worry about all these lines just yet.
29
30	CSS
31	Once you have created your sub-theme, look at the README.txt in your
32	sub-theme's css folder.
33
34	Templates
35	Now take a look at the README.txt in your sub-theme's templates folder.
36
37
38	ONLINE READING
39	--------------
40
41	Full documentation on the Zen theme can be found in Drupal's Handbook:
42	http://drupal.org/node/193318
43
44	Excellent documentation on Drupal theming can be found in the Theme Guide:
45	http://drupal.org/theme-guide
46
47
48	INSTALLATION
49	------------
50
51	1. Download Zen from http://drupal.org/project/zen
52
53	2. Unpack the downloaded file, take the entire zen folder (which includes the
54	README.txt file, a STARTERKIT folder, etc.) and place it in your Drupal
55	installation under one of the following locations:
56	sites/all/themes
57	making it available to the default Drupal site and to all Drupal sites
58	in a multi-site configuration
59	sites/default/themes
60	making it available to only the default Drupal site
61	sites/example.com/themes
62	making it available to only the example.com site if there is a
63	sites/example.com/settings.php configuration file
64
65	For more information about acceptable theme installation directories, read
66	the sites/default/default.settings.php file in your Drupal installation.
67
68	3. Log in as an administrator on your Drupal site and go to Administer > Site
69	building > Themes (admin/build/themes). You will see the Zen theme there
70	with links on how to create your own sub-theme. You can optionally make Zen
71	the default theme.
72
73	4. Now build your own sub-theme by reading the STARTERKIT/README.txt file.