aboutsummaryrefslogtreecommitdiff
path: root/doc/forum/best_way_to_update_setup_file_after_an_ikiwiki_update__63__.mdwn
blob: 8dfd5180c1e6861eee7cbfb973cc39d5ff47d8f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
Ok, I'm trying to get into a good routine where I keep ikiwiki updated for my site.
The plan is to keep a local (partial) git clone, and rebuild from tagged release commits.

I started out with 3.20140831, more or less like this:

    $ git clone ...
    $ git checkout 3.20140831
    $ perl Makefile.PL PREFIX=$HOME/blah
    $ make
    $ make install
    $ cd ~/my-wiki-admin-stuff
    $ ~/blah/bin/ikiwiki --dumpsetup=my.wiki.setup
    $ vi my.wiki.setup
    $ ~/blah/bin/ikiwiki --setup my.wiki.setup

So far so good. Fast-forward (heh) to 3.20140916:

    $ git fetch ...
    $ git merge --ff-only FETCH_HEAD
    $ git checkout 3.20140916
    $ perl Makefile.PL ... ; make ; make install
    $ cd ~/my-wiki-admin-stuff ; ~/blah/bin/ikiwiki --setup my.wiki.setup

This happened to work, but in general if the new ikiwiki version had new
setup options I needed to know about, I wouldn't necessarily find out, and
I could be running the new version with something important taking an
inappropriate default because I didn't add it to the setup file.

What I'm looking for is some sort of

    ikiwiki --read-my-current-setup-file-and-write-one-with-the-same-config-but-with-new-options-shown-and-commented

command.

Will `ikiwiki --changesetup setupfile` do what I'm looking for?

I'm hoping for something simple that takes care of the way the setup sections are conditional
(so `--dumpsetup` doesn't even show you `git` options unless it knows `rcs=git`, so ideally it
would look in the current setup to learn what to dump).

How are other folks handling this routinely?