To check out this repository please hg clone the following URL, or open the URL using EasyMercurial or your preferred Mercurial client.
root / README.txt
History | View | Annotate | Download (5.75 KB)
| 1 | 0:4c8ae668cc8c | Chris | |
|---|---|---|---|
| 2 | CONTENTS OF THIS FILE |
||
| 3 | --------------------- |
||
| 4 | |||
| 5 | * About Drupal |
||
| 6 | * Configuration and features |
||
| 7 | * Installation profiles |
||
| 8 | * Appearance |
||
| 9 | * Developing for Drupal |
||
| 10 | * More information |
||
| 11 | |||
| 12 | ABOUT DRUPAL |
||
| 13 | ------------ |
||
| 14 | |||
| 15 | Drupal is an open source content management platform supporting a variety of |
||
| 16 | websites ranging from personal weblogs to large community-driven websites. For |
||
| 17 | more information, see the Drupal website at https://www.drupal.org, and join |
||
| 18 | the Drupal community at https://www.drupal.org/community. |
||
| 19 | |||
| 20 | Legal information about Drupal: |
||
| 21 | * Know your rights when using Drupal: |
||
| 22 | See LICENSE.txt in the "core" directory. |
||
| 23 | * Learn about the Drupal trademark and logo policy: |
||
| 24 | https://www.drupal.com/trademark |
||
| 25 | |||
| 26 | CONFIGURATION AND FEATURES |
||
| 27 | -------------------------- |
||
| 28 | |||
| 29 | Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or |
||
| 30 | drupal-x.y.zip file from https://www.drupal.org/project/drupal) has what you |
||
| 31 | need to get started with your website. It includes several modules (extensions |
||
| 32 | that add functionality) for common website features, such as managing content, |
||
| 33 | user accounts, image uploading, and search. Core comes with many options that |
||
| 34 | allow site-specific configuration. In addition to the core modules, there are |
||
| 35 | thousands of contributed modules (for functionality not included with Drupal |
||
| 36 | core) available for download. |
||
| 37 | |||
| 38 | More about configuration: |
||
| 39 | * Install, update, and maintain Drupal: |
||
| 40 | See INSTALL.txt and UPDATE.txt in the "core" directory. |
||
| 41 | * Learn about how to use Drupal to create your site: |
||
| 42 | https://www.drupal.org/documentation |
||
| 43 | * Follow best practices: |
||
| 44 | https://www.drupal.org/best-practices |
||
| 45 | * Download contributed modules to /modules to extend Drupal's functionality: |
||
| 46 | https://www.drupal.org/project/modules |
||
| 47 | * See also: "Developing for Drupal" for writing your own modules, below. |
||
| 48 | |||
| 49 | |||
| 50 | INSTALLATION PROFILES |
||
| 51 | --------------------- |
||
| 52 | |||
| 53 | Installation profiles define additional steps (such as enabling modules, |
||
| 54 | defining content types, etc.) that run after the base installation provided |
||
| 55 | by core when Drupal is first installed. There are two basic installation |
||
| 56 | profiles provided with Drupal core. |
||
| 57 | |||
| 58 | Installation profiles from the Drupal community modify the installation process |
||
| 59 | to provide a website for a specific use case, such as a CMS for media |
||
| 60 | publishers, a web-based project tracking tool, or a full-fledged CRM for |
||
| 61 | non-profit organizations raising money and accepting donations. They can be |
||
| 62 | distributed as bare installation profiles or as "distributions". Distributions |
||
| 63 | include Drupal core, the installation profile, and all other required |
||
| 64 | extensions, such as contributed and custom modules, themes, and third-party |
||
| 65 | libraries. Bare installation profiles require you to download Drupal Core and |
||
| 66 | the required extensions separately; place the downloaded profile in the |
||
| 67 | /profiles directory before you start the installation process. |
||
| 68 | |||
| 69 | More about installation profiles and distributions: |
||
| 70 | * Read about the difference between installation profiles and distributions: |
||
| 71 | https://www.drupal.org/node/1089736 |
||
| 72 | * Download contributed installation profiles and distributions: |
||
| 73 | https://www.drupal.org/project/distributions |
||
| 74 | * Develop your own installation profile or distribution: |
||
| 75 | https://www.drupal.org/developing/distributions |
||
| 76 | |||
| 77 | |||
| 78 | APPEARANCE |
||
| 79 | ---------- |
||
| 80 | |||
| 81 | In Drupal, the appearance of your site is set by the theme (themes are |
||
| 82 | extensions that set fonts, colors, and layout). Drupal core comes with several |
||
| 83 | themes. More themes are available for download, and you can also create your own |
||
| 84 | custom theme. |
||
| 85 | |||
| 86 | More about themes: |
||
| 87 | * Download contributed themes to /themes to modify Drupal's appearance: |
||
| 88 | https://www.drupal.org/project/themes |
||
| 89 | * Develop your own theme: |
||
| 90 | https://www.drupal.org/documentation/theme |
||
| 91 | |||
| 92 | DEVELOPING FOR DRUPAL |
||
| 93 | --------------------- |
||
| 94 | |||
| 95 | Drupal contains an extensive API that allows you to add to and modify the |
||
| 96 | functionality of your site. The API consists of "hooks", which allow modules to |
||
| 97 | react to system events and customize Drupal's behavior, and functions that |
||
| 98 | standardize common operations such as database queries and form generation. The |
||
| 99 | flexible hook architecture means that you should never need to directly modify |
||
| 100 | the files that come with Drupal core to achieve the functionality you want; |
||
| 101 | instead, functionality modifications take the form of modules. |
||
| 102 | |||
| 103 | When you need new functionality for your Drupal site, search for existing |
||
| 104 | contributed modules. If you find a module that matches except for a bug or an |
||
| 105 | additional needed feature, change the module and contribute your improvements |
||
| 106 | back to the project in the form of a "patch". Create new custom modules only |
||
| 107 | when nothing existing comes close to what you need. |
||
| 108 | |||
| 109 | More about developing: |
||
| 110 | * Search for existing contributed modules: |
||
| 111 | https://www.drupal.org/project/modules |
||
| 112 | * Contribute a patch: |
||
| 113 | https://www.drupal.org/patch/submit |
||
| 114 | * Develop your own module: |
||
| 115 | https://www.drupal.org/developing/modules |
||
| 116 | * Follow programming best practices: |
||
| 117 | https://www.drupal.org/developing/best-practices |
||
| 118 | * Refer to the API documentation: |
||
| 119 | https://api.drupal.org/api/drupal/8 |
||
| 120 | * Learn from documented Drupal API examples: |
||
| 121 | https://www.drupal.org/project/examples |
||
| 122 | |||
| 123 | MORE INFORMATION |
||
| 124 | ---------------- |
||
| 125 | |||
| 126 | * See the Drupal.org online documentation: |
||
| 127 | https://www.drupal.org/documentation |
||
| 128 | |||
| 129 | * For a list of security announcements, see the "Security advisories" page at |
||
| 130 | https://www.drupal.org/security (available as an RSS feed). This page also |
||
| 131 | describes how to subscribe to these announcements via email. |
||
| 132 | |||
| 133 | * For information about the Drupal security process, or to find out how to |
||
| 134 | report a potential security issue to the Drupal security team, see the |
||
| 135 | "Security team" page at https://www.drupal.org/security-team |
||
| 136 | |||
| 137 | * For information about the wide range of available support options, visit |
||
| 138 | https://www.drupal.org and click on Community and Support in the top or |
||
| 139 | bottom navigation. |