mirror of
https://github.com/mkdocs/mkdocs.git
synced 2026-03-27 18:08:31 +07:00
f5b5446b71
An error page can be served from any location and therefore it is impossable to pre-build an error page with correct relative URLs. With absolute URLs, the error pages will properly link to other pages in the nav as well as media files (css, js, images, etc) from the template regardless of the actual URL the file is served from. However, to continue to support environments where the docs root is a subdir of the server root, all other pages must continue to use relative URLs. The `site_url` is used to determine the server root when building absolute URLs for the error page to ensure those URLs continue to work in that type of environment. Relative URLs are also nessecary for those who browse the site on the local file system (via `file://`). In that case, the error page will be broken. However, as error pages are not served by a local file system, this is no more than a minor inconvience. Error pages should always be tested from a server environment. Fixes #77.
MkDocs
Project documentation with Markdown.
- View the MkDocs documentation.
- Project release notes.
- Visit the MkDocs wiki for community resources, including third party themes and a list of MkDocs users.
- IRC channel:
#mkdocson freenode. - Discussions and support: https://groups.google.com/forum/#!forum/mkdocs
Code of Conduct
Everyone interacting in the MkDocs project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.