Fixed wireframes on #navigation .section.
[project/zen.git] / README-FIRST.txt
CommitLineData
007fb748
J
1// $Id$
2
3WHERE TO START
4--------------
5
6Yay! You opened the correct file first. The first thing that people notice when
7they download the Zen theme is that there are A LOT of files -- way more than
8other themes.
9
585f76c0
J
10Don't worry! You don't need to learn everything all at once in order to make a
11drupal theme. Zen will do the bits you haven't learned and patiently wait for
12you to discover the documentation and inline comments about them.
007fb748
J
13
14
585f76c0
J
15SUGGESTED READING
16-----------------
007fb748 17
585f76c0
J
18Installation
19 If you don't know how to install a Drupal theme, there is a quick primer later
20 in this document.
21
22Building a sub-theme
23 See the STARTERKIT/README.txt file for full instructions.
24
25Theme .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
30CSS
31 Once you have created your sub-theme, look at the README.txt in your
32 sub-theme's css folder.
33
34Templates
35 Now take a look at the README.txt in your sub-theme's templates folder.
36
37
38ONLINE READING
39--------------
007fb748
J
40
41Full documentation on the Zen theme can be found in Drupal's Handbook:
42 http://drupal.org/node/193318
43
44Excellent documentation on Drupal theming can be found in the Theme Guide:
45 http://drupal.org/theme-guide
46
47
48INSTALLATION
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
585f76c0 73 4. Now build your own sub-theme by reading the STARTERKIT/README.txt file.