search

PreTeXtBook / pretext

PreTeXt: an authoring and publishing system for scholarly documents
https://pretextbook.org
Other
266 stars 208 forks source link

Knowlize cross-references to list items #185

Open rbeezer opened 8 years ago

rbeezer commented 8 years ago

Presently, a cross-reference is just a traditional hyperlink. Which would be needed anyway for an "in-context" link of a knowl.

How would you knowlize a list item? Show the entire list? (This is like a numbered equation in a display - the knowl for a reference to the one equation shows all the lines of the display.) Or show just the item, along with any lists nested below that item?

davidfarmer commented 8 years ago

In SL2X I show just that list item in the knowl.

You can come up with use cases that make it seem preferable to show the whole list -- but if you do that it would make sense to somehow highlight the referenced item.

There also are cases where the list is very long and it would be better to just show the one item.

Maybe this would make everyone happy: Show only that item. In addition to an "In context" link in the knowl, there is a "Full list" sub-knowl that would show the whole list.

On Sat, 12 Dec 2015, Rob Beezer wrote:

Presently, a cross-reference is just a traditional hyperlink. Which would be needed anyway for an "in-context" link of a knowl.

How would you knowlize a list item? Show the entire list? (This is like a numbered equation in a display - the knowl for a reference to the one equation shows all the lines of the display.) Or show just the item, along with any lists nested below that item?

— Reply to this email directly or view it on GitHub.[AAM6LNg5UOwzN_JNaKP5tFtnmPzxmEnbks5pPKh0gaJpZM4G0NyJ.gif]

rbeezer commented 8 years ago

Thanks, David. That's helpful. If I make a "list" environment, then folks can make xref to that for the whole list, and just xref a particular item if they want that.

An in-context link will go to the whole list in every case, it is only a question of where the anchor is (top of the list, or at an item of the list).

Rob

On 12/13/2015 10:12 AM, davidfarmer wrote:

In SL2X I show just that list item in the knowl.

You can come up with use cases that make it seem preferable to show the whole list -- but if you do that it would make sense to somehow highlight the referenced item.

There also are cases where the list is very long and it would be better to just show the one item.

Maybe this would make everyone happy: Show only that item. In addition to an "In context" link in the knowl, there is a "Full list" sub-knowl that would show the whole list.

On Sat, 12 Dec 2015, Rob Beezer wrote:

Presently, a cross-reference is just a traditional hyperlink. Which would be needed anyway for an "in-context" link of a knowl.

How would you knowlize a list item? Show the entire list? (This is like a numbered equation in a display - the knowl for a reference to the one equation shows all the lines of the display.) Or show just the item, along with any lists nested below that item?

— Reply to this email directly or view it on GitHub.[AAM6LNg5UOwzN_JNaKP5tFtnmPzxmEnbks5pPKh0gaJpZM4G0NyJ.gif]

— Reply to this email directly or view it on GitHub https://github.com/rbeezer/mathbook/issues/185#issuecomment-164285064.