#547696: Update node.tpl to use ideas from D7
[project/zen.git] / README-FIRST.txt
1 // $Id$
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.