NAME

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

SYNOPSIS

       ikiwiki-transition type ...

DESCRIPTION

       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 your.setup

       The prefix_directives mode converts all pages 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 a 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.

setupformat your.setup

       The  setupformat  mode  converts  a setup file from using a single wrappers block to using
       cgi_wrapper, git_wrapper, etc.

       Note that all comments and any unusual stuff like perl code in  the  setup  file  will  be
       lost, as it is entirely rewritten by the transition.

aggregateinternal your.setup

       The  aggregateinternal  mode  moves  pages  aggregated by the aggregate plugin so that the
       aggregateinternal option can be enabled.

moveprefs your.setup

       Moves values that used to be admin preferences into the setup file.

       Note that all comments and any unusual stuff like perl code in  the  setup  file  will  be
       lost, as it is entirely rewritten by the move.

indexdb your.setup|srcdir

       The  indexdb  mode  handles  converting  a  plain  text  .ikiwiki/index  file  to a binary
       .ikiwiki/indexdb. You do not normally need to run ikiwiki-transition indexdb; ikiwiki will
       automatically run it as necessary.

hashpassword your.setup|srcdir

       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.)

       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.

deduplinks your.setup

       In the past, bugs in ikiwiki have allowed duplicate link information to be stored  in  its
       indexdb.  This mode removes such duplicate information, which may speed up wikis afflicted
       by it. Note that rebuilding the wiki will have the same effect.

AUTHOR

       Josh Triplett <josh@freedesktop.org>, Joey Hess <joey@ikiwiki.info>

                                                                            ikiwiki-transition(1)