improve instructions
authorJoey Hess <joey@kodama.kitenet.net>
Tue, 15 Jul 2008 01:43:05 +0000 (21:43 -0400)
committerJoey Hess <joey@kodama.kitenet.net>
Tue, 15 Jul 2008 01:43:05 +0000 (21:43 -0400)
It's better to -refresh rather than rebuild, as this way ikiwiki deletes
all the html files rendered to destdir for the aggregated pages before.

doc/plugins/aggregate.mdwn

index 61743a81644f00c66b4903b8faa2a2db4d654cac..d87e33ab93aec8be9e6d49254231696459d00cb0 100644 (file)
@@ -100,8 +100,9 @@ you should follow this process:
    in those PageSpecs. For example, if the PageSpec was `foo/*`, it should
    be changed to `internal(foo/*)`. This has to be done because internal
    pages are not matched by regular globs.
-2. Use [[ikiwiki-transition]] to move all existing aggregated `.html`
+2. Turn on `aggregateinternal` in the setup file.
+3. Use [[ikiwiki-transition]] to move all existing aggregated `.html`
    files. The command to run is `ikiwiki-transition aggregateinternal $srcdir`,
    or if you have changed the `htmlext` option to something other than "html",
    `ikiwiki-transition aggregateinternal $srcdir $htmlext`
-3. Turn on `aggregateinternal` in the setup file and rebuild the wiki.
+4. Refresh the wiki. (`ikiwiki -setup your.setup -refresh`)