STARK-web/README.md

About

This is a repository where you may access the code for STARK-web.

Running

Install required libraries using (we presume you have preinstalled python 3.8+):

pip install -r requirements

Move to project directory and write:

flask run

To run project locally.

Deployment

Website is deployed on 'storitve' server.

After connecting there, clone latest version of this repository to custom location.

Move inside clone repository and build a docker image using the following command (adapt version by modifying cited 2024-01-01):

docker build -t stark-web:2024-01-01_1 .

Move to the location with docker-compose.yml (/opt/Docker/STARK-web/) and adapt docker-compose.yml file to be a container of the latest image (in previous example this would be image: stark-web:2024-01-01_1)

Run new docker container:

docker compose up -d

Translations

Translations are implemented using flask-babel library (this should already be installed if you followed instructions in Running section).

Install gettext

In order to use msgmerge command you have to install gettext.

# Ubuntu command
sudo apt install gettext

Update translations commands

# Move to project directory

# Create .pot file
pybabel extract -F babel.cfg -o messages.pot .
msgmerge translations/sl/LC_MESSAGES/messages.po messages.pot -o translations/sl/LC_MESSAGES/messages.po
msgmerge translations/en/LC_MESSAGES/messages.po messages.pot -o translations/en/LC_MESSAGES/messages.po

# !Check and delete fuzzy in .po files

# Compile changes
pybabel compile -d translations

Initiate a new language

If new language is introduced, you may use the following command:

pybabel init -i messages.pot -d translations -l es