Allow start page to be specified for the site
These are the goals we want to accomplish:
- Designate a start page / home page for the site (we'll call this the site start page)
- Use a page from an existing component without having to make that page its own component and without promoting the component it lives in to the site component
Add configuration to the playbook that allows any page in the site to be designed as the start page. In the first iteration, this will create a redirect from the index.html page at the root of the site to this is page (either as a meta refresh page, URL rewrite, or both). In the future, we may implement a start page strategy that allows the page to be copied into the site root location (so the URL doesn't change).
The proposed configuration is as follows:
site:
start_page: my-component::index
NOTE: None of the source-to-source references on this page change. Underneath the covers it is still referenced using its page ID.
If the start_page is in a versioned component, the version must be specified:
site:
start_page: 1.0@my-component::index
So when the visitor navigates to the docs domain, the visitor is redirected automatically to the start page (my-docs.com/index.html -> my-docs.com/1.0/index.html).
If redirects are enabled, then a redirect should be set up that points from the root of the site to the start page, bypassing the use of the meta refresh redirect.