No edit summary Tag: 2017 source edit |
No edit summary |
||
| Line 60: | Line 60: | ||
Wiki admins or editors can be notified about new pendings in e-mail. | Wiki admins or editors can be notified about new pendings in e-mail. | ||
{{Box Links-en|Topic1=[[Reference: | {{Box Links-en|Topic1=[[Reference:MergeArticles]]|Topic2=}}<br /> | ||
{{translation}} | {{translation}} | ||
Latest revision as of 06:25, 2 June 2025
The functionality "Push & Merge" in a wiki farm copies the content of wiki pages from a source wiki to a different wiki instance of the same farm. In case of already existing content in the target wiki, a merge mechanism can be activated. With the merge functionality users accept or discard section-based differences between the existing and the transferred content.
Selecting source files
At least two wikis in the same farm are required (source wiki and target wiki).
The content transfer is initiated from the page Special:ContentTransfer in the source wiki. A user needs content-transfer rights, which are assigned to the admin role by default.
Selection of target wiki and source content
- Receiving: Selection of the wiki, to which the content will be copied. The target wiki is always in the same wiki farm as the source wiki.
- Include related: Content that is linked from the selected pages (linked pages, files, templates) can be included in the transfer or excluded if this option is deselected.
Filter options
The following search filter options can be used to retrieve a list of transfer candidates in the source wiki:
- Modified since: shows only pages that have been modified since a selected date regardless of the last transfer.
- Modified since last transfer: shows only pages that have been change since their last transfer to the selected target. This will also affect included ressources.
- Page name: filters the source pages based on naming pattern.
- Namespace: shows pages from a particular namespace.
- Category: shows pages from a particular category.
- Only modified pages: shows only pages that have been change since their last push to the selected target.
- Select all/select none: the shown pages from the filtered lilst can be completely selected or deselected for the push.
Starting the transfer
Clicking the button Transfer initiates the transfer mechanism.
- Maximum number of transferred pages: The maximum number of pages is 200 per transfer. If you want to copy more than that, the pages have to be copied in multiple transfers.
- Non-existing namespace (target wiki): If the namespace of the selected pages does not exist in the target wiki, the user is notified that the namepsace has to be created in the target wiki in advance.
Pushing the pages
After clicking Transfer, the files are copied over to the target wiki. The following files are included, if applicable:
Protected pages: If a page cannot be copied - for example, because a draft page is protected during a review workflow - you will be notified accordingly. You can decide whether you want to overwrite the page anyway or skip it.
After the selection of pages from the source wiki is complete, a new dialog window for the transfer opens. It contaisn the path to the target wiki and a list of all pages that will be copied.
In this window, you can also see the transfer progress as well as a final transfer report.
All transferred pages and files continue to exist in the source wiki. They have to be deleted manually, if they are no longer nedded there.
Merging pages
With the default configuration, transferred pages are instantly created to the target path in the wiki.
However, it is possible to change the server configuration so that pages are first transferred to a draft namespace. Users need to check the drafts regularly to approve them to be moved to their actual target location.
see the help page for "Merge articles"
Merging pages with approval feature
If a page is transferred to a namespace with approval mechanism activated, the new version in the target wiki must be approved by a user with approval rights.
For existing pages (template, category, file), the changes are done. The changes consist in merging line by line after interactive selection by the user. A new wiki item is set in “pending” status. The new item is then marked as “draft”.
- All „pending“ pages are listed on a special page Unreviewed pages.,
- From this special page, the user can browse to these pages, check the differences and approve each page after editing the draft version.
Wiki admins or editors can be notified about new pendings in e-mail.
Related info
