Navigation problem

[Gulshanaggarwal]

What is the issue?
Navigation on the Learn page of NucleoidJS doesn't work properly.

How to reproduce?

• Goto the Learn page
• Click on Express.js in the right-side navigation bar it doesn't scroll down to that section. Navigation doesn't work properly for all learning sections.

[Gulshanaggarwal]

@canmingir can I start working on the issue?

[canmingir]

👍 Sounds good, honestly, I couldn't find a good ToC library for React. BTW, HTML is generated thru markdown here

[Gulshanaggarwal]

@canmingir I have figured out why it's not working. If you clearly give a look at hyperlinks(on contents) that have either ? or , or .js included is not working.

Let's see through the image below -
Here I removed ? from What is Nucleoid markdown and hyperlink is working now.

Should I fix it by removing like this or something else? 🤔

[Gulshanaggarwal]

@canmingir what do you think about the previous comment ?

[canmingir]

Yes, you are right, the question mark is causing an issue in here. Instead of deleting an question mark from the content, let's see there is a workaround in react-markdown-heading, which I've opened up an issue on their side. BTW, I am in search of finding better ToC library as well, lmk if you know any of them,

kyoncy/react-markdown-heading#33

[Gulshanaggarwal]

@canmingir I tried to generate the toc with another library react-toc but it has the same problem but one thing which I figured out is that organizations like socket.io or enarx uses docusaurus tool with markdown files to generate their website content including toc.

What do you think 🤔

[canmingir]

Fantastic, docusaurus is looking really cool, we can switch into that, instead of trying to maintain our markdown generator

[Gulshanaggarwal]

@canmingir So, what's the plan for switching? Do you have any idea so that we can start?

[canmingir]

I would say yes, let's switch, do you want to give a shot?

[Gulshanaggarwal]

@canmingir in open-source always! let's give it a shot. What's the plan?

[canmingir]

I've been looking at it, looks like it won't be easy switch over, but I think this gives better handling on our docs, I will be working on it, but it may take awhile tho

[Gulshanaggarwal]

@canmingir ok, then go ahead. Once you start I will join you.

[canmingir]

There is a conversation going on, docusaurus may not be possible with MUI

facebook/docusaurus#7505

[Gulshanaggarwal]

@canmingir If MUI is not possible then we can go ahead with what docusaurus provides.

[canmingir]

Working on a hybrid solution, I am trying to keep the main page with MUI, but rebuilding rest of pages with docusaurus (They are already in markdown anyway). Let see, how far I can go with

https://github.com/NucleoidJS/nucleoid.com/tree/docusaurus

[Gulshanaggarwal]

👍

[canmingir]

Finally, docusaurus version:

https://nucleoid.com/docs/get-started/

[Gulshanaggarwal]

Improved UI great! although there are still problems.

[Gulshanaggarwal]

Hey Can, can you tell me if any help I can do?