resolve
Resolve a route with a reference path to some file to generate an absolute path.
For example, if the route is "d/e/f/slug", and the reference path is "a/b/c/filename.kt", then the resolved path will be "/a/b/c/d/e/f/slug".
If the route doesn't include an explicit slug, then it will be inferred from the reference path's filename. For example, if the route is "d/e/f/" and the reference path is "a/b/c/filename.kt", then the resolved path will be "/a/b/c/d/e/f/filename".
Finally, note that the route name "index" is special, and it resolves to the empty string. For example, if the route is "d/e/f/index" and the reference path is "a/b/c/filename.kt", then the resolved path will be "/a/b/c/d/e/f/".
Parameters
A path to some file, e.g. "a/b/c/filename.kt", that the route will be resolved relative to. If the path is empty or ends with a slash, an IllegalArgumentException will be thrown. You should think about the file as providing context to the route, such as a @Page("...")
annotation with a custom route inside a Kotlin source file (which would be the reference path in that case).