ikiwiki-transition(1)

NAME

ikiwiki-transition - transition ikiwiki pages to new syntaxes, etc

ikiwiki-transition type ...

ikiwiki-transition aids in converting wiki pages when there's a major change in ikiwiki syntax. It also handles other transitions not involving wiki pages.
prefix_directives
The prefix_directives mode converts the specified ikiwiki page from the old preprocessor directive syntax, requiring a space, to the new syntax, prefixed by '!'.
Preprocessor directives which already use the new syntax will remain unchanged.
Note that if the page contains wiki links with spaces, which some older versions of ikiwiki accepted, the prefix_directives transition will treat these as preprocessor directives and convert them.
indexdb
The indexdb mode handles converting a plain text .ikiwiki/index file to a binary .ikiwiki/indexdb. In this mode, you should specify the srcdir of the wiki as the second parameter. You do not normally need to run ikiwiki-transition indexdb; ikiwiki will automatically run it as necessary.
hashpassword
The hashpassword mode forces any plaintext passwords stored in the .ikiwiki/userdb file to be replaced with password hashes. (The Authen::Passphrase perl module is needed to do this.) In this mode, you should specify the srcdir of the wiki as the second parameter.
If this is not done explicitly, a user's plaintext password will be automatically converted to a hash when a user logs in for the first time after upgrade to ikiwiki 2.48.