Répartition

Principes généraux

Ce qui est traduisible va dans la localisation, ce qui ne l’est pas reste dans l’objet.

Images à la une

Le bénéfice de garder des éléments comme l’image et le crédit dans l’objet est de permettre la mise à jour en une fois. Le bénéfice de tout localiser est de permettre des choix différents par langue. Techniquement, il y a un avantage de simplicité à tout grouper. Comme on ne peut grouper que sur la localisation, on fait ce choix.

Published

Pour permettre de publier une localisation et pas une autre, published doit être lié à la localisation et pas à l’objet. La date de publication doit donc suivre. La propriété pinned, qui permet d’épingler un article, pourrait être d’un côté ou de l’autre, selon que l’on veut permettre une gestion éditoriale distincte dans chaque langue. Là encore, la simplicité technique l’emporte, nous laissons pinned avec published.

Objets directs

Page

Pages spéciales

Une grande question concerne les pages spéciales. Ce sont les pages comme l’accueil, ou l’index des actualités, qui ont un fonctionnement et/ou un rôle particulier dans le site. Ces objets sont implémentés en utilisant la Single-Table Inheritance (STI) native de Ruby on Rails. Conceptuellement, rien ne change, ce sont bien les pages qui ont des types spéciaux.

• https://www.martinfowler.com/eaaCatalog/singleTableInheritance.html
• https://api.rubyonrails.org/classes/ActiveRecord/Inheritance.html

Toutefois cela impacte l’implémentation :

• les dépendances partagées avec les localisations
• le git_path
• une petite partie du fichier statique

Parent spécial manquant

Un cas particulier se produit quand un objet, qu’il s’agisse d’une actualité ou d’une personne, est localisé dans une langue alors que sa page spéciale ne l’est pas.

2 possibilités :

1. soit on considère qu’on ne peut pas afficher l’objet du tout, ce qui ne paraît pas très pertinent
2. soit on considère qu’il faut afficher l’objet, avec un chemin pas trop faux Concrètement, ça peut donner /en/equipe/pierre-andre-boissinot. Quand la page spéciale Équipe sera traduite, l’url deviendra /en/team/pierre-andre-boissinot, et le système de permalinks gèrera la redirection.

Blog

Actualité

Communication::Website::Post

Catégorie

Communication::Website::Post::Category

Menu

Communication::Website::Menu::Item

Les menus sont différents dans chaque langue, il ne s’agit pas de localisation. On garde la logique de language_id, mais on supprime la notion d’original_id.

Comme les menus dans différentes langues partagent un identifiant (par exemple primary), on s’appuie sur cet identifiant pour passer d’une langue à l’autre dans un menu.

Les identifiants ne peuvent être définis qu’à la création du menu.

Élément

Communication::Website::Menu::Item

Les items n’ont pas besoin d’un language_id car ils existent dans un menu qui a déjà cette langue définie.

De même, les items de type blank et url ne sont pas impactés car ne sont liés à aucun objet.

Pour les autres types d’items de menu, ils ont un about qui a besoin d’évoluer pour être sur l’objet parent, et non pas une localisation. Il faut effectuer une migration pour bien être connecté à l’original des objets existants.

class MigrateCommunicationWebsiteMenuItemsAbout < ActiveRecord::Migration[7.1]
  def up
    Communication::Website::Menu::Item.where.not(kind: [:blank, :url]).find_each do |menu_item|
      about = menu_item.about
      next if about.nil?
      # Kind like paper can't respond to original_id
      about_id = about.try(:original_id) || about.id
      menu_item.update_column :about_id, about_id
    end
  end

  def down
  end
end

Ensuite dans les formulaires, on rajoute le scope tmp_original en attendant la fin de la migration.

On centralise la récupération des collections dans le modèle :

class Communication::Website::Menu::Item < ApplicationRecord
  def self.collection_for(kind, website)
    # TODO L10N : remove every tmp_orginal below
    case kind
    when 'page'
      website.pages.tmp_original
    when 'diploma'
      website.education_diplomas.tmp_original
    when 'program'
      website.education_programs.tmp_original
    when 'category'
      website.post_categories.tmp_original
    when 'post'
      website.posts.tmp_original
    when 'volume'
      website.research_volumes.tmp_original
    when 'paper'
      website.research_papers.tmp_original
    when 'location'
      website.administration_locations.tmp_original
    end
  end
end

Dans le fichier statique, on tente de récupérer la localisation de l’objet associé. Si elle n’existe pas, on ne renvoie pas de chemin, l’item de menu ne sera donc pas affiché.

Avant :

class Communication::Website::Menu::Item < ApplicationRecord
  def static_target
    # ...
    case kind
    when "blank"
      ''
    when "url"
      url
    else
      about.new_permalink_in_website(website).computed_path
    end
  end
end

Après :

class Communication::Website::Menu::Item < ApplicationRecord
  def static_target
    # ...
    case kind
    when "blank"
      ''
    when "url"
      url
    else
      about_l10n = about.localization_for(language)
      if about_l10n.present?
        about_l10n_permalink = about_l10n.new_permalink_in_website(website)
        about_l10n_permalink.computed_path
      else
        nil
      end
    end
  end
end

Agenda

Événement

Agenda::Event

Catégorie

Agenda::Category

Portfolio

Projet

Portfolio::Project

Catégorie

Portfolio::Category

Objets indirects

Organisation

University::Organization

Catégorie

University::Organization::Category

Person

University::Organization

Les personnes ont 3 tables liées :

• university_person_experiences
• university_person_involvements
• university_roles

Ces 3 tables n’avaient pas de gestion des langues avant l’énorme PR 2025. Il n’y a donc rien à migrer.

Facettes

Les personnes ont des facettes : Administrator, Author, Researcher, Teacher. Les facettes sont activées par des booléens, comme is_author (attention il y a des subtilités). Ces 4 facettes permettent de gérer les 5 pages différentes possibles pour une même personne dans Hugo. Les facettes sont devenues des classes qui héritent de la localisation et plus de la personne elle-même, parce qu’elles ont un slug qui dépend du nom (traduit). Dans les dépendances des pages spéciales, comme la page qui liste les administrateurs, il faut lister les administrateurs. Attention, prendre toutes les personnes qui ont un rôle d’administration amènerait à une situation fausse : une personne pourrait être administratrice dans un site d’une formation, alors qu’elle n’a pas de rôle administratif dans la formation, mais dans l’école. Il faut donc se limiter au contexte du site.

def dependencies_administrators
  University::Person::Localization::Administrator.where(
    about_id: website.administrators.pluck(:id),
    language_id: website.active_language_ids
  )
end

On récupère les facettes de localisations Administrator des personnes qui ont un rôle administratif pour ce site. La limite aux langues actives évite d’envoyer des langues non utilisées dans le site.

Catégorie

University::Organization::Category