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.