From 501b32b2551c12428b7637733701541bb7222cfa Mon Sep 17 00:00:00 2001 From: Flavio Curella Date: Thu, 10 Sep 2015 20:12:55 -0500 Subject: [PATCH] [1.8.x] Fixed #25380 -- Added Postgres.app to the PostGIS options on OS X. Backport of 0c7c18cc9e80101c882749c99437ad700fde0ca0 from master --- docs/ref/contrib/gis/install/index.txt | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/docs/ref/contrib/gis/install/index.txt b/docs/ref/contrib/gis/install/index.txt index 9b7feed694..a25a6e019f 100644 --- a/docs/ref/contrib/gis/install/index.txt +++ b/docs/ref/contrib/gis/install/index.txt @@ -214,17 +214,13 @@ Mac OS X Because of the variety of packaging systems available for OS X, users have several different options for installing GeoDjango. These options are: +* :ref:`postgresapp` (easiest and recommended) * :ref:`homebrew` * :ref:`kyngchaos` * :ref:`fink` * :ref:`macports` * :ref:`build_from_source` -.. note:: - - Currently, the easiest and recommended approach for installing GeoDjango - on OS X is to use the KyngChaos packages. - This section also includes instructions for installing an upgraded version of :ref:`macosx_python` from packages provided by the Python Software Foundation, however, this is not required. @@ -252,6 +248,26 @@ __ https://python.org/ftp/python/3.3.2/ export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH +.. _postgresapp: + +Postgres.app +^^^^^^^^^^^^ + +`Postgres.app `_ is a standalone PostgreSQL server +that includes the PostGIS extension. You will also need to install ``gdal`` and +``libgeoip`` with :ref:`homebrew`. + +After installing Postgres.app, add the following to your ``.bash_profile`` so +you can run the package's programs from the command-line. Replace ``X.Y`` with +the version of PostgreSQL in the Postgres.app you installed: + +.. code-block:: bash + + export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin + +You can check if the path is set up correctly by typing ``which psql`` at a +terminal prompt. + .. _homebrew: Homebrew