README.txt

Same filename in this branch
  1. 8.x drupal/README.txt
  2. 8.x drupal/themes/README.txt
  3. 8.x drupal/profiles/README.txt
  4. 8.x drupal/modules/README.txt
  5. 8.x drupal/sites/README.txt
  6. 8.x drupal/core/lib/README.txt
  7. 8.x drupal/core/themes/stark/README.txt
  8. 8.x drupal/core/lib/Drupal/Core/README.txt
  9. 8.x drupal/core/lib/Drupal/Component/README.txt
  10. 8.x drupal/core/modules/simpletest/files/README.txt
  11. 8.x drupal/core/modules/system/tests/modules/plugin_test/lib/Drupal/plugin_test/Plugin/plugin_test/fruit/README.txt
CONTENTS OF THIS FILE
---------------------

 * About Drupal
 * Configuration and features
 * Installation profiles
 * 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 "core" directory.
 * Learn about the Drupal trademark and logo policy:
   http://drupal.com/trademark

CONFIGURATION AND FEATURES
--------------------------

Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or
drupal-x.y.zip 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 that 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 "core" directory.
 * Learn about how to use Drupal to create your site:
   http://drupal.org/documentation
 * Download contributed modules to /modules to extend Drupal's functionality:
   http://drupal.org/project/modules
 * See also: "Developing for Drupal" for writing your own modules, below.


INSTALLATION PROFILES
---------------------

Installation profiles define additional steps (such as enabling modules,
defining content types, etc.) that run after the base installation provided
by core when Drupal is first installed. There are two basic installation
profiles provided with Drupal core.

Installation profiles from the Drupal community modify the installation process
to provide a website for a specific use case, such as a CMS for media
publishers, a web-based project tracking tool, or a full-fledged CRM for
non-profit organizations raising money and accepting donations. They can be
distributed as bare installation profiles or as "distributions". Distributions
include Drupal core, the installation profile, and all other required
extensions, such as contributed and custom modules, themes, and third-party
libraries. Bare installation profiles require you to download Drupal Core and
the required extensions separately; place the downloaded profile in the
/profiles directory before you start the installation process.

More about installation profiles and distributions:
* Read about the difference between installation profiles and distributions:
  http://drupal.org/node/1089736
* Download contributed installation profiles and distributions:
  http://drupal.org/project/distributions
* Develop your own installation profile or distribution:
  http://drupal.org/developing/distributions


APPEARANCE
----------

In Drupal, the appearance of your site is set by the theme (themes are
extensions that set fonts, colors, and layout). Drupal core comes with several
themes. More themes are available for download, and you can also create your own
custom theme.

More about themes:
 * Download contributed themes to /themes to modify Drupal's appearance:
   http://drupal.org/project/themes
 * Develop your own theme:
   http://drupal.org/documentation/theme

DEVELOPING FOR DRUPAL
---------------------

Drupal contains an extensive API that allows you to add to and modify the
functionality of your site. The API consists of "hooks", which allow modules to
react to system events and customize Drupal's behavior, and functions that
standardize common operations such as database queries and form generation. The
flexible hook architecture means that you should never need to directly modify
the files that come with Drupal core to achieve the functionality you want;
instead, functionality modifications take the form of modules.

When you need new functionality for your Drupal site, search for existing
contributed modules. If you find a module that matches except for a bug or an
additional needed feature, change the module and contribute your improvements
back to the project in the form of a "patch". Create new custom modules only
when nothing existing comes close to what you need.

More about developing:
 * Search for existing contributed modules:
   http://drupal.org/project/modules
 * Contribute a patch:
   http://drupal.org/patch/submit
 * Develop your own module:
   http://drupal.org/developing/modules
 * Follow best practices:
   http://drupal.org/best-practices
 * Refer to the API documentation:
   http://api.drupal.org/api/drupal/8

File

drupal/README.txt
View source
  1. 

  2. CONTENTS OF THIS FILE

  3. ---------------------

  4. 

  5.  * About Drupal

  6.  * Configuration and features

  7.  * Installation profiles

  8.  * Appearance

  9.  * Developing for Drupal

  10. 

  11. ABOUT DRUPAL

  12. ------------

  13. 

  14. Drupal is an open source content management platform supporting a variety of

  15. websites ranging from personal weblogs to large community-driven websites. For

  16. more information, see the Drupal website at http://drupal.org/, and join the

  17. Drupal community at http://drupal.org/community.

  18. 

  19. Legal information about Drupal:

  20.  * Know your rights when using Drupal:

  21.    See LICENSE.txt in the "core" directory.

  22.  * Learn about the Drupal trademark and logo policy:

  23.    http://drupal.com/trademark

  24. 

  25. CONFIGURATION AND FEATURES

  26. --------------------------

  27. 

  28. Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or

  29. drupal-x.y.zip file from http://drupal.org/project/drupal) has what you need to

  30. get started with your website. It includes several modules (extensions that add

  31. functionality) for common website features, such as managing content, user

  32. accounts, image uploading, and search. Core comes with many options that allow

  33. site-specific configuration. In addition to the core modules, there are

  34. thousands of contributed modules (for functionality not included with Drupal

  35. core) available for download.

  36. 

  37. More about configuration:

  38.  * Install, upgrade, and maintain Drupal:

  39.    See INSTALL.txt and UPGRADE.txt in the "core" directory.

  40.  * Learn about how to use Drupal to create your site:

  41.    http://drupal.org/documentation

  42.  * Download contributed modules to /modules to extend Drupal's functionality:

  43.    http://drupal.org/project/modules

  44.  * See also: "Developing for Drupal" for writing your own modules, below.

  45. 

  46. 

  47. INSTALLATION PROFILES

  48. ---------------------

  49. 

  50. Installation profiles define additional steps (such as enabling modules,

  51. defining content types, etc.) that run after the base installation provided

  52. by core when Drupal is first installed. There are two basic installation

  53. profiles provided with Drupal core.

  54. 

  55. Installation profiles from the Drupal community modify the installation process

  56. to provide a website for a specific use case, such as a CMS for media

  57. publishers, a web-based project tracking tool, or a full-fledged CRM for

  58. non-profit organizations raising money and accepting donations. They can be

  59. distributed as bare installation profiles or as "distributions". Distributions

  60. include Drupal core, the installation profile, and all other required

  61. extensions, such as contributed and custom modules, themes, and third-party

  62. libraries. Bare installation profiles require you to download Drupal Core and

  63. the required extensions separately; place the downloaded profile in the

  64. /profiles directory before you start the installation process.

  65. 

  66. More about installation profiles and distributions:

  67. * Read about the difference between installation profiles and distributions:

  68.   http://drupal.org/node/1089736

  69. * Download contributed installation profiles and distributions:

  70.   http://drupal.org/project/distributions

  71. * Develop your own installation profile or distribution:

  72.   http://drupal.org/developing/distributions

  73. 

  74. 

  75. APPEARANCE

  76. ----------

  77. 

  78. In Drupal, the appearance of your site is set by the theme (themes are

  79. extensions that set fonts, colors, and layout). Drupal core comes with several

  80. themes. More themes are available for download, and you can also create your own

  81. custom theme.

  82. 

  83. More about themes:

  84.  * Download contributed themes to /themes to modify Drupal's appearance:

  85.    http://drupal.org/project/themes

  86.  * Develop your own theme:

  87.    http://drupal.org/documentation/theme

  88. 

  89. DEVELOPING FOR DRUPAL

  90. ---------------------

  91. 

  92. Drupal contains an extensive API that allows you to add to and modify the

  93. functionality of your site. The API consists of "hooks", which allow modules to

  94. react to system events and customize Drupal's behavior, and functions that

  95. standardize common operations such as database queries and form generation. The

  96. flexible hook architecture means that you should never need to directly modify

  97. the files that come with Drupal core to achieve the functionality you want;

  98. instead, functionality modifications take the form of modules.

  99. 

  100. When you need new functionality for your Drupal site, search for existing

  101. contributed modules. If you find a module that matches except for a bug or an

  102. additional needed feature, change the module and contribute your improvements

  103. back to the project in the form of a "patch". Create new custom modules only

  104. when nothing existing comes close to what you need.

  105. 

  106. More about developing:

  107.  * Search for existing contributed modules:

  108.    http://drupal.org/project/modules

  109.  * Contribute a patch:

  110.    http://drupal.org/patch/submit

  111.  * Develop your own module:

  112.    http://drupal.org/developing/modules

  113.  * Follow best practices:

  114.    http://drupal.org/best-practices

  115.  * Refer to the API documentation:

  116.    http://api.drupal.org/api/drupal/8