-
Notifications
You must be signed in to change notification settings - Fork 3
Description
This is more of a proposal - it will enable us to do more things with the hompage like adding pages easily.
After #21 merged the homepage consists of:
- the static frontpage
- the docusaurus page that currently only contains the blog
The static frontpage is not integrated into the docusaurus theme.
Integrating the frontpage into docusaurus theme
Goal: Docusaurus wraps the frontpage as well, i.e. the docusaurs top navbar and footer is globally configured for the complete page.
Advantages:
- We can easily add pages (either react or markdown / mdx)
- We can add more fancy widgets because we are in the react universe there
Disadvantages:
- Initial effort to "convert" the current static frontpage to be used in docusaurus react page
Approaches
When working on the homepage I experimented with wrapping the static frontpage with the docusaurus theme by using an iframe. This would have the advantage that we we don't have to change the frontpage too much, but we still achieve it being integrated
It has some weird quirks, e.g. the iframe having separate scroll behaviour from the wrapping page by docusaurus.
It would be better to go one step further and integrate the static webpage into the docusaurus react page. For someone with react experience this should be quite easily possible.
Challenges:
- Configuring scss for docusaurus would be great - this would enable us to use
font-awesomeas CSS, which would e.g. enable having icons in the docusaurus navbar. (I experimented with that when workiung on Integrate blog into homepage using Docusaurus #21, but did not get it working within my timebox.)- This would help with integrating the static webpage as well, because it uses scss in many places
Tickets that would benefit from this epic - anything that we want to add as page...