Sébastien Gendre <s...@k-7.ch> writes: > I am modifying the ox-html options to add KEYWORD/OPTION and while > modify `org-html-allow-name-attribute-in-anchors', I wanted to know more > about the anchors. > > In an Org-mode document exported to HTML, anchors are the link that > point to somewhere else in the HTML document ?
Anchor in ox-html export is <a> tag - link to somewhere; not necessarily inside HTML document. See https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a If you are asking about `org-html--anchor', it is used only for internal links, AFAIK. > Do you think it's a good idea to add a paragraph, in the section `Links > in HTML export' of the org-mode documentation, to talk about the > variable `org-html-allow-name-attribute-in-anchors' and it's new in-file > option equivalent ? Nope. That option should probably be obsoleted. It was first introduced to handle ePub export: https://list.orgmode.org/orgmode/1323816335.4781.0@windy/ And we later switched from historical defaults to be compatible with HTML5: https://list.orgmode.org/orgmode/CAJ+TeocCiPt3MxPHyHcpS=dpoz0kjxwejuxnfwf_mm0opvv...@mail.gmail.com/ because non-nil value of `org-html-allow-name-attribute-in-anchors' is basically introducing an obsolete (in HTML5) <a> tag parameter. That was 11 years ago... -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
