dartdoc icon indicating copy to clipboard operation
dartdoc copied to clipboard

Add copyable link-to-this-section icon link to linkable headers.

Open jacob314 opened this issue 9 years ago • 9 comments

For example: https://www.dartdocs.org/documentation/test/0.12.15%2B11/#asynchronous-tests

should navigate to the asynchronous-tests section of the doc but doesn't.

jacob314 avatar Oct 31 '16 20:10 jacob314

It looks like Dartdoc isn't generating IDs for headers at all.

nex3 avatar Oct 31 '16 20:10 nex3

@keertip

devoncarew avatar Oct 31 '16 21:10 devoncarew

CC @jcollins-g

srawlins avatar Jul 11 '17 15:07 srawlins

I'd like to link to a specific section in Flutter's API docs such as the "Performance considerations" section in https://docs.flutter.io/flutter/widgets/StatefulWidget-class.html. This is probably covered by this bug. If not, I can file a separate one.

InMatrix avatar Oct 10 '18 23:10 InMatrix

@InMatrix dartdoc does generate ids now. This now works, for example: https://master-docs-flutter-io.firebaseapp.com/flutter/widgets/StatefulWidget-class.html#performance-considerations

jcollins-g avatar Oct 10 '18 23:10 jcollins-g

IIRC this is still open because I'm not entirely certain all edge cases around this work, since we're using javascript scrolling.

jcollins-g avatar Oct 10 '18 23:10 jcollins-g

Great, it works now. It would be nice to have a link-to-this-section icon next to each linkable header to help discover this feature.

InMatrix avatar Oct 10 '18 23:10 InMatrix

An example of the "link-to-this-section" icon can be found here: https://sites.google.com/corp/google.com/quantcon2018/talks

image

InMatrix avatar Oct 12 '18 22:10 InMatrix

Rewrote title to reflect current issue. Adding link icons probably means post-processing the markdown-generated HTML.

jcollins-g avatar Jan 31 '19 18:01 jcollins-g