[MIRROR] of postgis-workshops on github - that gets deployed to https://postgis.net/workshops/postgis-intro/
https://postgis.net/workshops/postgis-intro/
Translations update from OSGeo Weblate |
||
---|---|---|
postgis-intro | ||
themes | ||
.gitignore | ||
README.md |
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.
![Translation status](https://weblate.osgeo.org/widgets/postgis-workshop/-/287x66-grey.png)
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