Re: [Orgmode] Re: unique id=-values in aggregated html-exported docs

[Sebastian Rose]

Dirk-Jan C. Binnema <address@hidden> writes
>>>>>> On Tue, 11 May 2010 21:11:04 +0200, Sebastian Rose ("SR") wrote:
>
>   SR> Dirk-Jan C. Binnema <address@hidden> writes:
>   >> Hi,
>   >> 
>   >>>>>>> On Tue, 11 May 2010 11:07:15 +0200, Christian Egli ("CE") wrote:
>   >> 
>   CE> Dirk-Jan C. Binnema <address@hidden> writes:
>   >> >> I found a small issue when aggregating multiple org-exported-to-html
>   >> >> entries into one page. The problem is that some of the html-elements 
> have
>   >> >> id=... attributes, which are supposed to be unique in a html document;
>   >> >> however, this fails when aggregating different elements into one.
>   >> 
>   CE> Can you list which html elements are the problem? 
>   CE> Does it help if you use the BODY-ONLY option (C-h f org-export-as-html)?
>   >> 
>   >> Actually, that's what I'm doing already (through org-publish). The final
>   >> (aggegated) result is at:
>   >> http://www.djcbsoftware.nl/changelog/index.html 
>   >> I got warned by tidy. I think it wouldn't be too hard easy to fix this by
>   >> adding a per-document random cookie to these ids.
>
>   SR> Can you verify, that those are clashing IDs?
>
> Sure:
>
>
>   % cat index.html | grep id=
> [....]
>   
>    <div id="outline-container-1" class="outline-3">
>             <h3 id="sec-1">
>             <div class="outline-text-3" id="text-1">
>           <div id="outline-container-1" class="outline-3">
>             <h3 id="sec-1">
>             <div class="outline-text-3" id="text-1">
>           <div id="outline-container-2" class="outline-3">
>             <h3 id="sec-2">
>             <div class="outline-text-3" id="text-2">
>           <div id="outline-container-1" class="outline-3">
>             <h3 id="sec-1">
>             <div class="outline-text-3" id="text-1">
>           <div id="outline-container-2" class="outline-3">
> [...]


Funny - cannot verify that and never saw it. Why are your section
numbers not increased?

Could you please provide a simple testfile?



> So, the issue is with aggregating separate exported html blobs into one page;
> of course org-mode has no real control over the uniqueness of the ids then.
>
> My idea would be that we could add some per-exported org-file cookie, so the
> ids could be something like:
>
>    id="text-456EF-1"


How to refer to a certain section in a stylesheet then?


> Then we shouldn't get these clashes when aggregating them later. It's a bit of
> a small imperfection, except when you want to do something with those ids.
>
> There is a somewhat related issue with footnotes (id=footnotes and
> href=#fnr.1), that could be a practical problem, i.e.. you might jump to the
> wrong footnote.
>
>   >> BTW, tidy also warned me about missing summary= attributes for tables; is
>   >> there some way to add those?
>
>   SR> Yes, summary is required. We all forgot to add it. It's meant to take a
>   SR> description of the table's content and some browsers use it for
>   SR> accessability purposes (I guess the summary is read aloud then).
>
>   SR> A quick fix would be to just add `summary=""' to the table definition:
>
>   SR>    <table summary="" ...>
>
> Well, it's easy to shut up the html-validators (like tidy), but for true
> accessibility it'd be nice to set the summary to something meaningful (same
> for the alt= attribute of images). Not sure if that is a priority right now,
> and I guess it might add some complexity.

Agreed. But Org cannot guess.


> Anyway, these are all fairly minor points (for me at least, I don't use the
> a11y stuff -- in general I'd like to applaud the excellent work that has been
> done in the html-export area, which I enjoy every day.


Regards

  Sebastian