Localisation de Django

Localisation Django pour le contenu de la base de données et les API

Utilisez Altified avec Django pour traduire les champs de modèle, le contenu du backend et les réponses de l'API tout en préservant l'intégrité de votre base de données et du flux de travail de votre application.

Flux de données Django
Modèle Django
Altified traduction
API localisée

Votre système dorsal reste responsable des enregistrements et des autorisations, tandis qu'Altified gère les valeurs traduites et leur réutilisation.

La réponse courte

Le SDK Django permet au code backend de gérer les champs en fonction de la langue active. Votre API et votre frontend peuvent ainsi diffuser des données localisées issues du même système de gestion de produits.

/ 01

Installez le package

Exécutez pip install django-altified, ajoutez-le à INSTALLED_APPS et connectez votre Altified clé de projet.

/ 02

Champs d'enregistrement

Exécutez python manage.py init_altified et listez les champs du modèle à traduire dans altified.py.

/ 03

Utiliser la gestion des paramètres régionaux de Django

LocaleMiddleware définit la langue active, et les champs enregistrés renvoient des valeurs traduites pour cette langue.

/ 04

Répondre

Lisez les champs normalement dans les vues et les sérialiseurs. La valeur d'origine est utilisée par défaut lorsqu'aucune traduction n'existe.

Pourquoi c'est important

Un flux de travail de localisation qui a sa place au sein de votre produit.

Contenu prenant en compte le modèle

Traduire les noms de produits, les descriptions, les listes, les leçons, les articles et autres champs appartenant au backend.

Réponses de l'API

Veillez à ce que la localisation soit proche de la source de données afin que les clients frontaux reçoivent la langue demandée.

Fonctionne avec un SDK frontal

Associez la localisation de contenu Django à Next.js ou à un autre frontend qui gère les routes locales.

Identifiants côté serveur

Conservez les secrets du projet sur le serveur, tandis que votre application contrôle le contenu exposé.

/ Foire aux questions

Questions que se posent les équipes avant la localisation.

Quel contenu Django puis-je localiser ?

Vous pouvez localiser les champs de modèle, les enregistrements éditoriaux, les données produit et les valeurs issues d'API tout en conservant l'enregistrement de base de données d'origine comme solution de repli dans la langue source.

La localisation nécessite-t-elle le déplacement de mes données ?

Non. Votre application Django reste la source de référence pour les enregistrements, les permissions et le comportement de l'API. Altified gère les valeurs traduites en parallèle de ce flux de travail.

Django peut-il alimenter un frontend Next.js localisé ?

Oui. Django peut résoudre ou exposer le contenu backend localisé tandis qu'un SDK frontend gère les routes locales, le rendu des pages et les métadonnées.

Comment localiser les champs d'un modèle Django ?

Enregistrez le modèle et ses champs de texte dans altified.py, par exemple « Product » avec les champs « name » et « description ». Lors de la sauvegarde d'un modèle enregistré, le SDK synchronise ces champs. Si le code accède à « product.name » et que la langue active de Django n'est pas la langue source, la valeur traduite est renvoyée.

En quoi cela diffère-t-il de la localisation gettext intégrée à Django ?

Le flux de travail gettext de Django traduit les chaînes de caractères dans les modèles et le code Python via les fichiers .po compilés lors du déploiement. Il ne prend pas en charge le contenu stocké dans votre base de données. Altified gère le contenu de la base de données et de l'API qui change après le déploiement et fonctionne en complément de gettext pour les chaînes statiques.

En quoi est-ce différent de django-modeltranslation ?

django-modeltranslation ajoute une colonne de base de données par champ et par langue, ce qui implique une migration pour chaque nouvelle langue. Avec Altified, vous enregistrez les champs dans altified.py et votre schéma reste inchangé. Les traductions sont gérées dans le tableau de bord Altified avec glossaires et fonction de révision.

Puis-je demander une langue spécifique en dehors de la requête actuelle ?

Oui. Utilisez translate_field(product, "name", language="fr") de django_altified pour résoudre un champ dans une langue donnée, par exemple dans les e-mails, les tâches en arrière-plan ou les exportations.