Uploaded image for project: 'WildFly'
  1. WildFly
  2. WFLY-12277

Invalid 'images/images' in image URLs in the docs

    XMLWordPrintable

Details

    Description

      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.

      Attachments

        Issue Links

          Activity

            People

              bstansbe@redhat.com Brian Stansberry
              bstansbe@redhat.com Brian Stansberry
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: