Posted by Jeremie Bresson on
URL: https://discuss.asciidoctor.org/Relative-links-in-github-vs-firefox-extension-tp3011p3012.html

You should check this:
Link to an other document

Are you using the official firefox addon? Because includes are not working for me there:
Unresolved directive in <stdin> - include::../inc.adoc[] #21
This is a limitation of firefox itself.

GitHub includes are also not always working. Check this:
example-manual.adoc (from the maven example repo but it does not matters).

At the end of the doc you have:

[source,asciidoc]
----
.include::subdir/_b.adoc[]
====
include::subdir/_b.adoc[]
====

WARNING: Includes can be tricky!
----

And this is not working.

If browser preview matters to you, Dan Allen told us, that the Asciidoctor.js Live Preview Extension for Chrome is the best solution for now. (Learn more about our meeting at JavaLand and the extension setup).

Another tip that Dan told us about GitHub preview, is that there is a tool called gist.asciidoctor.org, where you can preview the same document: example-manual.adoc. Rendering should be better with this tool.