OASIS DocBook TC2

 View Only
  • 1.  Re: [docbook-tc] Re: RFE 3107140

    Posted 06-24-2011 10:57
    Jirka Kosek <jirka@kosek.cz> writes: > > Well, then description is outdated, it was not simply updated. Ah. My bad. How's this? <refsection condition="ref.description"> <title>Description</title> <para>The <tag>alt</tag> element was originally added to DocBook to provide an alternative, usually text, presentation for graphical elements. In DocBook V5.0, it was made a €œubiquitous € element so that it's available almost everywhere. The semantic intent of <tag>alt</tag> is simply that it provides alternative text, often for accessibility.</para> <refsection> <title>Processing expectations</title> <para>May be formatted inline or as a displayed block, depending on context. It is not usually rendered where it occurs, rather it is used to annotate some other aspect of the presentation.</para> <para>For example, in an HTML presentation, the <tag>alt</tag> for a media object would likely provide the text of the <tag class="attribute">alt</tag> attribute for the HTML <tag namespace=" http://www.w3.org/1999/xhtml" ;>img</tag> element.</para> <para>In the context of an <tag>acronym</tag>, the <tag>alt</tag> could provide the <tag class="attribute">title</tag> attribute for the HTML <tag namespace=" http://www.w3.org/1999/xhtml" ;>phrase</tag>, commonly presented as a €œtooltip € in visual browsers.</para> </refsection> Better? And does this provide a satisfactory close for 3107140? Be seeing you, norm -- Norman Walsh <ndw@nwalsh.com> True peace is not merely the http://www.oasis-open.org/docbook/ absence of tension: it is the Chair, DocBook Technical Committee presence of justice.--Martin Luther King PGP signature


  • 2.  Re: [docbook-tc] Re: RFE 3107140

    Posted 06-24-2011 11:13
    On 24 June 2011 11:56, Norman Walsh <ndw@nwalsh.com> wrote: > <para>In the context of an <tag>acronym</tag>, the <tag>alt</tag> could > provide the <tag class="attribute">title</tag> attribute for the HTML > <tag namespace=" http://www.w3.org/1999/xhtml" ;>phrase</tag>, commonly presented > as a €œtooltip € in visual browsers.</para> > > </refsection> > > Better? And does this provide a satisfactory close for 3107140? Except for <phrase> as in html? http://www.w3.org/WAI/wcag-curric/sam41-0.htm <ACRONYM TITLE="Museum of Fine Arts">MFA</ACRONYM>, I.e. the title attribute is on acronym element, not phrase? See http://www.w3.org/WAI/GL/2011/WD-WCAG20-TECHS-20110621/H28.html where it is used for abbr too? Same usage, <abbr title="and others">et al.</abbr> So yes, but change <tag namespace=" http://www.w3.org/1999/xhtml" ;>phrase</tag>, to <tag namespace=" http://www.w3.org/1999/xhtml" ;>acronym</tag>, Also wary of " commonly presented as a €œtooltip € in visual browsers" since that is a visual presentation? Blind users would hear it. How about "Allows the expansion to be presented appropriately to the user" HTH -- Dave Pawson XSLT XSL-FO FAQ. Docbook FAQ. http://www.dpawson.co.uk