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,83 @@ +// $Id$ + +CONTENTS OF THIS FILE +--------------------- + + * About Drupal + * Configuration and features + * Appearance + * Custom themes and modules + +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 (extensions 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 + functionality: + http://drupal.org/project/modules + * See also: "Custom themes and modules", below. + +APPEARANCE +---------- + +Drupal contains a theming system to separate the appearance of your website from +its functionality and content. You can activate one or more themes (extensions +that control the appearance of the site) on your website, and you can customize +theme settings (colors, logos, using a different theme for administrative tasks, +etc.). + +More about themes: + * Download contributed themes to sites/all/themes to modify Drupal's + appearance: + http://drupal.org/project/themes + * See also: "Custom themes and modules", below. + +CUSTOM THEMES AND MODULES +------------------------- + +Drupal contains an extensive API that allows you to extend and modify Drupal's +functionality, as well as its appearance. This is done by implementing "hooks" +in modules; implementing "theme hooks" in modules and themes; and overriding +"theme functions", "theme templates", and CSS rules in themes. Before you create +your own module or theme, try searching at http://drupal.org -- you may find +that an existing core or contributed module or theme can be used to meet your +requirements. Or if it comes close, maybe you can add a feature to an existing +module and contribute it back to the project. This saves time and improves the +quality of existing code for everyone. + +More about Drupal coding: + * Developing modules: + http://drupal.org/contributors-guide + * Developing themes: + http://drupal.org/documentation/theme + * API documentation: + 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