projects / project/zen.git / blame
| Commit | Line | Data |
|---|---|---|
| 007fb748 J |
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 | ||
| 585f76c0 J |
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. | |
| 007fb748 J |
13 | |
| 14 | ||
| 585f76c0 J |
15 | SUGGESTED READING |
| 16 | ----------------- | |
| 007fb748 | 17 | |
| 585f76c0 J |
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 | -------------- | |
| 007fb748 J |
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 | ||
| 585f76c0 | 73 | 4. Now build your own sub-theme by reading the STARTERKIT/README.txt file. |