QGIS-Website

QGIS-Website

To be able to run localisation targets you will need Sphinx 1.2b1 which comes with pip. Sphinx coming with most distro's is just 1.1.3. You will get an error with those.

Best to run the make file in a virtual env (http://www.virtualenv.org/):

Move to a directory (~/myvirtualenvs/) and create a virtualenv enabled dir:

virtualenv sphinx  # one time action, only to create the environment
cd sphinx

And activate this virtualenv

source bin/activate 
# now you will see sphinx before your prompt:
(sphinx)richard@mymachine

Now always activate your environment before building. To deactivate, you can do:

deactivate

So install sphinx 1.2b1 now in your virtual env:

pip install sphinx==1.2b1

Sphinx bootstrap theme (http://ryan-roemer.github.io/sphinx-bootstrap-theme/README.html). We use 0.3.0 currently.

pip install sphinx_bootstrap_theme==0.3.0

Sphinx intl extention (https://pypi.python.org/pypi/sphinx-intl):

pip install sphinx-intl

Then build:

make clean html (to build the english languag)
make clean LANG=nl html (to build the dutch version. Currently available: nl, es, zh_CN)

If you want add the QGIS-Documentation docs into the build, you need to manually copy the sources, resources and po files into the website project

TODO: do this via scripting or Makefile

# from the QGIS-Documentation / source / docs directory, copy all subdirs into the QGIS-Website /source / docs directory
# from the QGIS-Documentation / resources / en directory, copy all in to the QGIS-Website / resources / en directory
# from the QGIS-Documentation / i18n / <your language> / LC_MESSAGES / docs directory, copy all subdirs in the  QGIS-Website / i18n / <your language> / LC_MESSAGES / docs

To gather all strings in a pot (.po) file:

make gettext

To update or create strings:

sphinx-intl update -p i18n/pot -c source/conf.py -l nl (es, zh_CN, ja, de)

To create .mo files from the .po files then:

sphinx-intl build -c source/conf.py

Then normal build

make clean LANG=nl html

See it in action: http://new.qgis.org/html/en/site (to be moved)

qgis-style.css is based on Less (see http://lesscss.org/ )

To make changes to CSS on MacOsx

download / install / open Less app (http://incident57.com/less/)
in Finder navigate to themes/qgis-theme/static/
drag qgis-style.less file to the Less app
make changes in qgis-style.less
on save it should automatically compile into qgis-style.css
for advance usage read docs on Less CSS: http://lesscss.org/

(if you have any questions ping yulka_plekhanova on Skype)

To make changes on cli Linux

# install node-less and the compressor
sudo apt-get install node-less yui-compressor
# compile the less file to a normal css file:
lessc qgis-style.less qgis-style.css
# or
lessc qgis-style.less > qgis-style.css
# optional: compress the css
yui-compressor -o qgis-style.css qgis-style.css