Index: README.txt =================================================================== RCS file: README.txt diff -N README.txt --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ README.txt 1 Jan 1970 00:00:00 -0000 @@ -0,0 +1,77 @@ +// $Id$ + +CONTENTS OF THIS FILE +--------------------- + + * About Drupal + * Configuration and features + * Look and feel + * Custom code + +ABOUT DRUPAL +------------ + +Drupal is an open source content management platform supporting a variety of +websites ranging from personal weblogs to large community-driven websites. For +more information, see the Drupal website at http://drupal.org/, and join the +Drupal community at http://drupal.org/community. + +Legal information about Drupal: + * Know your rights when using Drupal: + See LICENSE.txt in the same directory as this document. + * Learn about the Drupal trademark and logo policy: + http://drupal.com/trademark + +CONFIGURATION AND FEATURES +-------------------------- + +Drupal core (what you get when you download and unzip a drupal-x.yy.tar.gz file +from http://drupal.org/project/drupal) has what you need to get started with +your website. It includes several modules (plugins that add functionality) for +common website features, such as managing content, user accounts, image +uploading, and search, and there are many configuration options. You can add +features to your website by enabling additional core modules, and remove +features by disabling modules. Also, thousands of contributed modules (for +functionality not included with Drupal core) are available for download. + +More about configuration: + * Install, upgrade, and maintain Drupal: + See INSTALL.txt and UPGRADE.txt in the same directory as this document. + * Learn about how to use Drupal to create your site: + http://drupal.org/documentation + * Download contributed modules to sites/all/modules to extend Drupal's + core functionality: + http://drupal.org/project/modules + +LOOK AND FEEL +------------- + +Drupal contains a theming system to separate the look and feel of your website +from its functionality and content. You can activate one or more themes (plugins +that control the look and feel of the site) on your website, and you can +customize theme settings (colors, logos, using a different theme for +administrative tasks, etc.). Drupal core comes with several themes, and you can +download additional contributed themes from http://drupal.org/project/themes +(put them in sites/all/themes). + +CUSTOM CODE +----------- + +Drupal contains an extensive API that allows you to extend and modify Drupal's +core functionality, as well as its look and feel. This is done by implementing +"hooks" in modules; implementing "theme hooks" in modules and themes; and +overriding "theme functions", "theme templates", and CSS directives in +themes. You can create your own completely custom modules and themes, but keep +in mind that there are thousands of contributed modules and themes available for +download. So before writing a new module or theme, be sure to search for an +existing module or theme that meets your requirements. + +More about Drupal coding: + * Developing modules: + http://drupal.org/contributors-guide + * Developing themes: + http://drupal.org/documentation/theme + * API reference: + http://api.drupal.org/api/drupal/7 + * Don't modify Drupal's core files ("hack core"): + http://drupal.org/best-practices/do-not-hack-core