The import/export API provides the ability to export a site into a compressed archive that can then be imported into another site. The archive is structured to maintain a consistent hierarchy of articles between the source site and destination site.
The import tool performs a series of actions such as article create, content update, and moves. All of these actions will show in site and page history as though the user who requested the import performed them.
Included in export
Consistent Article Hierarchy
The export archive contains the content and location of articles on the source site and unique identifiers for each page that allow for a synchronization of article locations. If an article is moved on the source site, that move will propagate to any destination sites on future imports. URL locations must remain consistent between source and destination sites. If a move is performed on a destination site and not the source site, that move will be reverted on subsequent imports.
Each article imported is stored with a unique identifier that is used to track the article through moves, deletes, and content changes.
If you delete a page, it will remain deleted even after subsequent imports. If an article is deleted on the source site, the delete action will not automatically propagate to destination sites. The article must be deleted on each destination site manually.
The source site provides the foundation for your other MindTouch instances. The source site is the site from which all your various language sites pull their core structure and root content.
- Your source site structure (hierarchy) dictates the core structure of your localized site(s). Any changes to your source structure are carried over into in your localized site(s) upon import.
- Your source site content should be generally the same across all international markets. Any changes to your source content are reflected on coinciding pages of your localized site(s) upon import.
Initial translation and subsequent updates
Initially, your entire translated source site will be imported into your localized instance(s). Subsequent updates will require only partial exports and imports.
The partial export is bound by a beginning date and the date of the export. To minimize overlap and ensure that all necessary content is exported successfully, set the beginning date equal to the date of the prior translation export.
Maintaining your source site
Keep your localized site(s) in mind as you update your source structure and content. Only include content meant to be available across all localized sites.
How updates affect your translated sites
Scenario 1: Content changes in localized site
Modifications to localized pages will be overwritten with future imports.
Scenario 2: Structure changes in source site
Modifications to the source site structure (hierarchy) will overwrite the localized site structure with future imports.
Scenario 3: Structure changes in localized site
Modifications to the localized site structure (hierarchy) will be overwritten with future imports.
Scenario 4: Deleted pages from localized site
Pages deleted from the localized site will remain deleted with future imports.
Scenario 5: Deleted pages from source site
Pages deleted from the source site will not be deleted from the localized site with future imports.
Scenario 6: Added pages in localized site
Pages manually added to the localized site will not be modified with future imports.
Scenario 7: Added pages in localized site and moved parent in source site
Pages manually added to the localized site will remain under their associated parent page with future imports, even if the parent page was moved in the source site.