core icon indicating copy to clipboard operation
core copied to clipboard

Docs page enhancements

Open suntong opened this issue 1 year ago • 5 comments

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:

image

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

suntong avatar Aug 03 '24 20:08 suntong

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

kkoreilly avatar Aug 03 '24 22:08 kkoreilly

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.

j0hnsmith avatar Aug 05 '24 09:08 j0hnsmith

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

kkoreilly avatar Aug 05 '24 16:08 kkoreilly

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

suntong avatar Aug 17 '24 01:08 suntong

Yes, I will also work on fixing that.

kkoreilly avatar Aug 17 '24 06:08 kkoreilly