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.