plugin:move
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:move [2017-01-18 03:07] – rgleason | plugin:move [2024-03-22 12:20] (current) – [Move Plugin] Compatible: +Kaos mopani | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : michael@content-space.de | email : michael@content-space.de | ||
type : admin, action, helper | type : admin, action, helper | ||
- | lastupdate : 2017-01-07 | + | lastupdate : 2022-01-23 |
- | compatible : Hrun, Detritus, " | + | compatible : Greebo, Hogfather, Igor, Jack Jackrum, Kaos |
depends | depends | ||
conflicts | conflicts | ||
Line 33: | Line 33: | ||
**Warning**: | **Warning**: | ||
- | Install | + | Search and install |
:!: **When updating an existing installation of this plugin in DokuWiki versions older than Release Summer 2015 " | :!: **When updating an existing installation of this plugin in DokuWiki versions older than Release Summer 2015 " | ||
- | If, for any reason, you used an FTP client to upload pages, you should " | + | If, for any reason, you used an FTP client to upload pages, you should " |
===== Usage ===== | ===== Usage ===== | ||
Line 69: | Line 70: | ||
{{https:// | {{https:// | ||
- | |||
===== Support for other plugins ===== | ===== Support for other plugins ===== | ||
Line 77: | Line 77: | ||
* [[include]] | * [[include]] | ||
* [[struct]] | * [[struct]] | ||
+ | * [[combo]] | ||
Plugins not explicitly stating their compatibility are most probably not adjusted. | Plugins not explicitly stating their compatibility are most probably not adjusted. | ||
- | |||
- | ==== Technical review for users ==== | ||
- | |||
- | The move plugin uses the search index of DokuWiki to find pages that contain links to moved pages or media files and then uses DokuWiki' | ||
- | |||
- | When a page or namespace is moved are all the internal links in the document / book / parent namespace checked and changed with an option to undo? Is there a Yes/no? check feature? | ||
- | |||
- | Yes, all links should be adapted as you already noted (both relative links in the moved page as well as links to the moved page/media file). There is currently no such check feature. However, as the plugin is using DokuWiki' | ||
- | |||
- | Are other housekeeping chores associated with " moving" | ||
- | |||
- | Both pages and media files have a list of revisions and saved, old versions in attic/ | ||
- | |||
- | What happens to old revisions and recent changes? | ||
- | |||
- | Old revisions are moved together with the page (and a new revision reflecting the move is added). In the recent changes, two changes are added, documenting both the deletion at the old name and the creation at the new name. As only one change per page is displayed in the recent changes, this means that older changes of the page won't be displayed in the recent changes. | ||
Line 132: | Line 117: | ||
Feel free to open a bug report if your plugin needs additional support from the move plugin. | Feel free to open a bug report if your plugin needs additional support from the move plugin. | ||
+ | |||
+ | ===== Technical Background ===== | ||
+ | |||
+ | The move plugin uses the search index of DokuWiki to find pages that contain links to moved pages or media files and then uses DokuWiki' | ||
+ | |||
+ | In contrast to a simple search and replace this can identify much more complex situations e.g. when a link is %%[[Foo Bar]]%% it will be found if the page foo_bar is moved and using DokuWiki' | ||
+ | |||
+ | Plugins can also add support, so e.g. the syntax of the include plugin will also be adjusted accordingly. | ||
+ | |||
+ | When using the admin interface to move whole namespaces or multiple pages and media files, an option to show a preview of the changes is available. You are encouraged to have a look at the preview to check that the plugin will do what you intended. Changes to individual pages can be easily reverted later using the builtin revert functionality of DokuWiki. | ||
+ | |||
+ | Both pages and media files have a list of revisions and saved, old versions in attic/ | ||
+ | |||
+ | Depending on the plugins you are using there might be additional data to be moved. Plugins can add support for moving their data when a page is moved using the move plugin, e.g. the struct plugin adapts its database when a page is moved. | ||
+ | |||
+ | The plugin moves old revisions together with the page (and a new revision reflecting the move is added). In the recent changes, two changes are added, documenting both the deletion at the old name and the creation at the new name. As only one change per page is displayed in the recent changes, this means that older changes of the page won't be displayed in the recent changes, but can be seen on the page's individual "old revisions" | ||
+ | |||
+ | ===== Troubleshooting ===== | ||
+ | |||
+ | * [[https:// | ||
===== Issues and feature requests ===== | ===== Issues and feature requests ===== | ||
Please report bugs and feature requests in the [[https:// | Please report bugs and feature requests in the [[https:// |
plugin/move.1484705252.txt.gz · Last modified: 2017-01-18 03:07 by rgleason