Issue #254 Fix link to BasisProject.cmake API doc.
Issue #254 Fix :orphan: in rendered HTML.

For some reason the :orphan: instruction does not behave as I expect/want it to. It is needed when generating the PDF to avoid a warning, but is then part of the HTML. Better a warning then a wrongly rendered HTML.
Issue #254 Fix link to reference on index page.
Issue #254 Make order of full table the same as sidebar.