Set up for development

1. Install Python and pip Make sure Python is added to PATH environment

2. Install virtualenv using pip: pip install virtualenv

3. Create virtual environment in project root: virtualenv venv

4. Activate virtual environment: Windows: .\venv\Scripts\activate

   Linux: source ./venv/bin/activate

   type deactivate to deactivate virtualenv

5. Make sure your venv is active: pip -V it should show current python interpreter in use. Must be the one inside project's venv folder.

6. Install requirements: pip install -r requirements.txt

7. Istall plugins clone to ./src/itsp https://github.com/getpelican/pelican-plugins

8. Create environment settings inside ./src/itsp/conf folder: Create new env_conf.py file from env_conf.py.example Create new dev_conf.py file from dev_conf.py.example and fill in all the required settings for your local evironment Create new test_conf.py file from test_conf.py.example and fill in all the required settings for your testing evironment Create new prod_conf.py file from prod_conf.py.example and fill in all the required settings for your production ready evironment

9. Switch between dev, test and prod inside conf/env_conf.py if you want to generate files for production or local development

Make sure you always use virtual environment before doing something in terminal. You can check for current environment with: pip -V. It should show current python interpreter in use. Must be the one inside project's venv folder.

https://docs.getpelican.com/en/stable/index.html

Commands

cd to project folder ./src/itsp

• pelican --help help
• pelican content generate output files
• pelican -r watch for changes in files
• pelican --listen run devserver at 127.0.0.1:8000

Theme translations

cd to themes/itsp

• Extract translatable strings from templates pybabel extract --mapping babel.cfg --output messages.pot ./
• Initialize message catalogs pybabel init --input-file messages.pot --output-dir translations/ --locale lang --domain messages lang should be locale like ru or en
• Fill the message catalogs with translation strings in *.po files inside themes/itsp/translations folder
• Compile the message catalogs pybabel compile --directory translations/ --domain messages