Official udata theme of the Open Data Portal of Luxembourg
Install the theme package in you udata environement:
pip install gouvlu
Then, define the installed theme as current in you
THEME = 'gouvlu'
Some features are optionnal and can be enabled with the following
GOUVLU_GOVBAR = True/False: Toggle the govbar
There is a
docker-compose configuration to get started fast.
Then go to http://localhost:7000 to connect to the development server with live reload.
If you want to execute some development tasks like extracting the translations or running the test suite, you need to install the dependencies localy (in a virtualenv).
virtualenv venv source venv/bin/activate pip install -r requirements/develop.pip
If you want to build assets, you also need node.js. The prefered way is with nvm:
nvm use npm install inv assets_build
Ok, you are ready, you can now execute some Development commands.
inv -l Available tasks: all Run tests, reports and packaging assets-build Build static assets assets-watch Build assets on change clean Cleanup all build artifacts cover Run tests suite with coverage dist Package for distribution i18n Extract translatable strings i18nc Compile translations pydist Perform python packaging (without compiling assets) qa Run a quality report test Run tests suite
Let's execute an entire build:
This project is translated on crowdin.
To update the source string, you need to extract them with the
inv i18n command and push the result on this repository.
Crowding will detect the new string as soon as they are available on the
Crowdin will submit a pull-request each time some translation is submitted by the contributors.
gouvlu uses bumpr to perform release.
# Install bumpr if not already installed pip install bumpr # Dry run to preview changes bumpr -dv # Perform release bumpr
Bumpr will execute test, package everything, update changelog, handle tagging and push to upstream repository... You just have to wait for the build to succeed and your release is available.