LEFT | RIGHT |
1 # Configuration (settings.ini) # | 1 # Configuration (settings.ini) # |
2 | 2 |
3 The following sections can be defined in `settings.ini`: | 3 The following sections can be defined in `settings.ini`: |
4 | 4 |
5 * `[general]`: The following settings should be listed here: | 5 * `[general]`: The following settings should be listed here: |
6 * `defaultlocale`: The fallback locale, to be used whenever no localized | 6 * `defaultlocale`: The fallback locale, to be used whenever no localized |
7 page/strings can be found for a locale. | 7 page/strings can be found for a locale. |
8 * `defaultpage`: The default page which is displayed by the server if the URL | 8 * `defaultpage`: The default page which is displayed by the server if the URL |
9 doesn't contain a page name. Note that while the test server will consider | 9 doesn't contain a page name. Note that while the test server will consider |
10 that setting automatically, the real server might need to be configured | 10 that setting automatically, the real server might need to be configured |
11 accordingly. | 11 accordingly. |
12 * `crowdin-project-name`: The Crowdin project name, this must be set if | 12 * `crowdin-project-name`: The Crowdin project name, this must be set if |
13 you intend to use the cms.bin.translate script to update the Crowdin | 13 you intend to use the cms.bin.translate script to update the Crowdin |
14 translations. | 14 translations. |
15 * `siteurl`: The base URL where pages will be served from. | 15 * `siteurl`: The base URL where pages will be served from. |
16 * `[langnames]`: Defines the language names correspoding to particular language | 16 * `[langnames]`: Defines the language names correspoding to particular language |
17 codes. | 17 codes. |
18 * `[rtl]`: Any language codes listed here are treated as right-to-left languages
. | 18 * `[rtl]`: Any language codes listed here are treated as right-to-left languages
. |
19 The values of the settings are ignored. | 19 The values of the settings are ignored. |
20 * `[locale_overrides]`: Every entry defines that a page should use a different | 20 * `[locale_overrides]`: Every entry defines that a page should use a different |
21 locale file, not the one matching its name (to be used when multiple pages | 21 locale file, not the one matching its name (to be used when multiple pages |
22 share localization data). | 22 share localization data). |
23 * '[paths]': A root folder of another website may be specified here, which will | 23 * `[paths]`: Configure where things are located on the filesystem: |
24 allow this website to access the remote resources. This is useful for | 24 * `additional-paths`: One or more additional website root directories (paths |
25 websites that share common resources. If the shared resources are in a | 25 should be relative to the root directory of this website). Pages, templates, |
26 separate repository, they can be 'inherited' here by using the key: | 26 translations, etc. from those websites will be added to this one. This is |
27 `additional-paths = {}` | 27 useful for sharing common resources between multiple websites. |
28 | 28 |
29 Prev: [XTM Integration](../usage/xml-sync.md) | Up: [Home](../../README.md) | Ne
xt: [Custom Jinja2 global functions and variables (`globals`)](globals.md) | 29 Prev: [XTM Integration](../usage/xml-sync.md) | Up: [Home](../../README.md) | Ne
xt: [Custom Jinja2 global functions and variables (`globals`)](globals.md) |
LEFT | RIGHT |