+1
Fixed

link description not displayed

Steven John Bethard 4 years ago updated by Christian Fritz 9 months ago 11

The documentation says "To add links to any additional content, just add fields to your bibtex file that start with url. The remainder of the field name will be used as link description." I've created a Bib entry with a field url_Data in the first entry here: http://clulab.cs.arizona.edu/papers/clulab.bib. But when displayed by bibbase, I get just a link icon, not the label "Data" like the documentation suggests: http://bibbase.org/show?bib=http%3A%2F%2Fclulab.cs.arizona.edu%2Fpapers%2Fclulab.bib

Answer

Answer
Not a bug

That's just a style decision. The default theme/CSS style hide the bibbase_icon_text elements and show the bibbase_icon elements instead. To show the text instead of the icons you can either change the CSS rules for these CSS classes accordingly, or use one of the predefined themes that already use that, e.g.:


http://bibbase.org/show?bib=http%3A%2F%2Fclulab.cs.arizona.edu%2Fpapers%2Fclulab.bib&theme=side

Answer
Not a bug

That's just a style decision. The default theme/CSS style hide the bibbase_icon_text elements and show the bibbase_icon elements instead. To show the text instead of the icons you can either change the CSS rules for these CSS classes accordingly, or use one of the predefined themes that already use that, e.g.:


http://bibbase.org/show?bib=http%3A%2F%2Fclulab.cs.arizona.edu%2Fpapers%2Fclulab.bib&theme=side

+3

Thanks for the help!


Can I suggest that you at least say something like "The remainder of the field name will be used as link description (which will show if enabled with CSS)" in the documentation? That way it's clearer why it doesn't show up by default.


Also, it seems that "theme=default" does indeed display the link descriptions, while leaving the theme off doesn't. The documentation says that "default = "default"" for the theme, but the following two links display differently:

http://bibbase.org/show?bib=http%3A%2F%2Fclulab.cs.arizona.edu%2Fpapers%2Fclulab.bib&theme=default

http://bibbase.org/show?bib=http%3A%2F%2Fclulab.cs.arizona.edu%2Fpapers%2Fclulab.bib

Why is that?

I want to to emphasize that Steven is right! The manual as it is currently is technically incorrect. It clearly says "To add links to any additional content, just add fields to your
bibtex file that start with url. The remainder of the field name will be used as link description." And -- as you said -- this is incorrect as it *only* is true if you add "theme=default".

So can you please correct (i.e., expand) that explanation in the manual? It would have saved me two hours of research! Just add this explanation and you can save lots of people lots of time... (At least those people who want to exploit that extremely useful feature.)

+1
Fixed

Thanks for reporting this and sorry for the delay. We've now fixes this in two ways: we updated the documentation to remove the inaccuracy, and we also changed the behavior such that these descriptions are used even when using icons instead of text, namely as tool-tip for the icon.

Thank you for fixing this! However, are you sure that you actually uploaded the updated text? The documentation (for me) still shows:

"To add links to any additional content, just add fields to your bibtex file that start with url. The remainder of the field name will be used as link description [...]"

which is still incorrect as it still does not say that this is only the case if "theme=default" is used.

What do you see in the ellipsis? It now says: "The remainder of the field name will be used as link description or, when using icon-link, as the icon tool-tip." If you don't see that, then you may need to force a reload of the page.

I do not see any ellipsis, but I do see exactly the text that you mention. But as argued this is still incorrect, as it still suggests that one sees "the remainder of the filed name as link description", which is, however, only true if "theme=default" is used. This is still not mentioned. Or is it? (I emptied my cache and refreshed, but still can't find that.)

Well, there is an "or" there. The or, to me, implies that the first part of the sentence is not universally true, because there is a different case that can occur. That case is when using icon-links, in which case the remainder of the field name is used as icon tool-tip. At least that was the intended meaning of that sentence. Is that not how you read it?

I read the sentence as two cases:
(2) Either icons are shown, in this case the link description is shown as tool tip,

or (i.e., otherwise)

(1) the link is shown as description on the page.


Ah, now I get it. The problem is, that (1) only holds *if* "theme=default" is used, is that correct? I was not aware of that! So apparently case (1) is equivalent to using "theme=default" and, thus, case (2) is equivalent to *not using* "theme=default". Is that right? That would explain why we disagree(d).

I still think it makes sense to somewhere (maybe even there, but otherwise in the "theme" section of the table) mention this, i.e., that showing this text is only enabled with "theme=default". I believe that *still*, i.e., despite your reformulation of the text, I would not able to find this out. I mean how would I? Your documentation still does not mention this.

OK, sounds good. I've change it to where it mentions the theme being used. I don't want to call out theme=default explicitly, because there are multiple themes that use text links, and it doesn't solely depend on the theme either. Many users define their own CSS rules to style the appearance instead of using a theme.