quarkiverse/quarkus-neo4j

Docs code snippets report an error

Thefolle opened this issue · 4 comments

Thefolle commented

Docs code snippets report an error

The Neo4j docs related to Quarkus have broken code snippets.

What I see on most snippets is:
Unresolved include directive in modules/ROOT/pages/index.adoc - include::../../../../integration-tests/src/main/java/io/quarkus/it/neo4j/FruitResource.java[]

I use Firefox.

Could you please check?

michael-simons commented

Thanks @Thefolle much appreciated.

Hello @gsmet I am unsure about the docs build: How can I tell antora / the asciidoc config here to make include things correctly? My local preview works (i.e. open the adoc file in IDEA). Would be nice if you can help me here please.

michael-simons commented

Hmm @gastaldi do you know?

gastaldi commented

@michael-simons you need to create symbolic links under an examples directory in the docs/modules/ROOT directory. See https://docs.antora.org/antora/latest/symlinks/ for more details

I created #83 to fix this

michael-simons commented

Thanks a lot, much appreciated!