Upgraden van meertalig Drupal 6 naar Drupal 8
Deze documentatiepagina geeft een overzicht van meertalige upgrades van Drupal 6 naar Drupal 8. Een soortgelijke pagina voor Drupal 7 naar Drupal 8 zal binnenkort beschikbaar zijn. In de tussentijd, zie de meta-issue voor meertalige migraties.
Voordat je begint: Schakel D8-modules in
Drupal 8 heeft uitgebreide meertalige ondersteuning in core. Zoals uitgelegd in de Drupal 8 Multilingual Guide, worden meertalige functies geleverd door de volgende kernmodules:
- Language
- Interface Translation
- Content Translation
- Configuration Translation
Zorg ervoor dat al deze kernmodules zijn ingeschakeld op je Drupal 8-site voordat je de upgrade uitvoert. Daarnaast moet de core-module Migrate Drupal voor meertaligheid ook zijn ingeschakeld.
Meertalige nodes
De i18n-module biedt meertalige functionaliteit voor nodes in Drupal 6. Soortgelijke functies zijn beschikbaar in Drupal 8 core.
Taalinstellingen voor contenttypes
- De migratie van taalinstellingen van contenttypes van Drupal 6 naar Drupal 8 wordt ondersteund.
Nodes met taal maar zonder vertalingen
- Nodes kunnen in Drupal 6 een taal hebben zonder vertaling.
- Het resultaat in Drupal 8 zal conceptueel hetzelfde zijn als in Drupal 6. Er zullen twee afzonderlijke node-objecten zijn, en de taal van elke node wordt automatisch gemigreerd.
- Zie de afbeelding hieronder voor deze migratie.
Nodevertalingen
Het vertaalconcept in Drupal 6 en Drupal 8 verschilt fundamenteel.
In Drupal 6 hebben we twee nodes, één voor Engels en één voor Fins. Beide taalversies zijn afzonderlijke node-objecten met hun eigen node-ID’s. De nodes zijn gekoppeld als vertalingen van elkaar.
In Drupal 8 is het concept anders. Er is slechts één node-entiteit die «gedeeld» wordt door alle talen, en de vertalingen gebeuren op veldniveau.
In de afbeelding hieronder wordt de migratie weergegeven. De inhoud van beide nodes (Engels en Fins) wordt gemigreerd naar één node, waarbij de vertalingen op veldniveau worden opgeslagen. Redirects van node/2 naar node/1 worden automatisch aangemaakt tijdens de migratie.
Node-revisies met vertalingen
LET OP: Node-revisievertalingen zijn nog niet gemigreerd!Resterende taken:
Meertalige menu-items
De i18n-module heeft een submodule voor menuvertalingen in Drupal 6 waarmee je:
- De taal voor menu-items kunt instellen
- Menu-items kunt vertalen via de stringvertaling-UI
Soortgelijke functies bestaan in Drupal 8 core. Het migreren van menu-itemtalen en hun vertalingen uit Drupal 6 wordt ondersteund.
Meertalige commentaren
LET OP: Migratie van commentaren is nog niet voltooid!Resterende taken:
- #2981393: Migreer taalinstellingen voor commenttyp. Workaround: dit kan handmatig worden aangepast in de instellingen van het commenttype in Drupal 8 na de upgrade.
Meertalige taxonomie-woordenlijsten en termen
De i18n-module heeft een submodule voor taxonomievertalingen die meertalige functies biedt voor woordenlijsten en termen in Drupal 6. Soortgelijke functies bestaan in Drupal 8 core.
Waarschuwing: migratie voor meertalige woordenlijsten is nog niet voltooid!
Drupal 6 heeft twee verschillende concepten van meertalige woordenlijsten. Zie hieronder de resterende taken.
Migratie van vocabulaire naam- en beschrijvingsvertalingen
- Het migreren van vertalingen van de naam en beschrijving van woordenlijsten wordt ondersteund.
Overzicht: Drupal 6 vocabulaire vertaalmodi
Drupal 6 ondersteunt verschillende meertalige modi voor woordenlijsten, zoals getoond in de afbeelding hieronder.
De opties «gelokaliseerde termen» en «per taal» worden hieronder uitgelegd. «Taal van vocabulaire» is alleen van toepassing wanneer de woordenlijst een vaste taal heeft («stel taal in voor vocabulaire»). In dat geval krijgen alle termen dezelfde taal.
Gelokaliseerde termen
Resterende taken voor migratie van «gelokaliseerde termen»
Tijdelijke oplossing: taalinstellingen handmatig aanpassen in Drupal 8.
Geen workaround (behalve handmatig vertalen in Drupal 8).
Geen workaround (behalve handmatig koppelen van termen aan vertaalde nodes in Drupal 8).
Het concept van «gelokaliseerde termen» in Drupal 6 wordt hieronder getoond:
- Twee nodes, één in Engels (nid 1) en één in Fins (nid 2), gekoppeld als vertalingen van elkaar.
- Eén taxonomieterm (tid 1). Beide nodes verwijzen naar dezelfde term.
- De titel en beschrijving van de term kan worden vertaald via i18n/String Translation.
Drupal 8 heeft een equivalent voor «gelokaliseerde termen»:
- Zoals hierboven uitgelegd worden nodevertalingen gemigreerd naar één node met vertaalbare velden.
- Er is één taxonomieterm zoals in Drupal 6.
- De Engelse en Finse versie van de node verwijzen naar dezelfde term.
Per-taal termen
Resterende taken voor migratie van «per-taal termen»
Tijdelijke oplossing: taalinstellingen handmatig aanpassen in Drupal 8.
Geen workaround (behalve handmatig koppelen van termen aan vertaalde nodes in Drupal 8).
Het «per-taal termen»-concept in Drupal 6:
- Twee nodes, één in Engels en één in Fins, eventueel gekoppeld als vertalingen van elkaar.
- Afzonderlijke taxonomietermen, één voor Engels en één voor Fins, elk met hun eigen tid. Deze kunnen als vertalingen van elkaar worden gekoppeld.
Het dichtstbijzijnde equivalent in Drupal 8 wordt hieronder getoond:
- Nodevertalingen worden gemigreerd naar één node met vertaalbare velden.
- Het veld dat verwijst naar taxonomietermen is vertaalbaar, zodat de Engelse nodeversie naar de Engelse term kan verwijzen (term/1) en de Finse nodeversie naar de Finse term (term/2).
- In Drupal 8 kunnen de termen zelf niet als vertalingen van elkaar worden gekoppeld.
Andere meertalige migraties
Andere ondersteunde migraties:
- Migratie van ingeschakelde talen van Drupal 6 naar Drupal 8.
- Migratie van taalonderhandelingsinstellingen van Drupal 6 naar Drupal 8.
- Migratie van block-vertalingen van Drupal 6 naar Drupal 8.
Andere resterende migratietaken van D6 naar D8:
#2845975: Migreer optie voor gebruikersprofielveldvertaling uit Drupal 6
Fout gevonden? Hulp nodig? Bijdragen aan migratie?
Als je een bug vindt in meertalige migraties, rapporteer die als sub-issue van de multilingual meta issue.
Heb je hulp nodig? Doe mee in het #migration-kanaal op Drupal Slack of stel je vraag op Drupal Stack Exchange.
Wil je bijdragen aan migratie-issues? Je bent welkom! Bekijk de pagina «Meehelpen met migratie».