NucleoidAI
Navigation problem
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.
👍 Sounds good, honestly, I couldn't find a good ToC library for React. BTW, HTML is generated thru markdown here
@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? 🤔
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,
https://github.com/kyoncy/react-markdown-heading/issues/33
@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 🤔
Fantastic, docusaurus is looking really cool, we can switch into that, instead of trying to maintain our markdown generator
@canmingir So, what's the plan for switching? Do you have any idea so that we can start?
@canmingir in open-source always! let's give it a shot. What's the plan?
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
There is a conversation going on, docusaurus may not be possible with MUI
https://github.com/facebook/docusaurus/issues/7505
@canmingir If MUI is not possible then we can go ahead with what docusaurus provides.
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