not quite there yet
[ikiwiki] / doc / forum / transition_from_handwritten_html_to_ikiwiki.mdwn
1 I'm trying to convert hand written html site to ikiwiki and maintain url compatibility. html plugin with indexpages=1 converts all dir_name/index.html correctly to dir_name urls with wiki/css based content, but somedir/somefile.html files are only accessible as somedir/somefile/. Non .html files seem to accessible with their full paths, for example somedir/pic.jpg from hand written html can be accessed by same path under ikiwiki.
2
3 How to make somedir/somefile.html accessible as somedir/somefile.html under ikiwiki?
4
5 Thanks,
6
7 -Mikko
8
9 > Hello! The options you need to investigate are `--usedirs` and
10 > `--no-usedirs`. The default `--usedirs` takes any source page foo
11 > (regardless of its format, be it markdown or html) and converts it into a
12 > destination page foo/index.html (URL foo/). By comparison, `--no-usedirs`
13 > maps the source file onto a destination file directly: src/foo.html becomes
14 > dest/foo.html, src/bar.mdwn becomes dest/bar.html, etc.
15
16 > It sounds like you want `--no-usedirs`, or the corresponding `usedirs => 0,`
17 > option in your setup file. See [[usage]] for more information. -- [[Jon]]
18
19 Thanks, usedirs seems to be just the thing I need.
20
21 -Mikko
22
23 Actually usedirs didn't do exactly what I want. The old site contains both
24 somedir/index.html and somedir/somename.html files. With html plugin and 
25 indexpages=1 the somedir/index.html pages are accessed correctly but 
26 somedir/somefile.html files not.
27
28 With usedirs => 0, somedir/somename.html pages are accessed correctly but
29 somedir/index.html pages are not. Actually the handwritten somedir/index.html
30 files were removed on a rebuild:
31
32     $ ikiwiki -setup blog.setup -rebuild -v
33     ...
34     removing test2/index.html, no longer built by test2
35
36 Is there a way for both index.html and somename.html raw html files to show up through ikiwki?
37
38 -Mikko