Beispiele zur Migration, alle Seiten #

Layouts, Einstellungen und Templates zwischen Installationen, Versionen und Sites verschieben.

1. Alle Layouts auf eine andere Installation übertragen: exp:layouts export --all auf der Quelle, Import mit Probelauf auf dem Ziel; Inhalte werden über Remote-ID und Pfad zugeordnet.
2. Nur einige Layouts übertragen: --only mit den Bezeichnern der Layouts; die gemeinsamen Layouts, mit denen sie verknüpft sind, kommen mit.
3. Die Zuordnungen mit den Layouts übertragen: --rules=none|selected|all entscheidet, welche Layout-Zuordnungen mitreisen; selected (der Standard) nimmt die der gewählten Layouts.
4. Wenn dem Ziel Inhalte fehlen: --unmapped=drop|keep|fail entscheidet, was mit Verweisen auf Inhalte geschieht, die das Ziel nicht hat (Standard drop).
5. Neben den vorhandenen Layouts importieren: --strategy=copy importiert bereits vorhandene Einträge als neue Kopien und lässt die Originale stehen.
6. Die Strategie pro Layout wählen: --item=<key>=<strategy>,... setzt skip, overwrite oder copy pro Eintrag, mit den Schlüsseln, die der Probelauf ausgibt.
7. Layouts im Projekt-Repository aufbewahren: Exporte neben der Design-Erweiterung committen; die layouts.json im Archiv lässt sich zwischen Versionen vergleichen.
8. Die Einstellungen einer Site in ihre Erweiterung verschieben: exp:ini move / move-all verschieben Blöcke oder ganze Siteaccess-Geltungsbereiche in eine Erweiterung (--create-extension --activate), mit Probelauf.
9. Die Menü-Einstellungen in einen anderen Siteaccess kopieren: exp:ini copy kopiert eine Einstellung (ein ganzes Array mit seiner Zurücksetz-Zeile) von einem Geltungsbereich in einen anderen.
10. Die Einstellungsdateien einer anderen Wurzel ändern: exp:ini --root=<dir> arbeitet auf dem Einstellungsbaum einer anderen Wurzel (einer Kopie der Installation); der INI-Cache dort wird nicht geleert, und der Geltungsbereich muss dort existieren.
11. Gespeicherte Bezeichner von Komponentenblöcken aktualisieren: Layouts von vor der Umbenennung speichern Komponenten als ibexa_component_<type>; ext:explayouts:updatecomponentblockidentifiers benennt sie in exp_component_<type> um.
12. Gespeicherte Block-Links auf Remote-IDs umstellen: ext:explayouts:updatelinklocationreferences wandelt Block-Links von ibexa-location://<id> in exp-remote-location://<remote id> um.
13. exp:layouts statt der alten Hilfsskripte verwenden: Die ext:explayouts:*-Helfer (block_list, layout_info, layout_copy, layout_list, rule_list, share_create, collection_list) laufen seit explayouts 1.4.42 wieder eigenständig; exp:layouts bleibt das Werkzeug für Export und Import.
14. Eine mit Templates gebaute Site zu Layouts migrieren: Das Design behalten; die Teile des Seitenlayouts zu Template-Blöcken eines gemeinsamen Header / Footer machen; Seitenlayouts pro Klasse hinzufügen; sie zuordnen.
15. Eine Layouts-Site in Templates einfrieren: Wenn sich eine Site nicht mehr ändern soll (ein Archiv), können ihre Layouts bleiben; Einfrieren heißt weniger Redakteure, nicht neu schreiben.
16. Eine Sprache hinzufügen und ihr Layouts geben: Ein neuer Siteaccess bekommt seine Einstellungen (menu.ini) mit exp:ini copy und seine eigenen Layouts über Zuordnungen mit einer Siteaccess-Bedingung.
17. Inhalte an eine andere Stelle im Baum verschieben: Eine Verschiebung behält die Knoten-IDs: Menüs, Ort-Zuordnungen und manuelle Sammlungen folgen; Ziele Pfad und Pfadpräfix nicht.
18. Seitenpakete und Layouts: Die Seitenpakete dieser Installation bringen Inhalte, aber keine Layouts mit; installieren Sie die Layouts mit exp:layouts import nach den Inhalten.
19. Layouts nach einem Upgrade prüfen: Nach dem Upgrade von Exponential exportieren, auflisten, die wichtigsten Layouts im Editor öffnen und die Seiten vergleichen.
20. Ihre Template-Overrides nach einem Upgrade prüfen: Ihre Kopien von Theme-Templates bekommen die Korrekturen des Themes nicht; vergleichen Sie sie mit den neuen Theme-Versionen.
21. Die Reihenfolge der Erweiterungen nach dem Verschieben von Einstellungen prüfen: Nach dem Verschieben von Einstellungen oder dem Hinzufügen von Erweiterungen DesignExtensions[] und AvailableBlocks[] in ihrer Wirkung prüfen.
22. Unterschiedliche Knoten-IDs auf Staging und Produktion: Knoten-IDs unterscheiden sich zwischen Installationen; Menüs (MainMenuID) brauchen die IDs des Ziels, Layouts werden über Remote-ID und Pfad zugeordnet.
23. Layouts umbenennen, ohne Importe zu brechen: Importe ordnen Layouts über den Bezeichner zu; halten Sie Bezeichner stabil und ändern Sie Namen nach Belieben.
24. Eine Installation in zwei Sites aufteilen: Die Layouts des Teilbaums der Site exportieren und auf der neuen Installation nach deren Inhalten importieren.
25. Layouts aus zwei Installationen zusammenführen: Die Layouts der zweiten Site mit --strategy=copy importieren, wo Bezeichner kollidieren, dann umbenennen und neu zuordnen.
26. Ein durch einen Import beschädigtes Layout retten: Den vorherigen Export mit overwrite und publish importieren; der Import leert den Seiten-Cache selbst.
27. Ein fest eingebautes Menü in Einstellungen überführen: Ein altes Template mit eingetippten Links wird zu einer Liste MainMenuID[], die main_menu.tpl des Themes liest.
28. Kopierte HTML-Snippets durch einen Blocktyp ersetzen: Viele HTML-snippet-Blöcke mit demselben Markup werden zu einem Blocktyp; ersetzen Sie sie einen nach dem anderen.
29. Inline-Styles ins Stylesheet verschieben: style="" und <style> in alten Templates kommen in Ihr Stylesheet und werden mit dem des Themes gepackt.
30. Festhalten, was die Migration geändert hat: Verschobene Einstellungen, importierte Layouts und ihre Strategien, hinzugefügte oder entfernte Overrides auflisten, für die nächste Migration.
31. Velocity nach einer Migration: Auf einer Site, die Exponential Velocity ausliefert, brauchen Änderungen an Einstellungen exp:velocity restart, wie exp:ini sagt.
32. Die Migration auf einer Kopie proben: Führen Sie jeden Befehl zuerst auf einer Kopie aus; die Probeläufe auf dem Live-System bergen dann keine Überraschungen.
33. Den Weg zurück planen: Exporte der Layouts, Sicherungen der INI-Dateien (exp:ini legt sie unter var/backup/ini/ ab) und das vorherige Release der Erweiterung.
34. Die Checkliste nach einer Migration: Seiten nach Markup, Menüs, Zuordnungen, Entwürfe, Caches, Velocity: die Prüfungen nach dem Umzug.

Verwandte Seiten #

• Beispiele zum Lebenszyklus
• Zwei Wege zum Bauen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.