NameDateSize

..16-Mar-201612 KiB

.editorconfig31-Oct-2013317

.eslintignore14-Jul-2014147

.eslintrc14-Jul-2014697

.gitattributes08-Jul-20143.3 KiB

.htaccess14-Jul-20146.7 KiB

composer.json28-Jul-20141.6 KiB

composer.lock28-Jul-201483.4 KiB

core/29-Jul-20144 KiB

example.gitignore03-Jun-20141.1 KiB

index.php27-Jun-20141.3 KiB

modules/29-Dec-20124 KiB

profiles/29-Dec-20124 KiB

README.txt30-Jul-20145.2 KiB

robots.txt26-Jun-20141.3 KiB

sites/06-May-20144 KiB

themes/29-Dec-20124 KiB

web.config27-Jun-20143.9 KiB

README.txt

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