Investigate whether docs resources can be stored in relative directory rather than static

[gdams]

No description provided.

[tellison]

Still valid?

[gdams]

yup

[gdams]

For a bit of extra context... https://www.npmjs.com/package/gatsby-remark-copy-linked-files does this for Markdown files so in principle we need to find a way of doing something similar for the asciidoc files or potentially even extend the functionality of the plugin upstream.

I've asked the question in gatsbyjs/gatsby#37149 to see if other people are interested in this.

[ascheman]

Could you please add a small description about the problem?

I suspect it is about error messages shown in an IDE, e.g., IntelliJ (using the IntelliJ AsciiDoctor Plugin):

and the missing preview

At least for IntelliJ this can be resolved by adding a file .asciidoctorconfig into the respective directory (/content here).

:imagesdir: {asciidoctorconfigdir}/../static/images

Then the error in IntelliJ is gone, a mouse over will even show the referenced image:

and the preview will of course show the image as well

[ascheman]

If you feel my comment above describes the problem, you may assign the issue to me @gdams / @smlambert and add it to the Q1 2023 project.

[gdams]

@ascheman I should have marked this as fixed by #1397. We should hopefully no longer have this problem. Thanks for bringing the issue to my attention again thought.

[ascheman]

Please, please don't drop AsciiDoc in favour of markdown.