Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello, William Crandall bc3141...@gmail.com writes: I confess I am puzzled by the choice to drop the ability to apply attributes to links. That's not a choice /per se/, merely an annoying side-effect of moving to an overall better paradigm. Org input: -- A paragraph with three papers, and an image: #+ATTR_HTML: title=Paper #1 [[./local/01.html][a first paper]] followed by #+ATTR_HTML: title=Paper #2 [[./local/02.html][a second paper]] which describe stuff. It then offers a cat #+ATTR_HTML: title=Some cats alt=Cat image [[./local/cats.png]] and finally a third, PDF paper #+ATTR_HTML: title=Paper #3 [[./local/03.pdf][a third paper]] -- Old exporter: -- p A paragraph with three papers, and an image: a href=./local/01.html title=Paper #1a first paper/a followed by a href=./local/02.html title=Paper #2a second paper/a which describe stuff. It then offers a cat img src=./local/cats.png title=Some cats alt=Cat image / and finally a third, PDF paper a href=./local/03.pdf title=Paper #3a third paper/a /p -- I believe that this ability, this specificity within paragraphs, is generally quite useful, and I hope that you will consider it for the new exporter. I understand your problem, but inserting ATTR_HTML keywords in a paragraph isn't possible anymore. I cannot allow that as it would defeat a fundamental change in the new Org syntax. Though, I'm open to any other suggestion. For example, link's syntax could be extended to allow attributes, much like Babel's inline source blocks or calls. It would probably require many changes to core, though. ATTR_HTML could also accept a list of properties that would be applied in order to each link in the paragraph. But it wouldn't scale well with a large number of links. I'm certain there are better solutions out there. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello, William Crandall bc3141...@gmail.com writes: You mentioned before using filters. I take it these are the ones described in org-export-filters.el (line 1775), The Filter System. Has anyone written up any worked examples of these? org-e-ascii.el and org-e-html.el both use filters. Also, I posted a few examples on this list while answering to requests from users. And, is that the best tool for adding attributes to links? Besides your canonical example, I don't know exactly what are your needs. Hence, it may be, but that's hard to tell. Filters are meant to modify output from transcoders (so you're working with HTML, or LaTeX, or... material) before it is concatenated into global result. They allow the user to have the last word in any situation. You can also define your own transcoders if you prefer to work on parsed data. Now, if the attributes you want to add have no pattern with regards to related link, you cannot do much programmatically and you'll have to insert HTML code manually. Also, besides code comments, you may have a look at: http://orgmode.org/worg/dev/org-export-reference.html Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello Nicolas, Many thanks for explaining the logic and functionality of the new exporter. I confess I am puzzled by the choice to drop the ability to apply attributes to links. The use case I'm aiming for is a standard HTML feature: 3.2.3.2 The 'title' attribute The title attribute represents advisory information for the element, such as would be appropriate for a tooltip. On a link, this could be the title or a description of the target resource; on an image, it could be the image credit or a description of the image; on a paragraph, it could be a footnote or commentary on the text; on a citation, it could be further information about the source; and so forth. http://www.w3.org/TR/html5/global-attributes.html#the-title-attribute In org-e-html today, it is only possible to attach a unique attribute to a paragraph; all links within that paragraph inherit its attributes. If a paragraph contains two links, they are both forced to show the same tooltip. The old exporter allowed this specificity, correctly interleaving link and image titles in one paragraph: Org input: -- A paragraph with three papers, and an image: #+ATTR_HTML: title=Paper #1 [[./local/01.html][a first paper]] followed by #+ATTR_HTML: title=Paper #2 [[./local/02.html][a second paper]] which describe stuff. It then offers a cat #+ATTR_HTML: title=Some cats alt=Cat image [[./local/cats.png]] and finally a third, PDF paper #+ATTR_HTML: title=Paper #3 [[./local/03.pdf][a third paper]] -- Old exporter: -- p A paragraph with three papers, and an image: a href=./local/01.html title=Paper #1a first paper/a followed by a href=./local/02.html title=Paper #2a second paper/a which describe stuff. It then offers a cat img src=./local/cats.png title=Some cats alt=Cat image / and finally a third, PDF paper a href=./local/03.pdf title=Paper #3a third paper/a /p -- I believe that this ability, this specificity within paragraphs, is generally quite useful, and I hope that you will consider it for the new exporter. If I'm missing something, if there /is/ a way to add individual link attributes, please let me know. It doesn't sound like filters allow that. Thanks again, for building and explaining. -BC Org-mode version 7.8.11 (release_7.8.11-64-g168c83) GNU Emacs 24.1.50.1 (i386-mingw-nt6.1.7601) Windows 7
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello, William Crandall bc3141...@gmail.com writes: ATTR_HTML is only for paragraphs, not links. This puzzles me, because (1) the old exporter works fine on links that are inside paragraphs, as my example showed, and (2) the Manual says ATTR_HTML lines are for links: That's a major change from previous exporter. Now, almost every element, including paragraphs, can have affiliated keywords at their beginning. Hence you can write: #+attr_latex: something - item 1 - item 2 or #+attr_html: something Some paragraph. This means that One paragraph. #+attr_html: something [[link]] Second paragraph is equivalent to: One paragraph. #+attr_html: something [[link]] Second paragraph Now let's have a look at your example. #+ATTR_HTML: title=The Org mode homepage style=color:red; [[http://orgmode.org]] In this case, the affiliated keyword is attached to the paragraph containing the link. But _the link can inherit from paragraph's attributes_. Since this is not the case yet in, I've added into code base. Is it working as expected? I hope I am clearer now. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello Nicolas, Yes, thanks for explanation and code update. It works as you describe, as you can see below. This is a change; now all links within a paragraph are given (inherit) the same ATTR_HTML. Is it possible with the new exporter to add ATTR_HTML attributes to individual link elements? Thanks again for all your work on this! -BC Org-mode: 7.8.11 (release_7.8.11-55-g3f0f87) Emacs: 24.1.50.1 Windows 7 Org input: -- #+ATTR_HTML: title=The Org mode homepage style=color:red; [[http://orgmode.org]] #+ATTR_HTML: title=Link hover text [[http://www.orgmode.org][This paragraph]] describes how to use orgmode. A paragraph about #+ATTR_HTML: title=Link hover text [[./orgmode][org-mode]] which describes org-e-html... #+ATTR_HTML: title=Link hover text Another paragraph about [[./orgmode][org-mode]] which describes org-e-html... -- Old: -- p a href=http://orgmode.org; title=The Org mode homepage style=color:red;http://orgmode.org/a /p p a href=http://www.orgmode.org; title=Link hover textThis paragraph/a describes how to use orgmode. /p p A paragraph about a href=./orgmode title=Link hover textorg-mode/a which describes org-e-htmlhellip; /p p Another paragraph about a href=./orgmodeorg-mode/a which describes org-e-htmlhellip; /p -- New: -- p a href=http://orgmode.org; title=The Org mode homepage style=color:red;http://orgmode.org/a /p p a href=http://www.orgmode.org; title=Link hover textThis paragraph/a describes how to use orgmode. /p p A paragraph about /p p a href=./orgmode title=Link hover textorg-mode/a which describes org-e-htmlhellip; /p p Another paragraph about a href=./orgmode title=Link hover textorg-mode/a which describes org-e-htmlhellip; -- On Fri, Jun 8, 2012 at 6:28 AM, Nicolas Goaziou n.goaz...@gmail.com wrote: Hello, William Crandall bc3141...@gmail.com writes: ATTR_HTML is only for paragraphs, not links. This puzzles me, because (1) the old exporter works fine on links that are inside paragraphs, as my example showed, and (2) the Manual says ATTR_HTML lines are for links: That's a major change from previous exporter. Now, almost every element, including paragraphs, can have affiliated keywords at their beginning. Hence you can write: #+attr_latex: something - item 1 - item 2 or #+attr_html: something Some paragraph. This means that One paragraph. #+attr_html: something [[link]] Second paragraph is equivalent to: One paragraph. #+attr_html: something [[link]] Second paragraph Now let's have a look at your example. #+ATTR_HTML: title=The Org mode homepage style=color:red; [[http://orgmode.org]] In this case, the affiliated keyword is attached to the paragraph containing the link. But _the link can inherit from paragraph's attributes_. Since this is not the case yet in, I've added into code base. Is it working as expected? I hope I am clearer now. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello, William Crandall bc3141...@gmail.com writes: This is a change; now all links within a paragraph are given (inherit) the same ATTR_HTML. Indeed. Is it possible with the new exporter to add ATTR_HTML attributes to individual link elements? No, it isn't possible to control individual link elements with affiliated keywords. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Ah, that is a pity. Seems like a step back, in allowable specificity. As it was possible in the old. You mentioned before using filters. I take it these are the ones described in org-export-filters.el (line 1775), The Filter System. Has anyone written up any worked examples of these? And, is that the best tool for adding attributes to links? Thanks again, -BC On Fri, Jun 8, 2012 at 3:37 PM, Nicolas Goaziou n.goaz...@gmail.com wrote: Hello, William Crandall bc3141...@gmail.com writes: This is a change; now all links within a paragraph are given (inherit) the same ATTR_HTML. Indeed. Is it possible with the new exporter to add ATTR_HTML attributes to individual link elements? No, it isn't possible to control individual link elements with affiliated keywords. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello, William Crandall bc3141...@gmail.com writes: If org-mode source text is: -- A paragraph about #+ATTR_HTML: title=Link hover text [[http://orgmode.org]] exalting new emacs mode... -- M-x org-export-dispatch h generates: -- p A paragraph about /p p a href=http://orgmode.org;http://orgmode.org/a exalting new emacs modehellip; /p -- which is less grand. I see two needed fixes, reading http://orgmode.org/org.html#Links-in-HTML-export 1. A new /pp should not be inserted before lines starting #+ATTR_HTML. It sure should: you're starting a new paragraph containing a link and exalting new emacs mode... text. ATTR_HTML is an attribute for paragraphs, not links (though it may apply on links within the paragraph). You may want to add your title attribute with filters. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Hello Nicolas, Thanks for your email. You write: ATTR_HTML is only for paragraphs, not links. This puzzles me, because (1) the old exporter works fine on links that are inside paragraphs, as my example showed, and (2) the Manual says ATTR_HTML lines are for links: 12.5.4 Links in HTML export http://orgmode.org/org.html#Links-in-HTML-export If you want to specify attributes for links, you can do so using a special #+ATTR_HTML line to define attributes that will be added to the a or img tags. Here is an example that sets title and style attributes for a link: #+ATTR_HTML: title=The Org mode homepage style=color:red; [[http://orgmode.org]] Thanks for looking at this again! -BC On Thu, Jun 7, 2012 at 12:28 PM, Nicolas Goaziou n.goaz...@gmail.com wrote: Hello, William Crandall bc3141...@gmail.com writes: If org-mode source text is: -- A paragraph about #+ATTR_HTML: title=Link hover text [[http://orgmode.org]] exalting new emacs mode... -- M-x org-export-dispatch h generates: -- p A paragraph about /p p a href=http://orgmode.org;http://orgmode.org/a exalting new emacs modehellip; /p -- which is less grand. I see two needed fixes, reading http://orgmode.org/org.html#Links-in-HTML-export 1. A new /pp should not be inserted before lines starting #+ATTR_HTML. It sure should: you're starting a new paragraph containing a link and exalting new emacs mode... text. ATTR_HTML is an attribute for paragraphs, not links (though it may apply on links within the paragraph). You may want to add your title attribute with filters. Regards, -- Nicolas Goaziou
Re: [O] org-e-html: Including ATTR_HTML: title=hover text
Also, any chance of getting (parentheses) around a link WITH a title, but without ( extra spaces )? Org input: -- A paragraph about a new mode ( #+ATTR_HTML: title=Link hover text [[./orgmode][org-mode]] ) that is really cool... -- M-x org-export h, generates: -- A paragraph about a new mode ( a href=./orgmode title=Link hover textorg-mode/a ) that is really coolhellip; /p -- which adds the title just fine, but it renders: ( org-mode ) ^^ * Putting the opening parentheses at the start of the #+ATTR_HTML line kills it. * Putting the closing parentheses at the end of the link line: ]]) kills the title attribute. It would be great, though perhaps tricky, for org-e-html to be able to generate a titled link, inside parentheses, WITHOUT extra spaces. But that may be a bridge too far. Thanks for giving it a try! -BC Org-mode: 7.8.11 (release_7.8.11-52-g451191) Emacs: 24.1.50.1 Windows 7 On Wed, Jun 6, 2012 at 7:08 PM, William Crandall bc3141...@gmail.com wrote: Hello Jambunathan and Nicolas, If org-mode source text is: -- A paragraph about #+ATTR_HTML: title=Link hover text [[http://orgmode.org]] exalting new emacs mode... --