diff --git a/docs/source/conf.py b/docs/source/conf.py index 5ad8dcf..e00d3f4 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -42,3 +42,5 @@ html_static_path = ['_static'] html_css_files = [ 'css/custom.css', ] + +pygments_style = "sphinx" \ No newline at end of file diff --git a/docs/source/install.rst b/docs/source/install.rst index 301f624..8688e75 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -1,45 +1,8 @@ Install ======= -GeoSync is installed using the included installation script. -The script will attempt to provision an SSL certificate using Certbot. - -Ensure that your hostname is properly set. If not set the hostname using 'hostnamectl set-hostname domain.com' - -Basic Install ------------- - -Clone the repository:: - - git clone https://git.acugis.com/AcuGIS/GeoSync.git - -Change to the GeoSync directory:: - - cd GeoSync - -Execute the scripts in order:: - - $ ./installer/postgres.sh - $ ./installer/app-install.sh - -Upon completion, you should see the message below:: - - Backend installation is finished. - - -Complete Setup --------------- - -Go to https://domain.com/admin.setup.php to complete the installation. - - .. image:: images/installer-2.png - - -Populate the required fields with whatever values you want to use. - - -Manual Installation on Ubuntu 22 +Installation on Ubuntu 22 -------------------------------- Follow below to customize your installation. @@ -54,26 +17,15 @@ If you do not already have it installed, install it now. .. code-block:: bash -#!/bin/bash -e - - apt install postgresql postgresql-contrib + apt -y install postgresql postgresql-contrib postgis Install Prerequisties ------------------------------------------ -For Community Edition: - -.. code-block:: bash - - apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd,simplexml} proftpd postfix python3-certbot-apache - -For Commerical Edition: - .. code-block:: bash apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd,simplexml} proftpd libapache2-mod-fcgid postfix python3-certbot-apache -install_qgis_server Create the PostGIS Database @@ -91,82 +43,137 @@ Create the Database Objects .. code-block:: sql - CREATE TYPE public.userlevel AS ENUM ('Admin', 'User'); + CREATE TYPE public.userlevel AS ENUM ('Admin', 'User'); - CREATE TABLE public.user ( id SERIAL PRIMARY KEY, - name character varying(250), - email character varying(250), - password character varying(255), - ftp_user character varying(250), - accesslevel public.userlevel, - owner_id integer NOT NULL REFERENCES public.user(id), - UNIQUE(email) - ); + CREATE TABLE public.user ( id SERIAL PRIMARY KEY, + name character varying(250), + email character varying(250), + password character varying(255), + ftp_user character varying(250), + accesslevel public.userlevel, + owner_id integer NOT NULL REFERENCES public.user(id), + UNIQUE(email) + ); - CREATE TABLE public.access_groups ( id SERIAL PRIMARY KEY, - name character varying(255) NOT NULL, - owner_id integer NOT NULL REFERENCES public.user(id) - ); + CREATE TABLE public.access_groups ( id SERIAL PRIMARY KEY, + name character varying(255) NOT NULL, + owner_id integer NOT NULL REFERENCES public.user(id) + ); - CREATE TABLE public.user_access ( id SERIAL PRIMARY KEY, - user_id integer NOT NULL REFERENCES public.user(id), - access_group_id integer NOT NULL REFERENCES public.access_groups(id), - UNIQUE(user_id, access_group_id) - ); + CREATE TABLE public.user_access ( id SERIAL PRIMARY KEY, + user_id integer NOT NULL REFERENCES public.user(id), + access_group_id integer NOT NULL REFERENCES public.access_groups(id), + UNIQUE(user_id, access_group_id) + ); - CREATE TABLE public.map ( id SERIAL PRIMARY KEY, - name character varying(50) NOT NULL, - description character varying(50) NOT NULL, - is_public BOOLEAN DEFAULT false, - owner_id integer NOT NULL REFERENCES public.user(id) - ); + CREATE TABLE public.map ( id SERIAL PRIMARY KEY, + name character varying(50) NOT NULL, + description character varying(50) NOT NULL, + is_public BOOLEAN DEFAULT false, + owner_id integer NOT NULL REFERENCES public.user(id) + ); - CREATE TABLE public.map_access ( id SERIAL PRIMARY KEY, - map_id integer NOT NULL REFERENCES public.map(id), - access_group_id integer NOT NULL REFERENCES public.access_groups(id), - UNIQUE(map_id, access_group_id) - ); + CREATE TABLE public.map_access ( id SERIAL PRIMARY KEY, + map_id integer NOT NULL REFERENCES public.map(id), + access_group_id integer NOT NULL REFERENCES public.access_groups(id), + UNIQUE(map_id, access_group_id) + ); - CREATE TABLE public.permalink ( id SERIAL PRIMARY KEY, - description character varying(255), - query character varying(255), - map_id integer NOT NULL REFERENCES public.map(id), - created TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, - expires TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP + interval '1 hour', - visits integer NOT NULL DEFAULT 0, - visits_limit integer NOT NULL DEFAULT 1, - hash character varying(36) NOT NULL, - owner_id integer NOT NULL REFERENCES public.user(id) - ); + CREATE TABLE public.permalink ( id SERIAL PRIMARY KEY, + description character varying(255), + query character varying(255), + map_id integer NOT NULL REFERENCES public.map(id), + created TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + expires TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP + interval '1 hour', + visits integer NOT NULL DEFAULT 0, + visits_limit integer NOT NULL DEFAULT 1, + hash character varying(36) NOT NULL, + owner_id integer NOT NULL REFERENCES public.user(id) + ); + + CREATE TABLE public.signup ( id SERIAL PRIMARY KEY, + name character varying(250), + email character varying(250), + password character varying(250), + verify character varying(250), + UNIQUE(email) + ); + + + +Install QGIS Server +----------------------------- + +To advertise WMS, WFS, and WTMS, install QGIS server. + + + +.. code-block:: bash + + RELEASE=$(lsb_release -cs) + wget --no-check-certificate --quiet -O /etc/apt/keyrings/qgis-archive-keyring.gpg https://download.qgis.org/downloads/qgis-archive-keyring.gpg + + cat >>/etc/apt/sources.list.d/qgis.sources </etc/logrotate.d/qgisserver <admin/incl/const.php < CAT_EOF -.. note:: If you want to quickly install and test Lizmap Web Client in a few steps, you can follow those - `instructions `_ using Docker and Docker-Compose. - -.. note:: In Debian distributions, you can work as administrator (log in with ``root``), without using ``sudo`` on contrary to Ubuntu. - - - - -.. code-block:: bash - - ln -s /etc/nginx/sites-available/lizmap.conf /etc/nginx/sites-enabled/lizmap.conf - -Restart Nginx -------------- - -You must restart the Nginx server to validate the configuration. - -.. code-block:: bash - - service nginx restart diff --git a/docs/source/intro.rst b/docs/source/intro.rst index 38e115b..b166760 100644 --- a/docs/source/intro.rst +++ b/docs/source/intro.rst @@ -3,7 +3,7 @@ Introduction .. image:: images/admin-2.png -Usage +Overview ------------ GeoSync provides a UI for DB-Sync and GeoDiff, allowing you to easily add Projects to be syncronized using PostGIS. @@ -11,3 +11,21 @@ GeoSync provides a UI for DB-Sync and GeoDiff, allowing you to easily add Projec GeoSync is built with Mergin Maps DB-Sync and GeoDiff It can be used with either self-hosted Mergin Maps servers or Mergin Maps Team accounts (which provides API access) + +Authors +------------ + +QuartzMap is from AcuGIS and produced by Cited, Inc. + +https://github.com/AcuGIS + +https://github.com/DavidGhedini + +https://github.com/kaloyan13 + +https://github.com/Cited + +qgis2web is an indepedent project. + +Learn more about qgis2web at https://github.com/qgis2web/qgis2web +