#634552 by JohnAlbin and tim.plunkett: Conflict with context module
[project/zen.git] / README-FIRST.txt
1 WHERE TO START
2 --------------
3
4 Yay! You opened the correct file first. The first thing that people notice when
5 they download the Zen theme is that there are A LOT of files -- way more than
6 other themes.
7
8 Don't worry! You don't need to learn everything all at once in order to make a
9 drupal theme. Zen will do the bits you haven't learned and patiently wait for
10 you to discover the documentation and inline comments about them.
11
12
13 SUGGESTED READING
14 -----------------
15
16 Installation
17   If you don't know how to install a Drupal theme, there is a quick primer later
18   in this document.
19
20 Building a sub-theme
21   See the STARTERKIT/README.txt file for full instructions.
22
23 Theme .info file
24   Your sub-theme's .info file holds the basic information about your theme that
25   Drupal needs to know: its name, description, features, template regions, CSS
26   files, and JavaScript. Don't worry about all these lines just yet.
27
28 CSS
29   Once you have created your sub-theme, look at the README.txt in your
30   sub-theme's css folder.
31
32 Templates
33   Now take a look at the README.txt in your sub-theme's templates folder.
34
35
36 ONLINE READING
37 --------------
38
39 Full documentation on the Zen theme can be found in Drupal's Handbook:
40   http://drupal.org/node/193318
41
42 Excellent documentation on Drupal theming can be found in the Theme Guide:
43   http://drupal.org/theme-guide
44
45
46 INSTALLATION
47 ------------
48
49  1. Download Zen from http://drupal.org/project/zen
50
51  2. Unpack the downloaded file, take the entire zen folder and place it in your
52     Drupal installation under one of the following locations:
53       sites/all/themes
54         making it available to the default Drupal site and to all Drupal sites
55         in a multi-site configuration
56       sites/default/themes
57         making it available to only the default Drupal site
58       sites/example.com/themes
59         making it available to only the example.com site if there is a
60         sites/example.com/settings.php configuration file
61
62     Please note: you will need to create the "theme" folder under "sites/all/"
63     or "sites/default/".
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.