[jboss-jira] [JBoss JIRA] (WFLY-12277) Invalid 'images/images' in image URLs in the docs

[Brian Stansberry (Jira)]

Brian Stansberry created WFLY-12277:
---------------------------------------

             Summary: Invalid 'images/images' in image URLs in the docs
                 Key: WFLY-12277
                 URL: https://issues.jboss.org/browse/WFLY-12277
             Project: WildFly
          Issue Type: Bug
          Components: Documentation
            Reporter: Brian Stansberry
            Assignee: Brian Stansberry


There are a lot docs.wildfly.org pages with broken image link because the 'images' part of src URL is duplicated.  The images render correctly when looking at the adoc page rendered by github in the wildfly/wildfly repo, but when the asciidoc is rendered to html, the 'images' part of the url is duplicated.

I think what happens is when there is an

image:xxx.png

in the adoc, the asciidoc plugin converts that to an image tag with a src attribute value of "images/xxx.png".  But our adoc files have this:

image:images/xxx.png

So, the 'images' is duplicated.

I think we have that in our files because that style renders correctly when looking at the raw adoc in http://github.com/wildfly/wildfly

I think the solution is to remove the 'images' from the line, and instead change the ifdef at the top of the page from:

ifdef::env-github[:imagesdir: ../]

to

ifdef::env-github[:imagesdir: ../images/]

At least with the one example I tried that worked.



--
This message was sent by Atlassian Jira
(v7.12.1#712002)