Docs page enhancements - Githubissues

cogentcore / core

A free and open source framework for building powerful, fast, elegant 2D and 3D apps that run on macOS, Windows, Linux, iOS, Android, and the web with a single Go codebase, allowing you to Code Once, Run Everywhere.

http://cogentcore.org/core

BSD 3-Clause "New" or "Revised" License

1.73k stars 82 forks source link

Docs page enhancements #1111

Open suntong opened 2 months ago

suntong commented 2 months ago

Interactive, editable examples of all major widgets are available on the main docs page (which is also a Cogent Core app running via wasm).

Here is what issues I found about our docs site.

Copy & paste not possible, at least with my Linux Chrome. This makes it hard for people to follow the instructions as-is, and tiny typos will make getting started to have more hurdles.
Search is not possible, when I type something in my search box and hit enter, I'm getting this:

Meanwhile, where is the source text for our main docs page please?

kkoreilly commented 2 months ago

Thank you for filing this. The source for the docs is in the docs directory, mainly the docs/content directory. It is built using pages, which you can read about here. I am working on improving the search setup. I am also working on improving the selection support for copy and paste (see #1051).

j0hnsmith commented 2 months ago

I noticed that double clicking a word in the docs selects the whole paragraph instead of the word, also right click doesn't display the usual menu, seems like something is overriding default os behaviours.

kkoreilly commented 2 months ago

Yes, we are overriding default os behaviors, which is necessary for the event system to work correctly. We just need to improve text selection (#1051).

suntong commented 2 months ago

I just noticed that middle clicking which should open the underlying link in another tab is not working either.

kkoreilly commented 2 months ago

Yes, I will also work on fixing that.