To check out this repository please hg clone the following URL, or open the URL using EasyMercurial or your preferred Mercurial client.

Statistics Download as Zip
| Branch: | Revision:

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.