#274 aconym expansion inline

Dave Pawson

Provide markup within the acronym tag to enable a tts system to read out the acronym expansion immediately after the acronym itself. I note the rejection of the previous rfe. This is a simple accessibility request. Markup should be optional. termdef may be appropriate.


  • Norman Walsh

    Norman Walsh - 2010-12-15

    We talked about this on the call today. It seems that there are two existing approaches that would work. First, you could put the acronyms in a glossary, point to the glossary entries, and get the expansions from there. If you wanted a one-off entry without all the glossary machinery, you could use alt for this purpose.

    If neither of those approaches satisfies your use case, could you provide a little more detail for us?


  • Robert Stayton

    Robert Stayton - 2011-10-25

    I notice that the stylesheets already use any alt element within acronym and abbrev as the value of the title attribute.

  • Norman Walsh

    Norman Walsh - 2011-12-13

    Dave? More detail?

  • Dave Pawson

    Dave Pawson - 2011-12-13

    I object to the glossary entry on accessibility grounds.
    Why should the blind reader have to follow a link to have the term explained (or a sighted reader for that matter)
    Ditto alt, on an inline? Not on for my 2c.

    If you won't add markup please accept that and clear this rfe.

    Semantic markup as the acronym marked up, and provides the expansion there, and at the same point in the document. Just my view.

  • Norman Walsh

    Norman Walsh - 2012-01-13

    I'm not prepared to say that we won't add markup for this case, but I think we need to understand it better. Are you using a reader on the DocBook XML sources? I was assuming that you were generating HTML of some sort with embedded markup for the reader. The suggestion to use glossary doesn't prevent you from inlining the expansions in the generated text.

    Could you provide some concrete examples of the markup that you'd like to use?

  • Dave Pawson

    Dave Pawson - 2012-01-13

    I'm not fussy about the gi, but something like
    <acronym>RNIB<expansion>Royal National Institute of the Blind</expansion></rnib>
    would provide quick access for a TTS engine (or a sighted reader)

  • Norman Walsh

    Norman Walsh - 2012-01-18

    Why is <acronym>RNIB<alt>Royal National Institute of the Blind</alt></acronym> not an acceptable alternative?

  • Dave Pawson

    Dave Pawson - 2012-01-18

    <acronym>RNIB<alt>Royal ... </alt></acronym> is fine by me. Sigh. I guess it is an alternative... I'd have preferred expansion as better semantics but I'll be satisfied with this Norm.
    Please close the rfe.


  • Norman Walsh

    Norman Walsh - 2012-03-20
    • status: open --> closed-works-for-me
  • Norman Walsh

    Norman Walsh - 2012-03-20

    Thanks, Dave.


Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks