91 lines
4.3 KiB
Markdown
91 lines
4.3 KiB
Markdown
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.
|
|
|
|
How to make somedir/somefile.html accessible as somedir/somefile.html under ikiwiki?
|
|
|
|
Thanks,
|
|
|
|
-Mikko
|
|
|
|
> Hello! The options you need to investigate are `--usedirs` and
|
|
> `--no-usedirs`. The default `--usedirs` takes any source page foo
|
|
> (regardless of its format, be it markdown or html) and converts it into a
|
|
> destination page foo/index.html (URL foo/). By comparison, `--no-usedirs`
|
|
> maps the source file onto a destination file directly: src/foo.html becomes
|
|
> dest/foo.html, src/bar.mdwn becomes dest/bar.html, etc.
|
|
>
|
|
> It sounds like you want `--no-usedirs`, or the corresponding `usedirs => 0,`
|
|
> option in your setup file. See [[usage]] for more information. -- [[Jon]]
|
|
|
|
Thanks, usedirs seems to be just the thing I need.
|
|
|
|
-Mikko
|
|
|
|
Actually usedirs didn't do exactly what I want. The old site contains both
|
|
somedir/index.html and somedir/somename.html files. With html plugin and
|
|
indexpages=1 the somedir/index.html pages are accessed correctly but
|
|
somedir/somefile.html files not.
|
|
|
|
With usedirs => 0, somedir/somename.html pages are accessed correctly but
|
|
somedir/index.html pages are not. Actually the handwritten somedir/index.html
|
|
files were removed on a rebuild:
|
|
|
|
$ ikiwiki -setup blog.setup -rebuild -v
|
|
...
|
|
removing test2/index.html, no longer built by test2
|
|
|
|
Is there a way for both index.html and somename.html raw html files to show up through ikiwki?
|
|
|
|
-Mikko
|
|
|
|
> I think you want usedirs => 0 and indexpages => 0?
|
|
>
|
|
> What IkiWiki does is to map the source filename to an abstract page name
|
|
> (indexpages alters how this is done), then map the abstract page name
|
|
> to an output filename (usedirs alters how this is done).
|
|
>
|
|
> The three columns here are input, abstract page name, output:
|
|
>
|
|
> usedirs => 0, indexpages => 0:
|
|
> a/index.html -> a/index -> a/index.html
|
|
> a/b.html -> a/b -> a/b.html
|
|
> usedirs => 1, indexpages => 0:
|
|
> a/index.html -> a/index -> a/index/index.html
|
|
> a/b.html -> a/b -> a/b/index.html
|
|
> usedirs => 0, indexpages => 1:
|
|
> a/index.html -> a -> a.html
|
|
> a/b.html -> a/b -> a/b.html
|
|
> usedirs => 1, indexpages => 1:
|
|
> a/index.html -> a -> a/index.html
|
|
> a/b.html -> a/b -> a/b/index.html
|
|
>
|
|
> The abstract page name is what you use in wikilinks and pagespecs.
|
|
>
|
|
> What I would suggest you do instead, though, is break your URLs once
|
|
> (but put in Apache redirections), to get everything to be consistent;
|
|
> I strongly recommend usedirs => 1 and indexpages => 0, then always
|
|
> advertising URLs that look like <http://www.example.com/a/b/>. This is
|
|
> what ikiwiki.info itself does, for instance. --[[smcv]]
|
|
|
|
Thanks for the explanation. usedirs => 0 and indexpages => 0 does the trick,
|
|
but I'll try to setup mod_rewrite from foo/bar.html to foo/bar in the final
|
|
conversion.
|
|
|
|
-Mikko
|
|
|
|
> That's roughly what I do, but you can do it with `Redirect` and `RedirectMatch` from `mod_alias`, rather than fire up rewrite. Mind you I don't write a generic rule, I have a finite set of pages to redirect which I know. -- [[Jon]]
|
|
|
|
I'm getting closer. Now with usedirs => 1 and raw html pages, ikiwiki transforms foo/index.html to foo/index/index.html.
|
|
Can ikiwiki be instructed map foo/index.html to page foo instead that foo/index?
|
|
|
|
-Mikko
|
|
|
|
> If you don't already have a foo.html in your source, why not just rename foo/index.html to foo.html? With usedirs, it will then map to foo/index.html. Before, you had 'foo/' and 'foo/index.html' as working URLS, and they will work after too.
|
|
>
|
|
> If you did have a foo.html and a foo/index.html, hmm, that's a tricky one. -- [[Jon]]
|
|
|
|
> We may be going round in circles - that's what indexpages => 1 does :-)
|
|
> See the table I constructed above, which explains the mapping from input
|
|
> files to abstract page names, and then the mapping from abstract page
|
|
> names to output files. (I personally think that moving your source pages
|
|
> around like Jon suggested is a better solution, though. --[[smcv]]
|