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

Add breadcrumbs for user navigation #12

Open
Athul0491 opened this issue Dec 27, 2023 · 1 comment
Open

Add breadcrumbs for user navigation #12

Athul0491 opened this issue Dec 27, 2023 · 1 comment

Comments

@Athul0491
Copy link
Owner

Add breadcrumbs which allow users to navigate through their file tree

@Athul0491
Copy link
Owner Author

Athul0491 commented Mar 9, 2024

After going through the description, prerequisites and the todo, I came up with a MVP.

MVP: Github | Demo

image

This is an HTTP API that generates an Open Graph image based on:

  1. docurl: a URL pointing to a raw AsyncAPI document.
  2. base64: an AsyncAPI document encoded in base64.

To generate an Open Graph image using the URL pointing to raw AsyncAPI document:
Go to /api/og?docurl={link_of_your_doc}

To generate an Open Graph image using base64 encoded AsyncAPI document:
Go to /api/og?base64={base64_encoded_doc}

Example:

image

Dynamic OpenGraph image

  • To make the OpenGraph image show dynamically based on such parameters, I tried adding a script in the
    <head> tag of public/index.html and by various other methods, but they were not concrete solutions.
  • react-helmet also does not seem to be a viable option as it does not provide support for web crawlers
    and it does not provide good compatibility with opengraph data.
    It is also considered to be deprecated as it is not currently being maintained.

Current issues:

  • For nextjs apps, there is a package called next-seo. We need something similar or need to find a workaround for this. Would need to investigate more for this.
  • The speed of preview picture generation on Studio would be slow unless caching is applied.
  • Design of the open graph image needs to be worked on.

_Any suggestions and insights are highly appreciated_ Cheers, Athul

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant