[jbosstools-issues] [JBoss JIRA] Commented: (JBIDE-5708) JBoss Tools docbook xslt does not allow for alt tags to be rendered correctly

OLga Chikvina (JIRA) jira-events at lists.jboss.org
Wed Jan 20 09:02:59 EST 2010


    [ https://jira.jboss.org/jira/browse/JBIDE-5708?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12507220#action_12507220 ] 

OLga Chikvina commented on JBIDE-5708:
--------------------------------------

Isaak,unfortunately I can't reproduce your bug,because in the https://svn.jboss.org/repos/jbosstools/trunk/documentation/guides/Beginners_Guide I can find only pom.xml without any docbook xml-s.But I tried to reproduce it by writting some text inside the <textobject>
<phrase>
some text
</phrase>
</textobject>  and putting it inside some <mediaobject>  tag,just like you did in your example.But no weird xml files appeared during compilation.That's why I suppose that the problem is just in your xml.Could you please commit all the Beginners_Guide content(including xml files,pictures) and I'll try to solve your problem.

> JBoss Tools docbook xslt does not allow for alt tags to be rendered correctly
> -----------------------------------------------------------------------------
>
>                 Key: JBIDE-5708
>                 URL: https://jira.jboss.org/jira/browse/JBIDE-5708
>             Project: Tools (JBoss Tools)
>          Issue Type: Bug
>          Components: maven
>         Environment: RHEL 5 and the jbosstools-docbook-xslt-1.0.0-SNAPSHOT
>            Reporter: Isaac Rooskov
>            Assignee: OLga Chikvina
>
> When using the <textobject> tag to house the necessary information of an image for the visually impared who use screenreaders to read our documentation, weird html files are created in the directory where the 'target' folder is generated. 
> Here's an example of the xml:
> <figure id="figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor">
> 						<title>Visual Page Editor</title> 
> 						<mediaobject>
> 							<imageobject>
> 								<imagedata fileref="images/figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor.png" format="PNG" width="444" />
> 							</imageobject>
> 							<textobject>
> 								<phrase>
> 									The Visual Page Editor, showing both the source and a visual preview simultaneously.
> 								</phrase>
> 							</textobject>
> 						</mediaobject>
> 					</figure>
> When the <textobject> isn't specified (which it doesn't seem to be in other JBoss Tools documentation I've had a look at) the title of the image is used as the alt-text for the image, however a visually impared reader requires more information than this, which is why the <textobject> tag exists. When using the <textobject> tag, the information in it is indeed used as the alt-text for the image, however weird xml files are generated in the output of compiling the book in maven (mvn compile). I have attached a screenshot of these files.
> Each weird html file contains the text of one <textobject> tag, thus there is a weird html file for every <textobject> in the book. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


More information about the jbosstools-issues mailing list