mirror of https://github.com/fafhrd91/actix-web
docs(files): improve `index_file` docs (#3924)
This commit is contained in:
parent
f31f9bc92c
commit
b1fb44722a
|
|
@ -213,10 +213,14 @@ impl Files {
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set index file
|
/// Sets index file for directory requests.
|
||||||
///
|
///
|
||||||
/// Shows specific index file for directories instead of
|
/// When a directory is requested, this value is appended to the directory's path on disk.
|
||||||
/// showing files listing.
|
/// Therefore, the index file path is relative to the served directory (the `serve_from` path
|
||||||
|
/// passed to [`Files::new`]) and should not include the `serve_from` prefix.
|
||||||
|
///
|
||||||
|
/// For example, to serve `./static/index.html` when mounting `Files::new("/", "./static")`,
|
||||||
|
/// configure it as `.index_file("index.html")` (not `.index_file("./static/index.html")`).
|
||||||
///
|
///
|
||||||
/// If the index file is not found, files listing is shown as a fallback if
|
/// If the index file is not found, files listing is shown as a fallback if
|
||||||
/// [`Files::show_files_listing()`] is set.
|
/// [`Files::show_files_listing()`] is set.
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue