Add the ability to include page titles in HTML title element

README.md

@@ -322,6 +322,25 @@ favicon = "/favicon.png"
 favicon_mimetype = "image/png"
 ```
 
+### Page titles
+
+The theme allows you to configure how the page titles (the `<title>` elements) are rendered.
+
+Use `"combined"` to render titles as `"Page title | Main title"`.
+
+```toml
+# Optional: Set how <title> elements are rendered.
+# Values:
+# - "main_only" -- only the main title (`config.title`) is rendered.
+# - "page_only" -- only the page title (if defined) is rendered,
+#                  falling back to `config.title` if not defined or empty.
+# - "combined" -- combine like so: "page_title | main_title",
+#                 or if page_title is not defined or empty, fall back to `main_title`
+#
+# Note that the main (index) page only has the main title.
+page_titles = "combined"
+```
+
 All the configuration options are also described in
 [`config.toml`](../master/config.toml).