You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
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 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:
Disadvantages:
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 integratedIt 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:
font-awesome
as 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.)Tickets that would benefit from this epic - anything that we want to add as page...
The text was updated successfully, but these errors were encountered: