Merge remote-tracking branch 'upstream/master'

[nominatim.git] / docs / admin / Customization.md

diff --git a/docs/admin/Customization.md b/docs/admin/Customization.md
index 10c8d3ddb1871ca0331302f33da4ea93990864e0..373356383325a241ae1d75ca293239e5ea424b64 100644 (file)
--- a/docs/admin/Customization.md
+++ b/docs/admin/Customization.md
@@ -51,11 +51,11 @@ entire US adds about 10GB to your database.
   1. Get preprocessed TIGER 2020 data:
 
         cd $PROJECT_DIR
   1. Get preprocessed TIGER 2020 data:
 
         cd $PROJECT_DIR

-        wget https://nominatim.org/data/tiger2020-nominatim-preprocessed.tar.gz
+        wget https://nominatim.org/data/tiger2020-nominatim-preprocessed.csv.tar.gz

 
   2. Import the data into your Nominatim database:
 
 
   2. Import the data into your Nominatim database:
 

-        nominatim add-data --tiger-data tiger2020-nominatim-preprocessed.tar.gz
+        nominatim add-data --tiger-data tiger2020-nominatim-preprocessed.csv.tar.gz

 
   3. Enable use of the Tiger data in your `.env` by adding:
 
 
   3. Enable use of the Tiger data in your `.env` by adding:
 


@@ -69,3 +69,33 @@ entire US adds about 10GB to your database.
 See the [developer's guide](../develop/data-sources.md#us-census-tiger) for more
 information on how the data got preprocessed.
 
 See the [developer's guide](../develop/data-sources.md#us-census-tiger) for more
 information on how the data got preprocessed.
 

+## Special phrases import
+
+As described in the [Importation chapter](Import.md), it is possible to
+import special phrases from the wiki with the following command:
+
+```sh
+nominatim special-phrases --import-from-wiki
+```
+
+But, it is also possible to import some phrases from a csv file. 
+To do so, you have access to the following command:
+
+```sh
+nominatim special-phrases --import-from-csv <csv file>
+```
+
+Note that the two previous import commands will update the phrases from your database.
+This means that if you import some phrases from a csv file, only the phrases
+present in the csv file will be kept into the database. All other phrases will
+be removed.
+
+If you want to only add new phrases and not update the other ones you can add
+the argument `--no-replace` to the import command. For example:
+
+```sh
+nominatim special-phrases --import-from-csv <csv file> --no-replace
+```
+
+This will add the phrases present in the csv file into the database without
+removing the other ones.