Skip to content

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

@da-kami

Description

@da-kami

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...

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions