Chris@0: Chris@0: CONTENTS OF THIS FILE Chris@0: --------------------- Chris@0: Chris@0: * About Drupal Chris@0: * Configuration and features Chris@0: * Installation profiles Chris@0: * Appearance Chris@0: * Developing for Drupal Chris@0: * More information Chris@0: Chris@0: ABOUT DRUPAL Chris@0: ------------ Chris@0: Chris@0: Drupal is an open source content management platform supporting a variety of Chris@0: websites ranging from personal weblogs to large community-driven websites. For Chris@0: more information, see the Drupal website at https://www.drupal.org, and join Chris@0: the Drupal community at https://www.drupal.org/community. Chris@0: Chris@0: Legal information about Drupal: Chris@0: * Know your rights when using Drupal: Chris@0: See LICENSE.txt in the "core" directory. Chris@0: * Learn about the Drupal trademark and logo policy: Chris@0: https://www.drupal.com/trademark Chris@0: Chris@0: CONFIGURATION AND FEATURES Chris@0: -------------------------- Chris@0: Chris@0: Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or Chris@0: drupal-x.y.zip file from https://www.drupal.org/project/drupal) has what you Chris@0: need to get started with your website. It includes several modules (extensions Chris@0: that add functionality) for common website features, such as managing content, Chris@0: user accounts, image uploading, and search. Core comes with many options that Chris@0: allow site-specific configuration. In addition to the core modules, there are Chris@0: thousands of contributed modules (for functionality not included with Drupal Chris@0: core) available for download. Chris@0: Chris@0: More about configuration: Chris@0: * Install, update, and maintain Drupal: Chris@0: See INSTALL.txt and UPDATE.txt in the "core" directory. Chris@0: * Learn about how to use Drupal to create your site: Chris@0: https://www.drupal.org/documentation Chris@0: * Follow best practices: Chris@0: https://www.drupal.org/best-practices Chris@0: * Download contributed modules to /modules to extend Drupal's functionality: Chris@0: https://www.drupal.org/project/modules Chris@0: * See also: "Developing for Drupal" for writing your own modules, below. Chris@0: Chris@0: Chris@0: INSTALLATION PROFILES Chris@0: --------------------- Chris@0: Chris@0: Installation profiles define additional steps (such as enabling modules, Chris@0: defining content types, etc.) that run after the base installation provided Chris@0: by core when Drupal is first installed. There are two basic installation Chris@0: profiles provided with Drupal core. Chris@0: Chris@0: Installation profiles from the Drupal community modify the installation process Chris@0: to provide a website for a specific use case, such as a CMS for media Chris@0: publishers, a web-based project tracking tool, or a full-fledged CRM for Chris@0: non-profit organizations raising money and accepting donations. They can be Chris@0: distributed as bare installation profiles or as "distributions". Distributions Chris@0: include Drupal core, the installation profile, and all other required Chris@0: extensions, such as contributed and custom modules, themes, and third-party Chris@0: libraries. Bare installation profiles require you to download Drupal Core and Chris@0: the required extensions separately; place the downloaded profile in the Chris@0: /profiles directory before you start the installation process. Chris@0: Chris@0: More about installation profiles and distributions: Chris@0: * Read about the difference between installation profiles and distributions: Chris@0: https://www.drupal.org/node/1089736 Chris@0: * Download contributed installation profiles and distributions: Chris@0: https://www.drupal.org/project/distributions Chris@0: * Develop your own installation profile or distribution: Chris@0: https://www.drupal.org/developing/distributions Chris@0: Chris@0: Chris@0: APPEARANCE Chris@0: ---------- Chris@0: Chris@0: In Drupal, the appearance of your site is set by the theme (themes are Chris@0: extensions that set fonts, colors, and layout). Drupal core comes with several Chris@0: themes. More themes are available for download, and you can also create your own Chris@0: custom theme. Chris@0: Chris@0: More about themes: Chris@0: * Download contributed themes to /themes to modify Drupal's appearance: Chris@0: https://www.drupal.org/project/themes Chris@0: * Develop your own theme: Chris@0: https://www.drupal.org/documentation/theme Chris@0: Chris@0: DEVELOPING FOR DRUPAL Chris@0: --------------------- Chris@0: Chris@0: Drupal contains an extensive API that allows you to add to and modify the Chris@0: functionality of your site. The API consists of "hooks", which allow modules to Chris@0: react to system events and customize Drupal's behavior, and functions that Chris@0: standardize common operations such as database queries and form generation. The Chris@0: flexible hook architecture means that you should never need to directly modify Chris@0: the files that come with Drupal core to achieve the functionality you want; Chris@0: instead, functionality modifications take the form of modules. Chris@0: Chris@0: When you need new functionality for your Drupal site, search for existing Chris@0: contributed modules. If you find a module that matches except for a bug or an Chris@0: additional needed feature, change the module and contribute your improvements Chris@0: back to the project in the form of a "patch". Create new custom modules only Chris@0: when nothing existing comes close to what you need. Chris@0: Chris@0: More about developing: Chris@0: * Search for existing contributed modules: Chris@0: https://www.drupal.org/project/modules Chris@0: * Contribute a patch: Chris@0: https://www.drupal.org/patch/submit Chris@0: * Develop your own module: Chris@0: https://www.drupal.org/developing/modules Chris@0: * Follow programming best practices: Chris@0: https://www.drupal.org/developing/best-practices Chris@0: * Refer to the API documentation: Chris@0: https://api.drupal.org/api/drupal/8 Chris@0: * Learn from documented Drupal API examples: Chris@0: https://www.drupal.org/project/examples Chris@0: Chris@0: MORE INFORMATION Chris@0: ---------------- Chris@0: Chris@0: * See the Drupal.org online documentation: Chris@0: https://www.drupal.org/documentation Chris@0: Chris@0: * For a list of security announcements, see the "Security advisories" page at Chris@0: https://www.drupal.org/security (available as an RSS feed). This page also Chris@0: describes how to subscribe to these announcements via email. Chris@0: Chris@0: * For information about the Drupal security process, or to find out how to Chris@0: report a potential security issue to the Drupal security team, see the Chris@0: "Security team" page at https://www.drupal.org/security-team Chris@0: Chris@0: * For information about the wide range of available support options, visit Chris@0: https://www.drupal.org and click on Community and Support in the top or Chris@0: bottom navigation.