The new Weitblick website is Django, and Python based. The search engine we use is called Elasticsearch, which is Java based. Downloading this code you can run and test the website with default content on you computer.

If you have Docker installed, you can just run:

        docker-compose up

It will install, build and run everything for you. For more info see the Docker Documentation. Changes in the wbcore folder will be avaliable instantly, other changes will require a rebuild of the container using the --build flag when starting. Otherwise, follow the following steps to set up everything natively.

Required Software & Tools: Python 3, Java 8, Tidy, cairo and Elastic Search 2.

Only necessary for Windows installation. Consider using Chocolatey.

Download Python 3.6.8 from the python website or using a package manager. For example using Chocolatey for Windows.

  curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

and then run:

  python get-pip.py

• for Linux: sudo -H pip install pipenv,
• for Windows run as Administrator: pip install pipenv

Go to the project root folder. To install the requirements type:

  pipenv install -r requirements.txt --three`

This can take a while. After that you are good to go.

Install Java 8 and be sure to set JAVA_HOME.

Install Elastic Search 2. You can download it here and unzip it.

For windows users an easy way is the installation of GTK2 as it contains cairo. E.g. follow point 2. here

Start Elastic Search.

On unix run :

  bin/elasticsearch

or on windows:

  bin\elasticsearch.bat

Enter the virtual environment. This is required for all following steps.

  pipenv shell

Use the django module command to build the search index:

  python manage.py rebuild_index

Accept with y or add a --noinput to the rebuild command.

This search index should be updated later when adding content, for example by using a cron job running:

  python manage.py update_index

Database migration and loading data can be achieved running the script initalize.sh

  python manage.py makemigrations wbcore
  python manage.py migrate

Enable support for german

sudo locale-gen de_DE
sudo update-locale

  python manage.py loaddata data/address.json
  python manage.py loaddata data/locations.json
  python manage.py loaddata data/hosts.json
  python manage.py loaddata data/images.json
  python manage.py loaddata data/news.json
  python manage.py loaddata data/blog.json
  python manage.py loaddata data/partners.json
  python manage.py loaddata data/projects.json

  python3 manage.py createsuperuser

Next we run the django server:

  python manage.py runserver

Now if everything worked, you can access the website on http://localhost:8000

To enable the login via Microsoft OAuth2 with the official Weitblick intranet accounts visit this site and set the domain name to localhost:8000.

To update the translations do the following inside the wbcore directory

django-admin makemessages
django-admin makemessages -d djangojs

For the first time you may have to run django-admin makemessages -l de or similar for each language. Fill the translation for newly added translated stings to wbcore/locale/de/LC_MESSAGES/django.po and .../djangojs.po. Finally compile the messeges

django-admin compilemessages

• no such table when database is empty: Run Database Migration