Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Integrate the frontpage of the hompeage into docusaurus as react page #31

Open
da-kami opened this issue May 22, 2023 · 0 comments
Open
Labels

Comments

@da-kami
Copy link
Contributor

da-kami commented May 22, 2023

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:


Tickets that would benefit from this epic - anything that we want to add as page...

@da-kami da-kami added the epic label May 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant