1ikiwiki-transition(1)       General Commands Manual      ikiwiki-transition(1)
2
3
4

NAME

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

SYNOPSIS

9       ikiwiki-transition type ...
10

DESCRIPTION

12       ikiwiki-transition  aids  in converting wiki pages when there's a major
13       change in ikiwiki syntax. It also handles other transitions not involv‐
14       ing wiki pages.
15

prefix_directives your.setup

17       The prefix_directives mode converts all pages from the old preprocessor
18       directive syntax, requiring a space, to the  new  syntax,  prefixed  by
19       '!'.
20
21       Preprocessor  directives  which  already use the new syntax will remain
22       unchanged.
23
24       Note that if a page contains wiki links with spaces, which  some  older
25       versions  of  ikiwiki  accepted,  the prefix_directives transition will
26       treat these as preprocessor directives and convert them.
27

setupformat your.setup

29       The setupformat mode converts a setup file from using a single wrappers
30       block to using cgi_wrapper, git_wrapper, etc.
31
32       Note that all comments and any unusual stuff like perl code in the set‐
33       up file will be lost, as it is entirely rewritten by the transition.
34

aggregateinternal your.setup

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

moveprefs your.setup

40       Moves values that used to be admin preferences into the setup file.
41
42       Note that all comments and any unusual stuff like perl code in the set‐
43       up file will be lost, as it is entirely rewritten by the move.
44

indexdb your.setup|srcdir

46       The indexdb mode handles converting a plain text .ikiwiki/index file to
47       a  binary  .ikiwiki/indexdb.  You  do  not  normally  need  to run iki‐
48       wiki-transition indexdb; ikiwiki will automatically run  it  as  neces‐
49       sary.
50

hashpassword your.setup|srcdir

52       The  hashpassword  mode  forces  any  plaintext passwords stored in the
53       .ikiwiki/userdb  file  to  be  replaced  with  password  hashes.   (The
54       Authen::Passphrase perl module is needed to do this.)
55
56       If  this  is  not  done explicitly, a user's plaintext password will be
57       automatically converted to a hash when a user logs  in  for  the  first
58       time after upgrade to ikiwiki 2.48.
59

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

AUTHOR

67       Josh Triplett <josh@freedesktop.org>, Joey Hess <joey@ikiwiki.info>
68
69                                                         ikiwiki-transition(1)
Impressum