Om een meertalig ondersteuningssysteem in je Flask-app te integreren, kun je Flask-Babel gebruiken. Hier is een stapsgewijze aanpak om vertalingen te beheren en taalherkenning te implementeren binnen je bestaande structuur met blueprints: 1. Flask-Babel installeren Voeg Flask-Babel toe aan je project: ```bash pip install flask-babel ``` 2. Configuratie in je hoofdapplicatie In je hoofd Flask-appbestand (bijvoorbeeld `app.py`) importeer en configureer je Flask-Babel: ```python from flask import Flask, request from flask_babel import Babel, gettext app = Flask(__name__) # Configuratie van ondersteunde talen en standaardtaal app.config['BABEL_DEFAULT_LOCALE'] = 'en' app.config['BABEL_SUPPORTED_LOCALES'] = ['en', 'nl', 'fr', 'de'] babel = Babel(app) ``` 3. Taalkeuze op basis van gebruiker of request Gebruik de decorator `@babel.localeselector` om de taal automatisch te bepalen, bijvoorbeeld op basis van URL, cookies of de Accept-Language header: ```python @babel.localeselector def get_locale(): # Voorbeeld: taal uit URL-parameter locale = request.args.get('lang') if locale in app.config['BABEL_SUPPORTED_LOCALES']: return locale # Anders, gebruik de 'Accept-Language' header return request.accept_languages.best_match(app.config['BABEL_SUPPORTED_LOCALES']) ``` 4. Vertalingen beheren Maak een `translations`-map in je projectdirectory en gebruik `pybabel` om vertaalbestanden aan te maken en te beheren: ```bash pybabel init -i messages.pot -d translations -l nl pybabel init -i messages.pot -d translations -l fr pybabel init -i messages.pot -d translations -l de ``` Vul de vertalingen in de `.po`-bestanden en compileer ze: ```bash pybabel compile -d translations ``` 5. Vertalingen gebruiken in je code Gebruik `gettext` of de shorthand `_` in je templates en Python-code: ```python from flask_babel import gettext as _ @app.route('/') def index(): greeting = _("Hello, World!") return render_template('index.html', greeting=greeting) ``` In templates: ```jinja2 {{ _('Hello, World!') }} ``` 6. Blueprints integreren Omdat je meerdere blueprints hebt, kun je Babel in elke blueprint gebruiken door de `gettext`-functie te importeren en te gebruiken. Zorg dat je Babel-initialisatie slechts één keer gebeurt in je hoofdapp, en dat `get_locale()` overal consistent wordt toegepast. 7. Naadloze gebruikerservaring - Voeg taalkeuzemogelijkheden toe (bijvoorbeeld vlaggen of dropdowns) die de URL aanpassen met `?lang=nl`. - Bewaar de taalkeuze in cookies of sessies voor persistente voorkeuren. - Pas `get_locale()` aan om voorkeuren van de gebruiker te respecteren. Door deze stappen te volgen, kan je Flask-app vertalingen beheren, automatisch de juiste taal selecteren, en een vloeiende meertalige gebruikerservaring bieden.

Hier is een stapsgewijze uitleg voor het implementeren van meertalige ondersteuning in je Flask-app met Flask-Babel: ## 1. Installatie ```bash pip install Flask-Babel ``` ## 2. Basisconfiguratie in je hoofd Flask-app ```python from flask import Flask, request, session, g from flask_babel import Babel, gettext as _ app = Flask(__name__) app.config['BABEL_DEFAULT_LOCALE'] = 'nl' app.config['BABEL_SUPPORTED_LOCALIZATIONS'] = ['nl', 'en', 'fr', 'de'] app.secret_key = 'je_secret_key' babel = Babel(app) ``` ## 3. Taalherkenning instellen ```python @babel.localeselector def get_locale(): # 1. Controleer of taal in URL parameters staat language = request.args.get('lang') if language in app.config['BABEL_SUPPORTED_LOCALIZATIONS']: return language # 2. Controleer of taal in sessie staat if 'language' in session: if session['language'] in app.config['BABEL_SUPPORTED_LOCALIZATIONS']: return session['language'] # 3. Gebruik browser taalvoorkeuren browser_language = request.accept_languages.best_match( app.config['BABEL_SUPPORTED_LOCALIZATIONS'] ) if browser_language: return browser_language # 4. Fallback naar standaard taal return app.config['BABEL_DEFAULT_LOCALE'] ``` ## 4. Taalwissel endpoint toevoegen ```python @app.route('/set_language/<language>') def set_language(language): if language in app.config['BABEL_SUPPORTED_LOCALIZATIONS']: session['language'] = language return redirect(request.referrer or url_for('index')) ``` ## 5. Vertalingen in templates **Jinja2 templates:** ```html <h1>{{ _('Welkom bij onze applicatie') }}</h1> <p>{{ _('U bent ingelogd als %(username)s', username=current_user.name) }}</p> <!-- Meervoud ondersteuning --> <p> {{ ngettext('%(num)d product', '%(num)d producten', products|count) }} </p> ``` ## 6. Vertalingen in Python code ```python from flask_babel import gettext as _, ngettext # Enkelvoud message = _('Er is een fout opgetreden') # Meervoud product_count = len(products) message = ngettext('%(num)d product gevonden', '%(num)d producten gevonden', product_count) % {'num': product_count} ``` ## 7. Vertaalbestanden aanmaken **Stap 1: Extracteer vertaalbare teksten** ```bash pybabel extract -F babel.cfg -o messages.pot . ``` **Stap 2: Maak vertaalbestanden aan** ```bash # Voor elke taal pybabel init -i messages.pot -d translations -l nl pybabel init -i messages.pot -d translations -l en pybabel init -i messages.pot -d translations -l fr ``` **Stap 3: Vertaal de teksten** Bewerk de `.po` bestanden in de `translations` map. **Stap 4: Compileer vertalingen** ```bash pybabel compile -d translations ``` ## 8. Blueprint ondersteuning Voor blueprints blijft de configuratie hetzelfde. Zorg dat je de babel instance importeert: ```python from hoofd_app import babel from flask_babel import _ @blueprint.route('/voorbeeld') def voorbeeld(): return _( 'Dit is een voorbeeld in de blueprint' ) ``` ## 9. Geavanceerde configuratie **babel.cfg bestand:** ```ini [python: **.py] [jinja2: **/templates/**.html] extensions=jinja2.ext.autoescape,jinja2.ext.with_ ``` **Tijdzone ondersteuning:** ```python from flask_babel import format_datetime @babel.timezoneselector def get_timezone(): user = getattr(g, 'user', None) if user is not None: return user.timezone return 'UTC' ``` ## 10. Gebruik in formulieren en validatie ```python from flask_babel import lazy_gettext as _l class LoginForm(FlaskForm): username = StringField(_l('Gebruikersnaam'), validators=[DataRequired()]) password = PasswordField(_l('Wachtwoord'), validators=[DataRequired()]) ``` ## Tips voor naadloze gebruikerservaring: 1. **Taalkeuze in navigatie**: Toon een taalwisselaar in je layout 2. **URL taalprefix**: Overweeg `/nl/route` of `?lang=nl` 3. **Standaardinstellingen**: Gebruik browserdetectie als fallback 4. **Cache headers**: Voeg `Vary: Accept-Language` header toe 5. **Talen bijwerken**: Gebruik `pybabel update` om nieuwe teksten toe te voegen Met deze setup heb je een complete meertalige ondersteuning die naadloos werkt across al je blueprints!