README.md

PostGIS Workshops

Training materials for PostGIS

Workshops

The workshop pages are viewable at below. Note that we are working on the translations from English to other languages.

• English: [pdf] https://postgis.net/workshops/en/postgis-intro/
• Japanese: https://postgis.net/workshops/ja/postgis-intro/
• Chinese (Simplified): https://postgis.net/workshops/zh_Hans/postgis-intro/
• German: [pdf] https://postgis.net/workshops/de/postgis-intro/
• Korean: https://postgis.net/workshops/ko/postgis-intro/
• Spanish: https://postgis.net/workshops/es/postgis-intro/
• Italian: https://postgis.net/workshops/it/postgis-intro/
• French: https://postgis.net/workshops/fr/postgis-intro/
• Ukrainian: https://postgis.net/workshops/uk/postgis-intro/

Translations

We are using Weblate software for translation. If you want to help out, log into OSGeo Weblate.

If you don't already have an OSGeo account, you can get one here. An OSGeo account will allow you to participate in translating both the PostGIS workshop and PostGIS documentation as well is several other OSGeo projects.

Building the Workshop Content

• Install Sphinx: http://www.sphinx-doc.org/en/1.8/usage/installation.html
• python3 -m venv ~/pw-env
• source ~/pw-env/bin/activate
• Go to the source directory: cd postgis-intro/sources/en/
• Build the HTML: make html
• Check the outputs: cd ../../doc/en

If you get an error about TemplateNotFound('sphinxdoc/layout.html') then Try doing below (for python3, might need to use pip3 instead of pip): pip install sphinx-rtd-theme

running in Python3 with virtual-env

sudo apt install python3-pip
sudo apt install python3-venv
python3 -m venv ~/pw-env
source ~/pw-env/bin/activate #enter the venv
pip3 install --upgrade pip
pip3 install sphinx-rtd-theme

setting up po translation files

pip3 install sphinx-intl
cd postgis-intro/sources/en
make pot
make po

Building translated docs

cd postgis-intro/sources/en
LANG=ja make html-translation
LANG=de make html-translation
LANG=es make html-translation
LANG=it make html-translation

# to build pdfs
LANG=de make pdf-translation

# if you get errors building, you might need to install lang specific
sudo apt install texlive-lang-german
sudo apt install texlive-lang-japanese

PDF builds

make pdf #builds just english
#if you get errors about cmap.sty missing try doing:
sudo apt install texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra

Slide Decks

• TBD, probably using reveal.js