Skip to content

Commit afec132

Browse files
authored
Update Settings.rst
1 parent 8c3bf62 commit afec132

File tree

1 file changed

+35
-37
lines changed

1 file changed

+35
-37
lines changed

Documentation/FirstProject/Settings.rst

Lines changed: 35 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@ parts of it.
1616
Global settings
1717
===============
1818

19-
Global settings can be made in the modules in section :guilabel:`Admin Tools`,
20-
which changes file :file:`config/system/settings.php` or be overridden manually
21-
in file :file:`config/system/additional.php`. Avoid making manual changes to
22-
the first file as it is auto-managed.
19+
Global settings can be made in the modules under the :guilabel:`Admin Tools` section,
20+
which updates the :file:`config/system/settings.php` file. Alternatively, settings can
21+
be overridden manually in the :file:`config/system/additional.php` file. Avoid making
22+
manual changes to the first file mentioned, as it is auto-managed.
2323

2424
.. todo: Also explain Configuration Presets and Feature Toggles here?
2525
@@ -28,16 +28,16 @@ the first file as it is auto-managed.
2828
Global extension settings
2929
-------------------------
3030

31-
Global settings to installed extensions, including some that are part of a
32-
default installation can be made in submodule
33-
:guilabel:`Admin Tools > Settings > Extension Configuration`.
31+
Global settings for installed extensions, including some that are part of a
32+
default installation, can be made in the
33+
:guilabel:`Admin Tools > Settings > Extension Configuration` submodule.
3434

3535
.. figure:: /Images/ManualScreenshots/AdminTools/ExtensionConfiguration.png
3636
:alt: Screenshot demonstration the location of the Extension Configuration in module "Settings"
3737

3838
You can find the global Extension Configuration in module Settings
3939

40-
After opening the submodule you can make your changes and hit save:
40+
After opening the submodule, you can make your changes and hit "Save":
4141

4242

4343
.. figure:: /Images/ManualScreenshots/AdminTools/ExtensionConfigurationDetail.png
@@ -46,25 +46,23 @@ After opening the submodule you can make your changes and hit save:
4646
Make changes and hit "Save".
4747

4848
.. note::
49-
File :file:`config/system/settings.php` has to be writable. If you keep it
50-
under version control make sure to commit and push your changes.
49+
The :file:`config/system/settings.php` file has to be writable. If you keep
50+
it under version control, make sure to commit and push your changes.
5151

5252
.. _settings_site:
5353

5454
Site handling
5555
=============
5656

57-
One TYPO3 installation may contain more then one site. Even if you have only one
58-
site in your installation important settings can be made here.
59-
60-
Important settings can be made in the site configuration. Read more about
61-
them in chapter :ref:`siteconfiguration`.
57+
One TYPO3 installation can contain more then one site. Even if you only have one
58+
site in your installation, important settings can be made in the Site Configuration.
59+
Read more about this in the chapter: :ref:`siteconfiguration`.
6260

6361
Site configurations are stored in a file called
64-
:file:`config/sites/my-site/config.yaml` and can be edited from module
65-
:guilabel:`Site Management > Sites`. Each site must have a unique key, called
66-
the "Site Identifier". For demonstration purposes we use "my-site" here. The
67-
Site Identifier is also used in the path to save the configuration.
62+
:file:`config/sites/my-site/config.yaml` and can be edited from the
63+
:guilabel:`Site Management > Sites` module. Each site must have a unique key, called
64+
the "Site Identifier". For demonstration purposes, we use "my-site" here. The
65+
Site Identifier is also used as the path for saving the configuration file.
6866

6967
.. figure:: /Images/ManualScreenshots/SiteManagement/SiteIdentifier.png
7068
:alt: Screenshot demonstration field "Site Identifier" in a site configuration
@@ -79,23 +77,23 @@ Site settings
7977
-------------
8078

8179
.. versionadded:: 13.3
82-
Starting with TYPO3 v13.3 site settings can also be edited in the site
80+
Starting with TYPO3 v13.3, site settings can also be edited in the site
8381
settings editor.
8482

85-
You can edit site settings in the module :guilabel:`Site Management > Settings`.
86-
Changes are written to file :file:`config/sites/my-site/settings.yaml`. If you
87-
keep this file under version control you must commit and push the changes made
83+
You can edit site settings in the :guilabel:`Site Management > Settings` module.
84+
Changes are written to the :file:`config/sites/my-site/settings.yaml` file. If you
85+
keep this file under version control, you must commit and push the changes made
8886
to this file.
8987

9088
.. figure:: /Images/ManualScreenshots/SiteManagement/SiteSettingsOverview.png
9189
:alt: Screenshot of the Site Settings Overview
9290

93-
You can find all sites in the settings module. If editable settings are available there is a button "Edit Settings"
91+
You can find all sites in the "Settings" module. If editable settings are available, there is a button "Edit Settings"
9492

9593
You can find more information about this editor in
9694
:ref:`TYPO3 Explained, Site settings editor <t3coreapi:site-settings-editor>`.
9795

98-
If site settings are available refer to the documentation of the extension
96+
If site settings are available, refer to the documentation of the extension
9997
offering them.
10098

10199
The following optional Core extensions offer site settings:
@@ -108,18 +106,18 @@ The following optional Core extensions offer site settings:
108106
Used to offer a login for frontend users.
109107
* :composer:`typo3/cms-indexed-search`:
110108
:ref:`Settings of the site set "Indexed Search" <typo3/cms-indexed-search:site-set-settings>`.
111-
Used to display a search box and offer basic indexing of a page without need
112-
for a Solr core as would be required by :composer:`apache-solr-for-typo3/solr`.
109+
Used to display a search box and offer basic indexing of a page without the need
110+
for a Solr core, as would be required by :composer:`apache-solr-for-typo3/solr`.
113111
* :composer:`typo3/cms-seo`:
114112
:ref:`Site sets settings of EXT:seo <typo3/cms-seo:configuration-site-set-settings>`.
115-
Used to improve meta tags, page titles and a provides a XML sitemap.
113+
Used to improve meta tags and page titles, and provides an XML sitemap.
116114

117115
You can define custom site settings in your site package:
118116
:ref:`TYPO3 Sitepackage Tutorial <t3sitepackage:start>`.
119117

120-
.. todo: link to the site settings page in the sitepackage tutorial once it is written.
118+
.. todo: link to the site settings page in the sitepackage tutorial once it is written.
121119
122-
Find detailed information on the topic also in
120+
For detailed information on this topic, see also
123121
:ref:`TYPO3 Explained, Site settings <t3coreapi:sitehandling-settings>`.
124122

125123
.. _settings_typoscript:
@@ -131,18 +129,18 @@ Page wide frontend definitions: TypoScript
131129
This module was renamed. With TYPO3 v12 it was moved from
132130
:guilabel:`Web > Template` to :guilabel:`Site Management > TypoScript`.
133131

134-
TypoScript is a scripting language that can and will most likely be used to
135-
influence the output of your pages. TypoScript can be managed in a TypoScript
136-
record that you find in module :guilabel:`Site Management > TypoScript`.
132+
TypoScript is a configuration language used to configure both the frontend
133+
output and the backend of a TYPO3 web site. TypoScript can be managed in a TypoScript
134+
record, which can be found in the :guilabel:`Site Management > TypoScript` module.
137135

138136
.. figure:: /Images/ManualScreenshots/SiteManagement/TypoScriptModule.png
139137
:ref: Screenshot demonstrating the TypoScript overview module
140138

141139
Edit the TypoScript record by clicking on the name of the record in the overview module
142140

143-
TypoScript affects the page it is defined on and all subpages. In most cases
144-
TypoScript is only defined on the root page of a site. In that case the
145-
settings made here affect the whole page.
141+
TypoScript affects the page on which it is defined, and any subpages. In most cases,
142+
TypoScript is only defined on the root page of a site. In this case. the
143+
settings made here affect the entire page.
146144

147145
You can also navigate between the different submodules by using the submodule menu:
148146

@@ -160,6 +158,6 @@ See also the complete :ref:`TypoScript Reference <t3tsref:start>`.
160158
Page wide backend settings: Page TSconfig
161159
=========================================
162160

163-
Read more about this in :ref:`Setting page TSconfig <t3tsref:setting-page-tsconfig>`.
161+
Read more about this topic in :ref:`Setting page TSconfig <t3tsref:setting-page-tsconfig>`.
164162

165163
.. todo: Add screenshots, mention the module etc?

0 commit comments

Comments
 (0)