Training materials for PostGIS
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/
- German: [pdf] https://postgis.net/workshops/de/postgis-intro/
- Japanese: https://postgis.net/workshops/ja/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/
- Chinese (Simplified): https://postgis.net/workshops/zh_Hans/postgis-intro/
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.
- 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
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
pip3 install sphinx-intl
cd postgis-intro/sources/en
make pot
#for starters do de, ja, es
sphinx-intl update -p _build/gettext -l de -l ja -l es
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
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
- TBD, probably using reveal.js