postgis-workshops

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

postgis-workshops

★ 85 Open GitHub ↗

PostGIS training materials

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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/PostGISIntro.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/
* Swedish: https://postgis.net/workshops/sv/postgis-intro/
* German:  [[pdf]](https://postgis.net/workshops/de/postgis-intro/PostGISIntro.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](https://weblate.org) for translation.  If you want to help out, log into [OSGeo Weblate](https://weblate.osgeo.org/projects/postgis-workshop/).

If you don't already have an OSGeo account, [you can get one here](https://id.osgeo.org/ldap/create). An OSGeo account will allow you to participate in translating both the PostGIS workshop and PostGIS documentation as well is several other [OSGeo projects](https://www.osgeo.org/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 or tgtermes.sty missing try doing:
sudo apt install tex-gyre texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra

# to build Chinese, Japanese, and Korean translated PDFs, install latexmk,
# xindy, XeLaTeX, FreeFont, Noto CJK, and the CJK language collections used by
# the generated Sphinx LaTeX sources:
sudo apt install latexmk xindy texlive-xetex fonts-freefont-otf fonts-noto-cjk texlive-lang-chinese texlive-lang-japanese texlive-lang-korean
```

### Slide Decks

* TBD, probably using reveal.js

postgis-workshops

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README