X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/c77df2d1ebb40bbdf28aa337490e7af2861b334d..e6775e713c2a1c009f7a01fad674a545e0e6bb39:/docs/customize/Settings.md diff --git a/docs/customize/Settings.md b/docs/customize/Settings.md index f34f85b1..d080dc77 100644 --- a/docs/customize/Settings.md +++ b/docs/customize/Settings.md @@ -189,7 +189,7 @@ will be used. | **Description:** | Enable searching for Tiger house number data | | **Format:** | boolean | | **Default:** | no | -| **After Changes:** | run `nominatim --refresh --functions` | +| **After Changes:** | run `nominatim refresh --functions` | When this setting is enabled, search and reverse queries also take data from [Tiger house number data](Tiger.md) into account. @@ -202,7 +202,7 @@ from [Tiger house number data](Tiger.md) into account. | **Description:** | Enable searching in external house number tables | | **Format:** | boolean | | **Default:** | no | -| **After Changes:** | run `nominatim --refresh --functions` | +| **After Changes:** | run `nominatim refresh --functions` | | **Comment:** | Do not use. | When this setting is enabled, search queries also take data from external @@ -309,12 +309,15 @@ unset, Nominatim expects the data to be saved in the project directory. | -------------- | --------------------------------------------------- | | **Description:** | Configuration file for rank assignments | | **Format:** | path | -| **Default:** | _empty_ (use default settings) | +| **Default:** | address-levels.json | -The _address level config_ configures rank assignments for places. See +The _address level configuration_ defines the rank assignments for places. See [Place Ranking](Ranking.md) for a detailed explanation what rank assignments -are and what the configuration file must look like. The default configuration -can be found in the configuration directory as `address-levels.json`. +are and what the configuration file must look like. + +When a relative path is given, then the file is searched first relative to the +project directory and then in the global settings directory. + #### NOMINATIM_IMPORT_STYLE @@ -325,9 +328,13 @@ can be found in the configuration directory as `address-levels.json`. | **Default:** | extratags | The _style configuration_ describes which OSM objects and tags are taken -into consideration for the search database. This setting may either -be a string pointing to one of the internal styles or it may be a path -pointing to a custom style. +into consideration for the search database. Nominatim comes with a set +of pre-configured styles, that may be configured here. + +You can also write your own custom style and point the setting to the file +with the style. When a relative path is given, then the style file is searched +first relative to the project directory and then in the global settings +directory. See [Import Styles](Import-Styles.md) for more information on the available internal styles and the format of the @@ -347,6 +354,9 @@ location for OSM nodes. For larger imports it can significantly speed up the import. When this option is unset, then osm2pgsql uses a PsotgreSQL table to store the locations. +When a relative path is given, then the flatnode file is created/searched +relative to the project directory. + !!! warning The flatnode file is not only used during the initial import but also @@ -624,7 +634,11 @@ Can be used as the same time as NOMINATIM_LOG_FILE. | **After Changes:** | run `nominatim refresh --website` | Enable logging of requests into a file with this setting by setting the log -file where to log to. The entries in the log file have the following format: +file where to log to. A relative file name is assumed to be relative to +the project directory. + + +The entries in the log file have the following format: ""