diff --git README.txt README.txt new file mode 100644 index 0000000..69dbcf6 --- /dev/null +++ README.txt @@ -0,0 +1,83 @@ +// $Id$ + +CONTENTS OF THIS FILE +--------------------- + + * About Drupal + * Configuration and features + * Appearance + * Developing for Drupal + +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.y.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. Core comes with many options which allow site-specific +configuration. In addition to the core modules, there are thousands of +contributed modules (for functionality not included with Drupal core) +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: "Developing for Drupal" for writing your own modules, below. + +APPEARANCE +---------- + +Drupal allows you to separate the appearance of the website from its +functionality and content. The appearance can be customized by using themes +(extensions that control the fonts, colors, and layout of the site). Drupal +lets you change aspects such as colors, logos, and you can choose different +themes for administrative tasks and for regular use. + +More about themes: + * Download contributed themes to sites/all/themes to modify Drupal's + appearance: + http://drupal.org/project/themes + * Developing themes: + http://drupal.org/documentation/theme + +DEVELOPING FOR DRUPAL +--------------------- + +Drupal contains an extensive API that allows you to extend and modify the +functionality of your site. By implementing 'hooks', modules can react to +system events and further customize Drupal's behavior. Drupal's flexible +architecture+means that you should never need to 'hack core' (directly modify +files that come with Drupal or one of its contributed projects) to achieve the +custom functionality you want. Instead contribute to an existing module or +write your own. + +More about Drupal coding: + * Developing modules: + http://drupal.org/contributors-guide + * API documentation: + http://api.drupal.org/api/drupal/7 + * Recommended best practices for coding and maintenance: + http://drupal.org/best-practices/ +